V2DL3 Docker recipes

V2DL3 is a tool to convert VERITAS data products to DL3 Fits format. This repository provides Docker recipes for converting Eventdisplay data files.

The V2DL3 software is available from here.

Building

$ docker build -t v2dl3-eventdisplay .

Running

All examples in the following expect that the Eventdisplay data files (anasum.root and effective area files) are in the directory '$(pwd)/data'.

Run the image and provide a bash environment:

$ docker run --rm -it -v "$(pwd)/data:/data" v2dl3-eventdisplay bash

Test the converter script:

$ python V2DL3/pyV2DL3/script/v2dl3_for_Eventdisplay.py

Example execution:

$ python V2DL3/pyV2DL3/script/v2dl3_for_Eventdisplay.py \
    -f /data/64080.anasum.root \
   /data/effArea-v486-auxv01-CARE_June2020-Cut-NTel2-PointSource-Moderate-TMVA-BDT-GEO-V6_2012_2013a-ATM62-T1234.root \
   /data/fits.gz

To convert with starting the container in bash:

docker run --rm -it -v "$(pwd)/data:/data" v2dl3-eventdisplay \
                       python V2DL3/pyV2DL3/script/v2dl3_for_Eventdisplay.py \
                       -f  /data/64080.anasum.root \
                       /data/effArea-v486-auxv01-CARE_June2020-Cut-NTel2-PointSource-Moderate-TMVA-BDT-GEO-V6_2012_2013a-ATM62-T1234.root \
                       /data/fits.gz

Docker hub

e.g.:

docker tag 396165de13d9 gernotmaier/v2dl3-eventdisplay:v0.2.1-v01
docker push gernotmaier/v2dl3-eventdisplay:v0.2.1-v01

Singularity

Build a singularity image, as required for many HEP computing environments.

1. Pull and convert Docker image to Singularity

singularity pull docker://gernotmaier/v2dl3-eventdisplay:v0.2.1-v01

2. Test the singularity container in bash mode

singularity exec -e --bind $(PWD)/data:/data v2dl3-eventdisplay_v0.2.1-v01.sif bash
micromamba activate v2dl3-ed
python /workdir/V2DL3/pyV2DL3/script/v2dl3_for_Eventdisplay.py --help

3. Run an example analysis:

(expecting the data files in the ./data/ directory)

 python /workdir/V2DL3/pyV2DL3/script/v2dl3_for_Eventdisplay.py \
     -f /data/64080.anasum.root \
     /data/effArea-v486-auxv01-CARE_June2020-Cut-NTel2-PointSource-Moderate-TMVA-BDT-GEO-V6_2012_2013a-ATM62-T1234.root  \
     /data/test.fits.gz