energy_methods.degradation_uncertainty#

Explicit physical-rate conventions for the 2021 PV uncertainty study.

The paper omits A_N and C_N for Table 5 and mixes rate/dose unit descriptions. No universal calibration or implicit conversion to a lifetime coefficient is provided. Every calibrated rate must declare its scale to fractional year^-1.

class energy_methods.degradation_uncertainty.PhysicalRate(raw_rate, annual_fractional_rate, rate_scale_to_year_inverse, mechanisms=())[source]#

Bases: object

Native calibrated numerical rate and explicit fractional/year conversion.

mechanisms holds raw hydrolysis, photo and thermal values when available. The multiplicative total is not a sum and its components are not shares.

Parameters:
  • raw_rate (ndarray[tuple[Any, ...], dtype[float64]])

  • annual_fractional_rate (ndarray[tuple[Any, ...], dtype[float64]])

  • rate_scale_to_year_inverse (float)

  • mechanisms (tuple[ndarray[tuple[Any, ...], dtype[float64]], ...])

raw_rate: ndarray[tuple[Any, ...], dtype[float64]]#
annual_fractional_rate: ndarray[tuple[Any, ...], dtype[float64]]#
rate_scale_to_year_inverse: float#
mechanisms: tuple[ndarray[tuple[Any, ...], dtype[float64]], ...]#
class energy_methods.degradation_uncertainty.StressRateParameters(*, beta0, beta1, beta2, beta3, beta4, rate_scale_to_year_inverse, calibration_source)[source]#

Bases: object

Equation 1 coefficients, including mandatory calibration and unit scale.

beta0 carries the calibration’s units. beta1 is activation energy in eV; beta2, beta3, beta4 are nonnegative powers of daily temperature range, daytime UV irradiance (W/m²) and daily RH (percent), respectively.

Parameters:
  • beta0 (float)

  • beta1 (float)

  • beta2 (float)

  • beta3 (float)

  • beta4 (float)

  • rate_scale_to_year_inverse (float)

  • calibration_source (str)

beta0: float#
beta1: float#
beta2: float#
beta3: float#
beta4: float#
rate_scale_to_year_inverse: float#
calibration_source: str#
energy_methods.degradation_uncertainty.stress_rate(*, daily_maximum_temperature_c, daily_temperature_range_c, daily_daytime_uv_w_m2, daily_relative_humidity_percent, parameters)[source]#

Equation 1 (Bala), evaluated on daily inputs, without hidden aggregation.

Annual integrated UV dose is NOT a substitute for daytime irradiance. Missing input masks the paired result; infinities and invalid finite values fail. The caller must declare any subsequent daily/annual aggregation.

Parameters:
  • daily_maximum_temperature_c (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])

  • daily_temperature_range_c (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])

  • daily_daytime_uv_w_m2 (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])

  • daily_relative_humidity_percent (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])

  • parameters (StressRateParameters)

Return type:

PhysicalRate

energy_methods.degradation_uncertainty.combined_rate_2021(*, module_temperature_mean_c, module_temperature_upper_c, module_temperature_lower_c, relative_humidity_percent, uv_dose_kwh_m2, cycles_per_year, parameters, rate_scale_to_year_inverse)[source]#

Equations 3-6, retaining the printed (273 + delta T)**theta term.

Reuses the mapping kernel’s input validation and Arrhenius equations, but does NOT change the existing 2019 mapping API. The 273 offset is a printed empirical expression, not a physical conversion of a temperature difference. Celsius-to-kelvin in Arrhenius terms uses 273.15. A_N, cycles/year and unit conversion are mandatory; Table 5 alone is not an executable calibration. A scale of 0.01 means native numerical %/year, 1 means fractional/year. Neither is inferred from the supplied parameters.

Parameters:
  • module_temperature_mean_c (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])

  • module_temperature_upper_c (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])

  • module_temperature_lower_c (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])

  • relative_humidity_percent (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])

  • uv_dose_kwh_m2 (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])

  • cycles_per_year (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])

  • parameters (DegradationParameters)

  • rate_scale_to_year_inverse (float)

Return type:

PhysicalRate