Struct PowerNetwork 

pub struct PowerNetwork {
    pub buses: Vec<Bus>,
    pub branches: Vec<Branch>,
    pub generators: Vec<Generator>,
    pub base_mva: f64,
}

AC power network: buses, branches, and generators.

Holds the full topology and parameter data needed to run power flow, OPF, stability analysis, and other studies.

Example

let net = PowerNetwork::from_matpower("ieee14.m")?;
let result = net.solve_powerflow(&PowerFlowConfig::default())?;
println!("Losses: {:.2} MW", result.total_p_loss_mw);

Fields

buses: Vec<Bus>

All buses (indexed 0..n−1 internally; bus.id holds the external ID).

branches: Vec<Branch>

All branches (π-model: r, x, b/2 shunt, tap, shift).

generators: Vec<Generator>

All generators (slack, PV, and dispatchable reactive sources).

base_mva: f64

System MVA base used throughout for per-unit conversion.

Implementations

impl PowerNetwork

pub fn new(base_mva: f64) -> Self

Create an empty network with the given MVA base.

pub fn bus_count(&self) -> usize

Number of buses in the network.

pub fn branch_count(&self) -> usize

Number of branches (lines + transformers) in the network.

pub fn bus_index(&self, bus_id: usize) -> Result<usize>

Look up the internal 0-based index for a bus given its external ID.

Returns Err if the bus ID is not found.

pub fn slack_bus_index(&self) -> Result<usize>

Internal index of the slack bus.

Returns Err if no slack bus is defined (BusType::Slack).

pub fn admittance_matrix(&self) -> Result<CsMat<Complex64>>

Build and return the sparse nodal admittance (Y-bus) matrix.

Uses the π-model for every branch (including transformers with tap + shift).

pub fn total_load_mw(&self) -> f64

Total real power load across all buses [MW].

pub fn total_load_mvar(&self) -> f64

Total reactive power load across all buses [MVAr].

pub fn installed_capacity_mw(&self) -> f64

Sum of Pmax for all in-service generators [MW] (installed capacity).

pub fn total_generation_mw(&self) -> f64

Sum of current Pg setpoints for all in-service generators [MW].

pub fn reserve_margin(&self) -> f64

Reserve margin: (installed capacity − total load) / total load.

Returns f64::INFINITY if total load is zero.

pub fn n_pq_buses(&self) -> usize

Number of PQ buses (load buses).

pub fn n_pv_buses(&self) -> usize

Number of PV buses (generator/voltage-controlled buses).

pub fn net_injection(&self) -> (Vec<f64>, Vec<f64>)

Net scheduled real and reactive power injections at each bus [p.u.].

Returns (p_inj, q_inj) vectors of length bus_count(). Positive = injection into network (generation), negative = load.

pub fn from_matpower(path: &str) -> Result<Self>

Parse a MATPOWER .m file (Case Format v2).

Accepts any MATPOWER test case: case14, case30, case57, case118, etc.

pub fn from_ieee_cdf(path: &str) -> Result<Self>

Parse an IEEE Common Data Format (CDF) file.

pub fn from_pandapower(path: &str) -> Result<Self>

Parse a pandapower JSON file.

pub fn from_pandapower_str(content: &str) -> Result<Self>

Parse pandapower JSON from a string.

pub fn incidence_matrix(&self) -> Vec<Vec<f64>>

Bus-branch incidence matrix A of size (n_bus × n_branch).

A[i,k] = +1 if branch k leaves bus i (from-bus) = -1 if branch k enters bus i (to-bus) = 0 otherwise

Returns a dense matrix as Vec<Vec>.

pub fn is_connected(&self) -> bool

Returns true if the network graph is fully connected (ignoring branch status).

Uses a BFS from the first bus over all defined branches.

pub fn degree(&self, bus_id: usize) -> usize

Number of branches incident to bus_id (degree in the network graph).

Returns 0 if the bus ID is not found or has no branches.

pub fn neighbors(&self, bus_id: usize) -> Vec<usize>

External bus IDs of all buses directly connected to bus_id by a branch.

Returns an empty vector if the bus ID is not found or has no branches.

pub fn validate(&self) -> Result<()>

Validate network data consistency.

Checks:

• At least one bus exists.
• Exactly one slack bus is present.
• All branch from/to bus IDs refer to defined buses.

impl PowerNetwork

pub fn solve_powerflow( &self, config: &PowerFlowConfig, ) -> Result<PowerFlowResult>

Trait Implementations

impl Clone for PowerNetwork

fn clone(&self) -> PowerNetwork

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PowerNetwork

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PowerNetwork

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for PowerNetwork

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl ToDigitalTwin for PowerNetwork

fn to_digital_twin(&self, model_id: &str) -> DigitalTwinModel