Paris Analysis & H.E.S.S. Access

If you've used PA on this cluster before

The environment setup below (pa10) is the current, maintained way to activate Paris Analysis. Older instructions referencing a hand-written setHESS.sh, PA versions 32/34, ROOT 5.34 or a py27 conda environment are out of date — that setup has been retired in favour of the one below.

Activating Paris Analysis

Make sure you have a working conda setup first — see Using Anaconda. Then create ~/setHESS/pa-v10.sh with the following:

~/setHESS/pa-v10.sh

source /home/software/gcc/env/gcc5.sh
conda activate py37
source /home/software/hess/root/root6_install_nodes/bin/thisroot.sh
source /home/software/hess/ParisAnalysis/pa-chain-paris-0-10-0-branch_root6/thishess.sh

alias gpa='python $HESSROOT/parisanalysis/gui/GUI.py &'
alias grq='python $HESSROOT/parisrunquality/gui/GUI.py &'
alias root='TZ=UTC root -l'

export PATH=$HESSROOT/scons/local:$PATH
alias scons="scons.py"
export SCONSFLAGS="--jobs=10"

Add an alias for it to your shell profile, then use it to activate PA in any session:

Add the pa10 alias (once, in ~/.bashrc)

alias pa10='source ~/setHESS/pa-v10.sh'

Activate PA

pa10

With PA active, start the GUI tools with the aliases defined above:

Paris Analysis GUI / Run Quality Selector

gpa   # Paris Analysis GUI
grq   # Run Quality Selector

Database access

To query the H.E.S.S. database you'll need a .dbtoolsrc file in your home directory:

~/.dbtoolsrc format

[astro]
 host=host
 port=port
 user=hess
 password=*****
 database=HESS_DAQ_Namibia

[hess]
 host=host
 port=port
 user=hess
 password=*****
 database=HESS_DAQ_Namibia

[calibration]
 host=host
 port=port
 user=hess
 password=*****
 database=CALIBRATION

[analysis]
 host=host
 port=port
 user=hess
 password=*****
 database=ANALYSIS

Contact your supervisor for the actual host, port and password values for this file.

Extracting run lists

Use the Run Quality Selector (grq) to find and export run lists: search for your source under Position, pick the telescope Profile for the configuration you need, select the runs in Selected Runs, and export as ASCII under a chosen list name. If you change any selection parameters, rerun the filters before selecting runs again.

Checking DST availability

DSTs live under /home/software/hess/data_temp/DST. Which subfolder you need depends on your data's production version — Model_HESSII_Hybrid_Prod10_PreProd1 or Model_HESSII_Hybrid_Prod8. To check locally which run numbers are actually present, feed a run list into a quick availability check:

Check which runs are available locally

#Test for available runs locally
#feed runlist as argument

import os
import sys

if len(sys.argv) < 2:
    raise Exception('You must feed in the runlist as an argument and the prod type!')

def read_runs():
    file_string = sys.argv[1]
    file = open(file_string, 'r')
    runlist = []
    for line in file:
        runlist.append(int(line))
    return runlist

def check(runlist):
    try:
        prod = sys.argv[2]
    except IndexError:
        sys.exit('WHAT IS THE PROD NUMBER, PROD10 OR PROD8')
    PATH = ''
    if prod.lower() == 'prod10':
        PATH = '/home/software/hess/data_temp/DST/Data/Model/Model_HESSII_Hybrid_Prod10_PreProd1/'
    elif prod.lower() == 'prod8':
        PATH = '/home/software/hess/data_temp/DST/Data/Model/Model_HESSII_Hybrid_Prod8/'

    for run in runlist:
        if len(list(str(run))) == 5:
            name = PATH + 'dst_model_0' + str(run) + '_01.root'
        else:
            name = PATH + 'dst_model_' + str(run) + '_01.root'
        if os.path.exists(name):
            continue
        else:
            print('Run number %i is not here' % run)

runlist = read_runs()
check(runlist)

Use it

python script.py runlist.list prod10

This prints any run numbers that aren't available locally. Tables live under /home/software/hess/Tables.

Full H.E.S.S. documentation

For a full, tab-by-tab description of the Paris Analysis software, see the official ParisAnalysis documentation:

ParisAnalysis documentation →

Campus-only

That link is only reachable from the UNAM campus network. If you're off campus, use the SOCKS proxy technique in Connect over SSH to reach it. The same technique also reaches the H.E.S.S. WebSummary at base.hess-experiment.eu (port 8005).