Enum AngleDifferenceBounds 

#[non_exhaustive]
pub enum AngleDifferenceBounds {
    PowerModelsPad,
    ShiftCenteredPad,
    Stated,
    None,
}

Which angle difference bounds an OPF or power flow preparation carries.

Every bound constrains theta_from - theta_to, the MATPOWER and PowerModels convention, which is not net of a branch’s phase shift.

The assembly options select one with with_angle_difference_bounds. Left unselected, their correct_angle_difference_bounds flag decides as it always has: true, the default, is Self::PowerModelsPad and false is Self::Stated.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

PowerModelsPad

PowerModels’ ±60 degree pad exactly as its correct_voltage_angle_differences! applies it (correct_angle_difference_bounds): a side the source leaves unconstrained or unusable (at or beyond ±90 degrees, the 0/0 spelling, or an inverted window) becomes ±60 degrees around zero, and a usable stated side is kept. A branch that shifts phase by more than 60 degrees cannot meet this window; select Self::ShiftCenteredPad or Self::Stated for such a case.

ShiftCenteredPad

The same pad centered on the branch’s phase shift, so a phase shifting branch keeps its operating point inside the window. An unshifted branch gets exactly Self::PowerModelsPad.

Stated

The bounds the source states (stated_angle_difference_bounds): an absent side becomes negative or positive infinity.

None

No angle difference bound: every interval is (−∞, +∞).

Implementations

impl AngleDifferenceBounds

pub const fn from_correct_flag(correct: bool) -> Self

The selection the legacy correct_angle_difference_bounds flag stands for: Self::PowerModelsPad when true, Self::Stated when false.

pub const fn is_padded(self) -> bool

Whether this selection pads unconstrained sides, which is what the preparations’ correct_angle_difference_bounds flag reports.

pub fn calc_bounds( self, angle_min: f64, angle_max: f64, shift: f64, ) -> (f64, f64)

The interval for one branch, in radians, from its stated angmin and angmax and the phase shift the preparation models.

Trait Implementations

impl Clone for AngleDifferenceBounds

fn clone(&self) -> AngleDifferenceBounds

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for AngleDifferenceBounds

impl Debug for AngleDifferenceBounds

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AngleDifferenceBounds

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for AngleDifferenceBounds

impl PartialEq for AngleDifferenceBounds

fn eq(&self, other: &AngleDifferenceBounds) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for AngleDifferenceBounds

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for AngleDifferenceBounds