TrackingTools/MaterialEffects/interface/PropagatorWithMaterial.h - master - githubmirror/cmssw

TrackingTools/MaterialEffects/interface/PropagatorWithMaterial.h
107 строк5 KB
Cms Build
Clang-Format
31 май 2019, 13:16
31 май 2019, 13:1614da925
#ifndef _COMMONRECO_PROPAGATORWITHMATERIAL_H_
#define _COMMONRECO_PROPAGATORWITHMATERIAL_H_

/** \class PropagatorWithMaterial
 *  Propagation including material effects.
 *
 *  Propagates using a specific for the geometrical part
 *  and a MaterialEffectsUpdator to include multiple scattering and
 *  energy loss. By default material effects are included at the
 *  source in the case of forward propagation and at the destination
 *  for backward propagation. Material effects at the source can
 *  only be included when propagating from a TrajectoryStateOnSurface.
 *  Ported from ORCA.
 *
 *  \author todorov, cerati
 */

#include "DataFormats/GeometryCommonDetAlgo/interface/DeepCopyPointerByClone.h"
#include "TrackPropagation/RungeKutta/interface/defaultRKPropagator.h"

#include "TrackingTools/GeomPropagators/interface/Propagator.h"
#include "TrackingTools/MaterialEffects/interface/MaterialEffectsUpdator.h"

class MagneticField;
class PropagatorWithMaterial final : public Propagator {
public:
  /** Constructor with PropagationDirection and mass hypothesis.
   *  Uses AnalyticalPropagator and CombinedMaterialEffectsUpdator
   *  with explicit mass hypothesis.MaxDPhi is a cut on the max change in
   *  phi during state propagation. For propagation of very low pt tracks
   *  (e.g. loopers), this cut can be loosened.
   *  If ptMin > 0, then multiple scattering calculations will take into
   *  account the uncertainty in the reconstructed track momentum, (by
   *  default neglected), but assuming that the track Pt will never fall
   *  below ptMin.
   */
  PropagatorWithMaterial(PropagationDirection dir,
                         const float mass,
                         const MagneticField* mf = nullptr,
                         const float maxDPhi = 1.6,
                         bool useRungeKutta = false,
                         float ptMin = -1.,
                         bool useOldGeoPropLogic = true);

  ~PropagatorWithMaterial() override;

  using Propagator::propagate;
  using Propagator::propagateWithPath;

private:
  std::pair<TrajectoryStateOnSurface, double> propagateWithPath(const TrajectoryStateOnSurface& tsos,
                                                                const Plane& plane) const override;

  std::pair<TrajectoryStateOnSurface, double> propagateWithPath(const FreeTrajectoryState& fts,
                                                                const Plane& plane) const override;

  std::pair<TrajectoryStateOnSurface, double> propagateWithPath(const TrajectoryStateOnSurface& tsos,
                                                                const Cylinder& cylinder) const override;

  std::pair<TrajectoryStateOnSurface, double> propagateWithPath(const FreeTrajectoryState& fts,
                                                                const Cylinder& cylinder) const override;

public:
  /// Limit on change in azimuthal angle
  bool setMaxDirectionChange(float phiMax) override { return theGeometricalPropagator->setMaxDirectionChange(phiMax); }
  /// Propagation direction
  void setPropagationDirection(PropagationDirection dir) override;

  enum MaterialLocation { atSource, atDestination, fromDirection };
  /** Choice of location for including material effects:
   *  fromDirection is equivalent to atSource for propagation alongMomentum
   *  and to atDestination for propagation oppositeToMomentum.
   *  Inclusion of material effects at the source (either explicitely or
   *  implicitely) is not possible if propagating with anyDirection and
   *  will effectively disable material effects when propagating from
   *  a FreeTrajectoryState.
   */
  void setMaterialLocation(const MaterialLocation location) { theMaterialLocation = location; }
  /// Access to the geometrical propagator
  const Propagator& geometricalPropagator() const { return *theGeometricalPropagator; }
  /// Access to the MaterialEffectsUpdator
  const MaterialEffectsUpdator& materialEffectsUpdator() const { return *theMEUpdator; }

  const MagneticField* magneticField() const override { return field; }

  PropagatorWithMaterial* clone() const override { return new PropagatorWithMaterial(*this); }

private:
  /// Inclusion of material at the source?
  bool materialAtSource() const dso_internal;

private:
  // Geometrical propagator

  defaultRKPropagator::Product rkProduct;
  DeepCopyPointerByClone<Propagator> theGeometricalPropagator;

  // Material effects
  DeepCopyPointerByClone<MaterialEffectsUpdator> theMEUpdator;
  typedef std::pair<TrajectoryStateOnSurface, double> TsosWP;
  // Use material at source?
  MaterialLocation theMaterialLocation;
  const MagneticField* field;
  bool useRungeKutta_;
};

#endif