CMS 3D CMS Logo

 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Pages
List of all members | Public Member Functions | Friends
RadialStripTopology Class Referenceabstract

#include <RadialStripTopology.h>

Inheritance diagram for RadialStripTopology:
StripTopology Topology CSCRadialStripTopology TkRadialStripTopology OffsetRadialStripTopology CSCStripTopology CSCGangedStripTopology CSCUngangedStripTopology

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
 
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.

35 {}

Member Function Documentation

virtual float RadialStripTopology::angularWidth ( ) const
pure virtual
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
virtual MeasurementPoint RadialStripTopology::measurementPosition ( const LocalPoint ) const
pure virtual
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
virtual

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.

4  {
5  throw cms::Exception("RadialStripTopology") << "pitch() called - makes no sense, use localPitch(.) instead.";
6  return 0.;
7 }
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.

10  {
11  os << "RadialStripTopology " << std::endl
12  << " " << std::endl
13  << "number of strips " << rst.nstrips() << std::endl
14  << "centre to whereStripsMeet " << rst.centreToIntersection() << std::endl
15  << "detector height in y " << rst.detHeight() << std::endl
16  << "angular width of strips " << rst.phiPitch() << std::endl
17  << "phi of one edge " << rst.phiOfOneEdge() << std::endl
18  << "y axis orientation " << rst.yAxisOrientation() << std::endl
19  << "y of centre of strip plane " << rst.yCentreOfStripPlane() << std::endl;
20  return os;
21 }
virtual float centreToIntersection() const =0
virtual float yAxisOrientation() const =0
virtual float phiPitch(void) const =0
virtual float detHeight() const =0
virtual int nstrips() const =0
virtual float yCentreOfStripPlane() const =0
virtual float phiOfOneEdge() const =0