Skip to main content

calc_load_nominal_voltage

Function calc_load_nominal_voltage 

Source
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.