Repository files navigation

Supera is designed to slice up the data products output from larsoft and package them to be consumed by the mlreco workflow. The bulk of the work is done bySuperaMCParticleCluster which consumes inputs fromsimenergydeposit(lite), cluster3D, and MC truth products such asMCTrack,MCShower, andMCParticle.

Verbosity can be set for any module used in supera by settingVerbosity : n

• n = 0 showsLARCV_DEBUG and above messages
• n = 1 showsLARCV_INFO and above messages
• n = 2 showsLARCV_NORMAL and above messages
• n = 3 showsLARCV_WARNING and above messages
• n = 4 showsLARCV_ERROR and above messages
• n = 5 only showsLARCV_CRITICAL and messages

This class is responsible for managing Monte Carlo (MC) particle clusters within the LArCV framework. The class is authored by drinkkazu.

• It provides functions to configure, initialize, process, and finalize instances of the class.
• It allows creation of particles and particle groups.
• It includes methods for analyzing simulated energy deposits and channels.
• It has functions for merging shower touchings, conversions, ionizations, and deltas.
• It includes functions for merging shower family touchings.
• The class also contains private variables and methods to work with particle clusters.

The class depends on several other modules and classes in the LArCV framework, including:

• SuperaBase
• SuperaTrue2RecoVoxel3D
• FMWKInterface
• MCParticleList
• Various data formats fromlarcv/core/DataFormat
• SuperaMCParticleClusterData

The class is built upon a factory pattern, with the correspondingSuperaMCParticleClusterProcessFactory class provided for creating instances ofSuperaMCParticleCluster.

In general,Supear works fine with latest larsoft release oncvmfs (linux only, sorry for mac users).The following has been tested with the tags specified. It depends on [[larcv2][https://github.com/DeepLearnPhysics/larcv2]].

For building

# ===========================# Prepare a working directory# ===========================source /cvmfs/dune.opensciencegrid.org/products/dune/setup_dune.shsetup larsoft v08_21_00 -q e17:profmkdir MyWorkDir && cd MyWorkDirmrb newDevsource MyWorkDir/localProducts_larsoft_v08_21_00_e17_prof/setup# ===============# checkout larcv2# ===============cd $MRB_SOURCEgit clone https://github.com/DeepLearnPhysics/larcv2cd larcv2source configure.shmake# ================# checkout dunetpc# ================cd $MRB_SOURCEmrb g dunetpc# ===============# checkout supera# ===============cd $MRB_SOURCE/dunetpc/dunegit clone -b pdune https://github.com/kvtsang/Supera.gitcd Superasource setup.sh pdune# ============================================# edit $MRB_SOURCE/dunetpc/dune/CMakeLists.txt# add this line "add_subdirectory(Supera)"# ============================================cd $MRB_BUILDDIRmrbsetenvmrb i             # or mrb i -j <n> for parallel build

For running

# ==========================================# Do it once, before executing "lar" command# ==========================================source /cvmfs/dune.opensciencegrid.org/products/dune/setup_dune.shsource MyWorkDir/localProducts_larsoft_v08_21_00_e17_prof/setupsource MyWorkDir/larcv2/configure.sh