Struct BusView 

pub struct BusView { /* private fields */ }

The mapping from nodes to electrical buses, plus what survived.

Implementations

impl BusView

pub fn n_buses(&self) -> usize

pub fn n_nodes(&self) -> usize

pub fn bus_of(&self, node: NodeIdx) -> BusIdx

The bus a node landed on.

pub fn nodes_of(&self, bus: BusIdx) -> &[NodeIdx]

The nodes that merged into a bus, ascending.

pub fn representative(&self, bus: BusIdx) -> NodeIdx

One node standing for the whole group, for a caller that must collapse per-node records into one per-bus record and has to pick whose.

Arbitrary but deterministic, and deliberately not documented as the lowest member — it is the union-find root, which depends on the order switches appear in NodeBreakerTopology::switches. Callers that need a stable, order-independent choice should use nodes_of(bus)[0] instead and accept that it may differ from this.

The distinction is not hypothetical. cgmes::merge_closed_switches clones this node’s Bus record — u_rated, bus_type — into the merged bus, and its own comment records that the root was chosen over the first-encountered index to make that extraction “provably behaviour-preserving rather than merely equivalent-looking”. Exposing the same choice here is what keeps rerouting through this layer bit-identical. The fields that matter do agree across a group in practice, since a conducting switch ties nodes at one nominal voltage — but “in practice” is not the same as “provably”.

pub fn retained(&self) -> &[RetainedSwitch]

pub fn bus_of_slice(&self) -> &[BusIdx]

The raw node -> bus map, for callers that need to remap a parallel array in one pass.

pub fn is_degenerate(&self, retained: &RetainedSwitch) -> bool

Whether a retained switch’s two endpoints landed on the same bus, so that its position cannot affect connectivity.

Happens when some other conducting path already ties the two ends — a bus-coupler in a ring, or a switch retained in parallel with a merged one. Worth knowing about rather than discovering as a singular constraint row later.

Trait Implementations

impl Clone for BusView

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 BusView

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

Formats the value using the given formatter.