Source code for x2power.utilities.units

"""Unit helpers. Gas conditions are explicit rather than inferred from a unit label."""

from x2power.utilities.validation import number


[docs] def mj_to_kwh(energy_mj: float) -> float: number("energy_mj", energy_mj) return energy_mj / 3.6
[docs] def normalize_gas_volume( actual_m3: float, temperature_c: float, pressure_pa: float, *, water_vapour_pressure_pa: float = 0.0, ) -> float: """Ideal-gas conversion to dry Nm³ at 0 °C and 101325 Pa. Supply ABSOLUTE pressure and the actual water-vapour partial pressure for wet gas. Compressibility differences are not modelled. """ number("actual_m3", actual_m3) number("temperature_c", temperature_c, minimum=-273.15, strict=True) number("pressure_pa", pressure_pa, strict=True) number("water_vapour_pressure_pa", water_vapour_pressure_pa) if water_vapour_pressure_pa >= pressure_pa: raise ValueError("Water-vapour pressure must be lower than total absolute pressure") return ( actual_m3 * (pressure_pa - water_vapour_pressure_pa) / 101325 * 273.15 / (temperature_c + 273.15) )