Struct AcPfInstance 

pub struct AcPfInstance { /* private fields */ }

The calculation types used by solver consumers. The full problem vocabulary lives in powerio_prob; these types sit at the facade root so a consumer does not need a second PowerIO dependency to name its boundary. The AC power flow instance: the shared network plus one AcBusSpecification per bus.

Implementations

impl AcPfInstance

pub fn new( network: BalancedNetwork, specifications: Vec<AcBusSpecification>, ) -> Result<AcPfInstance, Error>

Build an AC power flow instance from explicit bus specifications. The specification vector follows bus table order and is retained exactly; it is not inferred again from bus types, loads, or generator schedules.

Errors

The specification count differs from the bus count, or no specification declares a reference bus.

pub fn from_network(network: BalancedNetwork) -> Result<AcPfInstance, Error>

Build the instance from the network’s stated data. A PQ bus states its net injections; a PV bus its net active injection and the regulating generator’s voltage setpoint; a reference bus its setpoint magnitude and stated angle.

Errors

A network with no reference bus, or conflicting active voltage controllers: two in service generators at one bus stating different voltage setpoints are refused until an explicit edit resolves them.

pub fn with_initial_point( self, point: OperatingPoint<BalancedNetwork>, ) -> AcPfInstance

Supply an optional solver initial point.

pub fn with_network( self, network: BalancedNetwork, ) -> Result<AcPfInstance, Error>

Replace the network and recalculate the fixed bus specifications while preserving a compatible initial point.

Errors

The replacement has no reference bus, has conflicting voltage controllers, or changes an identity layout used by the initial point.

pub fn network(&self) -> &BalancedNetwork

The network this instance calculates on. Borrowed; never a copy.

pub fn specifications(&self) -> &[AcBusSpecification]

The per bus specifications, in bus table order.

pub const fn initial_point(&self) -> Option<&OperatingPoint<BalancedNetwork>>

The optional solver initial point.

pub fn to_dc_pf(&self) -> (DcPfInstance, Vec<Diagnostic>)

The DC power flow instance this AC problem implies: reactive data and voltage magnitudes are discarded, and the DC model’s flat voltage assumption is recorded as a diagnostic.

Trait Implementations

impl BalancedCalculationInstance for AcPfInstance

fn network(&self) -> &BalancedNetwork

The instance’s balanced electrical network.

impl Clone for AcPfInstance

fn clone(&self) -> AcPfInstance

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AcPfInstance

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl From<AcPfInstance> for PioValue

fn from(value: AcPfInstance) -> Self

Converts to this type from the input type.