Here are several things you can check to make sure you are ready for the summer school.
Download and install the FermiBottle container following the Installation instructions.
Start and attach to the container following the usage instructions.
Once in the container.
To help, we've created a run through below and short Jupyter notebook you can download to demonstrate these steps.
Fermitools Example Run Through
Here's an example session on a Mac. I created a directory called fermi_summer_school and a file in it called this_is_the_share_directory just so something shows up in a directory listing. Note that its name does not matter, and you can create it wherever you like or use an existing directory. This directory will be visible from the container. I then pulled the FermiBottle image from Docker and started it.
You can use either the container id or name of the container to start and attach to it.
This puts me in the container. You should notice that the prompt is now the "fermi" user and the container ID. Note that you only have to run the xhost command once. If you quit the container, you just have to run the start and attach commands to return to it.
I launched ds9 to make sure X-windows are working. Quit it (assuming it works) and change to the shared directory, which is under /data in the container.
Back on the host system, download this file, Quick_Test.zip, and put it in the shared directory. Then, unzip it which will create a directory.
In the container, you should see the change:
Now start the "fermi" environment and the Jupyter notebook server:
You can paste one of the http URLs into the browser (I used the 00.00.00.00 one) on your host machine and should see something like:
Click on the Quick_test.ipynb file to open it. You can then run the notebook by select Cell->Run All from the menu bar. It runs one of the Fermitools (gtbin) and then creates a lightcurve. You should then end up with a notebook that looks like this:
Congratulations, things seem to be working!
GBM Data Tools Example
The GBM Data Tools tutorials are in Jupyter notebooks. If you did the example above, you already have a notebook running, but you can't have more than one Jupyter notebook running at a time in FermiBottle by default. You can use the "Quit" button in the upper right of the Jupyter notebook start page or hit to
ctrl-c in the terminal window, which will then prompt you to shut it down.
The GBM Data Tools are in separate conda environment from the Fermitools. The GBM team provides the gbm-demos command to launch a list of the tutorial notebooks.
Like before, you will need to paste the URL into an external browser and will then find a list of notebooks. Open the index.ipynb one, which gives more descriptive list of the available tutorials. Try the first one on the list "GBM Science Data: Time History Spectra" and do Cell->Run All. It should run quickly and make some plots. You may see a warning that Basemap is not installed. That shouldn't be a problem for now.