Struct AcOpfInstance 

pub struct AcOpfInstance { /* 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 instance: the shared network, the typed objective, and the active generator capability, voltage, thermal, and angle constraint selections.

Implementations

impl AcOpfInstance

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

Build the instance with every stated limit active. The default objective is the network’s generator cost curves when at least one dispatchable generator carries cost data. A network with no applicable cost rows becomes an explicit feasibility problem instead of inventing zero cost curves. Partially populated costs still select the network objective so preparation reports the missing row.

Errors

A network with no reference bus or no in service generator attached to a non-isolated bus.

pub fn with_objective(self, objective: Objective) -> AcOpfInstance

Replace the objective, consuming the instance. The shared network moves; no table is copied.

pub fn with_objective_term(self, term: ObjectiveTerm) -> AcOpfInstance

Append one objective term, consuming the instance.

pub fn with_constraints(self, constraints: ActiveConstraints) -> AcOpfInstance

Replace the active constraint selections, consuming the instance.

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

Supply an optional solver initial point.

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

Replace the network while preserving this instance’s objective, constraint selections, and compatible initial point.

Errors

The replacement has no reference bus or dispatchable generator, or it 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 const fn objective(&self) -> &Objective

The typed objective.

pub const fn constraints(&self) -> &ActiveConstraints

The active constraint selections.

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

The optional solver initial point.

pub fn to_ac_pf(&self) -> Result<(AcPfInstance, Vec<Diagnostic>), Error>

The AC power flow instance for this problem’s network at its stated injections and setpoints: the objective and the constraint selections are discarded, and the discard is recorded.

Errors

As AcPfInstance::from_network.

pub fn to_dc_opf(&self) -> (DcOpfInstance, Vec<Diagnostic>)

The DC optimal power flow instance this AC problem implies: the objective and the generator capability, thermal, and angle selections carry over; the voltage bound selection has no DC variable and is discarded, and the flat voltage assumption is recorded.

Trait Implementations

impl BalancedCalculationInstance for AcOpfInstance

fn network(&self) -> &BalancedNetwork

The instance’s balanced electrical network.

impl Clone for AcOpfInstance

fn clone(&self) -> AcOpfInstance

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AcOpfInstance

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

Formats the value using the given formatter.

impl From<AcOpfInstance> for PioValue

fn from(value: AcOpfInstance) -> Self

Converts to this type from the input type.