Gammapy tutorial notebooks

What is this?

  • This is an overview of tutorial Jupyter notebooks for Gammapy, a Python package for gamma-ray astronomy.
  • The notebooks complement the Gammapy Sphinx-based documentation at
  • You can read a static HTML version of these notebooks (i.e. code can’t be executed) online here.
  • The notebooks and example datasets are available at

Set up

If you want to execute the notebooks locally, to play around with the examples, or to try to do one of the exercises, you have to first install Gammapy and get the gammapy-extra repository. This is described in Gammapy tutorial setup.

The basics

Gammapy is a Python package built on Numpy and Astropy, and the tutorials are Jupyter notebooks. If you’re already familar with those, you can skip to the next section and start learning about Gammapy.

If you’re new to Python or scientific Python, we can recommmend the following resources:

If you’re new to Astropy, here’s some good resources:


If you’re new to Astro (haven’t used Table, SkyCoord and Time much), start here:

For a quick introduction to Gammapy, go here:

Interested to do a first analysis of simulated CTA data?

To learn how to work with gamma-ray data with Gammapy:

2-dimensional sky image analysis:

1-dimensional spectral analysis:

3-dimensional cube analysis:

Time-related analysis:

Extra topics

These notebooks contain examples on some more specialised functionality in Gammapy.

Most users will not need them. It doesn’t make much sense that you read through all of them, but maybe browse the list and see if there’s something that could be interesting for your work (or contribute to Gammapy if something is missing!).

Work in progress

The following notebooks are work in progress or broken.

Please help make these better, or write new, better ones!