Struct AcOtsInstance 

pub struct AcOtsInstance { /* private fields */ }

The AC optimal transmission switching instance: an AC optimal power flow base, whose network supplies the candidate branches and their initial statuses, plus the switching options.

The base objective is kept exactly; switching costs enter the objective only when it states ObjectiveTerm::BranchSwitchingCost (with_switching_objective).

Implementations

impl AcOtsInstance

pub fn new(base: AcOpfInstance, options: AcOtsOptions) -> Result<Self, Error>

Combine an AC optimal power flow base with explicit switching options. The base objective is kept exactly.

Errors

An option names an unknown branch or names one twice, states a negative or non-finite cost, a nonpositive or non-finite current limit, a switching budget above the switchable branch count, or an open budget below the number of fixed open branches.

pub fn from_ac_opf(base: AcOpfInstance) -> Result<Self, Error>

The default switching instance over an AC optimal power flow base: every initially in-service branch may switch, at zero cost, with no budget, no islands, and no current limits, and the objective gains the switching cost term.

Errors

As new.

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

The default switching instance over a network: the AC optimal power flow AcOpfInstance::from_network states, with the defaults of from_ac_opf.

Errors

As AcOpfInstance::from_network and new.

pub fn with_options(self, options: AcOtsOptions) -> Result<Self, Error>

Replace the switching options, keeping the base problem and its objective.

Errors

As new.

pub fn with_switching_objective(self) -> Self

Add the switching cost objective term, once.

pub const fn base(&self) -> &AcOpfInstance

The AC optimal power flow base: the network with its initial topology, the objective, the constraint selections, and the initial point.

pub fn network(&self) -> &BalancedNetwork

The network with every candidate branch at its initial status.

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 const fn options(&self) -> &AcOtsOptions

The switching options as stated.

pub fn branches(&self) -> &[AcOtsBranch]

Every physical branch in table order, with its resolved switching settings.

pub fn branch_order(&self) -> impl ExactSizeIterator<Item = &str>

The branch identities in table order.

pub fn initial_closed(&self) -> Vec<bool>

The initial branch statuses in table order.

pub fn validate_topology(&self, branch_closed: &[bool]) -> Result<f64, Error>

Check a complete final branch status vector, in branch table order, against the fixed branches, the budgets, and the islanding policy, and return its switching cost. This does not certify AC feasibility.

The initial topology’s own islands are not checked against the policy: a base network with several islands accepts its initial statuses.

Errors

A vector of the wrong length, a changed fixed branch, a budget exceeded, when islands are forbidden a final topology that splits an island of the initial topology, or a final topology that leaves buses supplied initially in an island with no in-service generator.

pub fn fix_topology( &self, branch_closed: &[bool], ) -> Result<(AcOpfInstance, Vec<Diagnostic>), Error>

The AC optimal power flow over a validated final topology. Every branch row stays in the network with its final status. When islands are allowed, each final island gets exactly one reference bus. The switching options, the current limits, and the switching cost term are not part of the derived problem, and each discard is reported. An initial point that states branch statuses describes the initial topology, so it is discarded too.

Errors

As validate_topology.

Trait Implementations

impl Clone for AcOtsInstance

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 AcOtsInstance

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

Formats the value using the given formatter.