LBNE Far Detector Software Data Model

From DUNE
Jump to navigation Jump to search

This page summarizes the LBNE EDM (event data model) used in simulation and reconstruction of the LBNE 35-ton prototype detector. The description includes the event data classes and the art modules that produce the data for LBNE standard Monte Carlo production. The data classes describe the data that is shared by modules via the event data store and written to event data output files.

Missing from this page are an non-LAr products (e.g. photon and muon counters and triggers) and description of associations. The latter are an essential part of the EDM.

Simulation data classes

The following table lists the EDM classes used in the simulation.

Class Location Description
MCTruth nutools/SimulationBase ID, PDG ID, status code and starting and ending position and momentum for each input MC particle
MCParticle nutools/SimulationBase ID, PDG ID, status code and starting and ending positions and momenta for each MC particle
SimChannel larsim/Simulation Energy deposited by each MC particle in the LAr volume (voxel) for each readout channel
OnePhoton larsim/Simulation Electronics response in a single optical channel readout window. Potentially many separate optical detector readout windows per TPC readout window.
SimPhotons larsim/Simulation A collection of OnePhoton objects for a particular optical detector.
SimPhotonsLite larsim/Simulation The number of photons on each optical detector based on PhotonLibrary lookup.

Reconstruction data classes

The following table lists the EDM classes used in the reconstruction.

Class Location Description
RawDigit lardata/RawData Raw (convoluted) ADC signals in time slices. Unpack with raw::Decompress in RawData/raw.h
Wire lardata/RecoBase Deconvoluted signal for each channel.
Hit lardata/RecoBase Peaks on wire signals.
Cluster lardata/RecoBase Associated hits in a TPC plane, i.e. 2D tracks. Association to hit.
SpacePoint lardata/RecoBase Space point formed by combining hits from different planes. Association to hit.
Track lardata/RecoBase Trajectory with momentum. Association to space point, hit, cluster
PFParticle lardata/RecoBase Particle-flow description of a particle. Used by Pandora.
Vertex lardata/RecoBase Vertex position. Association with PFParticle. Used by Pandora.
Calorimetry lardata/AnalysisBase Vertex position. Association with PFParticle. Used by Pandora.

Plans to update the reconstruction model are described in a talk by Gianluca.

LBNE code repositories and their browsers

Reconstruction of Monte Carlo for the LBNE 35 ton prototype

The above data model is used for the MC (Monte Carlo) samples produced for the 35-ton prototype detector. Six different reconstruction paths are followed: standard reconstruction without use of MC, with full cheat that makes extensive use of MC information, cheat using MC only to resolve TPC ambiguities, and fast hit finding. In addition, Pandora is run in standard and disambiguation cheat modes.

The following tables list the reconstruction paths and the types of data products they produce. The name and type can be used to retrieve each data product. The entries in all but the first row are the instance names of producer modules. Details for these are given in the table at the end of this section.

Reconstruction chains without pandora
Path Wire Hit Cluster Track SpacePoint Calorimetry(?)
Standard (no cheat) caldata gaushit, hit35t dbcluster costrk, stitch costrk, stitch calo
Standard full cheat caldata hitcheat clustercheat trackcheat
Standard with disambiguation cheat caldata gaushit, dcheat dbclusterdc costrkdc, stitchdc costrkdc, stitchdc calodc
Fast hit finding plus disambiguation cheat caldata fasthit, fasthitdc
Reconstruction chains with pandora
Path Wire Hit Cluster, See, SpacePoint, PFParticle, Vertex PFParticle Track
No cheat caldata gaushit, hit35t pandora particlestitcher particletracks
Disambiguation cheat caldata gaushit, dcheat pandoradc particlestitcherdc particletracksdc

The next table lists all the producer instances. The first row is the process and the second column provides a link to the top-level fcl file where most of the producer instance names are assigned. The second column gives the names used in lower-level fcl files along with links to those files. The third column gives the names of the producers for the input data. The fourth provides the names of the output data types along with links to the class headers. The last column is the producer class name with a link to its source code.

Reconstruction producers
Nickname Full name(s) Inputs Output types Class
Reco Reco All below
caldata lbne35t_calwire daq (RawDigits) Wire CalWireLBNE10kt_module
gaushit lbne35t_gaushitfinder, gaus_hitfinder caldata Hit GausHitFinder
fasthit lbne35t_fasthitfinder, standard_fasthitfinder caldata Hit RawHitFinder
hitcheat lbne35t_hitcheater, standard_hitcheater caldata, largeant Hit HitCheater
hit35t lbne35t_hitfinder35t gaushit Hit HitFinder35t
fasthitdc lbne35t_disambigcheat, standard_disambigcheat fasthit Hit DisambigCheater
dcheat lbne35t_disambigcheat, standard_disambigcheat gaushit Hit DisambigCheater
dbcluster lbne35t_dbcluster, standard_dbcluster hit35t Cluster DBcluster
dbclusterdc lbne35t_dbcluster, standard_dbcluster dcheat Cluster DBcluster
clustercheat lbne35t_clustercheater, standard_clustercheater hitcheat, largeant Cluster ClusterCheater
costrk lbne35t_cosmictracker, standard_cosmictracker dbcluster SpacePoint, Track CosmicTracker
costrkdc lbne35t_cosmictracker, standard_cosmictracker dbclusterdc SpacePoint, Track CosmicTracker
stitch lbne35t_trackstitcher, standard_trackstitcher costrk Track TrackStitcher
stitchdc lbne35t_trackstitcher, standard_trackstitcher costrkdc Track TrackStitcher
trackcheat lbne35t_trackcheater, standard_trackcheater clustercheat, largeant SpacePoint, Track TrackCheater
calo lbne35t_calomc stitch Calorimetry Calorimetry
calodc lbne35t_calomc stitchdc, mctrutht0dc Calorimetry Calorimetry
pandora lbne35t_pandora hit35t, largeant Cluster, Seed, SpacePoint, PFParticle, Vertex LBNE35tPandora
pandoradc lbne35t_pandora dcheat, largeant Cluster, Seed, SpacePoint, PFParticle, Vertex LBNE35tPandora
particlestitcher lbne35t_particlestitcher pandora PFParticle LBNE35tParticleStitcher
particlestitcherdc lbne35t_particlestitcher pandoradc PFParticle LBNE35tParticleStitcher
particletracks pandora, particlestitcher Track PFParticleTrackMaker
particletracksdc pandoradc, particlestitcherdc Track PFParticleTrackMaker

The producer instance names and mapping to output types were obtained from a data file from the second round of MC production for 35-ton running. The low-level producer names and links between input and output producer names were obtained by (tediously) searching fcl files in the develop branches of larsoft and lbnecode April 21-22 2015.