This repo contains the current EventDisplay source code, example fcls, tutorials and documentation.
The EventDisplay is based on REve which is an updated version of the well-known and widely used TEve ROOT based Event Visualization Software. REve uses modernized infrastcutrue and allows Web Access for remote use.
For more information about REve and the implementation for Mu2e see: https://mu2ewiki.fnal.gov/wiki/Eve7EventDisplay#Examples_of_the_Eve-7_Mu2e_Display.
To use the display to scroll through events sequentially utilize either the nominal_example for nominal Mu2e geometry or extracted_example for the extracted geometry and run as you would any other .fcl:
mu2e -c <chosen_geom.fcl> <filename.art>
The current available options for the .fcl are located in the examples directory. There are four main examples:
- nominal_MDC2020.fcl: with the original CRV geometry, to be used the MDC2020 samples
- nominal_MDC2025.fcl: with the MDC2025 CRV geometry assuming the common GDML
- extracted_MDC2020.fcl: for those still using MDC2020 extracted samples, to be retired
- extracted_MDC2025.fcl: for those doing extracted studies with MDC2025 samples
- nominal_Run1A.fcl: Run1A CRV geometry MDC2025
- nominal_Run2.fcl: full CRV geometry, MDC2025
These .fcl can be edited as you wish (adding or removing certain features), they should provide good starting points for any study.
There are a number of ways to go from your analysis to a visualized event. Utilities are provided in both rooutils [cite] and pyutils [https://github.com/Mu2e/pyutils/blob/main/pyutils/pydisplay.py]. There is also a custom script in this repo config/EventDisplay.sh the usage is as follows:
./EventDisplay.sh --run 1201 --subrun 34 --event 15028 --dataset mcs.mu2e.ensembleMDS2cMix1BBTriggered.MDC2020ba_best_v1_3.art
if you know the name of the dataset.
If you are working with an ntuple, you may not know all the commands to figure out its parent mcs. In this case run:
./EventDisplay.sh --run 1201 --subrun 476 --event 1 --dataset nts.mu2e.ensembleMDS2cMix1BBTriggered.MDC2020ba_best_v1_3_v06_06_00.001201_00000476.root
where the run, subrun and event numbers are identified from your analysis to be an event of interest in that root file.
We are in the process of updating our Analysis Tools Tutorial material. In the meantime, please see: https://mu2ewiki.fnal.gov/wiki/EventDisplayTutorial
This code is still under development by the Mu2e Analysis Tools Group. The development team current consists of Sophie Middleton, Andy Edmonds and Namitha Chithiraseemadam. Please contact us to contribute.