energy_methods.degradation_mapping#
Annual stress processing and geographic degradation maps with explicit assumptions.
- energy_methods.degradation_mapping.annual_stresses(weather, *, year, cycles_per_year)[source]#
Process ONE complete UTC calendar year of hourly regional weather.
Inputs: module_temperature_c [degC], relative_humidity_percent [%], and uv_irradiance_w_m2 [W m-2], each (time, lat, lon). Time labels are timezone-naive datetime64 UTC interval starts; dataset time_zone must be ‘UTC’. UV means 280-400 nm; native ERA5 UV to 440 nm is not interchangeable.
Arithmetic RH and mean daily extrema are explicit implementation choices; use prepared annual stresses when a calibration uses other conventions. Any missing hourly input masks the whole cell-year; valid_hour_count remains. No annualization of partial coverage, interpolation, or inferred cycle count. Call on spatial tiles rather than loading a global hourly year into memory.
- Parameters:
weather (Dataset)
year (int)
cycles_per_year (float)
- Return type:
Dataset
- energy_methods.degradation_mapping.degradation_classes(rate, *, region)[source]#
Thesis Section 6.4 bins: 0.2%/year, overflow above 1.4 globally or 0.8 in Europe.
Upper edges are inclusive, an explicit implementation convention. ID 0 is missing, ID 1 includes a true zero; no clipping of high degradation rates.
- Parameters:
rate (DataArray)
region (Literal['global', 'europe'])
- Return type:
DataArray
- energy_methods.degradation_mapping.map_degradation(stresses, parameters, *, aggregation, region='global')[source]#
Map consecutive annual (year, lat, lon) stresses on their exact grid.
mean_stress evaluates once on equal-year mean stresses (the mapping workflow). mean_rate evaluates each year, then averages rates (a different, explicit sensitivity scenario). Cells need every stress in every year. Input dataset must describe stress_convention; no implicit regridding or ocean filling.
- Parameters:
stresses (Dataset)
parameters (DegradationParameters)
aggregation (Literal['mean_stress', 'mean_rate'])
region (Literal['global', 'europe'])
- Return type:
Dataset
- energy_methods.degradation_mapping.kgpv_degradation_summary(rates, kgpv)[source]#
Area-weighted mechanism means per KGPV zone on exactly matching regular grids.
Only cells with all four rates and a known KGPV class contribute. KGPV may use a different climate baseline; its supplied metadata is recorded. Regrid class maps explicitly with nearest-neighbour before calling this function.
- Parameters:
rates (Dataset)
kgpv (DataArray)
- Return type:
Dataset