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]