Struct AcOtsSolution 

pub struct AcOtsSolution { /* private fields */ }

The AC optimal transmission switching result: the final branch statuses, their switching cost, and the AC optimal power flow solution over that topology.

Implementations

impl AcOtsSolution

pub fn new( instance: Arc<AcOtsInstance>, branch_closed: Vec<bool>, ac_solution: AcOpfSolution, ) -> Result<Self, Error>

Attach the AC optimal power flow solution computed on instance.fix_topology(&branch_closed).

Errors

The topology fails AcOtsInstance::validate_topology, the AC solution answers a different problem than the fixed topology states (its network, objective, or constraint selections differ), or an open branch carries flow. A NaN flow on an open branch means no flow was recorded and is accepted; a NaN anywhere else is left to AcOpfSolution.

pub fn instance(&self) -> &AcOtsInstance

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

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

The shared instance owner.

pub fn network(&self) -> &BalancedNetwork

The instance’s network: every candidate branch at its initial status. The final statuses are branch_closed; the AC solution’s instance holds the network with them applied.

pub fn branch_closed(&self) -> &[bool]

The final branch statuses, in branch table order.

pub const fn ac_solution(&self) -> &AcOpfSolution

The AC optimal power flow solution over the final topology.

pub const fn switching_cost(&self) -> f64

The cost of the status changes against the initial topology.

pub fn branches_open(&self) -> usize

The number of branches open in the final topology.

pub fn branches_switched(&self) -> usize

The number of branches whose final status differs from the initial one.

pub fn objective(&self) -> f64

The objective value: the AC solution’s objective, plus the switching cost when the instance’s objective states the switching cost term.

pub fn termination(&self) -> &Termination

How the producing calculation ended, as the AC solution records it.

pub fn residuals(&self) -> &Residuals

The AC solution’s numerical residuals.

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

The producer or solver identity the AC solution records.

Trait Implementations

impl Clone for AcOtsSolution

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AcOtsSolution

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

Formats the value using the given formatter.