LBNE Far Detector Software Data Model

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.
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.

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.