Source code for energy_methods.pvdeg_mechanisms

"""PVDeg mechanism screening from complete hourly module stress histories.

All outputs are scenario exposure or material-model metrics, not measured power
loss. In particular, broadband light-assisted exposure is not spectral UV damage.
"""

from __future__ import annotations

import numpy as np
import pandas as pd

REFERENCE_IDS = ("pvdeg_software",)


[docs] def relative_arrhenius_exposure( temperature_c: pd.Series, humidity_pct: pd.Series, irradiance_w_m2: pd.Series, *, humidity_exponent: float = 1.0, irradiance_exponent: float = 0.0, activation_energy_kj_mol: float = 60.0, ) -> float: """Hourly exposure relative to constant 25 C, 50% RH and 1000 W/m2. Requires aligned, finite hourly series. Exponents and activation energy are explicit screening assumptions; no calibrated degradation prefactor is used. A ratio of two means twice the model exposure, not twice the power loss. """ arrays = [temperature_c, humidity_pct, irradiance_w_m2] if any(not isinstance(x, pd.Series) for x in arrays): raise ValueError("Inputs must be pandas Series") index = temperature_c.index if ( not isinstance(index, pd.DatetimeIndex) or index.tz is None or len(index) < 2 or any(not x.index.equals(index) for x in arrays) or not (index.to_series().diff().iloc[1:] == pd.Timedelta(hours=1)).all() ): raise ValueError("Expected aligned timezone-aware hourly series") if not all(np.isfinite(x).all() for x in arrays): raise ValueError("Missing or infinite stress inputs are not supported") if ( (temperature_c <= -273.15).any() or not humidity_pct.between(0, 100).all() or (irradiance_w_m2 < 0).any() ): raise ValueError("Invalid Celsius, percent humidity or irradiance") params = [activation_energy_kj_mol, humidity_exponent, irradiance_exponent] if not np.isfinite(params).all() or not 0 < params[0] <= 200 or min(params[1:]) < 0: raise ValueError("Expected positive Ea <= 200 kJ/mol and nonnegative exponents") from pvdeg import degradation kwargs = {"Ea": params[0], "n": params[1], "p": params[2]} dose = degradation.arrhenius( temperature=temperature_c, RH=humidity_pct, irradiance=irradiance_w_m2, **kwargs ) reference = degradation.arrhenius( temperature=pd.Series([25.0]), RH=pd.Series([50.0]), irradiance=pd.Series([1000.0]), **kwargs, ) return float(dose / (len(index) * reference))