pub fn calc_load_nominal_voltage(
v_nom: Option<f64>,
base_kv: f64,
) -> Result<f64, LoadVoltageError>Expand description
A load’s nominal voltage in per unit on its bus base.
No stated v_nom is the bus base voltage (1 per unit), the convention
every PowerIO reader writes. The balanced model does not state the unit of
a stated one, and sources use both, so it is read against the bus base
voltage base_kv: as kV giving v_nom / base_kv, or as per unit giving
v_nom. A reading is plausible in [0.5, 2] and usual in [0.8, 1.25].
When the two readings agree, or only one is plausible, or only one is
usual (v_nom = 0.69 on a 0.69 kV bus is 1 pu in kV, not 0.69 pu), that
reading is taken. When both are usual and differ (a 0.9 kV bus with
v_nom = 1), both are plausible and neither usual, or neither is
plausible, the nominal voltage is refused rather than guessed.
§Errors
A non-positive or non-finite v_nom, or one no reading makes plausible
or two readings make plausible differently.