#include <GsfPropagatorWithMaterial.h>
Propagation including material effects on destination surface for multiple trajectory states. Propagates components independently using a specific propagator for the geometrical part and a GsfMaterialEffectsUpdator to include multiple scattering and energy loss at the destination. The number of components will increase according to the result of the GsfMaterialEffectsUpdator.
Definition at line 23 of file GsfPropagatorWithMaterial.h.
typedef std::vector<TrajectoryStateOnSurface> GsfPropagatorWithMaterial::MultiTSOS [private] |
Definition at line 185 of file GsfPropagatorWithMaterial.h.
typedef std::pair<TrajectoryStateOnSurface,double> GsfPropagatorWithMaterial::TsosWP [private] |
Definition at line 184 of file GsfPropagatorWithMaterial.h.
Definition at line 136 of file GsfPropagatorWithMaterial.h.
GsfPropagatorWithMaterial::GsfPropagatorWithMaterial | ( | const Propagator & | Propagator, |
const GsfMaterialEffectsUpdator & | MEUpdator | ||
) |
Constructor with explicit single state propagator and material effects objects.
Definition at line 9 of file GsfPropagatorWithMaterial.cc.
Referenced by clone().
: Propagator(aPropagator.propagationDirection()), theGeometricalPropagator(new GsfPropagatorAdapter(aPropagator)), theConvolutor(new FullConvolutionWithMaterial(aMEUpdator)), theMaterialLocation(atDestination) { // if ( propWithPathTimer1==0 ) defineTimer(); }
GsfPropagatorWithMaterial::GsfPropagatorWithMaterial | ( | const GsfPropagatorAdapter & | Propagator, |
const FullConvolutionWithMaterial & | Convolutor | ||
) |
Constructor with explicit multi state propagator and convolutor.
Definition at line 19 of file GsfPropagatorWithMaterial.cc.
: Propagator(aGsfPropagator.propagationDirection()), theGeometricalPropagator(aGsfPropagator.clone()), theConvolutor(aConvolutor.clone()), theMaterialLocation(atDestination) { // if ( propWithPathTimer1==0 ) defineTimer(); }
GsfPropagatorWithMaterial::~GsfPropagatorWithMaterial | ( | ) | [inline] |
Definition at line 37 of file GsfPropagatorWithMaterial.h.
{}
virtual GsfPropagatorWithMaterial* GsfPropagatorWithMaterial::clone | ( | void | ) | const [inline, virtual] |
Implements Propagator.
Definition at line 157 of file GsfPropagatorWithMaterial.h.
References GsfPropagatorWithMaterial(), theConvolutor, and theGeometricalPropagator.
{ return new GsfPropagatorWithMaterial(*theGeometricalPropagator,*theConvolutor); }
TrajectoryStateOnSurface GsfPropagatorWithMaterial::convoluteStateWithMaterial | ( | const TrajectoryStateOnSurface | tsos, |
const PropagationDirection | propDir | ||
) | const [private] |
Convolution of state with material effects.
Definition at line 146 of file GsfPropagatorWithMaterial.cc.
References theConvolutor.
Referenced by propagateWithPath().
{ // // convolute with material // return (*theConvolutor)(tsos,propDir); }
std::pair< TrajectoryStateOnSurface, double > GsfPropagatorWithMaterial::convoluteWithMaterial | ( | const std::pair< TrajectoryStateOnSurface, double > & | aStateWithPath | ) | const [private] |
Convolution of state+path with material effects.
Definition at line 134 of file GsfPropagatorWithMaterial.cc.
References Propagator::propagationDirection(), and theConvolutor.
Referenced by propagateWithPath().
{ // // convolute with material // PropagationDirection propDir = PropagationDirectionFromPath()(aStateWithPath.second, propagationDirection()); return TsosWP((*theConvolutor)(aStateWithPath.first,propDir), aStateWithPath.second); }
const FullConvolutionWithMaterial& GsfPropagatorWithMaterial::convolutionWithMaterial | ( | ) | const [inline] |
Access to the convolutor and thus to the material effects.
Definition at line 153 of file GsfPropagatorWithMaterial.h.
References theConvolutor.
Referenced by GsfTrajectorySmoother::GsfTrajectorySmoother().
{ return *theConvolutor; }
const Propagator& GsfPropagatorWithMaterial::geometricalPropagator | ( | ) | const [inline] |
Access to the geometrical propagator.
Definition at line 149 of file GsfPropagatorWithMaterial.h.
References theGeometricalPropagator.
Referenced by GsfTrajectorySmoother::GsfTrajectorySmoother().
{ return *theGeometricalPropagator; }
const MagneticField* GsfPropagatorWithMaterial::magneticField | ( | ) | const [inline, virtual] |
Implements Propagator.
Definition at line 162 of file GsfPropagatorWithMaterial.h.
References theGeometricalPropagator.
{return theGeometricalPropagator->magneticField();}
bool GsfPropagatorWithMaterial::materialAtSource | ( | ) | const [private] |
Inclusion of material at the source?
Definition at line 156 of file GsfPropagatorWithMaterial.cc.
References alongMomentum, anyDirection, atDestination, atSource, Exception, fromDirection, Propagator::propagationDirection(), and theMaterialLocation.
Referenced by propagateWithPath().
{ if ( propagationDirection()==anyDirection ) { if ( theMaterialLocation!=atDestination ) { throw cms::Exception("LogicError") << "PropagatorWithMaterial: propagation direction = anyDirection is " << "incompatible with adding of material at source"; } } return theMaterialLocation==atSource || (theMaterialLocation==fromDirection&& propagationDirection()==alongMomentum); }
virtual TrajectoryStateOnSurface GsfPropagatorWithMaterial::propagate | ( | const FreeTrajectoryState & | fts, |
const Plane & | plane | ||
) | const [inline, virtual] |
Propagation to plane: use propagationWithPath (adequate for use with AnalyticalPropagator, should be implemented to be more general). Use from FTS implies single state (better use PropagatorWithMaterial)!
Implements Propagator.
Definition at line 95 of file GsfPropagatorWithMaterial.h.
References propagateWithPath().
{ return propagateWithPath(fts,plane).first; }
virtual TrajectoryStateOnSurface GsfPropagatorWithMaterial::propagate | ( | const TrajectoryStateOnSurface & | tsos, |
const Surface & | surface | ||
) | const [inline, virtual] |
Propagation to generic surface: specialisation done in base class.
Reimplemented from Propagator.
Definition at line 41 of file GsfPropagatorWithMaterial.h.
Referenced by propagate().
{ return Propagator::propagate(tsos,surface); }
virtual TrajectoryStateOnSurface GsfPropagatorWithMaterial::propagate | ( | const TrajectoryStateOnSurface & | tsos, |
const Plane & | plane | ||
) | const [inline, virtual] |
Propagation to plane: use propagationWithPath (adequate for use with AnalyticalPropagator, should be implemented to be more general).
Reimplemented from Propagator.
Definition at line 49 of file GsfPropagatorWithMaterial.h.
References propagateWithPath().
{ return propagateWithPath(tsos,plane).first; }
virtual TrajectoryStateOnSurface GsfPropagatorWithMaterial::propagate | ( | const FreeTrajectoryState & | fts, |
const Cylinder & | cylinder | ||
) | const [inline, virtual] |
Propagation to cylinder: use propagationWithPath (adequate for use with AnalyticalPropagator, should be implemented to be more general). Use from FTS implies single state (better use PropagatorWithMaterial)!
Implements Propagator.
Definition at line 104 of file GsfPropagatorWithMaterial.h.
References propagateWithPath().
{ return propagateWithPath(fts,cylinder).first; }
virtual TrajectoryStateOnSurface GsfPropagatorWithMaterial::propagate | ( | const TrajectoryStateOnSurface & | tsos, |
const Cylinder & | cylinder | ||
) | const [inline, virtual] |
Propagation to cylinder: use propagationWithPath (adequate for use with AnalyticalPropagator, should be implemented to be more general).
Reimplemented from Propagator.
Definition at line 57 of file GsfPropagatorWithMaterial.h.
References propagateWithPath().
{ return propagateWithPath(tsos,cylinder).first; }
virtual TrajectoryStateOnSurface GsfPropagatorWithMaterial::propagate | ( | const FreeTrajectoryState & | fts, |
const Surface & | surface | ||
) | const [inline, virtual] |
Propagation to generic surface: specialisation done in base class. Use from FTS implies single state (better use PropagatorWithMaterial)!
Reimplemented from Propagator.
Definition at line 86 of file GsfPropagatorWithMaterial.h.
References propagate().
{ return Propagator::propagate(fts,surface); }
std::pair< TrajectoryStateOnSurface, double > GsfPropagatorWithMaterial::propagateWithPath | ( | const FreeTrajectoryState & | fts, |
const Plane & | plane | ||
) | const [virtual] |
Propagation to plane with path length calculation. Use from FTS implies single state (better use PropagatorWithMaterial)!
Implements Propagator.
Definition at line 98 of file GsfPropagatorWithMaterial.cc.
References convoluteWithMaterial(), materialAtSource(), and theGeometricalPropagator.
{ static int nWarn(0); if ( nWarn++<5 ) edm::LogInfo("GsfPropagatorWithMaterial") << "GsfPropagatorWithMaterial used from FTS: input state might have been collapsed!"; TsosWP propStateWP = theGeometricalPropagator->propagateWithPath(fts,plane); if ( !(propStateWP.first).isValid() || materialAtSource() ) return propStateWP; // // return convoluted state // return convoluteWithMaterial(propStateWP); }
virtual std::pair<TrajectoryStateOnSurface,double> GsfPropagatorWithMaterial::propagateWithPath | ( | const TrajectoryStateOnSurface & | tsos, |
const Surface & | surface | ||
) | const [inline, virtual] |
Propagation to generic surface with path length calculation: specialisation done in base class.
Reimplemented from Propagator.
Definition at line 67 of file GsfPropagatorWithMaterial.h.
Referenced by propagate(), and propagateWithPath().
{ return Propagator::propagateWithPath(tsos,surface); }
virtual std::pair<TrajectoryStateOnSurface,double> GsfPropagatorWithMaterial::propagateWithPath | ( | const FreeTrajectoryState & | fts, |
const Surface & | surface | ||
) | const [inline, virtual] |
Propagation to generic surface with path length calculation: specialisation done in base class. Use from FTS implies single state (better use PropagatorWithMaterial)!
Reimplemented from Propagator.
Definition at line 114 of file GsfPropagatorWithMaterial.h.
References propagateWithPath().
{ return Propagator::propagateWithPath(fts,surface); }
std::pair< TrajectoryStateOnSurface, double > GsfPropagatorWithMaterial::propagateWithPath | ( | const FreeTrajectoryState & | fts, |
const Cylinder & | cylinder | ||
) | const [virtual] |
Propagation to cylinder with path length calculation. Use from FTS implies single state (better use PropagatorWithMaterial)!
Implements Propagator.
Definition at line 113 of file GsfPropagatorWithMaterial.cc.
References convoluteWithMaterial(), materialAtSource(), and theGeometricalPropagator.
{ static int nWarn(0); if ( nWarn++<5 ) edm::LogInfo("GsfPropagatorWithMaterial") << "GsfPropagatorWithMaterial used from FTS: input state might have been collapsed!"; TsosWP propStateWP = theGeometricalPropagator->propagateWithPath(fts,cylinder); if ( !(propStateWP.first).isValid() || materialAtSource() ) return propStateWP; // // return convoluted state // return convoluteWithMaterial(propStateWP); }
std::pair< TrajectoryStateOnSurface, double > GsfPropagatorWithMaterial::propagateWithPath | ( | const TrajectoryStateOnSurface & | tsos, |
const Cylinder & | cylinder | ||
) | const [virtual] |
Propagation to cylinder with path length calculation.
Reimplemented from Propagator.
Definition at line 74 of file GsfPropagatorWithMaterial.cc.
References convoluteStateWithMaterial(), convoluteWithMaterial(), TrajectoryStateOnSurface::isValid(), materialAtSource(), Propagator::propagationDirection(), and theGeometricalPropagator.
{ // TimeMe t2(*propWithPathTimer2,false); // // add material before propagation? // TrajectoryStateOnSurface stateAtSource; if ( materialAtSource() ) stateAtSource = convoluteStateWithMaterial(tsos,propagationDirection()); else stateAtSource = tsos; if ( !stateAtSource.isValid() ) return TsosWP(stateAtSource,0.); // // geometrical propagation // TsosWP propStateWP(theGeometricalPropagator->propagateWithPath(stateAtSource,cylinder)); if ( !(propStateWP.first).isValid() ) return propStateWP; // // return convoluted state // return convoluteWithMaterial(propStateWP); }
std::pair< TrajectoryStateOnSurface, double > GsfPropagatorWithMaterial::propagateWithPath | ( | const TrajectoryStateOnSurface & | tsos, |
const Plane & | plane | ||
) | const [virtual] |
Propagation to plane with path length calculation.
Reimplemented from Propagator.
Definition at line 50 of file GsfPropagatorWithMaterial.cc.
References convoluteStateWithMaterial(), convoluteWithMaterial(), TrajectoryStateOnSurface::isValid(), materialAtSource(), Propagator::propagationDirection(), and theGeometricalPropagator.
{ // TimeMe t1(*propWithPathTimer1,false); // // add material before propagation? // TrajectoryStateOnSurface stateAtSource; if ( materialAtSource() ) stateAtSource = convoluteStateWithMaterial(tsos,propagationDirection()); else stateAtSource = tsos; if ( !stateAtSource.isValid() ) return TsosWP(stateAtSource,0.); // // geometrical propagation // TsosWP propStateWP(theGeometricalPropagator->propagateWithPath(stateAtSource,plane)); if ( !(propStateWP.first).isValid() ) return propStateWP; // // return convoluted state // return convoluteWithMaterial(propStateWP); }
void GsfPropagatorWithMaterial::setMaterialLocation | ( | const MaterialLocation | location | ) | [inline] |
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.
Definition at line 145 of file GsfPropagatorWithMaterial.h.
References tests::location, and theMaterialLocation.
{ theMaterialLocation = location; }
virtual bool GsfPropagatorWithMaterial::setMaxDirectionChange | ( | float | phiMax | ) | [inline, virtual] |
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.
Reimplemented from Propagator.
Definition at line 130 of file GsfPropagatorWithMaterial.h.
References theGeometricalPropagator.
{ return theGeometricalPropagator->setMaxDirectionChange(phiMax); }
void GsfPropagatorWithMaterial::setPropagationDirection | ( | PropagationDirection | dir | ) | const [virtual] |
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.
Reimplemented from Propagator.
Definition at line 128 of file GsfPropagatorWithMaterial.cc.
References theGeometricalPropagator.
Referenced by GsfTrajectorySmoother::trajectories().
{ theGeometricalPropagator->setPropagationDirection(dir); Propagator::setPropagationDirection(dir); }
DeepCopyPointerByClone<FullConvolutionWithMaterial> GsfPropagatorWithMaterial::theConvolutor [private] |
Definition at line 180 of file GsfPropagatorWithMaterial.h.
Referenced by clone(), convoluteStateWithMaterial(), convoluteWithMaterial(), and convolutionWithMaterial().
DeepCopyPointerByClone<GsfPropagatorAdapter> GsfPropagatorWithMaterial::theGeometricalPropagator [private] |
Definition at line 178 of file GsfPropagatorWithMaterial.h.
Referenced by clone(), geometricalPropagator(), magneticField(), propagateWithPath(), setMaxDirectionChange(), and setPropagationDirection().
Definition at line 182 of file GsfPropagatorWithMaterial.h.
Referenced by materialAtSource(), and setMaterialLocation().