energy_methods.degradation#

Climate-driven PV degradation: thesis Eqs. 3.14-3.17 and Section 6.4.

Calibration is mandatory and module-specific. Rates use the numerical percent per year convention of the 2019 mapping paper, not fractional loss per year. These are climate degradation indicators, not observed performance loss rates.

class energy_methods.degradation.DegradationParameters(*, a_h, a_p, a_tm, e_h, e_p, e_tm, n, x, theta, a_n, calibration_id, calibration_source)[source]#

Bases: object

One calibration, including its numerical normalization and provenance.

Activation energies are in eV; n, x and theta are positive exponents. Prefactors and a_n must be fitted together using RH in percent, UV dose in kWh/m²/year, temperatures in kelvin, cycles/year, and rates in %/year. No generic c-Si calibration or normalization is silently substituted.

Parameters:
  • a_h (float)

  • a_p (float)

  • a_tm (float)

  • e_h (float)

  • e_p (float)

  • e_tm (float)

  • n (float)

  • x (float)

  • theta (float)

  • a_n (float)

  • calibration_id (str)

  • calibration_source (str)

a_h: float#
a_p: float#
a_tm: float#
e_h: float#
e_p: float#
e_tm: float#
n: float#
x: float#
theta: float#
a_n: float#
calibration_id: str#
calibration_source: str#
to_dict()[source]#

Return a portable, JSON-serializable calibration record.

Return type:

dict[str, object]

class energy_methods.degradation.DegradationRates(hydrolysis, photodegradation, thermomechanical, total)[source]#

Bases: object

Nonnegative mechanism and combined rates, all in %/year; NaN is missing.

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

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

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

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

hydrolysis: ndarray[tuple[Any, ...], dtype[float64]]#
photodegradation: ndarray[tuple[Any, ...], dtype[float64]]#
thermomechanical: ndarray[tuple[Any, ...], dtype[float64]]#
total: ndarray[tuple[Any, ...], dtype[float64]]#
energy_methods.degradation.degradation_rates(*, module_temperature_mean_c, module_temperature_upper_c, module_temperature_lower_c, relative_humidity_percent, uv_dose_kwh_m2, cycles_per_year, parameters)[source]#

Evaluate the 2019 mapping model in numerical %/year.

Inputs are annual stresses: temperatures in degrees C, RH in percent, UV dose in kWh/m²/year and cycles/year. No offset is applied to the thermal temperature difference. Missing values propagate jointly; invalid values and negative totals fail. The 2021 paper’s printed variant is exposed in degradation_uncertainty.combined_rate_2021 instead.

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)

Return type:

DegradationRates