Struct CurrentFunctional 

pub struct CurrentFunctional {
    pub at: usize,
    pub coefficients: Vec<(usize, Complex<f64>)>,
}

A terminal current as a sparse linear functional of the complex bus voltages, plus the bus whose voltage turns it into a power.

Fields

at: usize

The bus whose voltage forms the power S = V_at · conj(I).

coefficients: Vec<(usize, Complex<f64>)>

I = Σ c_k·V_k, as (bus, c).

Duplicate buses are allowed and sum, which is what makes gridoxide’s half-open branch — represented as a self-loop, so from == to — come out right, and what lets a node injection concatenate its Y-bus row with its source and shunt terms instead of merging them.

Implementations

impl CurrentFunctional

pub fn current(&self, v: &[Complex<f64>]) -> Complex<f64>

I = Σ c_k·V_k.

pub fn power(&self, v: &[Complex<f64>]) -> Complex<f64>

S = V_at · conj(I), i.e. (P, Q) as one complex number.

pub fn power_partials(&self, v: &[Complex<f64>], out: &mut Vec<Partial>)

Partials of S with respect to every bus it depends on, appended to out in coefficient order.

∂S/∂θ_k    = −j·V_at·conj(c_k·V_k)      + [k = at]·j·S
∂S/∂|V_k|  =    V_at·conj(c_k·e^{jθ_k}) + [k = at]·S/|V_at|

Every coefficient produces an entry, including one whose value is numerically zero. H’s sparsity pattern has to depend on the topology alone and not on the state — dropping a zero would shrink the row at a flat start, where many sin(θ_i − θ_k) vanish exactly, and grow it again next iteration, invalidating the cached symbolic factorization.

An empty functional produces nothing at all rather than a lone at entry. Its quantity is identically zero with no dependence on anything, and a row of structural zeros would defeat mask_untouched, which is what pins a genuinely disconnected bus.

pub fn local_current(&self, v: &[Complex<f64>]) -> Complex<f64>

I_local = S/|V_at| — see local_current_partials_of.

pub fn current_partials(&self, v: &[Complex<f64>], out: &mut Vec<Partial>)

pub fn local_current_partials(&self, v: &[Complex<f64>], out: &mut Vec<Partial>)

Trait Implementations

impl Clone for CurrentFunctional

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 CurrentFunctional

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

Formats the value using the given formatter.

impl PartialEq for CurrentFunctional

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for CurrentFunctional