- 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 http://docs.gammapy.org
- 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 https://github.com/gammapy/gammapy-extra

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.

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:

- A Whirlwind tour of Python (learn Python)
- Python data science handbook (learn IPython, Numpy, matplotlib)
- Scipy lectures (another intro to scientific Python)

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

- http://www.astropy.org/astropy-tutorials
- http://astropy.readthedocs.io
- https://python4astronomers.github.io/

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:

- IACT DL3 data with Gammapy (H.E.S.S. data example)
- Fermi-LAT data with Gammapy (Fermi-LAT data example)

2-dimensional sky image analysis:

- Image analysis with Gammapy (run pipeline) (H.E.S.S. data example)
- Image analysis with Gammapy (individual steps) (H.E.S.S. data example)
- Source detection with Gammapy (Fermi-LAT data example)

1-dimensional spectral analysis:

- Spectral models in Gammapy
- Spectral analysis with Gammapy (run pipeline) (H.E.S.S. data example)
- Spectral analysis with Gammapy (individual steps) (H.E.S.S. data example)
- Spectrum simulation and fitting (CTA data example with AGN / EBL)
- Flux point fitting with Gammapy
- Light curve estimation with Gammapy (H.E.S.S. fake data example TBC)

3-dimensional cube analysis:

- Cube analysis with Gammapy (part 1) - compute cubes and mean PSF / EDISP
- Cube analysis with Gammapy (part 2) - likelihood fit

Time-related analysis:

- Time analysis with Gammapy (not written yet)

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!).

The following notebooks are work in progress or broken.

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

- TODO: joint Fermi-IACT analysis with Gammpy
TODO: simulate Fermi and CTA sky with Gammapy

- notebooks/source_catalogs.ipynb : Working with gamma-ray source catalogs
- notebooks/diffuse_model_computation.ipynb : Diffuse model computation
- notebooks/fermi_vela_model.ipynb : Fermi Vela model
- Simulating and analysing sources and diffuse emission