TrackingTools/GeomPropagators/interface/Propagator.h - master - githubmirror/cmssw

TrackingTools/GeomPropagators/interface/Propagator.h
165 строк8 KB
Christopher Jones
Avoid direct forward declarations of data product classes
21 янв 2026, 20:32
21 янв 2026, 20:3272d73bd
#ifndef CommonDet_Propagator_H
#define CommonDet_Propagator_H

#include "DataFormats/TrajectorySeed/interface/PropagationDirection.h"
#include "DataFormats/BeamSpot/interface/BeamSpotFwd.h"
#include "TrackingTools/TrajectoryState/interface/FreeTrajectoryState.h"
#include "TrackingTools/TrajectoryState/interface/TrajectoryStateOnSurface.h"

#include <utility>
#include <memory>

class Plane;
class Cylinder;
class Surface;
class MagneticField;

/** Basic tool for "propagation" of trajectory states to surfaces.
 *  If the starting state has an error matrix the errors will be also
 *  propagated. If you want to propagate just the parameters,
 *  construct a starting state that does not have errors.
 *  In case of propagation failure (e.g. when the trajectory does
 *  not cross the destination surface) and invalid state is returned.
 *  Always check the returned state with isValid() before using it!
 *
 *  The propagation can be "alongMomentum" or "oppositeToMomentum"
 *  (see setPropagationDirection() below). The difference between the two
 *  is the sign of energy loss: the trajectory momentum decreases
 *  "alongMomentum" and increases "oppositeToMomentum".
 *  In both directions extrapolation errors and multiple scattering errors
 *  increase. Propagation "oppositeToMomentum" is convenient for
 *  fitting a track "backwards", sterting from the last measurement.
 *
 *  The propagator interface promises to take you to "any surface"
 *  but you should check the concrete propagator you are using for
 *  additional limitations.
 *
 *  derived classes have to implement the PropagateWithPath for Plane and Cylinder
 *
 */

class Propagator {
public:
  explicit Propagator(PropagationDirection dir = alongMomentum) : theDir(dir) {}
  virtual ~Propagator();

  template <typename STA, typename SUR>
  TrajectoryStateOnSurface propagate(STA const& state, SUR const& surface) const {
    return propagateWithPath(state, surface).first;
  }

public:
  /** The methods propagateWithPath() are identical to the corresponding
   *  methods propagate() in what concerns the resulting
   *  TrajectoryStateOnSurface, but they provide in addition the
   *  exact path length along the trajectory.
   */

  /** Only use the generic method if the surface type (plane or cylinder)
   *  is not known at the calling point.
   */
  virtual std::pair<TrajectoryStateOnSurface, double> propagateWithPath(const FreeTrajectoryState&,
                                                                        const Surface&) const final;

  virtual std::pair<TrajectoryStateOnSurface, double> propagateWithPath(const FreeTrajectoryState&,
                                                                        const Plane&) const = 0;

  virtual std::pair<TrajectoryStateOnSurface, double> propagateWithPath(const FreeTrajectoryState&,
                                                                        const Cylinder&) const = 0;

  /** The following three methods are equivalent to the corresponding
   *  methods above,
   *  but if the starting state is a TrajectoryStateOnSurface, it's better
   *  to use it as such rather than use just the FreeTrajectoryState
   *  part. It may help some concrete propagators.
   */

  /** Only use the generic method if the surface type (plane or cylinder)
   *  is not known at the calling point.
   */
  virtual std::pair<TrajectoryStateOnSurface, double> propagateWithPath(const TrajectoryStateOnSurface& tsos,
                                                                        const Surface& sur) const final;

  virtual std::pair<TrajectoryStateOnSurface, double> propagateWithPath(const TrajectoryStateOnSurface& tsos,
                                                                        const Plane& sur) const {
    return propagateWithPath(*tsos.freeState(), sur);
  }

  virtual std::pair<TrajectoryStateOnSurface, double> propagateWithPath(const TrajectoryStateOnSurface& tsos,
                                                                        const Cylinder& sur) const {
    return propagateWithPath(*tsos.freeState(), sur);
  }

  /// implemented by Stepping Helix
  //! Propagate to PCA to point given a starting point
  virtual std::pair<FreeTrajectoryState, double> propagateWithPath(const FreeTrajectoryState& ftsStart,
                                                                   const GlobalPoint& pDest) const;
  //! Propagate to PCA to a line (given by 2 points) given a starting point
  virtual std::pair<FreeTrajectoryState, double> propagateWithPath(const FreeTrajectoryState& ftsStart,
                                                                   const GlobalPoint& pDest1,
                                                                   const GlobalPoint& pDest2) const;
  //! Propagate to PCA to a line (given by beamSpot position and slope) given a starting point
  virtual std::pair<FreeTrajectoryState, double> propagateWithPath(const FreeTrajectoryState& ftsStart,
                                                                   const reco::BeamSpot& beamSpot) const;

  // this is a mess...
  virtual FreeTrajectoryState propagate(const FreeTrajectoryState& ftsStart, const GlobalPoint& pDest) const final {
    return propagateWithPath(ftsStart, pDest).first;
  }
  virtual FreeTrajectoryState propagate(const FreeTrajectoryState& ftsStart,
                                        const GlobalPoint& pDest1,
                                        const GlobalPoint& pDest2) const final {
    return propagateWithPath(ftsStart, pDest1, pDest2).first;
  }
  virtual FreeTrajectoryState propagate(const FreeTrajectoryState& ftsStart,
                                        const reco::BeamSpot& beamSpot) const final {
    return propagateWithPath(ftsStart, beamSpot).first;
  }

public:
  /** The propagation direction can now be set for every propagator.
   *  There is no more distinction between unidirectional and bidirectional
   *  at class level. The value "anyDiriction" for PropagationDirection
   *  provides the functionality of the ex-BidirectionalPropagator.
   *  The values "alongMomentum" and "oppositeToMomentum" provide the
   *  functionality of the ex-UnidirectionalPropagator.
   */
  virtual void setPropagationDirection(PropagationDirection dir) { theDir = dir; }

  /** Returns the current value of the propagation direction.
   *  If you need to know the actual direction used for a given propagation
   *  in case "propagationDirection() == anyDirection",
   *  you should use propagateWithPath. A positive sign of
   *  path lengt means "alongMomentum", an egeative sign means
   *  "oppositeToMomentum".
   */
  virtual PropagationDirection propagationDirection() const final { return theDir; }

  /** Set the maximal change of direction (integrated along the path)
   *  for any single propagation.
   *  If reaching of the destination surface requires change of direction that exceeds
   *  this value the Propagator returns an invalid state.
   *  For example, a track may reach a forward plane after many spirals,
   *  which may be undesirable for a track reconstructor. Setting this value
   *  to pi will force the propagation to fail.
   *  The default value is "no limit". The method returnd true if the concrete propagator
   *  respects the limit, false otherwise.
   */
  virtual bool setMaxDirectionChange(float phiMax) { return false; }

  virtual Propagator* clone() const = 0;

  virtual const MagneticField* magneticField() const = 0;

private:
  PropagationDirection theDir;
};

// Put here declaration of helper function, so that it is
// automatically included in all proper places w/o having to add an
// additional include file. Keep implementation separate, to avoid
// multiple definition of the same symbol in all cc inlcuding this
// file.
std::unique_ptr<Propagator> SetPropagationDirection(Propagator const& iprop, PropagationDirection dir);

#endif  // CommonDet_Propagator_H