.. _tutorials page:

#########
Tutorials
#########

MusicBox offers a series of tutorial notebooks that guide users from simple workflows to more advanced simulations, available in multiple formats below for ease of access.

Interactive Notebooks
----------------------
The MusicBox repository utilizes `Binder <https://mybinder.readthedocs.io/en/latest/index.html#>`_ to allow users to interact with the tutorial notebooks on a `JupyterHub <https://jupyter.org/hub>`_.
Each of the links below will open a JupyterHub set up with all necessary dependencies to run each tutorial:

1. `a basic MusicBox workflow <https://mybinder.org/v2/gh/NCAR/music-box/d2e3ce8df4d1e8b80bf1d240876a31ba6e3e9a4d?urlpath=lab%2Ftree%2Ftutorials%2F1.%20basic_workflow.ipynb>`_
2. `overriding mechanisms <https://mybinder.org/v2/gh/NCAR/music-box/d2e3ce8df4d1e8b80bf1d240876a31ba6e3e9a4d?urlpath=lab%2Ftree%2Ftutorials%2F2.%20override_mechanism.ipynb>`_
3. `loading custom box models <https://mybinder.org/v2/gh/NCAR/music-box/d2e3ce8df4d1e8b80bf1d240876a31ba6e3e9a4d?urlpath=lab%2Ftree%2Ftutorials%2F3.%20loading_custom_box_models.ipynb>`_
4. `machine learning <https://mybinder.org/v2/gh/NCAR/music-box/48c40203b19fbe68c6802be7d18022bc8a0e8f7b?urlpath=lab%2Ftree%2Ftutorials%2F4.%20machine_learning.ipynb>`_
5. `solving with GPUs <https://mybinder.org/v2/gh/NCAR/music-box/96b7c7b619791bfbddafc6c8e34fb7982f26c4ca?urlpath=lab%2Ftree%2Ftutorials%2F5.%20gpu_solver.ipynb>`_

GitHub
--------
For users that wish to directly download local copies of the tutorial notebooks, they are each made available on our GitHub within the `tutorials <https://github.com/NCAR/music-box/tree/main/tutorials>`_ folder. Each notebook is also linked below:

1. `a basic MusicBox workflow <https://github.com/NCAR/music-box/blob/main/tutorials/1.%20basic_workflow.ipynb>`_
2. `overriding mechanisms <https://github.com/NCAR/music-box/blob/main/tutorials/2.%20override_mechanism.ipynb>`_
3. `loading custom box models <https://github.com/NCAR/music-box/blob/main/tutorials/3.%20loading_custom_box_models.ipynb>`_
4. `machine learning <https://github.com/NCAR/music-box/blob/main/tutorials/4.%20machine_learning.ipynb>`_
5. `solving with GPUs <https://github.com/NCAR/music-box/blob/main/tutorials/5.%20gpu_solver.ipynb>`_


Web View
---------
The tutorial notebooks are also included here in the documentation for convenient online browsing.

.. toctree::
   :maxdepth: 1

   1. basic_workflow
   2. override_mechanism
   3. loading_custom_box_models
   4. machine_learning
   5. gpu_solver