Struct DcPfInstance 

pub struct DcPfInstance { /* 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 DC power flow instance: the shared network plus per bus boundary specifications and the selected branch susceptance formula.

Implementations

impl DcPfInstance

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

Build the instance from the network’s stated data: reference buses contribute their stated angle, isolated buses no equation, and every other bus its net active injection over in service generators and loads.

Errors

A network with no reference bus.

pub fn with_branch_susceptance_formula( self, formula: BranchSusceptanceFormula, ) -> DcPfInstance

Select the branch susceptance formula, consuming the instance. The network handle moves; no table is copied.

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

Supply an optional solver initial point.

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

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

Errors

The replacement has no reference bus 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) -> &[DcBusSpecification]

The per bus boundary specifications, in bus table order.

pub const fn branch_susceptance_formula(&self) -> BranchSusceptanceFormula

The selected branch susceptance formula.

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

The optional solver initial point.

Trait Implementations

impl BalancedCalculationInstance for DcPfInstance

fn network(&self) -> &BalancedNetwork

The instance’s balanced electrical network.

impl Clone for DcPfInstance

fn clone(&self) -> DcPfInstance

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DcPfInstance

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

Formats the value using the given formatter.

impl From<DcPfInstance> for PioValue

fn from(value: DcPfInstance) -> Self

Converts to this type from the input type.