Struct McAcPfSolution 

pub struct McAcPfSolution { /* 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 multiconductor AC power flow solution: terminal complex voltages, optional terminal currents and powers, and source injections over the shared instance.

Implementations

impl McAcPfSolution

pub fn new( instance: Arc<McAcPfInstance>, termination: Termination, terminal_voltage_magnitude: Vec<f64>, terminal_voltage_angle: Vec<f64>, source_active_injection: Vec<f64>, ) -> Result<McAcPfSolution, Error>

Assemble the required results: per terminal voltage magnitudes (volts) and angles (radians) in bus table and stated terminal order, and per source terminal active injections (watts) in source table order.

Errors

A column whose length disagrees with the instance’s resolved terminals.

pub fn instance(&self) -> &McAcPfInstance

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

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

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

pub fn network(&self) -> &MulticonductorNetwork

The network the solved instance calculates on.

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>) -> McAcPfSolution

Record the producer identity.

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

Record the numerical residuals.

pub fn terminal_voltage_magnitude( &self, bus: &str, terminal: &str, ) -> Option<f64>

Voltage magnitude at one bus terminal, volts.

pub fn terminal_voltage_angle(&self, bus: &str, terminal: &str) -> Option<f64>

Voltage angle at one bus terminal, radians.

pub fn terminal_current_magnitude( &self, bus: &str, terminal: &str, ) -> Option<f64>

Current into the network at one bus terminal, amperes, when the producer reported currents.

pub fn terminal_active_power(&self, bus: &str, terminal: &str) -> Option<f64>

Active power into the network at one bus terminal, watts, when the producer reported terminal powers.

pub fn with_terminal_currents( self, values: Vec<f64>, ) -> Result<McAcPfSolution, Error>

Record per terminal current magnitudes, amperes.

Errors

A column whose length disagrees with the resolved terminals.

pub fn with_terminal_powers( self, values: Vec<f64>, ) -> Result<McAcPfSolution, Error>

Record per terminal active powers, watts.

Errors

A column whose length disagrees with the resolved terminals.

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

Per source terminal active injections, watts, in source table order with each source’s terminal map order.

Trait Implementations

impl Clone for McAcPfSolution

fn clone(&self) -> McAcPfSolution

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for McAcPfSolution

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

Formats the value using the given formatter.

impl From<McAcPfSolution> for PioValue

fn from(value: McAcPfSolution) -> Self

Converts to this type from the input type.