Cheetah quick start


Source the appropriate setup file to get cheetah-gui and its dependencies in your path, then launch the GUI:


> source /reg/g/cfel/cheetah/ (or setup.csh)

> cheetah-gui


See the notes regarding EuXFEL (still under development)


> module load cheetah-gui

> cheetah-gui

Instructions for different facilities can be found on the following pages:

  1. Bullet At home

  2. Bullet SLAC/LCLS

  3. Bullet CFEL

  4. Bullet SACLA

  5. Bullet European XFEL

  6. Bullet Petra-III


  1. 1)The setup scripts do more than simply add the cheetah-gui location to your path.  They also point to specific python versions with which the GUI has been tested to ensure it runs smoothly.   This may affect your global python environment.  If this causes problems the easiest solution is to call the setup script manually or through an alias when you want Cheetah rather than adding it to your .profile/.bashrc/.cshrc file.

  1. 2)cheetah-gui itself is actually a shell script which sets paths and environment variables for an Anaconda python3 installation then calls the  This avoids affecting the rest of your setup or causing conflicts with other Python versions.   Modification of the setup scripts to get it to work at home (or on your laptop) should be trivial.

  1. 3)The list of experiments is saved in the file ~/.cheetah-crawler, one line per experiment.  This file can be edited manually if needed.

You should be presented with a list of all past experiments you have previously looked at making it easy to manage data from multiple experiments.  If the experiment is not already in the list it can be added using the 2nd button - simply navigate to the cheetah/gui/crawler.config file for the new experiment. Or set up a new experiment using the 3rd button. 

After this, the table of runs and processed (or unprocessed) data should appear.  More detail on processing options is given on the following pages. If in doubt, follow the instructions for LCLS as this is the most tested and frequently used example.