21.6. Tracking Utility Functions

tracking.__init__.add_tracking_reconstruction(path, components=None, pruneTracks=False, skipGeometryAdding=False, mcTrackFinding=False, trackFitHypotheses=None, reco_tracks='RecoTracks', prune_temporary_tracks=True, fit_tracks=True, use_second_cdc_hits=False, skipHitPreparerAdding=False, use_svd_to_cdc_ckf=True, use_ecl_to_cdc_ckf=False, add_cdcTrack_QI=True, add_vxdTrack_QI=False, add_recoTrack_QI=False)[source]

This function adds the standard tracking reconstruction modules to a path:

  1. first we find tracks using the CDC hits only, see CDC Track Finding

  2. CDC tracks are extrapolated to SVD and SVD hits are attached, see CDC to SVD CKF

  3. remaining SVD hits are used to find SVD tracks, see SVD Track Finding

  4. SVD tracks are extrapolated to CDC to attach CDC hits, see SVD to CDC CKF

  5. SVD and CDC tracks are merged and fitted, see Track Fitting

  6. merged SVD+CDC tracks are extrapolated to PXD to attach PXD hits, see SVD to PXD CKF

Note

PXD hits are not available on HLT. At the end of the tracking chain on HLT we have the PXD Region Of Interest Finding, that consists of extrapolating the tracks on the PXD sensors and defining regions in which we expect to find the hit. Only fired pixels inside these regions reach Event Builder 2.

  1. after all the tracks from the IP are found, we look for special classes of tracks, in particular we search for displaced vertices to reconstruct K-short, Lambda and photon-conversions, see V0 Finding

Note

this last step is not run on HLT

Parameters

  • path – the path to add the tracking reconstruction modules to

  • components – the list of geometry components in use or None for all components.

  • pruneTracks – if true, delete all hits except the first and the last in the found tracks.

  • skipGeometryAdding – (advanced flag) the tracking modules need the geometry module and will add it, if it is not already present in the path. In a setup with multiple (conditional) paths however, it can not determine, if the geometry is already loaded. This flag can be used o just turn off the geometry adding at all (but you will have to add it on your own then).

  • skipHitPreparerAdding – (advanced flag) if true, do not add the hit preparation (esp. VXD cluster creation modules. This is useful if they have been added before already.

  • mcTrackFinding – if true, use the MC track finders instead of the realistic ones.

  • reco_tracks – name of the StoreArray where the reco tracks should be stored

  • prune_temporary_tracks – if false, store all information of the single CDC and VXD tracks before merging. If true, prune them.

  • fit_tracks – if false, the final track find and the TrackCreator module will no be executed

  • use_second_cdc_hits – if true, the second hit information will be used in the CDC track finding.

  • trackFitHypotheses – which pdg hypothesis to fit. Defaults to [211, 321, 2212].

  • use_svd_to_cdc_ckf – if true, add SVD to CDC CKF module.

  • use_ecl_to_cdc_ckf – if true, add ECL to CDC CKF module.

  • add_cdcTrack_QI – if true, add the MVA track quality estimation to the path that sets the quality indicator property of the found CDC standalone tracks

  • add_vxdTrack_QI – if true, add the MVA track quality estimation to the path that sets the quality indicator property of the found VXDTF2 tracks (ATTENTION: Standard triplet QI of VXDTF2 is replaced in this case -> setting this option to ‘True’ will have some influence on the final track collection)

  • add_recoTrack_QI – if true, add the MVA track quality estimation to the path that sets the quality indicator property of all found reco tracks (Both other QIs needed as input.)