RadialStripTopology Class Reference

#include <RadialStripTopology.h>

Inheritance diagram for RadialStripTopology:

Public Member Functions
virtual float	angularWidth () const =0
virtual float	centreToIntersection () const =0
virtual int	channel (const LocalPoint &) const =0
virtual float	detHeight () const =0
virtual LocalError	localError (float strip, float stripErr2) const =0
virtual LocalError	localError (const MeasurementPoint &, const MeasurementError &) const =0
virtual float	localPitch (const LocalPoint &) const =0
virtual LocalPoint	localPosition (float strip) const =0
virtual LocalPoint	localPosition (const MeasurementPoint &) const =0
virtual float	localStripLength (const LocalPoint &) const =0
virtual MeasurementError	measurementError (const LocalPoint &, const LocalError &) const =0
virtual MeasurementPoint	measurementPosition (const LocalPoint &) const =0
virtual int	nearestStrip (const LocalPoint &) const =0
virtual int	nstrips () const =0
virtual float	originToIntersection () const =0
virtual float	phiOfOneEdge () const =0
virtual float	phiPitch (void) const =0
virtual float	pitch () const final
virtual float	strip (const LocalPoint &) const =0
virtual float	stripAngle (float strip) const =0
virtual float	stripLength () const =0
virtual float	xOfStrip (int strip, float y) const =0
virtual float	yAxisOrientation () const =0
virtual float	yCentreOfStripPlane () const =0
virtual float	yDistanceToIntersection (float y) const =0
virtual float	yExtentOfStripPlane () const =0
virtual	~RadialStripTopology ()
Public Member Functions inherited from StripTopology
virtual float	coveredStrips (const LocalPoint &lp1, const LocalPoint &lp2) const
virtual LocalError	localError (float strip, float stripErr2, const Topology::LocalTrackPred &) const
	conversion taking also the angle from the predicted track state More...
virtual float	localPitch (const LocalPoint &lp, const Topology::LocalTrackAngles &) const
	conversion taking also the angle from the track state (LocalTrajectoryParameters) More...
virtual LocalPoint	localPosition (float strip, const Topology::LocalTrackPred &) const
	conversion taking also the predicted track state More...
virtual float	localStripLength (const LocalPoint &lp, const Topology::LocalTrackAngles &) const
	conversion taking also the angle from the track state (LocalTrajectoryParameters) More...
virtual float	strip (const LocalPoint &lp, const Topology::LocalTrackAngles &) const
	conversion taking also the angle from the track state (LocalTrajectoryParameters) More...
virtual	~StripTopology ()
Public Member Functions inherited from Topology
virtual int	channel (const LocalPoint &lp, const LocalTrackAngles &) const
	conversion taking also the angle from the track state More...
virtual LocalError	localError (const MeasurementPoint &mp, const MeasurementError &me, const LocalTrackPred &) const
	conversion taking also the angle from the predicted track state More...
virtual LocalPoint	localPosition (const MeasurementPoint &mp, const LocalTrackPred &) const
	conversion taking also the angle from the predicted track state More...
virtual MeasurementError	measurementError (const LocalPoint &lp, const LocalError &le, const LocalTrackAngles &) const
	conversion taking also the angle from the track state More...
virtual MeasurementPoint	measurementPosition (const LocalPoint &lp, const LocalTrackAngles &) const
	conversion taking also the angle from the track state More...
virtual	~Topology ()

Friends
std::ostream &	operator<< (std::ostream &, const RadialStripTopology &)

Additional Inherited Members
Public Types inherited from Topology
typedef Point2DBase< double, LocalTag >	Local2DPoint
typedef Vector2D::MathVector	MathVector2D
typedef Basic2DVector< double >	Vector2D

Detailed Description

A StripTopology in which the component strips subtend a constant angular width, and, if projected, intersect at a point.

Author

Tim Cox

WARNING! Wherever 'float strip' is used the units of 'strip' are angular widths of each strip. The range is from 0.0 at the extreme edge of the 'first' strip at one edge of the detector, to nstrip*angular width at the other edge.
The centre of the first strip is at strip = 0.5
The centre of the last strip is at strip = 0.5 + (nstrip-1)
This is for consistency with CommonDet usage of 'float strip' (but where units are strip pitch rather than strip angular width.)

WARNING! If the mid-point along local y of the plane of strips does not correspond to the local coordinate origin, set the final ctor argument appropriately.

Original version, allows inheritance

A StripTopology in which the component strips subtend a constant angular width, and, if projected, intersect at a point.

Author

Tim Cox

WARNING! Wherever 'float strip' is used the units of 'strip' are angular widths of each strip. The range is from 0.0 at the extreme edge of the 'first' strip at one edge of the detector, to nstrip*angular width at the other edge.
The centre of the first strip is at strip = 0.5
The centre of the last strip is at strip = 0.5 + (nstrip-1)
This is for consistency with CommonDet usage of 'float strip' (but where units are strip pitch rather than strip angular width.)

WARNING! If the mid-point along local y of the plane of strips does not correspond to the local coordinate origin, set the final ctor argument appropriately.

now is an abstract class to allow different specialization for tracker and muon

Definition at line 28 of file RadialStripTopology.h.

Constructor & Destructor Documentation

virtual RadialStripTopology::~RadialStripTopology ( )

inlinevirtual

Destructor

Definition at line 35 of file RadialStripTopology.h.

{}

Member Function Documentation

virtual float RadialStripTopology::angularWidth ( ) const

pure virtual

Angular width of a each strip

Implemented in TkRadialStripTopology, and CSCRadialStripTopology.

Referenced by TrackerValidationVariables::fillHitQuantities(), and ApeEstimator::radialPositionAndError2().

virtual float RadialStripTopology::centreToIntersection ( ) const

pure virtual

Distance from the intersection of the projections of the extreme edges of the two extreme strips to the symmetry centre of the plane of strips.

Implemented in TkRadialStripTopology, and CSCRadialStripTopology.

Referenced by operator<<().

virtual int RadialStripTopology::channel ( const LocalPoint &  ) const

pure virtual

Channel number corresponding to a given LocalPoint.
This is effectively an integer version of strip(), with range 0 to nstrips-1.
LocalPoints outside the detector strip plane will be considered as contributing to the edge channels 0 or nstrips-1.

Implements Topology.

Implemented in TkRadialStripTopology, CSCRadialStripTopology, OffsetRadialStripTopology, CSCUngangedStripTopology, and CSCGangedStripTopology.

virtual float RadialStripTopology::detHeight ( ) const

pure virtual

Length of long symmetry axis of plane of strips

Implemented in TkRadialStripTopology, and CSCRadialStripTopology.

Referenced by TrackerValidationVariables::fillHitQuantities(), operator<<(), and ApeEstimator::radialPositionAndError2().

virtual LocalError RadialStripTopology::localError ( float  strip, float  stripErr2  ) const

pure virtual

LocalError for a pure strip measurement, where 'strip' is the (float) position (a 'phi' angle wrt y axis) and stripErr2 is the sigma-squared. Both quantities are expressed in units of theAngularWidth of a strip.

Implements StripTopology.

Implemented in CSCRadialStripTopology, and TkRadialStripTopology.

virtual LocalError RadialStripTopology::localError ( const MeasurementPoint &  , const MeasurementError &    ) const

pure virtual

LocalError for a given MeasurementPoint with known MeasurementError. This may be used in Kalman filtering and hence must allow possible correlations between the components.

Implements Topology.

Implemented in CSCRadialStripTopology, and TkRadialStripTopology.

virtual float RadialStripTopology::localPitch ( const LocalPoint &  ) const

pure virtual

Pitch (strip width) at a given LocalPoint.
BEWARE: are you sure you really want to call this for a RadialStripTopology?

Implements StripTopology.

Implemented in TkRadialStripTopology, and CSCRadialStripTopology.

virtual LocalPoint RadialStripTopology::localPosition ( float  strip ) const

pure virtual

LocalPoint on x axis for given 'strip' 'strip' is a float in units of the strip (angular) width

Implements StripTopology.

Implemented in CSCRadialStripTopology, TkRadialStripTopology, and OffsetRadialStripTopology.

Referenced by TrackerValidationVariables::fillHitQuantities().

virtual LocalPoint RadialStripTopology::localPosition ( const MeasurementPoint &  ) const

pure virtual

LocalPoint for a given MeasurementPoint
What's a MeasurementPoint?
In analogy with that used with TrapezoidalStripTopology objects, a MeasurementPoint is a 2-dim object.
The first dimension measures the angular position wrt central line of symmetry of detector, in units of strip (angular) widths (range 0 to total angle subtended by a detector).
The second dimension measures the fractional position along the strip (range -0.5 to +0.5).
BEWARE! The components are not Cartesian.

Implements Topology.

Implemented in CSCRadialStripTopology, TkRadialStripTopology, and OffsetRadialStripTopology.

virtual float RadialStripTopology::localStripLength ( const LocalPoint &  ) const

pure virtual

Length of a strip passing through a given LocalPpoint

Implements StripTopology.

Implemented in TkRadialStripTopology, and CSCRadialStripTopology.

Referenced by TrackerValidationVariables::fillHitQuantities(), and ApeEstimator::radialPositionAndError2().

virtual MeasurementError RadialStripTopology::measurementError ( const LocalPoint &  , const LocalError &    ) const

pure virtual

Implements Topology.

Implemented in TkRadialStripTopology, and CSCRadialStripTopology.

Referenced by TrackerValidationVariables::fillHitQuantities(), ApeEstimator::positionAndError2(), and ApeEstimator::radialPositionAndError2().

virtual MeasurementPoint RadialStripTopology::measurementPosition ( const LocalPoint &  ) const

pure virtual

Implements Topology.

Implemented in TkRadialStripTopology, CSCRadialStripTopology, and OffsetRadialStripTopology.

Referenced by TrackerValidationVariables::fillHitQuantities(), and ApeEstimator::radialPositionAndError2().

virtual int RadialStripTopology::nearestStrip ( const LocalPoint &  ) const

pure virtual

Nearest strip to given LocalPoint

Implemented in TkRadialStripTopology, and CSCRadialStripTopology.

virtual int RadialStripTopology::nstrips ( ) const

pure virtual

Total number of strips

Implements StripTopology.

Implemented in TkRadialStripTopology, and CSCRadialStripTopology.

Referenced by operator<<().

virtual float RadialStripTopology::originToIntersection ( ) const

pure virtual

(y) distance from intersection of the projections of the strips to the local coordinate origin. Same as centreToIntersection() if symmetry centre of strip plane coincides with local origin.

Implemented in TkRadialStripTopology, and CSCRadialStripTopology.

Referenced by TrackerValidationVariables::fillHitQuantities(), and ApeEstimator::radialPositionAndError2().

virtual float RadialStripTopology::phiOfOneEdge ( ) const

pure virtual

Convenience function to access azimuthal angle of extreme edge of first strip measured relative to long symmetry axis of the plane of strips.

WARNING! This angle is measured clockwise from the local y axis which means it is in the conventional azimuthal phi plane, but azimuth is of course measured from local x axis not y. The range of this angle is -(full angle)/2 to +(full angle)/2.
where (full angle) = nstrips() * angularWidth().

Implemented in TkRadialStripTopology, and CSCRadialStripTopology.

Referenced by operator<<().

virtual float RadialStripTopology::phiPitch ( void  ) const

pure virtual

Phi pitch of each strip (= angular width!)

Implemented in TkRadialStripTopology, and CSCRadialStripTopology.

Referenced by operator<<().

float RadialStripTopology::pitch ( ) const

finalvirtual

BEWARE: calling pitch() throws an exception.
Pitch is conventional name for width of something, but this is not sensible for a RadialStripTopology since strip widths vary with local y. Use localPitch(.) instead.

Implements StripTopology.

Definition at line 4 of file RadialStripTopology.cc.

References Exception.

                                       {  
  throw cms::Exception("RadialStripTopology") << "pitch() called - makes no sense, use localPitch(.) instead."; 
  return 0.;
}

virtual float RadialStripTopology::strip ( const LocalPoint &  ) const

pure virtual

Strip in which a given LocalPoint lies. This is a float which represents the fractional strip position within the detector.
Returns zero if the LocalPoint falls at the extreme low edge of the detector or BELOW, and float(nstrips) if it falls at the extreme high edge or ABOVE.

Implements StripTopology.

Implemented in CSCRadialStripTopology, TkRadialStripTopology, and OffsetRadialStripTopology.

virtual float RadialStripTopology::stripAngle ( float  strip ) const

pure virtual

Angle between strip and symmetry axis (=local y axis) for given strip.
This is like a phi angle but measured clockwise from y axis rather than counter clockwise from x axis. Note that 'strip' is a float with a continuous range from 0 to float(nstrips) to cover the whole detector, and the centres of strips correspond to half-integer values 0.5, 1.5, ..., nstrips-0.5 whereas values 1, 2, ... nstrips correspond to the upper phi edges of the strips.

Implements StripTopology.

Implemented in TkRadialStripTopology, CSCRadialStripTopology, and OffsetRadialStripTopology.

Referenced by TrackerValidationVariables::fillHitQuantities(), and ApeEstimator::radialPositionAndError2().

virtual float RadialStripTopology::stripLength ( ) const

pure virtual

Height of detector (= length of long symmetry axis of the plane of strips).

Implements StripTopology.

Implemented in TkRadialStripTopology, and CSCRadialStripTopology.

virtual float RadialStripTopology::xOfStrip ( int  strip, float  y  ) const

pure virtual

Local x where centre of strip intersects input local y
'strip' should be in range 1 to nstrips()

Implemented in TkRadialStripTopology, and CSCRadialStripTopology.

virtual float RadialStripTopology::yAxisOrientation ( ) const

pure virtual

y axis orientation, 1 means detector width increases with local y

Implemented in TkRadialStripTopology, and CSCRadialStripTopology.

Referenced by operator<<().

virtual float RadialStripTopology::yCentreOfStripPlane ( ) const

pure virtual

Offset in local y between midpoint of detector (strip plane) extent and local origin

Implemented in TkRadialStripTopology, and CSCRadialStripTopology.

Referenced by operator<<().

virtual float RadialStripTopology::yDistanceToIntersection ( float  y ) const

pure virtual

Distance in local y from a hit to the point of intersection of projected strips

Implemented in TkRadialStripTopology, and CSCRadialStripTopology.

virtual float RadialStripTopology::yExtentOfStripPlane ( ) const

pure virtual

y extent of strip plane

Implemented in TkRadialStripTopology, and CSCRadialStripTopology.

Friends And Related Function Documentation

std::ostream& operator<< ( std::ostream &  os, const RadialStripTopology &  rst  )

friend

Definition at line 10 of file RadialStripTopology.cc.

                                                                            {
  os  << "RadialStripTopology " << std::endl
      << " " << std::endl
      << "number of strips          " << rst.nstrips() << std::endl
      << "centre to whereStripsMeet " << rst.centreToIntersection() << std::endl
      << "detector height in y      " << rst.detHeight() << std::endl
      << "angular width of strips   " << rst.phiPitch() << std::endl
      << "phi of one edge           " << rst.phiOfOneEdge() << std::endl
      << "y axis orientation        " << rst.yAxisOrientation() << std::endl
      << "y of centre of strip plane " << rst.yCentreOfStripPlane() << std::endl;
  return os;
}