Particle physics data-analysis with CMS open data

This repository contains material for the exercise where real data from CMS experiment at CERN is used for a simple particle physics data-analysis. There are a few easy ways to get the exercise working:

monty.stfc.ac.uk Users

If you are reading this after having logged onto https://monty.stfc.ac.uk (you need to have been given an account) just click on Exercise.ipynb to start the computer exercise and read no further

1) Opening the exercise with Binder

With Binder it is easy to make Jupyter Notebook files interactive in the browser without any installing. Just open the badge in the new browser tab to create the Binder environment. When Binder has finished building the interactive environment, it will automatically show the contents of the repository. The exercise can be started by clicking the "Exercise.ipynb" file in the Binder environment.

If the badge isn't working, you can set the Binder environment manually. Go to https://mybinder.org/ and paste the URL of this repository (https://mybinder.org/v2/gh/olaiya/zboson-exercise/master?filepath=Exercise.ipynb) into the field "GitHub repository name or URL". After that click the "launch" button and wait a moment for Binder to create the environment.

Note that the Binder environment is just temporary and will be deleted after you choose to close the exercise.

2) Opening the exercise with Google Colab (need a Google account)

Using Google Colab you will need a Google account. However, there are some big benefits with this option. Your work is stored (on your Google Drive), so you can return to where you left off at another time. You also have access to more powerful GPU and CPU resources. This would be a good place to set up your own projects for analysing data! Click here:

3) Downloading the material to be opened with Jupyter Notebook

Another way to open the exercise is to download the repository to your computer and then use Jupyter Notebook to open the exercise. This way requires that you have installed Jupyter Notebook (https://jupyter.org/) to your computer.

The contents of the repository can be downloaded by clicking the green Clone or download button on the main page of the repository. Note that all files of the repository have to be in the same directory in the computer.

Contents

• Exercise.ipynb
  • This is the Jupyter Notebook file that contains the exercise.
• DoubleMuRun2011A.csv
  • This is the data file that is used in the exercise.
• images
  • This folder contains the images that are used in the exercise.
• requirements.txt
  • This text file contains information for Binder (https://mybinder.org/) to import needed Python modules.

This material is made available under a CC-BY licence https://creativecommons.org/licenses/by/4.0/.

Further reading

These notebooks use the programming language python. We provide an extremely basic introduction to python at the start of the notebook. If you want to learn more about python, please consider looking at this page: https://github.com/stfcoz/PythonIntroduction

This page provides various levels for introducing you to python

Contributing

Development ideas, feature requests, bug reports and further exercises are warmly encouraged and welcome!