Page History

Table of Contents

Basic Recipe

This is the basic recipe for reconstructing HPS data:

1. EVIO data files are converted to LCIO events using the EvioToLcio command line utility (if you have an LCIO file you don't need to do this).
2. The HPS Java reconstruction is run to produce physics object collections.
3. The recon LCIO is converted to ROOT DST Data Format so that the events can be easily analyzed in ROOT.

Oftentimes, the physics reconstruction is performed in the same job (process) as the conversion from raw data to LCIO for efficiency, typically using the EvioToLcio command line utility.

Overview

The HPS physics reconstruction is implemented in the HPS Java project as a chain of org.lcsim Drivers which process LCIO Data Format events that are accessed using the EventHeader API.  The driver list is described in an lcsim xml steering file which configures the lcsim job manager.  A driver is simply an event processing component that operates on each event in a record processing loop and may add new object collections to the event.  For example, a driver might convert ADC data to a hit class object or it could perform track finding and create new track object collections.  

Before the drivers can process the data, it must be converted from the EVIO Data Format written by the DAQ.  The EvioToLcio command line tool reads EvioEvents using an EvioReader and these are converted into LCIO events by an LCSimEventBuilder such as LCSimEngRunEventBuilder.  The driver chain is then run to perform the physics reconstruction which will add additional object collections to the event.  The combined events with the data and recon collections are written out to an LCIO filesfile.  The LCIO output can be converted to ROOT DST Data Format for ROOT compatibility, or it may be loaded back into HPS Java for analysis. 

Basic Recipe

This is the basic recipe for reconstructing HPS data:

1. EVIO data files are converted to LCIO events using the EvioToLcio command line utility (if you have an LCIO file you don't need to do this).
2. The HPS Java reconstruction is run to produce physics object collections.
3. The recon LCIO is converted to ROOT DST Data Format so that the events can be easily analyzed in ROOT.

Oftentimes, the physics reconstruction is performed in the same job (process) as the conversion from raw data to LCIO for efficiency, typically using the EvioToLcio command line utility.

Data Conversion

The EvioToLcio utility converts EVIO to LCIO using an LCSimEventBuilder implementation such as LCSimEngRunEventBuilder.  The generated LCIO events are then optionally written to disk using an LCIODriver.  The physics reconstruction may also be run in the same process for efficiency.

...

The default builder will also convert and write DAQ config  information, EPICS data, and scaler bank data into the output LCSim events, if these banks are present in the EVIO data.

Track Reconstruction

These are the steps in the HPS Java track reconstruction:

...

The tracking packages in lcsim form the basis for HPS's tracking algorithms through usage and extension.  Seed Tracker is used for track finding using a set of input tracking strategies.  The track fit from lcsim is further refined using a Java implementation (port) of the GBL C++ algorithm. 

ECal Reconstruction

These are the basic steps of the ECal reconstruction:

...

The copied collection will be updated with corrected energies in the next step which creates recon particles.

Reconstructed Particles

The ReconParticleDriver creates ReconstructedParticle objects representing the final state particles from the event reconstruction.  These are tracks with matching clusters (when applicable).  It also performs vertex reconstruction and creates a number of candidate particle collections.

...