Cheetah quick start

 
 

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


At SLAC

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

    > cheetah-gui


At EuXFEL

    > source /gpfs/cfel/cxi/common/public/development/cheetah/setup.sh (or setup.csh if using csh/tcsh)

    > cheetah-gui

    Please read the notes regarding EuXFEL


At CFEL (Use Cheetah for EuXFEL installed on Maxwell as it is the most up-to-date)

       > source /gpfs/cfel/cxi/common/public/development/cheetah/setup.sh (or setup.csh if using csh/tcsh)

       > cheetah-gui


Elsewhere

    The Cheetah GUI is written in Python and uses a standard Anaconda python 3.x installation, notes here.



Tip:

Create an alias to source setup files file only when you need it.  For example:

        alias psana-ini source /reg/g/psdm/etc/ana_env.csh

        alias cheetah-ini source /reg/g/cfel/cheetah/setup.csh

        alias crystfel-ini source /reg/g/cfel/crystfel/crystfel-dev/setup-csh

or

        aliascheetah-ini source /gpfs/cfel/cxi/common/public/development/cheetah/setup.csh


This avoids the ‘who comes last’ arms race of conflicting dependencies in your .profile/.bashrc/.cshrc file.

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




Notes:

  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 cheetah-gui.py.  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.