Warning, /snippets/Calorimetery/CaloDebugTools/HCalDebugTreeMaker/README.md is written in an unsupported language. File is not indexed.
0001 # Flat/RelationalHCalDebugTreeMaker
0002
0003 Two simple JANA plugins to prepare trees which consolidate potentially useful information for
0004 debugging hadronic calorimeter software.
0005
0006 Both takes an edm4hep file as input, and both produce a single TTree as output.
0007
0008 - `FlatHCalDebugTreeMaker:` produces a tree which contains select information from all hadronic
0009 calorimeter clusters, cells, generated particles, and MC particles (i.e. the truth record).
0010 - `RelationalHCalDebugTreeMaker:` a tree which contains select information from all hadronic
0011 clusters and the following:
0012 1. the cells comprising those clusters,
0013 2. the MC particles *associated* to those clusters, and
0014 3. the MC particles *contributing* to those clusters.
0015
0016 In the case of the latter, belonging relationships between clusters and cells/particles are encoded
0017 in indices running parallel to the relevant branches.
0018
0019 (Initially derived from code by Frederike Bock. Thanks!!)
0020
0021 ### {Flat,Relational}HCalDebugTreeMaker Usage
0022
0023 To build either:
0024
0025 ```
0026 # after compiling EICrecon, create plugin by:
0027 eicmkplugin.py <tree>HCalDebugTreeMaker
0028 cp <path-to-this-repo>/<tree>HCalDebugTreeMakerProcessor.* $EICrecon_ROOT/<tree>HCalDebugTreeMaker/
0029
0030 # then compile plugin by:
0031 cmake -S <tree>HCalDebugTreeMaker -B <tree>HCalDebugTreeMaker/buid
0032 cmake --build <tree>HCalDebugTreeMaker/build --target install -- -j8
0033
0034 # run EICrecon with macro by:
0035 eicrecon -Pplugins=<tree>HCalDebugTreeMaker <input-edm4hep-file>
0036 ```
0037
0038 Options are set in the `Config` struct at the top of either plugin header; make changes and then
0039 recompile.
