Eventdisplay Analysis Scripts for VERITAS

Eventdisplay analysis scripts for VERITAS, see EventDisplay_v4 for the reconstruction and analysis codes.

This release should be used together with

• Eventdisplay v490-beta.2
• Eventdisplay_AnalysisScripts_VTS v490-beta.2
• Eventdisplay_AnalysisFiles_VTS v490-beta.2

Changes (includes beta.1 changes): AP and NN Analysis support

Script support different analysis types, including the afterpulsing and optimised next-neighbour cleaning.

Best to set a environmental variable $VERITAS_ANALYSIS_TYPE to either AP (afterpulsing threshold cleaning) or NN (optimised next neighbour cleaning).

Scripts should pick up the correct settings (e.g., IRF.production.sh will set the eventdisplay reconstruction parameter file to EVNDISP.reconstruction.runparameter.NN.v4x for NN cleaning and EVNDISP.reconstruction.runparameter.AP.v4x for AP cleaning)

dispBDT Angular Reconstruction support

Scripts to train and use dispBDT regression trees for the angular reconstruction.

Training scripts are IRF.trainTMVAforAngularReconstruction.sh and reconstruction scripts are IRF.mscw_energy_MC.sh and IRF.generate_mscw_effective_area_parts.sh. Note that at this point dispBDT reconstruction is switched on by changing a flag in the IRF.production.sh script.

HT Condor support

Introduce HTCondor support (as this is slowly introduced at DESY in 2022).

Only change necessary to use the the HTCondor system is to set * condor_submit in the submissionCommands.dat file.

(and just not to forget it, queue status is checked with condor_status, job status with condor_q at DESY)

Slurm support

Addition of slurm as possible job submission system.

BDT gamma/hadron separation

Scripts for more efficient gamma/hadron separation include scripts to select background runs and optimise cuts.

Support for zstd-compressed evndisp MC files

Support zstd compressed MC evndisp root files.

This involves a slightly different directory structure for IRF production, where MC evndisp files are now located in $VERITAS_IRFPRODUCTION_DIR/v4N (all other IRF data products are stored in a similar directory structure as before)

Scripts to extract DB text files and use them in the evndisp analysis

Scripts to extract DB information are in the db_scripts directory. Users generally need only the db_run.sh script. Allows large-scale parallel process without DB overload.

Large-scale processing

Optimise directory structure to avoid having files from all runs of VERITAS in a single directory. Runs are sorted accordingi to the first digit, e.g. run 64080 into ./6/ and run 104500 into ./10/.

Log files

To reduce the number of files on disk, log files are written into the corresponding root files. e..g. the log file from the eventdisplay processing can be retrieved by the following command: $EVNDISPSYS/bin/logFile evndispLog 64080.root

(same for all other stages; includes files used for IRF production)