#include <CSCWireTopology.h>

Inheritance diagram for CSCWireTopology:

Public Member Functions
int	channel (const LocalPoint &p) const override

	CSCWireTopology (const CSCWireGroupPackage &wg, double yOfFirstWire, float wireAngleInDegrees)

	CSCWireTopology (const CSCWireTopology &)

std::pair< float, float >	equationOfWire (float wire) const

double	extentOfWirePlane () const

bool	insideYOfWirePlane (float y) const

double	lengthOfPlane () const

LocalError	localError (const MeasurementPoint &, const MeasurementError &) const override

LocalPoint	localPosition (const MeasurementPoint &) const override

MeasurementError	measurementError (const LocalPoint &, const LocalError &) const override

MeasurementPoint	measurementPosition (const LocalPoint &) const override

float	middleWireOfGroup (int wireGroup) const

double	narrowWidthOfPlane () const

int	nearestWire (const LocalPoint &lp) const override

int	numberOfWireGroups () const

int	numberOfWires () const override

int	numberOfWiresPerGroup (int wireGroup) const

CSCWireTopology &	operator= (const CSCWireTopology &)

float	restrictToYOfWirePlane (float y) const

double	wideWidthOfPlane () const

float	wireAngle () const override

std::pair< LocalPoint, LocalPoint >	wireEnds (float wire) const

int	wireGroup (int wire) const

float	wirePitch () const override

double	wireSpacing () const

std::vector< float >	wireValues (float wire) const

float	yOfWire (float wire, float x=0.) const

float	yOfWireGroup (int wireGroup, float x=0.) const

float	yResolution (int wireGroup=1) const

	~CSCWireTopology () override

Public Member Functions inherited from WireTopology
	~WireTopology () override

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 ()

Private Attributes
double	theAlignmentPinToFirstWire

CSCWireGeometry *	theWireGeometry

CSCWireGrouping *	theWireGrouping

Additional Inherited Members
Public Types inherited from Topology
typedef Point2DBase< double, LocalTag >	Local2DPoint

typedef Vector2D::MathVector	MathVector2D

typedef Basic2DVector< double >	Vector2D

Detailed Description

A concrete class derived from WireTopology, to handle wire (group) geometry functionality for endcap muon CSCs.

Author: Tim Cox

Definition at line 18 of file CSCWireTopology.h.

Constructor & Destructor Documentation

◆ ~CSCWireTopology()

CSCWireTopology::~CSCWireTopology ( )

override

Definition at line 16 of file CSCWireTopology.cc.

                                   {
   delete theWireGrouping;
   delete theWireGeometry;
 }

◆ CSCWireTopology() [1/2]

CSCWireTopology::CSCWireTopology	(	const CSCWireGroupPackage &	wg,
		double	yOfFirstWire,
		float	wireAngleInDegrees
	)

Constructor from endcap muon CSC wire geometry specs

Definition at line 21 of file CSCWireTopology.cc.

     : theWireGrouping(nullptr), theWireGeometry(nullptr), theAlignmentPinToFirstWire(wg.alignmentPinToFirstWire / 10.) {
   // Pass consecutiveGroups and wiresInConsecutiveGroups
   // directly on to theWireGrouping ctor. These vectors
   // are transient info and can go once ctor is complete.
  
   theWireGrouping = new CSCGangedWireGrouping(wg.consecutiveGroups, wg.wiresInEachGroup, wg.numberOfGroups);
  
   const float zeroprecision = 1.E-06;  // blur zero a bit, for comparisons
  
   float wireAngleInRadians = convertDegToRad(wireAngleInDegrees);
  
   //@@ Conversion from mm to cm
   float wireSpacing = convertMmToCm(wg.wireSpacing);
   float nw = convertMmToCm(wg.narrowWidthOfWirePlane);
   float ww = convertMmToCm(wg.wideWidthOfWirePlane);
   float lw = convertMmToCm(wg.lengthOfWirePlane);
  
   LogTrace("CSCWireTopology|CSC") << "CSCWireTopology constructing CSCWireGeometry with:\n"
                                   << " wireSpacing = " << wireSpacing * 10. << " (mm) "
                                   << ", yOfFirstWire = " << yOfFirstWire << " (cm) "
                                   << ", wireAngle = " << wireAngleInDegrees << " (deg) = " << wireAngleInRadians
                                   << " (rads)"
                                   << ", extent: n, w, l = " << nw << ", " << ww << ", " << lw << " (cm)";
  
   if (fabs(wireAngleInDegrees) > zeroprecision) {
     theWireGeometry = new CSCSlantedWireGeometry(wireSpacing, yOfFirstWire, nw, ww, lw, wireAngleInRadians);
   } else {
     theWireGeometry = new CSCNonslantedWireGeometry(wireSpacing, yOfFirstWire, nw, ww, lw);
   }
 }

References CSCWireGroupPackage::consecutiveGroups, angle_units::operators::convertDegToRad(), geant_units::operators::convertMmToCm(), CSCWireGroupPackage::lengthOfWirePlane, LogTrace, CSCWireGroupPackage::narrowWidthOfWirePlane, CSCWireGroupPackage::numberOfGroups, theWireGeometry, theWireGrouping, CSCWireGroupPackage::wideWidthOfWirePlane, CSCWireGroupPackage::wiresInEachGroup, CSCWireGroupPackage::wireSpacing, and wireSpacing().

◆ CSCWireTopology() [2/2]

CSCWireTopology::CSCWireTopology ( const CSCWireTopology & mewt )

Copy constructor

Definition at line 53 of file CSCWireTopology.cc.

     : theAlignmentPinToFirstWire(mewt.theAlignmentPinToFirstWire) {
   if (mewt.theWireGrouping)
     theWireGrouping = mewt.theWireGrouping->clone();
   else
     theWireGrouping = nullptr;
   if (mewt.theWireGeometry)
     theWireGeometry = mewt.theWireGeometry->clone();
   else
     theWireGeometry = nullptr;
 }

References CSCWireGrouping::clone(), CSCWireGeometry::clone(), theWireGeometry, and theWireGrouping.

Member Function Documentation

◆ channel()

int CSCWireTopology::channel ( const LocalPoint & p ) const

overridevirtual

'channel' is wire group number from 1 to no. of groups. Return 0 if out-of-range or in a dead region

Implements Topology.

Definition at line 108 of file CSCWireTopology.cc.

                                                       {
   int wire = theWireGeometry->nearestWire(p);
   int group = theWireGrouping->wireGroup(wire);
   return group;  // 0 means out of range or dead region
 }

References watchdog::group, CSCWireGeometry::nearestWire(), AlCaHLTBitMon_ParallelJobs::p, theWireGeometry, theWireGrouping, and CSCWireGrouping::wireGroup().

◆ equationOfWire()

std::pair< float, float > CSCWireTopology::equationOfWire ( float wire ) const

Return slope and intercept of straight line representing a wire in 2-dim local coordinates.

The return value is a pair p with p.first = m, p.second = c, where y=mx+c.

Definition at line 131 of file CSCWireTopology.cc.

                                                                       {
   return theWireGeometry->equationOfWire(wire);
 }

References CSCWireGeometry::equationOfWire(), and theWireGeometry.

Referenced by CSCLayerGeometry::intersectionOfStripAndWire().

◆ extentOfWirePlane()

double CSCWireTopology::extentOfWirePlane ( ) const

inline

Extent of wire plane (width normal to wire direction).
Note that for ME11 this distance is not along local y!
cf. lengthOfPlane() which should be the same for all chambers but ME11.

Definition at line 155 of file CSCWireTopology.h.

155 { return wireSpacing() * (numberOfWires() - 1); }

References numberOfWires(), and wireSpacing().

◆ insideYOfWirePlane()

bool CSCWireTopology::insideYOfWirePlane ( float y ) const

Returns true if arg falls within y limits of wire plane; false otherwise.

Definition at line 148 of file CSCWireTopology.cc.

                                                       {
   // Returns true if arg falls within y limits of wire plane; false otherwise.
  
   std::pair<float, float> ylim = theWireGeometry->yLimitsOfWirePlane();
  
   if (y < ylim.first) {
     return false;
   } else if (y > ylim.second) {
     return false;
   }
   return true;
 }

References theWireGeometry, y, and CSCWireGeometry::yLimitsOfWirePlane().

Referenced by CSCLayerGeometry::intersectionOfStripAndWire().

◆ lengthOfPlane()

double CSCWireTopology::lengthOfPlane ( ) const

inline

Length/height of wire plane along long axis of trapezoid (local y direction)

Definition at line 96 of file CSCWireTopology.h.

96 { return theWireGeometry->lengthOfPlane(); }

References CSCWireGeometry::lengthOfPlane(), and theWireGeometry.

Referenced by TrackDetectorAssociator::getTAMuonChamberMatches().

◆ localError()

LocalError CSCWireTopology::localError	(	const MeasurementPoint &	,
		const MeasurementError &
	)		const

overridevirtual

Implements Topology.

Definition at line 90 of file CSCWireTopology.cc.

                                                                                              {
   edm::LogWarning("CSC") << "CSCWireTopology: localError unimplemented. Don't use it."
                          << "\n";
   return LocalError();
 }

◆ localPosition()

LocalPoint CSCWireTopology::localPosition ( const MeasurementPoint & ) const

overridevirtual

Topology interface, but not implemented for CSCWireTopology (yet!)

Implements Topology.

Definition at line 84 of file CSCWireTopology.cc.

                                                                        {
   edm::LogWarning("CSC") << "CSCWireTopology: localPosition unimplemented. Don't use it."
                          << "\n";
   return LocalPoint();
 }

◆ measurementError()

MeasurementError CSCWireTopology::measurementError	(	const LocalPoint &	,
		const LocalError &
	)		const

overridevirtual

Implements Topology.

Definition at line 102 of file CSCWireTopology.cc.

                                                                                              {
   edm::LogWarning("CSC") << "CSCWireTopology: measurementError unimplemented. Don't use it."
                          << "\n";
   return MeasurementError();
 }

◆ measurementPosition()

MeasurementPoint CSCWireTopology::measurementPosition ( const LocalPoint & ) const

overridevirtual

Implements Topology.

Definition at line 96 of file CSCWireTopology.cc.

                                                                              {
   edm::LogWarning("CSC") << "CSCWireTopology: measurementPosition unimplemented. Don't use it."
                          << "\n";
   return MeasurementPoint();
 }

◆ middleWireOfGroup()

float CSCWireTopology::middleWireOfGroup ( int wireGroup ) const

inline

Middle of wire-group. This is the central wire no. for a group with an odd no. of wires. This is a pseudo-wire no. for a group with an even no. of wires. Accordingly, it is non-integer.

Definition at line 131 of file CSCWireTopology.h.

131 { return theWireGrouping->middleWireOfGroup(wireGroup); }

References CSCWireGrouping::middleWireOfGroup(), theWireGrouping, and wireGroup().

Referenced by CSCLayerGeometry::middleWireOfGroup(), and yOfWireGroup().

◆ narrowWidthOfPlane()

double CSCWireTopology::narrowWidthOfPlane ( ) const

inline

Width of wire plane at narrow end of trapezoid

Definition at line 86 of file CSCWireTopology.h.

86 { return theWireGeometry->narrowWidthOfPlane(); }

References CSCWireGeometry::narrowWidthOfPlane(), and theWireGeometry.

Referenced by TrackDetectorAssociator::getTAMuonChamberMatches().

◆ nearestWire()

int CSCWireTopology::nearestWire ( const LocalPoint & lp ) const

inlineoverridevirtual

The nearest (virtual) wire to a given LocalPoint. Beware that this wire might not exist or be read out!

Implements WireTopology.

Definition at line 76 of file CSCWireTopology.h.

76 { return theWireGeometry->nearestWire(lp); }

References CSCWireGeometry::nearestWire(), and theWireGeometry.

Referenced by CSCLayerGeometry::nearestWire().

◆ numberOfWireGroups()

int CSCWireTopology::numberOfWireGroups ( ) const

inline

How many wire groups

Definition at line 113 of file CSCWireTopology.h.

113 { return theWireGrouping->numberOfWireGroups(); }

References CSCWireGrouping::numberOfWireGroups(), and theWireGrouping.

Referenced by CSCLayerGeometry::numberOfWireGroups().

◆ numberOfWires()

int CSCWireTopology::numberOfWires ( ) const

inlineoverridevirtual

Wire group interface Total number of (virtual) wires. Some wires may not be implemented in the hardware. This is the number which would fill the region covered by wires, assuming the constant wire spacing.

Implements WireTopology.

Definition at line 108 of file CSCWireTopology.h.

108 { return theWireGrouping->numberOfWires(); }

References CSCWireGrouping::numberOfWires(), and theWireGrouping.

Referenced by extentOfWirePlane(), and CSCLayerGeometry::numberOfWires().

◆ numberOfWiresPerGroup()

int CSCWireTopology::numberOfWiresPerGroup ( int wireGroup ) const

inline

How many wires in a wiregroup

Definition at line 118 of file CSCWireTopology.h.

118 { return theWireGrouping->numberOfWiresPerGroup(wireGroup); }

References CSCWireGrouping::numberOfWiresPerGroup(), theWireGrouping, and wireGroup().

Referenced by CSCLayerGeometry::numberOfWiresPerGroup().

◆ operator=()

CSCWireTopology & CSCWireTopology::operator= ( const CSCWireTopology & mewt )

Assignment op

Definition at line 65 of file CSCWireTopology.cc.

                                                                        {
   if (&mewt != this) {
     delete theWireGrouping;
     if (mewt.theWireGrouping)
       theWireGrouping = mewt.theWireGrouping->clone();
     else
       theWireGrouping = nullptr;
  
     delete theWireGeometry;
     if (mewt.theWireGeometry)
       theWireGeometry = mewt.theWireGeometry->clone();
     else
       theWireGeometry = nullptr;
  
     theAlignmentPinToFirstWire = mewt.theAlignmentPinToFirstWire;
   }
   return *this;
 }

References CSCWireGrouping::clone(), CSCWireGeometry::clone(), theAlignmentPinToFirstWire, theWireGeometry, and theWireGrouping.

◆ restrictToYOfWirePlane()

float CSCWireTopology::restrictToYOfWirePlane ( float y ) const

Reset input y to lie within bounds of wire plane at top and bottom.

Definition at line 135 of file CSCWireTopology.cc.

                                                            {
   // Reset y to lie within bounds of wire plane at top and bottom.
  
   std::pair<float, float> ylim = theWireGeometry->yLimitsOfWirePlane();
  
   if (y < ylim.first) {
     y = ylim.first;
   } else if (y > ylim.second) {
     y = ylim.second;
   }
   return y;
 }

References theWireGeometry, y, and CSCWireGeometry::yLimitsOfWirePlane().

Referenced by CSCLayerGeometry::intersectionOfStripAndWire().

◆ wideWidthOfPlane()

double CSCWireTopology::wideWidthOfPlane ( ) const

inline

Width of wire plane at wide end of trapezoid

Definition at line 91 of file CSCWireTopology.h.

91 { return theWireGeometry->wideWidthOfPlane(); }

References theWireGeometry, and CSCWireGeometry::wideWidthOfPlane().

Referenced by TrackDetectorAssociator::getTAMuonChamberMatches().

◆ wireAngle()

float CSCWireTopology::wireAngle ( ) const

inlineoverridevirtual

The angle of the wires w.r.t local x axis (in radians)

Implements WireTopology.

Definition at line 70 of file CSCWireTopology.h.

70 { return theWireGeometry->wireAngle(); }

References theWireGeometry, and CSCWireGeometry::wireAngle().

Referenced by FWRecoGeometryESProducer::addCSCGeometry(), TrackDetectorAssociator::getTAMuonChamberMatches(), CSCGeometryValidate::validateCSCLayerGeometry(), ValidateGeometry::validateCSCLayerGeometry(), and CSCLayerGeometry::wireAngle().

◆ wireEnds()

std::pair<LocalPoint, LocalPoint> CSCWireTopology::wireEnds ( float wire ) const

inline

Return local (x,y) coordinates of the two ends of a wire across the extent of the wire plane. The returned value is a pair of LocalPoints.

Definition at line 162 of file CSCWireTopology.h.

162 { return theWireGeometry->wireEnds(wire); }

References theWireGeometry, and CSCWireGeometry::wireEnds().

◆ wireGroup()

int CSCWireTopology::wireGroup ( int wire ) const

inline

Wire group containing a given wire

Definition at line 123 of file CSCWireTopology.h.

123 { return theWireGrouping->wireGroup(wire); }

References theWireGrouping, and CSCWireGrouping::wireGroup().

Referenced by middleWireOfGroup(), numberOfWiresPerGroup(), CSCLayerGeometry::wireGroup(), yOfWireGroup(), and yResolution().

◆ wirePitch()

float CSCWireTopology::wirePitch ( ) const

inlineoverridevirtual

The wire pitch. This is the wire spacing but old-timers like the word 'pitch'.

Implements WireTopology.

Definition at line 65 of file CSCWireTopology.h.

65 { return static_cast<float>(wireSpacing()); }

References wireSpacing().

Referenced by CSCLayerGeometry::wirePitch().

◆ wireSpacing()

double CSCWireTopology::wireSpacing ( ) const

inline

WireTopology interface The wire spacing (in cm)

Definition at line 59 of file CSCWireTopology.h.

59 { return theWireGeometry->wireSpacing(); }

References theWireGeometry, and CSCWireGeometry::wireSpacing().

Referenced by FWRecoGeometryESProducer::addCSCGeometry(), CSCWireTopology(), extentOfWirePlane(), CSCGeometryValidate::validateCSCLayerGeometry(), ValidateGeometry::validateCSCLayerGeometry(), wirePitch(), and yResolution().

◆ wireValues()

std::vector<float> CSCWireTopology::wireValues ( float wire ) const

inline

Return mid-point of a wire in local coordinates, and its length across the chamber volume, in a vector as x, y, length

Definition at line 167 of file CSCWireTopology.h.

167 { return theWireGeometry->wireValues(wire); }

References theWireGeometry, and CSCWireGeometry::wireValues().

Referenced by CSCLayerGeometry::lengthOfWireGroup(), and CSCLayerGeometry::localCenterOfWireGroup().

◆ yOfWire()

float CSCWireTopology::yOfWire	(	float	wire,
		float	x = `0.`
	)		const

inline

Local y of a given wire 'number' (float) at given x

Definition at line 81 of file CSCWireTopology.h.

81 { return theWireGeometry->yOfWire(wire, x); }

References theWireGeometry, x, and CSCWireGeometry::yOfWire().

Referenced by TrackDetectorAssociator::getTAMuonChamberMatches(), and CSCLayerGeometry::yOfWire().

◆ yOfWireGroup()

float CSCWireTopology::yOfWireGroup	(	int	wireGroup,
		float	x = `0.`
	)		const

Extended interface which 'mixes' WireGrouping and WireGeometry info Local y of a given wire group at given x

Definition at line 114 of file CSCWireTopology.cc.

                                                                 {
   float wire = middleWireOfGroup(wireGroup);
   return theWireGeometry->yOfWire(wire, x);
 }

References middleWireOfGroup(), theWireGeometry, wireGroup(), x, and CSCWireGeometry::yOfWire().

Referenced by CSCLayerGeometry::yOfWireGroup().

◆ yResolution()

float CSCWireTopology::yResolution ( int wireGroup = 1 ) const

The measurement resolution from wire groups (in cm.) This approximates the measurement resolution in the local y direction but may be too small by a factor of up to 1.26 due to stripAngle contributions which are neglected here.

Definition at line 119 of file CSCWireTopology.cc.

                                                       {
   // Return the resolution in the wire group measurement (in cm).
   // To really be resolution in local y this should be scaled by Sin
   // factors involving strip and wire angles, and also add a contribution
   // from strip measurement (which is negligible w.r.t. wire resolution.)
   // These factors can increase the number here by up to 1.26.
  
   // Should be improvable for smaller partial wire groups
  
   return wireSpacing() * theWireGrouping->numberOfWiresPerGroup(wireGroup) / sqrt(12.);
 }

References CSCWireGrouping::numberOfWiresPerGroup(), mathSSE::sqrt(), theWireGrouping, wireGroup(), and wireSpacing().

Referenced by CSCLayerGeometry::yResolution().

Member Data Documentation

◆ theAlignmentPinToFirstWire

double CSCWireTopology::theAlignmentPinToFirstWire

private

Definition at line 190 of file CSCWireTopology.h.

Referenced by operator=().

◆ theWireGeometry

CSCWireGeometry* CSCWireTopology::theWireGeometry

private

Definition at line 188 of file CSCWireTopology.h.

Referenced by channel(), CSCWireTopology(), equationOfWire(), insideYOfWirePlane(), lengthOfPlane(), narrowWidthOfPlane(), nearestWire(), operator=(), restrictToYOfWirePlane(), wideWidthOfPlane(), wireAngle(), wireEnds(), wireSpacing(), wireValues(), yOfWire(), and yOfWireGroup().

◆ theWireGrouping

CSCWireGrouping* CSCWireTopology::theWireGrouping

private

Definition at line 187 of file CSCWireTopology.h.

Referenced by channel(), CSCWireTopology(), middleWireOfGroup(), numberOfWireGroups(), numberOfWires(), numberOfWiresPerGroup(), operator=(), wireGroup(), and yResolution().

Public Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ~CSCWireTopology()

◆ CSCWireTopology() [1/2]

◆ CSCWireTopology() [2/2]

Member Function Documentation

◆ channel()

◆ equationOfWire()

◆ extentOfWirePlane()

◆ insideYOfWirePlane()

◆ lengthOfPlane()

◆ localError()

◆ localPosition()

◆ measurementError()

◆ measurementPosition()

◆ middleWireOfGroup()

◆ narrowWidthOfPlane()

◆ nearestWire()

◆ numberOfWireGroups()

◆ numberOfWires()

◆ numberOfWiresPerGroup()

◆ operator=()

◆ restrictToYOfWirePlane()

◆ wideWidthOfPlane()

◆ wireAngle()

◆ wireEnds()

◆ wireGroup()

◆ wirePitch()

◆ wireSpacing()

◆ wireValues()

◆ yOfWire()

◆ yOfWireGroup()

◆ yResolution()

Member Data Documentation

◆ theAlignmentPinToFirstWire

◆ theWireGeometry

◆ theWireGrouping