Struct PerPhase 

pub struct PerPhase<T> {
    pub l1: T,
    pub l2: T,
    pub l3: T,
}

A value measured or commanded per outer conductor.

The unbalance rule of VDE-AR-N 4100 is stated per phase, so anything that has to satisfy it — a single-phase wallbox, a heating rod, the site as a whole — carries its numbers in here rather than as a scalar.

Fields

l1: T

Value on L1.

l2: T

Value on L2.

l3: T

Value on L3.

Implementations

impl<T: Copy> PerPhase<T>

pub const fn splat(value: T) -> Self

The same value on all three phases.

pub const fn get(&self, phase: Phase) -> T

The value on one phase.

pub const fn set(&mut self, phase: Phase, value: T)

Replace the value on one phase.

pub const fn as_array(&self) -> [T; 3]

The three values, L1 first.

pub fn map<U: Copy>(&self, f: impl FnMut(T) -> U) -> PerPhase<U>

Apply f to every phase.

pub fn zip_with<U: Copy, V: Copy>( &self, other: &PerPhase<U>, f: impl FnMut(T, U) -> V, ) -> PerPhase<V>

Combine two per-phase values elementwise.

pub fn iter(&self) -> impl Iterator<Item = (Phase, T)> + '_

Iterate over (phase, value) pairs.

impl PerPhase<Power>

pub const ZERO: Self

All three phases at zero.

pub fn total(&self) -> Power

The total across the three phases.

pub fn unbalance(&self) -> ApparentPower

The Unsymmetrieleistung: the largest difference between any two outer conductors, expressed as apparent power.

VDE-AR-N 4100 Abschnitt 5.5.2 caps it at 4,6 kVA for a customer installation — the figure metering::power_quality::UNSYMMETRIE_LIMIT_KVA carries with its derivation, and the same limit as the 20 A per Außenleiter the VDE FNN Hinweis states it as.

Which devices count. The requirement reaches only equipment that can feed in or store — generation, storage, charge points — so the caller sums those and not the household’s own load. See Asset::symmetry_relevant.

kVA, not kW. The limit is apparent power, and an inverter at cos φ < 1 — which VDE-AR-N 4105 requires it to be capable of — moves more kVA than kW. This is computed from active power because that is what a household driver reports, so it understates the unbalance exactly when the grid has asked for reactive support. A meter that reports apparent power per conductor should be used as it stands.

Trait Implementations

impl Add for PerPhase<Power>

type Output = PerPhase<Power>

The resulting type after applying the + operator.

fn add(self, rhs: Self) -> Self

Performs the + operation.

impl<T: Clone> Clone for PerPhase<T>

fn clone(&self) -> PerPhase<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Copy> Copy for PerPhase<T>

impl<T: Debug> Debug for PerPhase<T>

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

Formats the value using the given formatter.

impl<T: Default> Default for PerPhase<T>

fn default() -> PerPhase<T>

Returns the “default value” for a type.

impl<'de, T> Deserialize<'de> for PerPhase<T>

where T: Deserialize<'de>,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T: PartialEq> PartialEq for PerPhase<T>

fn eq(&self, other: &PerPhase<T>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<T> Serialize for PerPhase<T>

where T: Serialize,

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<T: PartialEq> StructuralPartialEq for PerPhase<T>

impl Sub for PerPhase<Power>

type Output = PerPhase<Power>

The resulting type after applying the - operator.

fn sub(self, rhs: Self) -> Self

Performs the - operation.

impl Sum for PerPhase<Power>

fn sum<I: Iterator<Item = Self>>(iter: I) -> Self

Takes an iterator and generates Self from the elements by “summing up” the items.