[WIP] 0.8.0 changes to Scenario

.github/nbval_sanitization_rules.cfg

@@ -69,3 +69,11 @@ replace: SCIPY-OPTIMIZATION-WARNING
 [regex18]
 regex: ^\s*C = A / \(A \+ B\)
 replace:
+
+[regex19]
+regex: [Pp]vdeg version\s*:\s*.*
+replace: pvdeg version : X.X.X
+
+[regex20]
+regex: ^\s*Named results:\s*\[.*\]$
+replace:   Named results: [NBVAL-SANITIZED]

.github/workflows/nbval.yaml

@@ -27,6 +27,10 @@ jobs:
         "02_degradation/06_vant_hoff_degradation_model.ipynb:5"
         "03_monte_carlo/01_arrhenius.ipynb:180"
         "03_monte_carlo/02_standoff.ipynb:30"
+        "04_scenario/05_scenario_perovskite_sequential.ipynb:15"
+        "04_scenario/06_scenario_perovskite_ey.ipynb:50"
+        "04_scenario/07_scenario_module_stack.ipynb:20"
+        "04_scenario/08_scenario_backsheet_comparison.ipynb:30"
         "06_advanced/01_custom_functions_nopython.ipynb:30"
         "10_workshop_demos/01_astm_live_demo.ipynb:10"
     steps:

.gitignore

@@ -117,3 +117,9 @@ tests\data\h5_pytest.h5
 tests/TEMP_test_addModule_materials.py
 /tutorials_and_tools/tutorials_and_tools/pvd_job_temperature and degradation/pipeline_results
 /tutorials/04_scenario/pvd_job_temperature and degradation/pipeline_results
+/tutorials/04_scenario/pvd_job_temperature and degradation
+/pipeline_results
+/tutorials/04_scenario/pvd_job_two-material-demo/pipeline_results
+/tutorials/04_scenario/pvd_job_two-material-demo
+/tutorials/04_scenario/pvd_job_stack
+/tutorials/04_scenario/pvd_job_perov-module-stack

docs/source/whatsnew/releases/v0.7.2.rst

@@ -0,0 +1,40 @@
+v0.7.2 (2026-XX-XX)
+===================
+
+Enhancements
+------------
+
+
+Documentation
+-------------
+
+
+Notebooks
+---------
+- Make the ASTM live demo and custom-functions tutorial notebooks reproducible
+  offline by loading cached NSRDB TMY data (with ``USE_LIVE_*`` toggle for the
+  live API path), fixing ``nbval`` failures caused by stale stored outputs and
+  the PVGIS API being unreachable from CI. (:issue:`342`, :pull:`350`)
+
+
+Deprecations
+-------------
+
+
+Bug Fixes
+---------
+
+
+Dependencies
+------------
+- Move ``pre-commit`` from core install requirements to the optional development
+  extras (``dev = ["pre-commit"]``), reducing runtime dependency footprint.
+  (:issue:`341`, :pull:`347`)
+- Bump aiohttp from 3.13.3 to 3.14.1. (:pull:`344`)
+
+
+
+Contributors
+------------
+- Rajiv Daxini (:ghuser:`rdaxini`)
+

pvdeg/config.py

@@ -12,6 +12,8 @@
 # downloader target directory
 METOROLOGICAL_DOWNLOAD_PATH = Path.home() / "PVDeg-Meteorological"
 
+SCENARIO_OUTPUT_PATH = None
+
 # DATA_LIBRARY = PVDEG_DIR.parent / "DataLibrary"
 # if not os.path.isdir(DATA_LIBRARY):
 #     DATA_LIBRARY = os.path.join(sys.prefix, "DataLibrary")

pvdeg/data/AApermeation.json

@@ -10,5 +10,19 @@
 	"comment": "Extracted from Figure 10 of Weber et al. The activation energy does not exactly match that in the published work (35.0 kJ/mol). I did this because I wanted to include the prefactor.",
       "Ead": { "name": "Diffusivity Activation Energy", "units": "kJ/mol", "value": 39.1970399216688 },
       "Do": { "name": "Diffusivity Prefactor", "units": "cm²/s", "value": 0.190570685252167 }
+    },
+
+    "AA002": {
+	"name": "EVA-source-term",
+      "alias": "EVA-AA-generation",
+	"contributor": "Luca Gnocchi / Michael Kempe",
+	"source_generation": "Kempe, Michael D., et al. Acetic acid production and glass transition concerns with ethylene-vinyl acetate used in photovoltaic devices. Solar Energy Materials and Solar Cells 91.4 (2007): 315-329.",
+	"source_diffusion": "Kim, Namsu, and Changwoon Han. Experimental characterization and simulation of water vapor diffusion through various encapsulants used in PV modules. Solar Energy Materials and Solar Cells 116 (2013): 68-75.",
+	"source_validation": "Gnocchi, Luca, et al. Measuring and modelling the generation of acetic acid in aged ethylene-vinyl acetate-based encapsulants used in solar modules. EU PVSEC 2018.",
+	"comment": "Acetic acid (AA) generation source term and diffusion coefficient for FEM-type acetic acid production modeling in EVA. Source term at 27°C from Kempe 2007; diffusion coefficient at 50°C from Kim & Han 2013. Used in Gnocchi et al. Table I. Defines how fast AA is genearted inside the EVA encapsulant in PV modules. These parameters allow AA production calculation as a function of temperature, using an Arrhenius equation.",
+      "Ro": { "name": "Source Term Prefactor", "units": "ng/min/g", "value": 0.00331, "ref_temp_C": 27 },
+      "Ea_gen": { "name": "Generation Activation Energy", "units": "kJ/mol", "value": 90.0 },
+      "D_ref": { "name": "Diffusion Coefficient at Reference Temperature", "units": "m²/s", "value": 1e-11, "ref_temp_C": 50 },
+      "Ea_diff": { "name": "Diffusion Activation Energy", "units": "kJ/mol", "value": 35.0 }
     }
 }

pvdeg/data/DegradationDatabase.json

@@ -308,15 +308,15 @@
         "Degradation": "Optical Transmittance In-Situ measurement",
         "Comments": "LED Light at 550nm",
         "EquationType": "Perovskite_1",
-        "Equation": "R_D=R_{0,WPO}\\cdot e^{ \\left( \\frac{-E_{a,WPO}}{R\\cdot T_K } \\right) } \\cdot \\left< \\frac{P_{O_2}\\cdot P_{H_2 O}\\cdot G_{550}^{0.7} }{ \\left[ 1+K_{2W}\\cdot P_{O_2} \\left(1+K_{3W}\\cdot G_{550}^{0.7} \\right) \\right]^2}  \\right> +R_{0,DPO}\\cdot e^ {\\left( \\frac{-E_{a,DPO}}{R\\cdot T_K} \\right) } \\cdot \\frac{P_{O_2} \\cdot G_{550}^{0.7} }{1+K_{2D}\\cdot P_{O_2} \\cdot \\left( 1+K_3D\\cdot G_{550}^{0.7}  \\right)} +R_{0,hum}\\cdot e^ { \\left( \\frac {-E_a^{hum}}{R\\cdot T_K } \\right) } \\cdot P_{H_2 O}\\cdot G_{550}^{0.7}+R_{0,therm}\\cdot e^{ \\left( \\frac{-E_a^{therm}}{R\\cdot T_K } \\right) }",
+        "Equation": "R_D=k_{0,WPO}\\cdot e^{ \\left( \\frac{-E_{A,WPO}}{R\\cdot T_K } \\right) } \\cdot \\frac{P_{O_2}\\cdot P_{H_2 O}\\cdot I_{in}^{0.7} }{ \\left[ 1+K_{2W}\\cdot P_{O_2} \\left(1+K_{3W}\\cdot I_{in}^{0.7} \\right) \\right]^2} +k_{0,DPO}\\cdot e^ {\\left( \\frac{-E_{A,DPO}}{R\\cdot T_K} \\right) } \\cdot \\frac{P_{O_2} \\cdot I_{in}^{0.7} }{1+K_{2D}\\cdot P_{O_2} \\cdot \\left( 1+K_{3D}\\cdot I_{in}^{0.7} \\right)} +k_{0,hum}\\cdot e^ { \\left( \\frac {-E_{A}^{hum}}{R\\cdot T_K } \\right) } \\cdot P_{H_2 O}\\cdot I_{in}^{0.7}+k_{0,therm}\\cdot e^{ \\left( \\frac{-E_{A}^{therm}}{R\\cdot T_K } \\right) }",
         "R_D": {
             "units": "mol/(m^2·s)"
         },
-        "R_0,WPO": {
+        "k_0,WPO": {
             "value": 3.16E-25,
             "units": "mol/(m^2·s·kpa^2 )·(photons/(m^2·s))^(-0.7)"
         },
-        "E_a,WPO": {
+        "E_A,WPO": {
             "value": -8.6827,
             "units": "kJ/mol"
         },
@@ -328,11 +328,11 @@
             "value": 4.32E-15,
             "units": "(photons/(m^2·s))^(-0.7)"
         },
-        "R_0,DPO": {
+        "k_0,DPO": {
             "value": 5.45E-15,
             "units": "mol/(m^2·s·kpa )·(photons/(m^2·s))^(-0.7)"
         },
-        "E_a,DPO": {
+        "E_A,DPO": {
             "value": 59.82,
             "units": "kJ/mol"
         },
@@ -344,19 +344,19 @@
             "value": 6.97E-15,
             "units": "(photons/(m^2·s))^(-0.7)"
         },
-        "R_0,hum": {
+        "k_0,hum": {
             "value": 9.2E-22,
             "units": "mol/(m^2·s·kpa)·(photons/(m^2·s))^(-0.7)"
         },
-        "E_a^hum": {
+        "E_A^hum": {
             "value": 19.3,
             "units": "kJ/mol"
         },
-        "E_a^therm": {
+        "E_A^therm": {
             "value": 43.42,
             "units": "kJ/mol"
         },
-        "R_0,therm": {
+        "k_0,therm": {
             "value": 0.00041,
             "units": "mol/(m^2·s)"
         }
@@ -1178,5 +1178,25 @@
         "srv_ab": {"value": 0, "units": ""},
         "srv_bc": {"value": 0, "units": ""},
         "comments": "Lit BO-LID + fit to Qcells destab"
+    },
+    "D046": {
+        "DataEntryPerson": "Rajiv (Dax) Daxini",
+        "DateEntered": "5/8/2026",
+        "doi": "10.1126/science.abn5679",
+        "SourceTitle": "Accelerated aging of all-inorganic, interface-stabilized perovskite solar cells",
+        "Authors": "Xiaoming Zhao, Tianran Liu, Quinn C. Burlingame, Tianjun Liu, Rudolph Holley III, Guangming Cheng, Nan Yao, Feng Gao, Yueh-Lin Loo",
+        "Reference": "Science 377, 307-310 (2022)",
+        "Material": "Halide Perovskite (CsPbI3, uncapped device)",
+        "EquationType": "Perovskite_biexponential",
+        "Comments": "Parameters for the uncapped CsPbI3 device from Zhao et al. 2022. Ea values read directly from the Arrhenius plot (Fig. 3C, uncapped fast/slow dashed lines). k0 values are calibrated to reproduce T90,Agg ~ 1440 h under ISOS-L2 (85 C, 1000 W/m^2) as reported by Orooji et al. 2026 (doi:10.1039/d6el00021e) using the same Zhao parameters. A1, A2, B are estimated from the biexponential shape in Fig. 3A (uncapped). Exact fitted coefficients are in the Zhao supplementary (doi:10.1126/science.abn5679); users should re-fit k0, A1, A2, B to their own device data for quantitative predictions.",
+        "Ea_fast": {"value": 0.248, "units": "eV"},
+        "Ea_slow": {"value": 0.243, "units": "eV"},
+        "k0_fast": {"value": 0.56, "units": "h^-1 (pre-exponential at reference irradiance I_ref)"},
+        "k0_slow": {"value": 0.48, "units": "h^-1 (pre-exponential at reference irradiance I_ref)"},
+        "A1": {"value": 0.25, "units": "dimensionless (fast-process amplitude, A1+A2+B=1)"},
+        "A2": {"value": 0.70, "units": "dimensionless (slow-process amplitude)"},
+        "B": {"value": 0.05, "units": "dimensionless (residual stable fraction)"},
+        "gamma": {"value": 1.0, "units": "dimensionless (light-intensity exponent)"},
+        "I_ref": {"value": 1200.0, "units": "W/m^2 (reference irradiance used in Zhao experiments)"}
     }
 }