Skip to content

Quickstart Guide

jasercion edited this page May 15, 2018 · 34 revisions

Fermitools Quickstart Guide

The Fermitools and associated data files are distributed via precompiled packages which are hosted on an Anaconda Cloud channel named fermi_dev_externals. In order to obtain/run the Fermitools you must, at a minimum, have the following system requirements:

System Requirements

  • OS: MacOS or Linux (Currently the FSSC supports MacOS Sierra/High Sierra, Ubuntu XX.XX, Fedora XX.XX and Scientific Linux XX
  • Anaconda Python 2.7 (Full Anaconda Python distribution can be obtained here or the lightweight MiniConda distribution can be obtained here)
  • A POSIX compatible shell (e.g. BASH, KSH, ZSH). Unfortunately, at this time Conda does not support CSH.

Once you have downloaded and installed Anaconda, use the following two commands to download and setup your Fermitools environment:

conda create -n fermi -c conda-forge -c fermi_dev_externals fermitools
source activate fermi

The first command will create a conda environment named fermi and install the Fermitools and the Fermitool's dependencies (including Fermitools-data) into the fermi environment. The second command activates the environment and runs the necessary activation scripts for the Fermitools. You will be dropped into the fermi conda environment with the Fermitools setup and ready to go!

Note: If you install any extra software into the fermi environment via conda install it will be isolated to this environment. Please keep this in mind. For more information on Conda environments please read the documentation located here.