Difference between revisions of "LBNE Far Detector Software Data Model"

From DUNE
Jump to navigation Jump to search
 
(38 intermediate revisions by 2 users not shown)
Line 1: Line 1:
This page documents D. Adams attempts to understand the LBNE EDM (event data model), i.e. the classes describing the data share by modules via the event data store and written to event data files.
+
----
 +
----
 +
----
 +
----
 +
==<span style="background:yellow">This page has moved to the [https://wiki.dunescience.org/wiki/Far_Detector_Software_Data_Model DUNE Wiki]</span>==
 +
----
 +
----
 +
----
 +
----
  
== Simulation ==
+
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.
 
The following table lists the EDM classes used in the simulation.
 
{| class="wikitable" style="text-align:left;"
 
{| class="wikitable" style="text-align:left;"
 
! Class !! Location !! Description
 
! Class !! Location !! Description
 
|-
 
|-
| MCTruth || nutools/SimulationBase || ID, PDG ID, status code and starting and ending position and momentum for each input MC particle
+
| [https://cdcvs.fnal.gov/redmine/projects/nusoftart/repository/entry/trunk/nutools/SimulationBase/MCTruth.h MCTruth] || [https://cdcvs.fnal.gov/redmine/projects/nusoftart/repository/entry/trunk/nutools/SimulationBase nutools/SimulationBase] || ID, PDG ID, status code and starting and ending position and momentum for each input MC particle
 +
|-
 +
| [https://cdcvs.fnal.gov/redmine/projects/nusoftart/repository/entry/trunk/nutools/SimulationBase/MCParticle.h MCParticle] || [https://cdcvs.fnal.gov/redmine/projects/nusoftart/repository/entry/trunk/nutools/SimulationBase nutools/SimulationBase] || ID, PDG ID, status code and trajectory (position and momentum) for each MC particle
 +
|-
 +
| [https://cdcvs.fnal.gov/redmine/projects/larsim/repository/revisions/master/entry/Simulation/SimChannel.h SimChannel] || [https://cdcvs.fnal.gov/redmine/projects/larsim/repository/revisions/master/entry/Simulation larsim/Simulation] || Energy deposited by each MC particle in the LAr volume (voxel) for each readout channel
 
|-
 
|-
| MCParticle || nutools/SimulationBase || ID, PDG ID, status code and starting and ending positions and momenta for each MC particle
+
| [https://cdcvs.fnal.gov/redmine/projects/larsim/repository/revisions/master/entry/Simulation/SimPhotons.h OnePhoton] || [https://cdcvs.fnal.gov/redmine/projects/larsim/repository/revisions/master/entry/Simulation larsim/Simulation] || Electronics response in a single optical channel readout window. Potentially many separate optical detector readout windows per TPC readout window.
 
|-
 
|-
| SimChannel || larsim/Simulation     || Energy deposited by each MC particle in the volume for each readout channel
+
| [https://cdcvs.fnal.gov/redmine/projects/larsim/repository/revisions/master/entry/Simulation/SimPhotons.h SimPhotons] || [https://cdcvs.fnal.gov/redmine/projects/larsim/repository/revisions/master/entry/Simulation larsim/Simulation] || A collection of OnePhoton objects for a particular optical detector.
 +
|-
 +
| [https://cdcvs.fnal.gov/redmine/projects/larsim/repository/revisions/master/entry/Simulation/SimPhotons.h SimPhotonsLite] || [https://cdcvs.fnal.gov/redmine/projects/larsim/repository/revisions/master/entry/Simulation larsim/Simulation] || The number of photons on each optical detector based on PhotonLibrary lookup.
 
|}
 
|}
  
== Reconstruction ==
+
== Reconstruction data classes ==
  
 
The following table lists the EDM classes used in the reconstruction.
 
The following table lists the EDM classes used in the reconstruction.
Line 19: Line 37:
 
! Class !! Location !! Description
 
! Class !! Location !! Description
 
|-
 
|-
| RawDigit || lardata/RawData || Raw (convoluted) ADC signals in time slices. Unpack with raw::Decompress in RawData/raw.h
+
| [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RawData/RawDigit.h RawDigit] || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RawData lardata/RawData] || Raw (convoluted) ADC signals in time slices. Unpack with raw::Decompress in [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RawData/raw.h RawData/raw.h]
 
|-
 
|-
| Wire || lardata/RecoBase || Deconvoluted signal for each channel.
+
| [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/Wire.h Wire] || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase lardata/RecoBase] || Deconvoluted signal for each channel.
 
|-
 
|-
| Hit || lardata/RecoBase || Peaks on wire signals.
+
| [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/Hit.h Hit] || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase lardata/RecoBase] || Peaks on wire signals.
 
|-
 
|-
| Cluster || lardata/RecoBase || Associated hits in a TPC plane, i.e. 2D tracks. Association to hit.
+
| [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/Cluster.h Cluster] || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase 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.
+
| [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/SpacePoint.h SpacePoint] || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase 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
+
| [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/Track.h Track] || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase lardata/RecoBase] || Trajectory with momentum. Association to space point, hit, cluster
 
|-
 
|-
| PFParticle || lardata/RecoBase || Reconstructed particle? Association to cluster, space point, track, seed, vertex.
+
| [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/AnalysisBase/T0.h T0] || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase lardata/AnalysisBase] || Time offset.
 
|-
 
|-
| Seed || lardata/RecoBase || Space point with direction. Used by Pandora.
+
| [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/PFParticle.h PFParticle] || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase lardata/RecoBase] || Particle-flow description of a particle. Used by Pandora.
 
|-
 
|-
| Vertex || lardata/RecoBase || Vertex position. Association with PFParticle. Used by Pandora.
+
| [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/Vertex.h Vertex] || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase lardata/RecoBase] || Vertex position. Association with PFParticle. Used by Pandora.
 +
|-
 +
| [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/AnalysisBase/Calorimetry.h Calorimetry] || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/AnalysisBase lardata/AnalysisBase] || Vertex position. Association with PFParticle. Used by Pandora.
 +
|-
 +
| [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/changes/RawData/OpDetWaveform.h?rev=master OpDetWaveform] || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RawData lardata/RawData] || Electronics response in a single optical channel readout window. Potentially many separate optical detector readout windows per TPC readout window.
 +
|-
 +
| [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/changes/RecoBase/OpHit.h?rev=master OpHit] || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase lardata/RecoBase] || A reconstructed signal on a single optical channel.
 +
|-
 +
| [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/changes/RecoBase/OpFlash.h?rev=master OpFlash] || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase lardata/RecoBase] || A reconstructed single source of light in the detector made up of OpHits coincident in time.
 
|}
 
|}
 
Plans to update the reconstruction model are described in a [http://lbne2-docdb.fnal.gov:8080/cgi-bin/RetrieveFile?docid=10187&filename=20150112-Petrillo.pdf&version=3 talk by Gianluca].
 
Plans to update the reconstruction model are described in a [http://lbne2-docdb.fnal.gov:8080/cgi-bin/RetrieveFile?docid=10187&filename=20150112-Petrillo.pdf&version=3 talk by Gianluca].
  
== Code browsing ==
+
[[LBNE_code_repositories | LBNE code repositories and their browsers]]
  
{| class="wikitable" style="text-align:left;"
+
== Reconstruction of Monte Carlo for the LBNE 35 ton prototype ==
|+ DUNE
+
 
! Repository !!  !!
+
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.
|-
+
 
| lbnecode || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/show Redmine] || || [ssh://p-larcore@cdcvs.fnal.gov/cvs/projects/lbnecode git]
+
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.
|}
+
 
 +
=== MCC3 ===
 +
 
 +
Top-level fcl file is [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/v04_12_00/entry/fcl/lbne35t/reco/standard_reco_lbne35t.fcl lbnecode/fcl/lbne35t/standard_reco_lbne35t.fcl].
 +
(On atlassw9, see /home/dladams/tmp/lbnecode/lbnecode/fcl/lbne35t/reco.)
  
 
{| class="wikitable" style="text-align:left;"
 
{| class="wikitable" style="text-align:left;"
|+ LArSoft
+
|+ Reconstruction chains without pandora
! Repository !! !!
+
! Path                !! Wire    !! Hit            !! Cluster      !! Track, SpacePoint        !! T0        !! Calorimetry(?)
 
|-
 
|-
| larsoft || [https://cdcvs.fnal.gov/redmine/projects/larsoft/repository?rev=master Redmine] || [http://cdcvs.fnal.gov/lxr/larsoft/index.html LXR]
+
| Standard (no cheat) || caldata || gaushit, hit35t || linecluster    || costrk  || costrk    || mctrutht0 || calo
 
|-
 
|-
| larcore || [https://cdcvs.fnal.gov/redmine/projects/larcore/repository?rev=master Redmine] || [http://cdcvs.fnal.gov/lxr/larcore/index.html LXR]
+
| Standard full cheat || caldata || hitcheat        || clustercheat || trackcheat        ||                    ||          ||   
 
|-
 
|-
| lardata || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository?rev=master Redmine] || [http://cdcvs.fnal.gov/lxr/lardata/index.html LXR]
+
| Standard with disambiguation cheat || caldata || gaushit, dcheat  || lineclusterdc  || costrkdc || mctrutht0dc || calodc
 
|-
 
|-
| larevt || [https://cdcvs.fnal.gov/redmine/projects/larevt/repository?rev=master Redmine] || [http://cdcvs.fnal.gov/lxr/larevt/index.html LXR]
+
|}
 +
 
 +
More to come....
 +
 
 +
=== MCC2 ===
 +
 
 +
{| class="wikitable" style="text-align:left;"
 +
|+ Reconstruction chains without pandora
 +
! Path                !! Wire    !! Hit      !! Cluster      !! Track, SpacePoint        !! Calorimetry(?)
 
|-
 
|-
| larsim || [https://cdcvs.fnal.gov/redmine/projects/larsim/repository?rev=master Redmine] || [http://cdcvs.fnal.gov/lxr/larsim/index.html LXR]
+
| Standard (no cheat) || caldata || gaushit, hit35t || dbcluster, linecluster    || costrk, stitch  || calo
 
|-
 
|-
| larreco || [https://cdcvs.fnal.gov/redmine/projects/larreco/repository?rev=master Redmine] || [http://cdcvs.fnal.gov/lxr/larreco/index.html LXR]
+
| Standard full cheat || caldata || hitcheat        || clustercheat || trackcheat        ||                    ||
 
|-
 
|-
| larana || [https://cdcvs.fnal.gov/redmine/projects/larana/repository?rev=master Redmine] || [http://cdcvs.fnal.gov/lxr/larana/index.html LXR]
+
| Standard with disambiguation cheat || caldata || gaushit, dcheat  || dbclusterdc, lineclusterdc  || costrkdc || costrkdc, stitchdc || calodc
|-
 
| ... || || |
 
 
|-
 
|-
 +
| Fast hit finding plus disambiguation cheat    || caldata || fasthit, fasthitdc ||    || || ||
 
|}
 
|}
  
 
{| class="wikitable" style="text-align:left;"
 
{| class="wikitable" style="text-align:left;"
|+ Supporting products
+
|+ Reconstruction chains with pandora
! Repository !! !!
+
! Path                !! Wire    !! Hit      !! Cluster, See, SpacePoint, PFParticle, Vertex !! PFParticle !! Track
 
|-
 
|-
| art || [https://cdcvs.fnal.gov/redmine/projects/art/repository/revisions/master/show/art?rev=master Redmine] || [http://cdcvs.fnal.gov/lxr/art/index.html LXR]
+
| No cheat            || caldata || gaushit, hit35t || pandora  || particlestitcher || particletracks
 
|-
 
|-
| nutools || [https://cdcvs.fnal.gov/redmine/projects/nusoftart/repository/show/trunk/nutools Redmine] ||
+
| Disambiguation cheat || caldata || gaushit, dcheat || pandoradc || particlestitcherdc || particletracksdc
 
|}
 
|}
  
For more LArSoft links, see the [https://cdcvs.fnal.gov/redmine/projects/larsoft/wiki/_The_Fermilab_core_LArSoft_installation_ LArSoft core installation page].
+
=== Producers ===
  
== Monte Carlo Production for 35 ton ==
+
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.
 
 
This section is under construction.
 
 
 
The above data model is used for the MC (Monte Carlo) samples produced for the 35-ton prototype detector. Five different reconstruction paths are followed: standard reconstruction without use of MC, with full cheat that makes extensive use of MC information and half-cheat that uses MC only to resolve TPC ambiguities. In addition, Pandora is run in standard and half-cheat modes. The following table lists the names of the producers for these reconstruction paths and the types of data products they produce. The name and type can be used to retrieve each data product.
 
  
 
{| class="wikitable" style="text-align:left;"
 
{| class="wikitable" style="text-align:left;"
|+ Reconstruction chains
+
|+ Reconstruction producers
! Path                !! Wire    !! Hit      !! Cluster      !! Track            !! SpacePoint        !! Calorimetry(?)  
+
! Nickname !! Full name(s)          !! Inputs          !! Output types || Class 
 +
|-
 +
| Reco    || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/fcl/lbne35t/reco/standard_reco_lbne35t.fcl Reco] || All below ||
 +
|-
 +
| caldata  || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/CalData/caldata_lbne.fcl lbne35t_calwire] || daq (RawDigits) || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/Wire.h Wire] || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/CalData/CalWireLBNE10kt_module.cc CalWireLBNE10kt_module]
 +
|-
 +
| gaushit  || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/HitFinderLBNE/hitfindermodules_lbne.fcl lbne35t_gaushitfinder], [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/HitFinder/hitfindermodules.fcl gaus_hitfinder] || caldata || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/Hit.h Hit] || [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/HitFinder/GausHitFinder_module.cc GausHitFinder]
 +
|-
 +
| fasthit  || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/HitFinderLBNE/hitfindermodules_lbne.fcl lbne35t_fasthitfinder], [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/HitFinder/hitfindermodules.fcl standard_fasthitfinder] || caldata || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/Hit.h Hit] || [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/HitFinder/RawHitFinder_module.cc RawHitFinder]
 +
|-
 +
| hitcheat || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/HitFinderLBNE/hitfindermodules_lbne.fcl lbne35t_hitcheater], [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/HitFinder/hitfindermodules.fcl standard_hitcheater]  || caldata, largeant|| [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/Hit.h Hit] || [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/HitFinder/HitCheater_module.cc HitCheater]
 +
|-
 +
| hit35t  || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/HitFinderLBNE/hitfindermodules_lbne.fcl lbne35t_hitfinder35t] || gaushit || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/Hit.h Hit] || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/HitFinderLBNE/HitFinder35t_module.cc HitFinder35t]
 +
|-
 +
| fasthitdc || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/HitFinderLBNE/hitfindermodules_lbne.fcl lbne35t_disambigcheat], [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/HitFinderLBNE/hitfindermodules_lbne.fcl standard_disambigcheat] || fasthit || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/Hit.h Hit] || [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/HitFinder/DisambigCheater_module.cc DisambigCheater]
 +
|-
 +
| dcheat  ||  [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/HitFinderLBNE/hitfindermodules_lbne.fcl lbne35t_disambigcheat],  [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/HitFinderLBNE/hitfindermodules_lbne.fcl standard_disambigcheat] || gaushit || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/Hit.h Hit] || [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/HitFinder/DisambigCheater_module.cc DisambigCheater]
 +
|-
 +
| linecluster || [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/ClusterFinder/cluster_lbne.fcl lbne35t_linecluster], [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/ClusterFinder/clustermodules.fcl standard_linecluster] || || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/Cluster.h Cluster] || [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/ClusterFinder/LineCluster_module.cc LineCluster] || Cluster crawler. New in MCC3.
 +
|-
 +
| dbcluster || [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/ClusterFinder/cluster_lbne.fcl lbne35t_dbcluster], [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/ClusterFinder/clustermodules.fcl standard_dbcluster] || hit35t || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/Cluster.h Cluster] || [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/ClusterFinder/DBcluster_module.cc DBcluster]
 +
|-
 +
| dbclusterdc || [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/ClusterFinder/cluster_lbne.fcl lbne35t_dbcluster], [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/ClusterFinder/clustermodules.fcl standard_dbcluster] || dcheat || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/Cluster.h Cluster] || [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/ClusterFinder/DBcluster_module.cc DBcluster]
 
|-
 
|-
| Standard (no cheat) || caldata || gaushit, hit35t || fuzzy        || (kalmanhit)      ||                   ||
+
| clustercheat || [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/ClusterFinder/cluster_lbne.fcl lbne35t_clustercheater], [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/ClusterFinder/clustermodules.fcl standard_clustercheater] || hitcheat, largeant || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/Cluster.h Cluster] || [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/ClusterFinder/ClusterCheater_module.cc ClusterCheater]
 
|-
 
|-
| Standard (no cheat) ||        || gaushit, hit35t || dbcluster   || costrk, stitch    || costrk, stitch    || calo
+
| costrk || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/TrackFinderLBNE/trackfindermodules_lbne.fcl lbne35t_cosmictracker], [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/TrackFinder/trackfindermodules.fcl standard_cosmictracker] || dbcluster || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/SpacePoint.h SpacePoint], [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/Track.h Track] || [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/TrackFinder/CosmicTracker_module.cc CosmicTracker ]
 
|-
 
|-
| Standard full cheat ||         || hitcheat        || clustercheat || trackcheat        ||                    ||
+
| costrkdc || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/TrackFinderLBNE/trackfindermodules_lbne.fcl lbne35t_cosmictracker], [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/TrackFinder/trackfindermodules.fcl standard_cosmictracker] || dbclusterdc || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/SpacePoint.h SpacePoint], [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/Track.h Track] || [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/TrackFinder/CosmicTracker_module.cc CosmicTracker ]
 
|-
 
|-
| Standard half cheat ||         || dcheat  || fuzzydc      ||                  ||                    ||
+
| stitch || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/TrackFinderLBNE/trackfindermodules_lbne.fcl lbne35t_trackstitcher], [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/TrackFinder/trackfindermodules.fcl standard_trackstitcher] || costrk || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/Track.h Track] || [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/TrackFinder/TrackStitcher_module.cc TrackStitcher ]
 
|-
 
|-
| Standard half cheat ||         || dcheat  || dbclusterdc  || costrkdc, stitchdc || costrkdc, stitchdc || calodc
+
| stitchdc || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/TrackFinderLBNE/trackfindermodules_lbne.fcl lbne35t_trackstitcher], [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/TrackFinder/trackfindermodules.fcl standard_trackstitcher] || costrkdc || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/Track.h Track] || [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/TrackFinder/TrackStitcher_module.cc TrackStitcher ]
 
|-
 
|-
| Another half cheat? ||         || fasthit, fasthitdc ||   || || ||
+
| trackcheat || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/TrackFinderLBNE/trackfindermodules_lbne.fcl lbne35t_trackcheater], [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/TrackFinder/trackfindermodules.fcl standard_trackcheater] || clustercheat, largeant || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/SpacePoint.h SpacePoint], [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/Track.h Track] || [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/TrackFinder/TrackCheater_module.cc TrackCheater]
|}
 
 
 
{| class="wikitable" style="text-align:left;"
 
|+ Reconstruction producers
 
! Nickname !! Full name(s)          !! Inputs          !! Output types 
 
 
|-
 
|-
| Reco    || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/fcl/lbne35t/reco/standard_reco_lbne35t.fcl Reco] || All below
+
| mctrutht0 || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/TrackMatching/mctrutht0matching.fcl lbne35t_mctrutht0matching] || costrk || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/AnalysisBase/T0.h T0] || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/TrackMatching/MCTruthT0Matching_module.cc MCTruthT0Matching]
 
|-
 
|-
| caldata  || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/CalData/caldata_lbne.fcl lbne35t_calwire] || daq (RawDigits) || Wire
+
| calo || [https://cdcvs.fnal.gov/redmine/projects/larana/repository/revisions/master/entry/Calorimetry/calorimetry_lbne35t.fcl lbne35t_calomc] || stitch || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/AnalysisBase/Calorimetry.h Calorimetry] || [https://cdcvs.fnal.gov/redmine/projects/larana/repository/revisions/master/entry/Calorimetry/Calorimetry_module.cc Calorimetry ]
 
|-
 
|-
| gaushit  || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/HitFinderLBNE/hitfindermodules_lbne.fcl lbne35t_gaushitfinder], [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/HitFinder/hitfindermodules.fcl gaus_hitfinder] || caldata || Hit
+
| calodc || [https://cdcvs.fnal.gov/redmine/projects/larana/repository/revisions/master/entry/Calorimetry/calorimetry_lbne35t.fcl lbne35t_calomc] || stitchdc, mctrutht0dc || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/AnalysisBase/Calorimetry.h Calorimetry] || [https://cdcvs.fnal.gov/redmine/projects/larana/repository/revisions/master/entry/Calorimetry/Calorimetry_module.cc Calorimetry ]
 
|-
 
|-
| fasthit  || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/HitFinderLBNE/hitfindermodules_lbne.fcl lbne35t_fasthitfinder], [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/HitFinder/hitfindermodules.fcl standard_fasthitfinder] || caldata || Hit
+
| pandora || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/LBNEPandora/pandoramodules_lbne.fcl lbne35t_pandora] || hit35t, largeant || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/Cluster.h Cluster], [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/Seed.h Seed], [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/SpacePoint.h SpacePoint], [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/PFParticle.h PFParticle], [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/Vertex.h Vertex] || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/LBNEPandora/LBNE35tPandora_module.cc LBNE35tPandora]
 
|-
 
|-
| hitcheat || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/HitFinderLBNE/hitfindermodules_lbne.fcl lbne35t_hitcheater], [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/HitFinder/hitfindermodules.fcl standard_hitcheater] || caldata, largeant|| Hit
+
| pandoradc || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/LBNEPandora/pandoramodules_lbne.fcl lbne35t_pandora] || dcheat, largeant || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/Cluster.h Cluster], [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/Seed.h Seed], [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/SpacePoint.h SpacePoint], [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/PFParticle.h PFParticle], [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/Vertex.h Vertex] || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/LBNEPandora/LBNE35tPandora_module.cc LBNE35tPandora ]
 
|-
 
|-
| hit35t  || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/HitFinderLBNE/hitfindermodules_lbne.fcl lbne35t_hitfinder35t] || gaushit || Hit
+
| particlestitcher || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/LBNEPandora/pandoramodules_lbne.fcl lbne35t_particlestitcher] || pandora || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/PFParticle.h PFParticle] || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/LBNEPandora/LBNE35tParticleStitcher_module.cc LBNE35tParticleStitcher]
 
|-
 
|-
| fasthitdc || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/HitFinderLBNE/hitfindermodules_lbne.fcl lbne35t_disambigcheat], [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/HitFinderLBNE/hitfindermodules_lbne.fcl standard_disambigcheat] || fasthit || Hit
+
| particlestitcherdc || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/LBNEPandora/pandoramodules_lbne.fcl lbne35t_particlestitcher] || pandoradc || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/PFParticle.h PFParticle] || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/LBNEPandora/LBNE35tParticleStitcher_module.cc LBNE35tParticleStitcher]
 
|-
 
|-
| dcheat  || [https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/HitFinderLBNE/hitfindermodules_lbne.fcl lbne35t_disambigcheat][https://cdcvs.fnal.gov/redmine/projects/lbnecode/repository/revisions/master/entry/lbne/HitFinderLBNE/hitfindermodules_lbne.fcl standard_disambigcheat] || gaushit || Hit
+
| particletracks || || pandora, particlestitcher || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/Track.h Track] || [https://cdcvs.fnal.gov/redmine/projects/larpandora/repository/revisions/master/entry/LArPandoraInterface/PFParticleTrackMaker_module.cc PFParticleTrackMaker]
 
|-
 
|-
| dbcluster || [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/ClusterFinder/cluster_lbne.fcl lbne35t_dbcluster], [https://cdcvs.fnal.gov/redmine/projects/larreco/repository/revisions/master/entry/ClusterFinder/clustermodules.fcl standard_dbcluster] || hit35t || Cluster
+
| particletracksdc || || pandoradc, particlestitcherdc || [https://cdcvs.fnal.gov/redmine/projects/lardata/repository/revisions/master/entry/RecoBase/Track.h Track] || [https://cdcvs.fnal.gov/redmine/projects/larpandora/repository/revisions/master/entry/LArPandoraInterface/PFParticleTrackMaker_module.cc 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.

Latest revision as of 14:08, 12 December 2017





This page has moved to the DUNE Wiki





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 trajectory (position and momentum) 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
T0 lardata/AnalysisBase Time offset.
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.
OpDetWaveform lardata/RawData Electronics response in a single optical channel readout window. Potentially many separate optical detector readout windows per TPC readout window.
OpHit lardata/RecoBase A reconstructed signal on a single optical channel.
OpFlash lardata/RecoBase A reconstructed single source of light in the detector made up of OpHits coincident in time.

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.

MCC3

Top-level fcl file is lbnecode/fcl/lbne35t/standard_reco_lbne35t.fcl. (On atlassw9, see /home/dladams/tmp/lbnecode/lbnecode/fcl/lbne35t/reco.)

Reconstruction chains without pandora
Path Wire Hit Cluster Track, SpacePoint T0 Calorimetry(?)
Standard (no cheat) caldata gaushit, hit35t linecluster costrk costrk mctrutht0 calo
Standard full cheat caldata hitcheat clustercheat trackcheat
Standard with disambiguation cheat caldata gaushit, dcheat lineclusterdc costrkdc mctrutht0dc calodc

More to come....

MCC2

Reconstruction chains without pandora
Path Wire Hit Cluster Track, SpacePoint Calorimetry(?)
Standard (no cheat) caldata gaushit, hit35t dbcluster, linecluster costrk, stitch calo
Standard full cheat caldata hitcheat clustercheat trackcheat
Standard with disambiguation cheat caldata gaushit, dcheat dbclusterdc, lineclusterdc costrkdc 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

Producers

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
linecluster lbne35t_linecluster, standard_linecluster Cluster LineCluster Cluster crawler. New in MCC3.
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
mctrutht0 lbne35t_mctrutht0matching costrk T0 MCTruthT0Matching
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.