eventdisplay is a software package for analysis of data from ground-based gamma-ray observatories like VERITAS and CTA. It was originally developed as display for the VERITAS prototype data, but evolved into a full analysis package with routines for calibration, FADC trace integration, image and stereo parameter analysis, response function calculation and high-level analysis steps (e.g. sky maps and spectral analysis). The original authors of eventdisplay are Jamie Holder and Gernot Maier, see the README/Authors file for all contributions.

Eventdisplay is used in VERITAS for science analysis. The package has been used for the analysis of simulations of the response of the 36-telescope concept studies of AGIS, and is well suited for the analysis of CTA arrays with a large number of telescopes.

evndisplay can be used by all members of the CTA collaboration. We recommend to contact G.Maier before starting an analysis.

Documentation

General description of the reconstruction / analysis steps (Proceedings of the ICRC 2017): https://arxiv.org/abs/1708.04048

Analysis description: pdf

The most up-to-date version of the manual can be found in the source tar ball below. Note that the documentation is work-in-progress.

Additional descriptions for VERITAS users can be found on the VERITAS wiki page Eventdisplay_Manual, more information for CTA users on the CTA wiki.

Email list

Please send a mail to Gernot Maier to sign up to the Eventdisplay list for CTA users.

Software distribution

If you are in doubt which version to choose, take the most recent one. For access to the software repository, please contact the developers.

Note that in order to analyse VERITAS data, additional libraries will be needed. For CTA analysis, HESSIO libraries have to be installed.

tar balls of recent development version

Please contact G.Maier to get the most recent updates.

Example for prod3 (North) analysis

Assume that you are in the main directory of eventdisplay

Convert sim_telarray file to DST root file

Assume your sim_telarray data file is called mono.output_muon.simtel.gz

./bin/CTA.convert_hessio_to_VDST -a $CTA_EVNDISP_AUX_DIR/DetectorGeometry/CTA.prod3N.LST.lis -f 2 -c ped.20151106.evndisp.root -o mono.output_muon.dst.root mono.output_muon.simtel.gz

Display and analyse

source ./setObservatory.sh CTA

./bin/evndisp -sourcefile mono.output_muon.dst.root -averagetzerofiducialradius=0.5 -shorttree -l2setspecialchannels nofile -writenoMCTree -ignoredstgains -reconstructionparameter EVNDISP.prod3.reconstruction.runparameter.NN -NNcleaninginputcard EVNDISP.NNcleaning.dat -display=1

Contact

For questions contact Gernot Maier (gernot.maier@desy.de)

The development of eventdisplay was supported by the Helmholtz Young Investigator Program.