Struct AcOpfSolution 

pub struct AcOpfSolution { /* 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 optimal power flow solution: the AC power flow results plus the optimized generator active and reactive dispatch and the objective value.

Implementations

impl AcOpfSolution

pub fn new( instance: Arc<AcOpfInstance>, termination: Termination, bus_voltage_magnitude: Vec<f64>, bus_voltage_angle: Vec<f64>, bus_active_injection: Vec<f64>, bus_reactive_injection: Vec<f64>, branch_from_active_flow: Vec<f64>, branch_from_reactive_flow: Vec<f64>, branch_to_active_flow: Vec<f64>, branch_to_reactive_flow: Vec<f64>, generator_active_power: Vec<f64>, generator_reactive_power: Vec<f64>, objective: f64, three_winding_transformer_terminal_power: Vec<ThreeWindingTransformerTerminalPower>, ) -> Result<AcOpfSolution, Error>

Assemble the results: the AC power flow columns, the optimized per generator dispatch (MW and MVAr, generator table order), and the objective value.

Errors

A column whose length disagrees with the instance’s tables.

pub fn instance(&self) -> &AcOpfInstance

The immutable instance this solution solves. Borrowed; never a copy.

pub fn shared_instance(&self) -> Arc<AcOpfInstance>

The shared instance owner, for another solution of the same problem.

pub fn network(&self) -> &BalancedNetwork

The network the solved instance calculates on.

pub fn bus_order(&self) -> Vec<BusId>

Bus IDs in the column order every bulk accessor uses.

pub fn branch_order(&self) -> Vec<String>

Stable branch identities in bulk column order.

pub fn generator_order(&self) -> Vec<String>

Stable generator identities in bulk column order.

pub fn termination(&self) -> &Termination

How the producing calculation ended.

pub fn residuals(&self) -> &Residuals

The reported numerical residuals.

pub fn producer(&self) -> Option<&str>

The producer or solver identity, when recorded.

pub fn with_producer(self, producer: impl Into<String>) -> AcOpfSolution

Record the producer identity.

pub fn with_residuals(self, residuals: Residuals) -> AcOpfSolution

Record the numerical residuals.

pub fn branch_identity_order(&self) -> impl Iterator<Item = String>

The branch identities the flow columns follow, in table order.

pub fn with_bus_active_power_marginals( self, marginals: Vec<f64>, ) -> Result<AcOpfSolution, Error>

Attach the derivative of the optimal objective with respect to added active demand, in objective units per MW and bus table order.

Errors

A column whose length disagrees with the instance’s bus table.

pub fn with_bus_reactive_power_marginals( self, marginals: Vec<f64>, ) -> Result<AcOpfSolution, Error>

Attach the derivative of the optimal objective with respect to added reactive demand, in objective units per MVAr and bus table order.

Errors

A column whose length disagrees with the instance’s bus table.

pub fn with_branch_thermal_limit_multipliers( self, from: Vec<f64>, to: Vec<f64>, ) -> Result<AcOpfSolution, Error>

Attach the two nonnegative apparent power limit multipliers, in objective units per MVA and branch table order. Increasing the shared rating by one MVA changes the local optimal objective by the negative sum of the from and to terminal multipliers.

pub const fn objective(&self) -> f64

The optimized objective value.

pub fn bus_active_power_marginal(&self, bus: BusId) -> Option<f64>

Optimal objective derivative per added MW of active demand at one bus.

pub fn bus_reactive_power_marginal(&self, bus: BusId) -> Option<f64>

Optimal objective derivative per added MVAr of reactive demand.

pub fn branch_from_limit_multiplier(&self, identity: &str) -> Option<f64>

From-terminal apparent power bound multiplier by branch identity.

pub fn branch_to_limit_multiplier(&self, identity: &str) -> Option<f64>

To-terminal apparent power bound multiplier by branch identity.

pub fn bus_active_power_marginals(&self) -> Option<&[f64]>

All active demand marginals in bus table order, when attached.

pub fn bus_reactive_power_marginals(&self) -> Option<&[f64]>

All reactive demand marginals in bus table order, when attached.

pub fn branch_from_limit_multipliers(&self) -> Option<&[f64]>

All from-terminal thermal bound multipliers in branch table order.

pub fn branch_to_limit_multipliers(&self) -> Option<&[f64]>

All to-terminal thermal bound multipliers in branch table order.

pub fn generator_active_power(&self, identity: &str) -> Option<f64>

Optimized active power of one generator, MW, by stable identity.

pub fn generator_reactive_power(&self, identity: &str) -> Option<f64>

Optimized reactive power of one generator, MVAr.

pub fn bus_voltage_magnitude(&self, bus: BusId) -> Option<f64>

Voltage magnitude at one bus, per unit.

pub fn bus_voltage_angle(&self, bus: BusId) -> Option<f64>

Voltage angle at one bus, degrees.

pub fn bus_active_injection(&self, bus: BusId) -> Option<f64>

Net active injection at one bus, MW.

pub fn bus_reactive_injection(&self, bus: BusId) -> Option<f64>

Net reactive injection at one bus, MVAr.

pub fn branch_from_active_flow(&self, identity: &str) -> Option<f64>

Active flow into the branch at its from terminal, MW.

pub fn branch_from_reactive_flow(&self, identity: &str) -> Option<f64>

Reactive flow into the branch at its from terminal, MVAr.

pub fn branch_to_active_flow(&self, identity: &str) -> Option<f64>

Active flow into the branch at its to terminal, MW.

pub fn branch_to_reactive_flow(&self, identity: &str) -> Option<f64>

Reactive flow into the branch at its to terminal, MVAr.

pub fn three_winding_transformer_terminal_powers( &self, ) -> &[ThreeWindingTransformerTerminalPower]

Three winding transformer terminal powers in transformer table order.

pub fn bus_voltage_magnitudes(&self) -> &[f64]

The complete bus_voltage_magnitude column, in bus_order.

pub fn bus_voltage_angles(&self) -> &[f64]

The complete bus_voltage_angle column, in bus_order.

pub fn bus_active_injections(&self) -> &[f64]

The complete bus_active_injection column, in bus_order.

pub fn bus_reactive_injections(&self) -> &[f64]

The complete bus_reactive_injection column, in bus_order.

pub fn branch_from_active_flows(&self) -> &[f64]

The complete branch_from_active_flow column, in branch_order.

pub fn branch_from_reactive_flows(&self) -> &[f64]

The complete branch_from_reactive_flow column, in branch_order.

pub fn branch_to_active_flows(&self) -> &[f64]

The complete branch_to_active_flow column, in branch_order.

pub fn branch_to_reactive_flows(&self) -> &[f64]

The complete branch_to_reactive_flow column, in branch_order.

pub fn generator_active_powers(&self) -> &[f64]

The complete generator_active_power column, in generator_order.

pub fn generator_reactive_powers(&self) -> &[f64]

The complete generator_reactive_power column, in generator_order.

Trait Implementations

impl Clone for AcOpfSolution

fn clone(&self) -> AcOpfSolution

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AcOpfSolution

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

Formats the value using the given formatter.

impl From<AcOpfSolution> for PioValue

fn from(value: AcOpfSolution) -> Self

Converts to this type from the input type.