.. _python-notebooks:

Notebooks
=========

Interactive Jupyter Notebook tutorials covering advanced Python usage.
Each notebook is available to run interactively via Binder, to download from GitHub,
or to browse inline below.

Interactive (Binder)
---------------------

Each link opens a live JupyterHub with all dependencies pre-installed.
Note: Binder uses the latest commit on ``main``, not necessarily the latest release.

0. `welcome to MUSICA <https://mybinder.org/v2/gh/NCAR/musica/HEAD?filepath=tutorials/0.%20Welcome%20to%20MUSICA.ipynb>`_
1. `working with multiple grid cells <https://mybinder.org/v2/gh/NCAR/musica/HEAD?filepath=tutorials/1.%20multiple_grid_cells.ipynb>`_
2. `latin hypercube sampling <https://mybinder.org/v2/gh/NCAR/musica/HEAD?filepath=tutorials/2.%20hypercube.ipynb>`_
3. `user-defined reactions <https://mybinder.org/v2/gh/NCAR/musica/HEAD?filepath=tutorials/3.%20user_defined_reactions.ipynb>`_
4. `local parallelization <https://mybinder.org/v2/gh/NCAR/musica/HEAD?filepath=tutorials/4.%20local_parallelization.ipynb>`_
5. `HPC parallelization <https://mybinder.org/v2/gh/NCAR/musica/HEAD?filepath=tutorials/5.%20hpc_parallelization.ipynb>`_
6. `using GPU solvers <https://mybinder.org/v2/gh/NCAR/musica/HEAD?filepath=tutorials/6.%20gpu_solver.ipynb>`_
7. `using CARMA <https://mybinder.org/v2/gh/NCAR/musica/HEAD?filepath=tutorials/7.%20carma.ipynb>`_
8. `TUV-x standard configurations <https://mybinder.org/v2/gh/NCAR/musica/HEAD?filepath=tutorials/8.%20tuv-x_standard_configurations.ipynb>`_
9. `TUV-x conditions <https://mybinder.org/v2/gh/NCAR/musica/HEAD?filepath=tutorials/9.%20tuv-x_conditions.ipynb>`_
10. `Chapman cycle box model <https://mybinder.org/v2/gh/NCAR/musica/HEAD?filepath=tutorials/10.%20chapman.ipynb>`_
11. `TS1 box model <https://mybinder.org/v2/gh/NCAR/musica/HEAD?filepath=tutorials/11.%20ts1_box_model.ipynb>`_
12. `multiple mechanisms in the same host application <https://mybinder.org/v2/gh/NCAR/musica/HEAD?filepath=tutorials/12.%20multiple_mechanisms.ipynb>`_
13. `TUV-x subset photolysis <https://mybinder.org/v2/gh/NCAR/musica/HEAD?filepath=tutorials/13.%20tuv-x_subset_photolysis.ipynb>`_
14. `introduction to aerosol and cloud chemistry <https://mybinder.org/v2/gh/NCAR/musica/HEAD?filepath=tutorials/14.%20aerosol_chemistry_intro.ipynb>`_
15. `DAE solving introduction <https://mybinder.org/v2/gh/NCAR/musica/HEAD?filepath=tutorials/15.%20dae_solving_intro.ipynb>`_
16. `MIAM processes and constraints <https://mybinder.org/v2/gh/NCAR/musica/HEAD?filepath=tutorials/16.%20miam_processes_and_constraints.ipynb>`_
17. `CAM cloud chemistry <https://mybinder.org/v2/gh/NCAR/musica/HEAD?filepath=tutorials/17.%20cam_cloud_chemistry.ipynb>`_
18. `CAM aerosol distributions <https://mybinder.org/v2/gh/NCAR/musica/HEAD?filepath=tutorials/18.%20cam_aerosol_distributions.ipynb>`_
19. `MIEM NOx emissions box model <https://mybinder.org/v2/gh/NCAR/musica/HEAD?filepath=tutorials/19.%20miem_nox_box_model.ipynb>`_

Download (GitHub)
------------------

0. `welcome to MUSICA notebook <https://github.com/NCAR/musica/blob/main/tutorials/0.%20Welcome%20to%20MUSICA.ipynb>`_
1. `multiple grid cells notebook <https://github.com/NCAR/musica/blob/main/tutorials/1.%20multiple_grid_cells.ipynb>`_
2. `hypercube sampling notebook <https://github.com/NCAR/musica/blob/main/tutorials/2.%20hypercube.ipynb>`_
3. `user-defined reactions notebook <https://github.com/NCAR/musica/blob/main/tutorials/3.%20user_defined_reactions.ipynb>`_
4. `local parallelization notebook <https://github.com/NCAR/musica/blob/main/tutorials/4.%20local_parallelization.ipynb>`_
5. `HPC parallelization notebook <https://github.com/NCAR/musica/blob/main/tutorials/5.%20hpc_parallelization.ipynb>`_
6. `GPU solvers notebook <https://github.com/NCAR/musica/blob/main/tutorials/6.%20gpu_solver.ipynb>`_
7. `CARMA notebook <https://github.com/NCAR/musica/blob/main/tutorials/7.%20carma.ipynb>`_
8. `TUV-x standard configurations notebook <https://github.com/NCAR/musica/blob/main/tutorials/8.%20tuv-x_standard_configurations.ipynb>`_
9. `TUV-x conditions notebook <https://github.com/NCAR/musica/blob/main/tutorials/9.%20tuv-x_conditions.ipynb>`_
10. `Chapman cycle box model notebook <https://github.com/NCAR/musica/blob/main/tutorials/10.%20chapman.ipynb>`_
11. `TS1 box model notebook <https://github.com/NCAR/musica/blob/main/tutorials/11.%20ts1_box_model.ipynb>`_
12. `multiple mechanisms notebook <https://github.com/NCAR/musica/blob/main/tutorials/12.%20multiple_mechanisms.ipynb>`_
13. `TUV-x subset photolysis notebook <https://github.com/NCAR/musica/blob/main/tutorials/13.%20tuv-x_subset_photolysis.ipynb>`_
14. `introduction to aerosol and cloud chemistry notebook <https://github.com/NCAR/musica/blob/main/tutorials/14.%20aerosol_chemistry_intro.ipynb>`_
15. `DAE solving introduction notebook <https://github.com/NCAR/musica/blob/main/tutorials/15.%20dae_solving_intro.ipynb>`_
16. `MIAM processes and constraints notebook <https://github.com/NCAR/musica/blob/main/tutorials/16.%20miam_processes_and_constraints.ipynb>`_
17. `CAM cloud chemistry notebook <https://github.com/NCAR/musica/blob/main/tutorials/17.%20cam_cloud_chemistry.ipynb>`_
18. `CAM aerosol distributions notebook <https://github.com/NCAR/musica/blob/main/tutorials/18.%20cam_aerosol_distributions.ipynb>`_
19. `MIEM NOx emissions box model notebook <https://github.com/NCAR/musica/blob/main/tutorials/19.%20miem_nox_box_model.ipynb>`_

Browse Online
--------------

.. toctree::
   :maxdepth: 1

   0. Welcome to MUSICA <0. Welcome to MUSICA>
   1. Multiple Grid Cells <1. multiple_grid_cells>
   2. Latin Hypercube Sampling <2. hypercube>
   3. User-Defined Reactions <3. user_defined_reactions>
   4. Local Parallelization <4. local_parallelization>
   5. HPC Parallelization <5. hpc_parallelization>
   6. Using GPU Solvers <6. gpu_solver>
   7. Using CARMA <7. carma>
   8. TUV-x Standard Configurations <8. tuv-x_standard_configurations>
   9. TUV-x Conditions <9. tuv-x_conditions>
   10. Chapman Cycle Box Model <10. chapman>
   11. TS1 Box Model <11. ts1_box_model>
   12. Multiple Mechanisms <12. multiple_mechanisms>
   13. TUV-x Subset Photolysis <13. tuv-x_subset_photolysis>
   14. Introduction to Aerosol and Cloud Chemistry <14. aerosol_chemistry_intro>
   15. DAE Solving Introduction <15. dae_solving_intro>
   16. MIAM Processes and Constraints <16. miam_processes_and_constraints>
   17. CAM Cloud Chemistry <17. cam_cloud_chemistry>
   18. CAM Aerosol Distributions <18. cam_aerosol_distributions>
   19. MIEM NOx Emissions Box Model <19. miem_nox_box_model>
