Changes between Version 5 and Version 6 of RaveKinematics

Timestamp:

Jan 25, 2008, 12:23:56 PM (17 years ago)

Author:

fmos

Comment:

--

RaveKinematics

@@ -106 +106 @@
 == Converting the input ==
 
-The kinematic fit makes heavy use of the !KinematicParticle class. It is used as an input as well as an output data class. Strictly spoken, the input data accepted by the kinematic fitting algorithms must be converted to !TransientTrackKinematicParticle classes. This class can be created from !Track objects by providing an additional mass hypothesis or from !Vector7D and !Covariance7D objects by providing the additional charge information. The two basic constructors are 
+The kinematic fit makes heavy use of the !KinematicParticle class. It is used as an input as well as an output data class. Strictly spoken, the input data accepted by the kinematic fitting algorithms must be converted to !TransientTrackKinematicParticle classes. This class can be created from !Track objects by providing an additional mass hypothesis or from !Vector7D and !Covariance7D objects by providing additional charge and fit information. The two basic constructors are 
 
 {{{
 #!cpp
-rave::TransientTrackKinematicParticle (const rave::Track &initialTrack, const double &massGuess, const double &massSigma, boost::any origin=boost::any(), std::string tag="")
-rave::TransientTrackKinematicParticle (const rave::Vector7D &state, const rave::Covariance7D &error, const rave::Charge &charge, const double &chiSquared, const double &degreesOfFr, boost::any origin=boost::any(), std::string tag="")
+using namespace rave;
+TransientTrackKinematicParticle (const Track &initialTrack, const double &massGuess, const double &massSigma)
+TransientTrackKinematicParticle (const Vector7D &state, const Covariance7D &error, const Charge &charge, const double &chiSquared, const double &degreesOfFr)
 }}}
+
+The construction of Track instances works as described for the vertex fit.
+
+In the example above, two instances of !KinematicParticle are created from the respective Vector7D and Covariance7D instances, which themselves are initialized with hardcoded numbers. The basic constructors for these two classes are
+
+{{{
+#!cpp
+using namespace rave;
+Vector7D (double x,  double y,  double z, double px, double py, double pz, double m);
+Covariance7D (double dxx, double dxy, double dxz, double dyy, double dyz, double dzz, double dxpx, double dxpy, double dxpz, double dypx, double dypy, double dypz, double dzpx, double dzpy, double dzpz, double dpxpx, double dpxpy, double dpxpz, double dpypy, double dpypz, double dpzpz, double dxm, double dym, double dzm, double dpxm, double dpym, double dpzm, double dmm);
+}}}
+
+Pushed into a vector, those instances are handed over to the fitter together with a constraint.
+
+== Constraints ==
+
+Constraints are a central concept when it comes to kinematic fitting. Rave offers a certain set of constraints. The user can choose to apply any number of them to the problem at hand, but the calling convention of the fitter slightly depends on the type of constraint chosen.
+
+The available constraints are:
+* Back-to-Back
+* Four-Momentum
+* Mass
+* Momentum
+* Pointing
+* Simple pointing
+* Smart pointing
+* Two-track Mass
+* Vertex
+* (Multiple)
+
+Constraints are represented by instances of the !KinematicConstraint class. They cannot be created freely, but only by using the !KinematicConstraintBuilder. This builder offers a creation method for each type of constraint. The signatures of those methods are
+
+{{{
+#!cpp
+using namespace rave;
+KinematicConstraint createBackToBackKinematicConstraint () const;
+KinematicConstraint createFourMomentumKinematicConstraint (const Vector4D &momentum, const Vector4D &deviation) const;
+KinematicConstraint createMassKinematicConstraint (const double &mass, const float sigma) const;
+KinematicConstraint createMomentumKinematicConstraint (const Vector3D &momentum, const rave::Vector3D &deviation) const;
+KinematicConstraint createPointingKinematicConstraint (const Point3D &reference) const;
+KinematicConstraint createSimplePointingConstraint (const Point3D &reference) const;
+KinematicConstraint createSmartPointingConstraint (const Point3D &reference) const;
+KinematicConstraint createTwoTrackMassKinematicConstraint (const double &mass) const;
+KinematicConstraint createVertexKinematicConstraint () const;
+MultipleKinematicConstraint createMultipleKinematicConstraint () const;
+}}}
+
+As is visible from these signatures, the !MultipleKinematicConstraint has a special role copared to the other constraints.