Simulated events can be fully reconstructed by a ReconCheater that uses Monte Carlo truth to reconstruct individual particles. Charged tracks found by the TrackingCheater and calorimeter clusters found by the ClusterCheater are used to provide the basis for full event reconstruction. Various options and parameter settings in a Cheating properties file or Cheating Table for each detector are used to mix reconstructed tracks and clusters with Monte Carlo particles. Options for obtaining various measures of the neutral energy deposition, and for controlling decays and nuclear interactions are included.

To add the ReconCheater to a process, use

    add(new org.lcsim.recon.cheater.ReconCheater());

The TrackingCheater and ClusterCheater drivers will be added by the ReconCheater.

To access reconstructed particles, use

    event.get(ReconstructedParticle.class);

Fully simulated GEANT4 events are reconstructed by the ReconCheater in the following way:

• Only those tracks and clusters that were reconstructed, e.g. by the corresponding cheaters, are used, so particles do get lost.
• For charged particle decays, the track from the primary particle is used if it was found, otherwise the secondary track is used, allowing neutrinos to carry away energy.
• For converted photons, the found tracks are used.
• At this stage, perfect energy flow is used where a cluster's parentage is checked to see if there is a charged track which should be associated.
• Nuclear interactions are turned off by default since the reconstruction is not optimized for them yet: for example should low energy protons be ignored, can low energy neutrons be cut out, can the leading particle be used to get an estimate of the corresponding neutral energy in the calorimeter.
  The original particle (or reconstructed primary track if it's charged) is used and all secondary tracks and clusters are removed. Nuclear interactions can be turned on for comparisons.