Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Oftentimes, steps 1-3 are performed in the same job (process) for efficiency using the EvioToLcio command line utility.

...

Info

The following information on the reconstruction Driver chain

...

Info

The following information is and output collections is current as of February 28, 2016 (Physics Run 2016), but it may become outdated as if the reconstruction changescode is changed (for instance if Drivers or output collections are added or removed). Consult the latest versions of the production reconstruction steering files for the most up to date information.

Reconstruction Drivers 

The reconstruction Driver chain is defined in production steering files such as EngineeringRun2015FullRecon.lcsim, which are kept in this SVN folder and typically accessed as a class resource from a jar file.

 

Driver NameDriver ClassDescription

RfFitter

RfFitterDriverconverts accelerator's RF wave form to time and inserts into event
EcalRunningPedestal

EcalRunningPedestalDriver

calculates per channel running averages for ECal signal pedestals
EcalRawConverterEcalRawConverterDriverconverts ECal digits to CalorimeterHit collection with energy and time measurements
ReconClustererReconClusterDriverperforms calorimeter clustering algorithm on ECal hits
CopyCollectionCopyClusterCollectionDrivercopies calorimeter clusters to new collection to preserve uncorrected energy measurements
RawTrackerHitSensorSetupRawTrackerHitSensorSetupassigns RawTrackerHits to their sensors for use by track recon
RawTrackerHitFitterDriverRawTrackerHitFitterDriverfits ADC vs time signal to produce fitted hits collection
TrackerHitDriverDataTrackerHitDrivercreates stereo pairs from from SVT strip hits
HelicalTrackHitDriverHelicalTrackHitDrivercreates 3D hits from clusters of stereo pairs
TrackReconSeed345Conf2Extd16TrackerReconDriverruns track finding using layers 3, 4 & 5 as a seed, layer 2 to confirm, and layers 1 and 6 to extend
TrackReconSeed456Conf3Extd21TrackerReconDriverruns track finding using layers 4, 5 & 6 as a seed, layer 3 to confirm, and layers 2 and 1 to extend
TrackReconSeed123Conf4Extd56TrackerReconDriverruns track finding using layers 1, 2 & 3 as a seed, layer 4 to confirm, and layers 5 and 6 to extend
TrackReconSeed123Conf5Extd46TrackerReconDriverruns track finding using layers 1, 2 & 3 as a seed, layer 5 to confirm, and layers 4 and 6 to extend
MergeTrackCollectionsMergeTrackCollectionsmerge collections from track finding into single output collection
GBLRefitterDriverGBLRefitterDriverperforms GBL track refit
TrackDataDriverTrackDataDriveradds additional collections containing track information to output event
ReconParticleDriverHpsReconParticleDriver

creates output reconstructed particle collection, associating tracks with clusters

also performs vertex reconstruction

LCIOWriterLCIODriverwrites output LCIO file
CleanupDriverReadoutCleanupDrivercleanup readout state for next event (clears assignments of SVT raw hits to sensors)
AidaSaveDriverAidaSaveDriversaves AIDA plots to file at end of job

...

CollectionJava ClassCreated ByDescription
BeamspotConstrainedMollerCandidatesReconstructedParticleHpsReconParticleDriver

Møller candidate particles required to point back to beamspot at the target

BeamspotConstrainedMollerVerticesVertexHpsReconParticleDriverMøller vertices required to point back to beamspot at the target
BeamspotConstraintedV0CandidatesReconstructedParticleHpsReconParticleDriverelectron-positron candidate particles required to point back to beamspot at the target
BeamspotConstraintedV0VerticesVertexHpsReconParticleDriverelectron-positron vertices required to point back to beamspot at the target
EcalCalHitsCalorimeterHitEcalRawConverterDrivercalibrated ECal Hits
EcalClustersClusterReconClusterDriverreconstructed ECal clusters with uncorrected energies
EcalClustersCorrClusterCopyClusterCollectionDriver

reconstructed ECal clusters with corrected energies

copied from EcalClusters and then updated 

EcalReadoutHitsRawTrackerHitEcalEvioReaderECal Hits in ADC counts 
EpicsDataGenericObjectLCSimEngRunEventBuilderEPICS data banks
FADCGenericHitsGenericObject EcalEvioReaderadditional FADC readout information 
FinalStateParticlesReconstructedParticleHpsReconParticleDriverfinal state particles (electrons, positrons, photons) with 4-momenta
GBLKinkDataGenericObjectGBLRefitterDriver  extra GBL track kink data
GBLKinkDataRelationsLCRelationGBLRefitterDriver  relation from GBLTracks to GBLKinkData
GBLTracksTrack GBLRefitterDrivertracks created from GBL refit 
HelicalTrackHitRelationsLCRelationHelicalTrackHitDriver relation from HelicalTrackHits to StripClusterer_SiTrackerHitStrip1D
HelicalTrackHitsTrackerHitHelicalTrackHitDriver3D hits combining StripClusterer_SiTrackerHitStrip1D hits in axial/stereo layers
MatchedToGBLTrackRelationsLCRelation  relation from MatchedTracks to GBLTracks
MatchedTracksTrackTrackerReconDriver

primary collection of reconstructed tracks

merged from collections with tracks generated from different strategies

PartialTracksTrack MergeTrackCollectionscollection of tracks which have a set of hits that are a strict subset of another track 
RotatedHelicalTrackHitRelationsLCRelationHelicalTrackHitDriver relation from RotatedHelicalTrackHit to HelicalTrackHit
RotatedHelicalTrackHitsTrackerHitHelicalTrackHitDriver 

HelicalTrackHits rotated into SeedTracker tracking frame: xy, yz, zx

SVTFittedRawTrackerHitsLCRelationRawTrackerHitFitterDriverrelation from SVTRawTrackerHits to SVTShapeFitParameters
SVTRawTrackerHitsRawTrackerHitSvtEvioReaderSi sensor single strip hits
SVTShapeFitParametersGenericObjectRawTrackerHitFitterDriverresults of the ADC vs sample number fits for SVT data
StripClusterer_SiTrackerHitStrip1DTrackerHitDataTrackerHitDriver1D Si strip clusters
TargetConstrainedMollerCandidatesReconstructedParticle HpsReconParticleDriverMøller candidate particles with the vertex z fixed to the target position and (x,y) constrained to beamspot 
TargetConstrainedMollerVerticesVertex HpsReconParticleDriverMøller vertices with the vertex z fixed to the target position and (x,y) constrained to beamspot 
TargetConstrainedV0CandidatesReconstructedParticleHpsReconParticleDriverelectron-positron pairs with the vertex z fixed to the target position and (x,y) constrained to beamspot
TargetConstrainedV0VerticesVertexHpsReconParticleDriver electron-positron vertices with the vertex z fixed to the target position and (x,y) constrained to beamspot
TrackDataGenericObject  
TrackDataRelationsLCRelation  
TrackResidualsGenericObject  
TrackResidualsRelationsLCRelation  
TriggerBankGenericObjectLCSimEngRunEventBuildertrigger information for the event
UnconstrainedMollerCandidatesReconstructedParticleHpsReconParticleDriver 
UnconstrainedMollerVerticesVertexHpsReconParticleDriver 
UnconstrainedV0CandidatesReconstructedParticleHpsReconParticleDriverelectron-positron pairs with unconstrained vertex
UnconstrainedV0VerticesVertexHpsReconParticleDriver 

...