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:
objectNative calibrated numerical rate and explicit fractional/year conversion.
mechanismsholds 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:
objectEquation 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:
- 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: