{
  "format_version": 1,
  "created_at": "2026-10-29T09:59:52.897603+00:00",
  "description": "Real ERA5-derived annual stresses, 2016-2018; explicit mono-Si scenario",
  "scope": "Published coefficients with explicit aggregation/cycling assumptions; screening scenario, not site-specific prediction or original thesis reproduction",
  "study": {
    "name": "Global degradation screening, 2016-2018 (15-degree sample grid)",
    "start_year": 2016,
    "end_year": 2018,
    "latitude_min": -60.0,
    "latitude_max": 75.0,
    "longitude_min": -172.5,
    "longitude_max": 172.5,
    "step_degrees": 15.0,
    "cycles_per_day": 1.0,
    "aggregation": "mean_stress",
    "u0": 26.9,
    "u1": 6.2,
    "module_height_m": 2.0
  },
  "stress_metadata": {
    "stress_convention": "UTC hourly interval means; annual mean module temperature and ambient RH; upper/lower are annual means of daily maxima/minima; integrated 280-400 nm UV; explicit cycles/year. Repository aggregation, not an exact published raster reproduction.",
    "source": "Open-Meteo ERA5; normalized endpoint means; GHI-Faiman; Wald 280-400 nm UV",
    "reference_ids": "ascencio_vasquez_2021_thesis ascencio_vasquez_2019_degradation_mapping kaaya_2019_degradation",
    "weather_processing": "{\"u0\": 26.9, \"u1\": 6.2, \"module_height_m\": 2.0, \"cycles_per_day\": 1.0, \"negative_toa_policy\": \"unavailable; raw values retained; no zero clipping\"}"
  },
  "result_metadata": {
    "method": "Kaaya climate degradation; thesis Eqs. 3.14-3.17 and Section 6.4",
    "reference_ids": "ascencio_vasquez_2021_thesis ascencio_vasquez_2019_degradation_mapping kaaya_2019_degradation kaaya_2020_thesis faiman_2008_temperature wald_2018_spectral huld_amillo_2015_performance hersbach_2020_era5 era5_single_levels open_meteo_historical_weather open_meteo_variable_definitions harris_2020_cru_ts cru_ts_410",
    "baseline_start_year": 2016,
    "baseline_end_year": 2018,
    "aggregation": "mean_stress",
    "coverage_policy": "all stresses in every year",
    "stress_convention": "UTC hourly interval means; annual mean module temperature and ambient RH; upper/lower are annual means of daily maxima/minima; integrated 280-400 nm UV; explicit cycles/year. Repository aggregation, not an exact published raster reproduction.",
    "source": "Open-Meteo ERA5; normalized endpoint means; GHI-Faiman; Wald 280-400 nm UV",
    "calibration": "{\"a_h\": 49100000.0, \"a_n\": 1.0, \"a_p\": 71.83, \"a_tm\": 2.04, \"calibration_id\": \"kaaya-2019-mono-si-explicit-study-scenario\", \"calibration_source\": \"Kaaya et al. 2019, Table IV, DOI 10.1109/JPHOTOV.2019.2916197. A_N=1, arithmetic ambient RH, mean daily extrema and one cycle/day are explicit study assumptions; this is not a new field calibration or exact reproduction of the thesis maps. Independently checked against Kaaya (2020), doctoral thesis Table 4.3, p.45: https://www.uma.es/media/tinyimages/file/Ismail__Thesis2.pdf.\", \"e_h\": 0.74, \"e_p\": 0.45, \"e_tm\": 0.43, \"n\": 1.9, \"theta\": 2.24, \"x\": 0.63}",
    "scope": "Module-specific climate indicators; excludes LID, LeTID, PID, soiling and snow losses",
    "study_name": "Global degradation screening, 2016-2018 (15-degree sample grid)",
    "grid_step_degrees": 15.0,
    "spatial_interpretation": "nearest ERA5 sample at each CRU-supported centre; not area-averaged climate"
  },
  "variable_units": {
    "module_temperature_mean_c": "degC",
    "module_temperature_upper_c": "degC",
    "module_temperature_lower_c": "degC",
    "relative_humidity_percent": "%",
    "uv_dose_kwh_m2": "kWh m-2 year-1",
    "cycles_per_year": "year-1",
    "valid_hour_count": "hours",
    "positive_ghi_zero_toa_hours": "hours",
    "negative_toa_hours": "hours"
  },
  "land_cells": 71,
  "valid_cells": 63,
  "masked_incomplete_cells": 8,
  "hours_retrieved": 1867584,
  "source_software": {
    "python": "3.12.14",
    "energy-analysis": "0.1.0",
    "energy-methods": "0.1.0",
    "energy-data-retrieval": "0.1.0",
    "numpy": "2.3.5",
    "pandas": "2.3.3",
    "xarray": "2026.9.0",
    "matplotlib": "3.11.2",
    "scipy": "1.18.1",
    "pyarrow": "24.0.0"
  },
  "references": [
    {
      "id": "ascencio_vasquez_2021_thesis",
      "title": "Modelling and worldwide assessment of performance and aging of photovoltaic modules and systems",
      "authors": [
        "Ascencio Vásquez, Julián Andrés"
      ],
      "year": 2021,
      "doi": null,
      "url": "https://www.dlib.si/details/URN:NBN:SI:DOC-TMG3QFI9",
      "kind": "thesis",
      "role": "primary",
      "used_by": [
        "README.md",
        "methods/README.md",
        "analysis/README.md",
        "methods/src/energy_methods/degradation.py",
        "docs/degradation.md",
        "methods/src/energy_methods/ccya.py",
        "docs/ccya.md",
        "analysis/examples/ccya/README.md",
        "analysis/src/energy_analysis/ccya_case/pipeline.py"
      ],
      "note": "Primary scientific reference for this repository. University of Ljubljana catalogue: COBISS 77808131; national-library URN:NBN:SI:DOC-TMG3QFI9. Defended 21 September 2021. Marko Topič is the advisor, not a coauthor. No thesis DOI has been verified. Citation does not claim that every thesis chapter is implemented. CCYA implementation follows sections 7.5.1–7.5.3 (pp. 150–164), with equations 3.6/3.8 for thermal context. The institutional full text is https://repozitorij.uni-lj.si/Dokument.php?id=148326&lang=eng. Explicit choices for monthly centroid scaling, incremental temperature normalization, nonexceedance quantiles and cumulative ratio versus signed gain are documented in docs/ccya.md; no numerical reproduction of Bolzano is claimed.",
      "publication": "",
      "volume": "",
      "issue": "",
      "pages": "",
      "institution": "University of Ljubljana, Faculty of Electrical Engineering",
      "verified_at": "2026-10-29"
    },
    {
      "id": "hersbach_2020_era5",
      "title": "The ERA5 global reanalysis",
      "authors": [
        "Hersbach, Hans",
        "Bell, Bill",
        "Berrisford, Paul",
        "Hirahara, Shoji",
        "Horányi, András",
        "Muñoz‐Sabater, Joaquín",
        "Nicolas, Julien",
        "Peubey, Carole",
        "Radu, Raluca",
        "Schepers, Dinand",
        "Simmons, Adrian",
        "Soci, Cornel",
        "Abdalla, Saleh",
        "Abellan, Xavier",
        "Balsamo, Gianpaolo",
        "Bechtold, Peter",
        "Biavati, Gionata",
        "Bidlot, Jean",
        "Bonavita, Massimo",
        "De Chiara, Giovanna",
        "Dahlgren, Per",
        "Dee, Dick",
        "Diamantakis, Michail",
        "Dragani, Rossana",
        "Flemming, Johannes",
        "Forbes, Richard",
        "Fuentes, Manuel",
        "Geer, Alan",
        "Haimberger, Leo",
        "Healy, Sean",
        "Hogan, Robin J.",
        "Hólm, Elías",
        "Janisková, Marta",
        "Keeley, Sarah",
        "Laloyaux, Patrick",
        "Lopez, Philippe",
        "Lupu, Cristina",
        "Radnoti, Gabor",
        "de Rosnay, Patricia",
        "Rozum, Iryna",
        "Vamborg, Freja",
        "Villaume, Sebastien",
        "Thépaut, Jean‐Noël"
      ],
      "year": 2020,
      "doi": "10.1002/qj.3803",
      "url": "https://doi.org/10.1002/qj.3803",
      "kind": "article",
      "role": "data",
      "used_by": [
        "data-retrieval/src/energy_data_retrieval/sources/open_meteo",
        "data-retrieval/src/energy_data_retrieval/sources/earthmover_era5",
        "data-retrieval/src/energy_data_retrieval/grid_discovery.py",
        "docs/location-discovery.md"
      ],
      "note": "Scientific description of ERA5 reanalysis. Reanalysis is modelled weather and cannot be relabelled as a measured station. Cite the actual dataset and acquisition wrapper separately.",
      "publication": "Quarterly Journal of the Royal Meteorological Society",
      "volume": "146",
      "issue": "730",
      "pages": "1999-2049",
      "institution": "",
      "verified_at": "2026-10-29"
    },
    {
      "id": "era5_single_levels",
      "title": "ERA5 hourly data on single levels from 1940 to present",
      "authors": [
        "Copernicus Climate Change Service (C3S) Climate Data Store (CDS)"
      ],
      "year": 2023,
      "doi": "10.24381/cds.adbb2d47",
      "url": "https://cds.climate.copernicus.eu/datasets/reanalysis-era5-single-levels",
      "kind": "data",
      "role": "data",
      "used_by": [
        "data-retrieval/src/energy_data_retrieval/sources/open_meteo",
        "data-retrieval/src/energy_data_retrieval/sources/earthmover_era5",
        "data-retrieval/src/energy_data_retrieval/grid_discovery.py",
        "docs/location-discovery.md"
      ],
      "note": "Single-level dataset citation as recommended by the Earthmover source catalogue. Record the actual retrieval date and selected data vintage; do not use the metadata-verification date as a data-access date.",
      "publication": "",
      "volume": "",
      "issue": "",
      "pages": "",
      "institution": "",
      "verified_at": "2026-10-29"
    },
    {
      "id": "open_meteo_historical_weather",
      "title": "Historical Weather API",
      "authors": [
        "Open-Meteo"
      ],
      "year": null,
      "doi": null,
      "url": "https://open-meteo.com/en/docs/historical-weather-api",
      "kind": "manual",
      "role": "data",
      "used_by": [
        "data-retrieval/src/energy_data_retrieval/sources/open_meteo",
        "data-retrieval/src/energy_data_retrieval/grid_discovery.py",
        "docs/location-discovery.md"
      ],
      "note": "Optional ERA5 weather wrapper. Cite the underlying ERA5 dataset/paper and retain the explicitly requested product, grid cell and interval semantics; this is not measured irradiance.",
      "publication": "",
      "volume": "",
      "issue": "",
      "pages": "",
      "institution": "",
      "verified_at": "2026-10-29"
    },
    {
      "id": "open_meteo_variable_definitions",
      "title": "Weather Forecast API: hourly variable definitions",
      "authors": [
        "Open-Meteo"
      ],
      "year": null,
      "doi": null,
      "url": "https://open-meteo.com/en/docs",
      "kind": "manual",
      "role": "data",
      "used_by": [
        "data-retrieval/src/energy_data_retrieval/sources/open_meteo",
        "data-retrieval/README.md",
        "data-retrieval/src/energy_data_retrieval/grid_discovery.py",
        "docs/location-discovery.md"
      ],
      "note": "Provider definitions for preceding-hour radiation/gust variables and instantaneous temperature/wind. Archive-specific variable definitions take priority where products differ.",
      "publication": "",
      "volume": "",
      "issue": "",
      "pages": "",
      "institution": "",
      "verified_at": "2026-10-29"
    },
    {
      "id": "harris_2020_cru_ts",
      "title": "Version 4 of the CRU TS monthly high-resolution gridded multivariate climate dataset",
      "authors": [
        "Harris, Ian",
        "Osborn, Timothy J.",
        "Jones, Phil",
        "Lister, David"
      ],
      "year": 2020,
      "doi": "10.1038/s41597-020-0453-3",
      "url": "https://doi.org/10.1038/s41597-020-0453-3",
      "kind": "article",
      "role": "data",
      "used_by": [
        "data-retrieval/src/energy_data_retrieval/sources/cru_ts/client.py",
        "docs/kgpv.md"
      ],
      "note": "Method reference requested by the CRU TS provider. Data version is cited separately; use of this adapter does not imply that any particular analysis consumed CRU data.",
      "publication": "Scientific Data",
      "volume": "7",
      "issue": "",
      "pages": "109",
      "institution": "",
      "verified_at": "2026-10-29"
    },
    {
      "id": "cru_ts_410",
      "title": "CRU-TS Version 4.10",
      "authors": [
        "Climatic Research Unit, University of East Anglia"
      ],
      "year": 2026,
      "doi": null,
      "url": "https://crudata.uea.ac.uk/cru/data/hrg/cru_ts_4.10/",
      "kind": "dataset",
      "role": "data",
      "used_by": [
        "data-retrieval/src/energy_data_retrieval/sources/cru_ts/client.py",
        "docs/kgpv.md"
      ],
      "note": "Pinned release cruts.2604091129.v4.10, monthly 1901-2025 at 0.5 degrees over land excluding Antarctica. No version DOI was provided on the verified release page. Provider asks users to prefer CEDA and use UEA if CEDA is unavailable or the release has not yet been published there. ODbL with Database Contents License, attribution and share-alike. TMP is monthly mean temperature; PRE is monthly total; PET remains mm/day.",
      "publication": "",
      "volume": "",
      "issue": "",
      "pages": "",
      "institution": "",
      "verified_at": "2026-10-29"
    },
    {
      "id": "ascencio_vasquez_2019_degradation_mapping",
      "title": "Global Climate Data Processing and Mapping of Degradation Mechanisms and Degradation Rates of PV Modules",
      "authors": [
        "Ascencio-Vásquez, Julián",
        "Kaaya, Ismail",
        "Brecl, Kristijan",
        "Weiss, Karl-Anders",
        "Topič, Marko"
      ],
      "year": 2019,
      "doi": "10.3390/en12244749",
      "url": "https://www.mdpi.com/1996-1073/12/24/4749",
      "kind": "article",
      "role": "implemented",
      "used_by": [
        "methods/src/energy_methods/degradation.py",
        "methods/src/energy_methods/degradation_mapping.py",
        "docs/degradation.md"
      ],
      "note": "Source of climate-driven mechanism mapping and 0.2 percent/year categories, also presented in thesis Section 6.4. This implementation requires explicit module calibration and stress conventions. Mean daily extrema and arithmetic ambient humidity in the optional hourly processor are declared adaptations; the published global rasters and their calibration are not claimed reproduced.",
      "publication": "Energies",
      "volume": "12",
      "issue": "24",
      "pages": "4749",
      "institution": "",
      "verified_at": "2026-10-29"
    },
    {
      "id": "kaaya_2019_degradation",
      "title": "Modeling Outdoor Service Lifetime Prediction of PV Modules: Effects of Combined Climatic Stressors on PV Module Power Degradation",
      "authors": [
        "Kaaya, Ismail",
        "Koehl, Michael",
        "Mehilli, Amantin Panos",
        "de Cardona Mariano, Sidrach",
        "Weiss, Karl Anders"
      ],
      "year": 2019,
      "doi": "10.1109/JPHOTOV.2019.2916197",
      "url": "https://doi.org/10.1109/JPHOTOV.2019.2916197",
      "kind": "article",
      "role": "implemented",
      "used_by": [
        "methods/src/energy_methods/degradation.py",
        "methods/src/energy_methods/degradation_mapping.py",
        "docs/degradation.md"
      ],
      "note": "Original hydrolysis, photodegradation, thermomechanical and multiplicative combined-rate equations (3)-(7), reproduced in thesis equations 3.14-3.17. Publication Boltzmann constant and normalization placement retained. Calibration and climatic aggregation must be supplied explicitly; no universal module coefficients, power-loss trajectory or service-lifetime predictor are implied.",
      "publication": "IEEE Journal of Photovoltaics",
      "volume": "9",
      "issue": "4",
      "pages": "1105-1112",
      "institution": "",
      "verified_at": "2026-10-29"
    },
    {
      "id": "faiman_2008_temperature",
      "title": "Assessing the outdoor operating temperature of photovoltaic modules",
      "authors": [
        "Faiman, David"
      ],
      "year": 2008,
      "doi": "10.1002/pip.813",
      "url": "https://doi.org/10.1002/pip.813",
      "kind": "article",
      "role": "implemented",
      "used_by": [
        "methods/src/energy_methods/degradation_weather.py"
      ],
      "note": "Faiman heat-loss temperature model. This implementation follows the 2019 global mapping paper's GHI approximation; it is not a plane-of-array irradiance model.",
      "publication": "Progress in Photovoltaics: Research and Applications",
      "volume": "16",
      "issue": "4",
      "pages": "307-315",
      "institution": "",
      "verified_at": "2026-10-29"
    },
    {
      "id": "huld_amillo_2015_performance",
      "title": "Estimating PV Module Performance over Large Geographical Regions: The Role of Irradiance, Air Temperature, Wind Speed and Solar Spectrum",
      "authors": [
        "Huld, Thomas",
        "Gracia Amillo, Ana M."
      ],
      "year": 2015,
      "doi": "10.3390/en8065159",
      "url": "https://doi.org/10.3390/en8065159",
      "kind": "article",
      "role": "implemented",
      "used_by": [
        "methods/src/energy_methods/degradation_weather.py"
      ],
      "note": "Source cited by the 2019 mapping study for open-rack crystalline-silicon Faiman coefficients u0=26.9 and u1=6.2 and wind-height scaling exponent 0.2.",
      "publication": "Energies",
      "volume": "8",
      "issue": "6",
      "pages": "5159-5181",
      "institution": "",
      "verified_at": "2026-10-29"
    },
    {
      "id": "wald_2018_spectral",
      "title": "A simple algorithm for the computation of the spectral distribution of the solar irradiance at surface",
      "authors": [
        "Wald, Lucien"
      ],
      "year": 2018,
      "doi": null,
      "url": "https://hal.science/hal-01693473",
      "kind": "report",
      "role": "implemented",
      "used_by": [
        "methods/src/energy_methods/degradation_weather.py"
      ],
      "note": "UVA/UVB clearness-index regressions, as reproduced in the 2019 degradation mapping paper equations 5–8. The implementation clamps kt to 0.1–0.7 and documents missing/zero-TOA handling.",
      "publication": "",
      "volume": "",
      "issue": "",
      "pages": "",
      "institution": "MINES ParisTech",
      "verified_at": "2026-10-29"
    },
    {
      "id": "kaaya_2020_thesis",
      "title": "Photovoltaic Lifetime Forecast: Models for long-term photovoltaic degradation prediction and forecast",
      "authors": [
        "Kaaya, Ismail"
      ],
      "year": 2020,
      "doi": null,
      "url": "https://www.uma.es/media/tinyimages/file/Ismail__Thesis2.pdf",
      "kind": "thesis",
      "role": "implemented",
      "used_by": [
        "analysis/src/energy_analysis/degradation/pipeline.py",
        "analysis/examples/degradation/kaaya_2019_scenario.json"
      ],
      "note": "Author-accessible verification of the 2019 Kaaya model coefficients: Table 4.3, printed p.45 / PDF p.55. Gran Canaria mono-Si calibration: Ah=4.91e7, Eh=0.74, n=1.90; Ap=71.83, Ep=0.45, x=0.63; Atm=2.04, Etm=0.43, theta=2.24. A_N=1 and the applied analysis aggregation/cycling conventions are explicit study choices, not newly fitted coefficients.",
      "publication": "",
      "volume": "",
      "issue": "",
      "pages": "",
      "institution": "University of Málaga, School of Industrial Engineering",
      "verified_at": "2026-10-29"
    }
  ],
  "original_manifest_sha256": "617fa971c360e6338f9fcbbe8bbb28799d8fba268cb916542725d80b35d508e3",
  "retrieval_manifest_sha256": "98be61b518182874cb9c6e164221a00f9e502ab6a7fbb6d76825c51664f5e69e",
  "original_output_sha256": {
    "annual_stresses.nc": "b9e7f70fac4351fd1cf7fcf5562b4baab2e10dfc64f1051ef389023ff937aeb4",
    "degradation.nc": "3ac8889ea1644324b8ff638e21f35edcef8816aa056b95d754d177157f576968",
    "parameters.json": "2603bd458601b66a14956b63c04251104483e526c68f6730f2ce57a5c8f400ab",
    "source_cells.csv": "522cce906e2bacc6625a45086897ba7cc9ac79a624eba84c2bb0a6443ade6fa2"
  },
  "files": {
    "degradation_stresses.csv": "f2ef29612aaff9c95036f059d0292ead42676cb62f0ab02e53d6230ac148586b",
    "degradation_reference.csv": "eba79f8aedbd3021a2249087926541dbd5f53ada352a7e8feffd586751bb1a2f",
    "degradation_parameters.json": "2603bd458601b66a14956b63c04251104483e526c68f6730f2ce57a5c8f400ab",
    "degradation_source_cells.csv": "522cce906e2bacc6625a45086897ba7cc9ac79a624eba84c2bb0a6443ade6fa2"
  },
  "boundaries_sha256": "15a7455a79e04066b79aac6e480c059c999bb94ad0a3df7c7c6c650bc6cae0a9",
  "attribution": {
    "weather": "Copernicus ERA5 via Open-Meteo, CC BY 4.0; modelled, not measured",
    "land_support": "CRU TS v4.10, Climatic Research Unit, UEA; ODbL-1.0 / DbCL",
    "outlines": "Natural Earth public-domain country outlines; visual context only"
  }
}
