CMS Machine Learning Hands-on Advanced Tutorial Session (HATS)#
This is a set of tutorials for the CMS Machine Learning Hands-on Advanced Tutorial Session (HATS).
They are intended to show you how to build machine learning models in python, using
PyTorch, and use them in your
We will build event-level classifiers for differentiating VBF Higgs and standard model background 4 muon events and jet-level classifiers for differentiating boosted W boson jets from QCD jets using dense and convolutional neural networks.
We will also explore more advanced models such as graph neural networks (GNNs), variational autoencoders (VAEs), and generative adversarial networks (GANs) on simple datasets.
Vanderbilt Jupyterhub (Recommended!)#
The recommended method for running the tutorials live is the Vanderbilt Jupyterhub, follow the instructions here.
Not as well supported, but instructions are here.
All these notebooks can be run on your local machine as well. It can often be useful to test your models and pipelines locally, but it is not recommended to run full trainings as these can be resource-intensive.
To run locally, run these commands from your terminal:
# Download the setup bash file for your machine from here https://github.com/conda-forge/miniforge#mambaforge # e.g. wget https://github.com/conda-forge/miniforge/releases/latest/download/Mambaforge-Linux-x86_64.sh # Install: (the mamba directory can end up taking O(1-10GB) so make sure the directory you're using allows that quota) chmod u+x Mambaforge-Linux-x86_64.sh ./Mambaforge-Linux-x86_64.sh # follow instructions in the installation git clone https://github.com/FNALLPC/machine-learning-hats/ cd machine-learning-hats mamba create -f environment.yml mamba activate machine-learning-hats jupyter lab # this will create a JupyterLab instance from which you can run all the notebooks.
This may be a more convenient, but it has not been well tested and the set-up time can be slow.
Each notebook can also be launched in a Google Colab instance by clicking “Google Colab” option in the menu bar above. To use this, you will have to install any extra libraries needed for the tutorial yourself and re-download the relevant datasets each time.
This project is created using the excellent open source Jupyter Book project and the executablebooks/cookiecutter-jupyter-book template.