Enum IslandStatus 

pub enum IslandStatus {
    Converged,
    MaxIterationsReached,
    Singular,
    NoReferenceBus,
    AmbiguousReferenceBus,
}

Per-connected-component outcome of a multi-island power-flow solve (see network::connected_components/classify) — one shared Newton-Raphson call across every solvable component’s unknowns at once (the Y-bus has no coupling between disconnected components, so this is mathematically equivalent, iteration for iteration, to solving each independently), with per-component status recovered afterward rather than tracked live.

Variants

Converged

This component’s own mismatch is below tol in the final buses state, regardless of the overall multi-component solve’s status.

MaxIterationsReached

The overall solve ran out of iterations, and this component’s own mismatch is still above tol.

Singular

The overall solve hit a singular Jacobian, and this component’s own mismatch is still above tol. Best-effort, not precise: every backend solves one combined sparse factorization and detects singularity via a finiteness check on the result vector (see sparse.rs), not a specific failing pivot/row — there is no way to attribute a singular failure to one particular component in general, so every still-unconverged component is marked Singular when the overall result is Singular, whether or not it was the actual cause.

NoReferenceBus

This component had no Slack bus at all — every member bus was pinned to a fixed V = 0, P = Q = 0 placeholder (network::mark_unreferenced_islands) instead of being solved; its bus values are not a power-flow result, just the marker value. There is no principled way to fabricate a reference bus for a genuinely sourceless island, so this is never attempted.

AmbiguousReferenceBus

This component had more than one Slack bus. Left in the shared solve unmodified (its non-slack buses are still live unknowns): two independently-fixed slack voltages in one connected component is physically over-determined, not necessarily numerically singular, so Newton-Raphson can converge to a result that satisfies neither slack’s true power balance. This verdict is decided once, before the solve, and is never overwritten by a numerically-convergent-looking post-hoc mismatch check.

Trait Implementations

impl Clone for IslandStatus

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for IslandStatus

impl Debug for IslandStatus

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

Formats the value using the given formatter.

impl Eq for IslandStatus

impl PartialEq for IslandStatus

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for IslandStatus