energy_methods.pv_stress_weather#
POA-based temperature, UV and humidity models, 2021 study Eqs. 7-17.
All arrays must be finite. Filter night and missing observations explicitly before calibration; these functions do not align timestamps or impute weather.
- energy_methods.pv_stress_weather.ross_temperature(ambient_temperature_c, poa_w_m2, *, coefficient)[source]#
Equation 7, module °C; coefficient in °C m²/W is explicit.
- Parameters:
ambient_temperature_c (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])
poa_w_m2 (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])
coefficient (float)
- Return type:
ndarray[tuple[Any, …], dtype[float64]]
- energy_methods.pv_stress_weather.faiman_temperature(ambient_temperature_c, poa_w_m2, wind_speed_ms, *, u0, u1)[source]#
Equation 8, module °C using POA and wind at the calibration’s height.
Reuse the existing algebra with unity wind-height scaling. No GHI-to-POA substitution, wind-height conversion or site-independent coefficient fit.
- Parameters:
ambient_temperature_c (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])
poa_w_m2 (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])
wind_speed_ms (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])
u0 (float)
u1 (float)
- Return type:
ndarray[tuple[Any, …], dtype[float64]]
- energy_methods.pv_stress_weather.linear_uv(poa_w_m2, *, slope, intercept=0)[source]#
Equation 9, UV W/m². Outputs outside [0, POA] fail rather than clip.
- Parameters:
poa_w_m2 (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])
slope (float)
intercept (float)
- Return type:
ndarray[tuple[Any, …], dtype[_ScalarT]]
- energy_methods.pv_stress_weather.wald_uv(poa_w_m2, clearness_index, *, a=7.21, b=2.365)[source]#
Equations 10-14, UV 280-400 nm in W/m²; kt clamped to [0.1, 0.7].
The default is original Wald. Modified coefficients use
a - b*kt; negative b in Table 9 is retained, not silently sign-corrected.- Parameters:
poa_w_m2 (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])
clearness_index (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])
a (float)
b (float)
- Return type:
ndarray[tuple[Any, …], dtype[_ScalarT]]
- energy_methods.pv_stress_weather.airmass_uv(poa_w_m2, air_mass, *, coefficients)[source]#
Equation 15: POA times a fourth-degree polynomial in air mass.
Five coefficients ordered m0..m4 are required. Air mass must be >=1; extrapolation producing a UV fraction outside [0,1] fails.
- Parameters:
poa_w_m2 (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])
air_mass (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])
coefficients (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])
- Return type:
ndarray[tuple[Any, …], dtype[_ScalarT]]
- energy_methods.pv_stress_weather.buck_vapour_pressure(temperature_c)[source]#
Equation 17 saturation vapour pressure, kPa, with ice/water branches.
Values 0.61115/0.61121 are kPa despite the nomenclature’s Pa label. The documented operating domain here is -80..60 °C; no extrapolation.
- Parameters:
temperature_c (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])
- Return type:
ndarray[tuple[Any, …], dtype[_ScalarT]]
- energy_methods.pv_stress_weather.buck_relative_humidity(ambient_temperature_c, dewpoint_c)[source]#
Equation 16, percent; reject dewpoint above ambient instead of clipping.
- Parameters:
ambient_temperature_c (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])
dewpoint_c (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])
- Return type:
ndarray[tuple[Any, …], dtype[_ScalarT]]
- energy_methods.pv_stress_weather.fit_temperature_model(ambient_temperature_c, poa_w_m2, measured_module_c, *, model, wind_speed_ms=None)[source]#
Least-squares coefficients on a declared calibration interval only.
Equal one-dimensional shapes, positive POA, and an identifiable design are required. Evaluate errors on another year; do not mix train and test records.
- Parameters:
ambient_temperature_c (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])
poa_w_m2 (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])
measured_module_c (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])
model (Literal['ross', 'faiman'])
wind_speed_ms (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str] | None)
- Return type:
dict[str, float]