/home/bes3soft/bes3soft/Boss/7.0.2/dist/7.0.2/Reconstruction/KalFitAlg/KalFitAlg-00-07-55-p03/KalFitAlg/helix/Helix.h

Go to the documentation of this file.

//   Author      Date         comments
//   Y.Ohnishi   03/01/1997   original version
//   Y.Ohnishi   06/03/1997   updated
//   Y.Iwasaki   17/02/1998   BFILED removed, func. name changed, func. added
//   J.Tanaka    06/12/1998   add some utilities.
//   Y.Iwasaki   07/07/1998   cache added to speed up
//   Y.Iwasaki   25/04/2001   cache m_ac[5] added to speed up
//
#ifndef Helix_FLAG_
#define Helix_FLAG_

#include "KalFitAlg/KalFitHitMdc.h"
#include "GaudiKernel/IInterface.h"
#include "GaudiKernel/Kernel.h"
#include "GaudiKernel/Service.h"
#include "MagneticField/IMagneticFieldSvc.h"
#include "MagneticField/MagneticFieldSvc.h"

#include "CLHEP/Matrix/Vector.h"
#include "CLHEP/Matrix/SymMatrix.h"
//#ifndef CLHEP_THREEVECTOR_H
#include "CLHEP/Vector/ThreeVector.h"
//#endif
#include "CLHEP/Vector/LorentzVector.h"
//#ifndef CLHEP_POINT3D_H
#include "CLHEP/Geometry/Point3D.h"
//#endif

#ifndef ENABLE_BACKWARDS_COMPATIBILITY
typedef HepGeom::Point3D<double> HepPoint3D;
#endif

using namespace CLHEP;

namespace KalmanFit{

class Helix {

  public:
    Helix(const HepPoint3D & pivot,
          const HepVector & a,
          const HepSymMatrix & Ea);

    Helix(const HepPoint3D & pivot,
          const HepVector & a);

    Helix(const HepPoint3D & position,
          const Hep3Vector & momentum,
          double charge);

    virtual ~Helix();

  public:// Selectors
    const HepPoint3D & center(void) const;

    const HepPoint3D & pivot(void) const;

    double radius(void) const;

    HepPoint3D x(double dPhi = 0.) const;
    double * x(double dPhi, double p[3]) const;

    HepPoint3D x(double dPhi, HepSymMatrix & Ex) const;

    Hep3Vector direction(double dPhi = 0.) const;

    Hep3Vector momentum(double dPhi = 0.) const;

    Hep3Vector momentum(double dPhi, HepSymMatrix & Em) const;

    HepLorentzVector momentum(double dPhi, double mass) const;

    HepLorentzVector momentum(double dPhi, double mass, HepSymMatrix & Em) const;

    HepLorentzVector momentum(double dPhi, double mass, HepPoint3D & x, HepSymMatrix & Emx) const;  

  public:// Parametrization dependent functions. Prepared for tracking codes. Users should not use them.
    double dr(void) const;
    double phi0(void) const;
    double kappa(void) const;
    double dz(void) const;
    double tanl(void) const;
    double curv(void) const;
    double sinPhi0(void) const;
    double cosPhi0(void) const;

    const HepVector & a(void) const;

    const HepSymMatrix & Ea(void) const;

    double approach(KalFitHitMdc& hit, bool doSagCorrection) const;
 
    double approach(HepPoint3D pfwd, HepPoint3D pbwd,  bool doSagCorrection) const;
        
    
  public:// Modifiers
    const HepVector & a(const HepVector & newA); 

    const HepSymMatrix & Ea(const HepSymMatrix & newdA);

    const HepPoint3D & pivot(const HepPoint3D & newPivot);

    void set(const HepPoint3D & pivot,
             const HepVector & a,
             const HepSymMatrix & Ea);

    void ignoreErrorMatrix(void);

    double bFieldZ(double);
    double bFieldZ(void) const;

    double alpha(void) const;
    
  public:// Operators
    Helix & operator = (const Helix &);

  public:// Mathmatical functions
    HepMatrix delApDelA(const HepVector & ap) const;
    HepMatrix delXDelA(double phi) const;
    HepMatrix delMDelA(double phi) const;
    HepMatrix del4MDelA(double phi, double mass) const;
    HepMatrix del4MXDelA(double phi, double mass) const;

  private:
    IMagneticFieldSvc* m_pmgnIMF;

  private:
    void updateCache(void);

  public:
    static const double ConstantAlpha;

  private:
    double m_bField;
    double m_alpha;
    HepPoint3D m_pivot;
    HepVector m_a;
    HepSymMatrix m_Ea;
    bool m_matrixValid;

  private: // caches
    HepPoint3D m_center;
    double m_cp;
    double m_sp;
    double m_pt;
    double m_r;
    double m_ac[5];
};

//-----------------------------------------------------------------------------

#ifdef Helix_NO_INLINE
#define inline
#else
#undef inline
#define Helix_INLINE_DEFINE_HERE
#endif

#ifdef Helix_INLINE_DEFINE_HERE

inline
const HepPoint3D &
Helix::center(void) const {
    return m_center;
}

inline
const HepPoint3D &
Helix::pivot(void) const {
    return m_pivot;
}

inline
double
Helix::radius(void) const {
    return m_r;
}

inline
Hep3Vector
Helix::direction(double phi) const {
    return momentum(phi).unit();
}

inline
double
Helix::dr(void) const {
    return m_ac[0];
}

inline
double
Helix::phi0(void) const {
    return m_ac[1];
}

inline
double
Helix::kappa(void) const {
    return m_ac[2];
}

inline
double
Helix::dz(void) const {
    return m_ac[3];
}

inline
double
Helix::tanl(void) const {
    return m_ac[4];
}

inline
double
Helix::curv(void) const {
    return m_r;
}

inline
const HepVector &
Helix::a(void) const {
    return m_a;
}

inline
const HepSymMatrix &
Helix::Ea(void) const {
    return m_Ea;
}

inline
const HepVector &
Helix::a(const HepVector & i) {
    m_a = i;
    updateCache();
    return m_a;
}

inline
const HepSymMatrix &
Helix::Ea(const HepSymMatrix & i) {
    return m_Ea = i;
}

inline
double
Helix::bFieldZ(double a) {
    m_bField = a;
    m_alpha = 10000. / 2.99792458 / m_bField;

    //std::cout<<"m_alpha: "<<m_alpha<<std::endl;
    updateCache();
    return m_bField;
}


inline
double
Helix::alpha(void) const {

  return m_alpha;
}


inline
double
Helix::bFieldZ(void) const {
    return m_bField;
}

inline
double
Helix::sinPhi0(void) const {
    return m_sp;
}

inline
double
Helix::cosPhi0(void) const {
    return m_cp;
}

#endif

#undef inline

}


#endif /* Helix_FLAG_ */

---