Tutorials

PVDeg provides comprehensive tutorials organized by topic. Choose your preferred environment:

Jupyter Book (Recommended)

Interactive tutorials with live execution: PVDeg Jupyter Book

• Click the 🚀 rocket icon to launch notebooks in Google Colab

• Development Preview: See latest changes at dev-preview

Binder

Run tutorials in your browser without installation:

Local Installation

1. Install PVDeg (see Installation)

2. Clone the repository to access tutorial notebooks:

   git clone https://github.com/NREL/PVDegradationTools.git
   cd PVDegradationTools
   

3. Start Jupyter:

   jupyter notebook
   

4. Navigate to tutorials organized by category:

   • 01_basics/ - Introduction to PVDeg fundamentals

   • 02_degradation/ - Degradation mechanism modeling

   • 03_monte_carlo/ - Monte Carlo uncertainty analysis

   • 04_geospatial/ - Geospatial and HPC scenarios

   • 05_advanced/ - Advanced topics and API access

   • 10_workshop_demos/ - Workshop demonstrations

   • tools/ - Standalone analysis tools

NREL HPC (Kestrel)

Running notebooks on Kestrel is documented on the NREL HPC Documentation.

Important: Register a custom iPykernel before running notebooks on Kestrel:

python -m ipykernel install --user --name=pvdeg-env

Replace pvdeg-env with your conda environment name. Restart your Jupyter server to load the new kernel, which will appear in the kernel selection dropdown.

For more information on validating notebook outputs and best practices, see the Contributing guide.