Installation using Anaconda¶
The easiest way to install Gammapy is to install the Anaconda distribution from https://www.anaconda.com/download/ and then to install Gammapy and its dependencies by executing this command in a terminal:
conda install -c conda-forge gammapy
Though this is one line command is the standard way to install a software package using Anaconda, we recommend to make use of an environment definition file that we provide, so you can get additional useful packages together with Gammapy in a virtual isolated environment. If you want to learn about using virtual environments see Using virtual environments. In order to proceed in this way, just copy and paste in your terminal the two lines below:
curl -O https://gammapy.org/download/install/gammapy-0.19-environment.yml conda env create -f gammapy-0.19-environment.yml
On Windows, you have to open up the conda environment file and delete the
healpy. Those are optional dependencies that
currently aren’t available on Windows.
This creates a conda environment called
gammapy-0.19 which you can activate via:
conda activate gammapy-0.19
Note that you have to execute that activation command (but not the environment creation command) every time you open a new terminal window, because the default with conda is the base environment, which might not have Gammapy installed.
To check your Gammapy installation, you can use this command:
To leave the environment, you may activate another one or just type:
You can now proceed to download the Gammapy tutorial notebooks and the example datasets used there (at the moment from CTA, H.E.S.S.. and Fermi-LAT). The total size to download is ~180 MB. Select the location where you want to install the datasets and proceed with the following commands:
gammapy download notebooks --release 0.19 gammapy download datasets export GAMMAPY_DATA=$PWD/gammapy-datasets
You might want to put the definition of the
variable in your shell profile setup file that is executed when you open a new
terminal (for example
If you are not using the
bash shell, handling of shell environment variables
might be different, e.g. in some shells the command to use is
set or something
else instead of
export, and also the profile setup file will be different.
On Windows, you should set the
GAMMAPY_DATA environment variable in the
“Environment Variables” settings dialog, as explained e.g.
The datasets are curated and stable, the notebooks are still under development just like Gammapy itself, and thus stored in a sub-folder that contains the Gammapy version number.
If there are issues, note that you can just delete the folder any time using
-r gammapy-tutorials and start over.