Versions Compared

Key

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

...

The reconstruction is implemented within the HPS Java project as a chain of org.lcsim Drivers (event processors) described by lcsim xml and run by the lcsim job manager.  The EvioToLcio command line tool is used to convert the EVIO to LCIO events using an LCSimEventBuilder such as LCSimEngRunEventBuilder.  The LCIO events are accessed in Java code through the EventHeader API.  The Drivers add output collections to the event such as tracks, calorimeter clusters, reconstructed particles and vertices.  The combined data/physics LCIO events are written out to an LCIO file, which can subsequently be converted to ROOT DST Data Format.  The LCIO events may also be loaded back into the HPS Java environment for analysis.  

Basic Steps

These are the steps performed in reconstructing the data:

  1. EvioToLcio command line tool is run with command line parameters like the EVIO file(s) and the path to the XML steering file.
  2. The JobControlManager loads the steering file which defines the chain of reconstruction Drivers and their parameters.
  3. Detector Conditions including per channel calibrations are read and applied in Driver detectorChanged methods.
  4. Each EvioEvent is read with EvioReader and converted to an LCIO raw data event using an appropriate LCSimEventBuilder.
  5. The HPS Java reconstruction runs on the LCIO event, adding additional reconstruction collections to the events.
  6. The events are written to an LCIO file containing the results of the recon.
  7. The output LCIO file is converted to ROOT DST Data Format for analysis.

Steps 1-7 6 are typically performed in the same job using the EvioToLcio command line utility.

...

OrderDriver NameDriver ClassDescription
1

RfFitter

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

EcalRunningPedestalDriver

calculates per channel running averages for ECal signal pedestals
3EcalRawConverterEcalRawConverterDriverconverts ECal digits to CalorimeterHit collection with energy and time measurements
4ReconClustererReconClusterDriverperforms calorimeter clustering algorithm on ECal hits
5CopyCollectionCopyClusterCollectionDrivercopies calorimeter clusters to new collection to preserve uncorrected energy measurements
6RawTrackerHitSensorSetupRawTrackerHitSensorSetupassigns RawTrackerHits to their sensors for use by track recon
7RawTrackerHitFitterDriverRawTrackerHitFitterDriverfits ADC vs time signal and stores the results, associated to the each raw hit
8TrackerHitDriverDataTrackerHitDrivercreates stereo pairs from SVT strip hits
9HelicalTrackHitDriverHelicalTrackHitDrivercreates 3D hit clusters from stereo pairs
10TrackReconSeed345Conf2Extd16TrackerReconDrivertrack finding using layers 3, 4 & 5 as a seed, layer 2 to confirm, and layers 1 and 6 to extend
11TrackReconSeed456Conf3Extd21TrackerReconDrivertrack finding using layers 4, 5 & 6 as a seed, layer 3 to confirm, and layers 2 and 1 to extend
12TrackReconSeed123Conf4Extd56TrackerReconDrivertrack finding using layers 1, 2 & 3 as a seed, layer 4 to confirm, and layers 5 and 6 to extend
13TrackReconSeed123Conf5Extd46TrackerReconDrivertrack finding using layers 1, 2 & 3 as a seed, layer 5 to confirm, and layers 4 and 6 to extend
14MergeTrackCollectionsMergeTrackCollectionsmerges collections from track finding into a single output collection
15GBLRefitterDriverGBLRefitterDriverperforms GBL track refit
16TrackDataDriverTrackDataDriveradds additional collections containing track information to the output event
17ReconParticleDriverHpsReconParticleDriver

creates output reconstructed particle collections, associating tracks with clusters

also performs vertex reconstruction and creates vertex collection

18LCIOWriterLCIODriverwrites output LCIO file
19CleanupDriverReadoutCleanupDrivercleans up readout state for next event (clears assignments of SVT raw hits to sensors)

...

HPS Java Reconstruction Packages

The  The HPS Java Documentation can be used to browse the packages and classes used for physics reconstruction.

...