Skip to main content

Module load_voltage

Module load_voltage 

Source
Expand description

Voltage dependent load power: the one evaluation of a balanced load’s LoadVoltageModel at a bus voltage magnitude, with its derivative.

With x = vm / vn, the bus voltage magnitude against the load’s nominal voltage (both per unit on the bus base), a load draws

P(vm) = p - Σ c_k + Σ c_k x^γ_k        (and Q alike)

where p is the stated Load::p and each term c_k x^γ_k is a ZIP constant current part (γ = 1), a ZIP constant impedance part (γ = 2), or an exponential side (its γ, when not zero). The stated power stays authoritative for everything beyond the terms: the ZIP constant power part, an exponential γ = 0 side, or a demand edit written onto p.

Structs§

LoadPowerAtVoltage
A load’s power at a voltage magnitude, in its own unit, with the derivatives with respect to the magnitude.
LoadVoltageTerm
One voltage dependent part of a load: coefficient · (vm / v_nom)^exponent in the load’s power unit.

Enums§

LoadVoltageError
Why a load’s voltage model cannot be evaluated.

Constants§

LOAD_VOLTAGE_RATIO_FLOOR
The voltage ratio floor of the one power law term evaluation (powerio_core::electrical::calc_voltage_power_term). Below this voltage ratio a power law term with exponent below one is continued by its tangent at the floor (calc_voltage_power_term): x^γ has an unbounded slope at zero for γ < 1 (and is itself unbounded for γ < 0), and an iterate can pass near zero on its way to a solution.

Functions§

calc_load_nominal_voltage
A load’s nominal voltage in per unit on its bus base.