Reconstruction/MdcPatRec/TrkBase/include/TrkBase/TrkFitMaker.h

Go to the documentation of this file.

//--------------------------------------------------------------------------
// File and Version Information:
//      $Id: TrkFitMaker.h,v 1.2 2007/11/13 07:27:23 codeman Exp $
//
// Description: Abstract base class for FitMaker classes.  FitMakers have
//   two functions, and only FitMakers are supposed to perform these
//   functions: 1) creating tracks and 2) changing the TrkRep + Fitter
//   combination for a track.
//   Derived classes may have data members -- e.g. cut values
//   to be set in created fitters.
//   Derived classes usually implement something like these functions:
//   TrkRecoTrk* makeTrack(const TrkExchangePar& helix, const
//              HepAList<TrkHitOnTrk>* hotList, double chi2=-999.);
//   virtual void changeFit(TrkRecoTrk& theTrack) const = 0;
//
//   But I've found too many exceptions to make these virtual functions.
//   So what this class really does is give friendship access to TrkRecoTrks,
//   and permits derived classes to muck about to their hearts' content.
//
// Environment:
//      Software developed for the BaBar Detector at the SLAC B-Factory.
//
// Authors: Steve Schaffner
//
//------------------------------------------------------------------------
#ifndef TRKFITMAKER_HH
#define TRKFITMAKER_HH
#include "MdcRecoUtil/PdtPid.h"
#include "TrkBase/TrkRep.h"
#include <utility>
 
class TrkHitOnTrk;
class TrkRep;
class TrkRecoTrk;
class TrkExchangePar;
class TrkContext;
class TrkIdManager;
namespace MdcPatRec {
  class BField;
}
class TrkRepIter;
class KalMiniTrkK;
 
// Class interface //
class TrkFitMaker {
 
public:
  virtual ~TrkFitMaker();
 
  void changeDefault( TrkRecoTrk&, PdtPid::PidType ) const;
 
protected:
  // The following functions provide friendship access to TrkRecoTrk
  //   (including to ctor).
  // gets current TrkReps from track:
  std::pair<TrkRepIter, TrkRepIter> uniqueReps( const TrkRecoTrk& t ) const; // was currentReps
  void                              setRep( TrkRecoTrk&, TrkRep* ) const;
  void repointHypo( TrkRecoTrk&, PdtPid::PidType hypo, PdtPid::PidType fit ) const;
  void setFitNumber( TrkRecoTrk&, PdtPid::PidType, int ) const;
  std::pair<TrkRepIter, TrkRepIter> allReps( const TrkRecoTrk& t ) const; // was repPtrs
  TrkRep*                           getRep( TrkRecoTrk&, PdtPid::PidType ) const;
  void        addHypoTo( TrkRecoTrk&, TrkRep*, PdtPid::PidType hypo ) const;
  TrkRecoTrk* createTrack( PdtPid::PidType, const TrkContext&, double t0 ) const;
  TrkRecoTrk* createTrack( PdtPid::PidType, long idnum, double t0 ) const;
  // the following functions try to cover the fact that the
  // persistence model is completely incompatible with the tracking design.
  // They allow direct manipulation of what should be private or constructor-supplied
  // arguments.
  void setIdManager( TrkRecoTrk&, TrkIdManager* ) const;
  void setBField( TrkRecoTrk&, const MdcPatRec::BField* ) const;
  // allow persistence to call these functions
  friend class KalMiniTrkK;
  friend class KalMiniRX;
  friend class KalFit;
};
 
#endif