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