CSCWireTopology Class Reference

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

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

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

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

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

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

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

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

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

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

{ return theWireGeometry->wireAngle(); }

References theWireGeometry, and CSCWireGeometry::wireAngle().

Referenced by FWRecoGeometryESProducer::addCSCGeometry(), TrackDetectorAssociator::getTAMuonChamberMatches(), CSCGeometryValidate::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.

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

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

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

{ return theWireGeometry->wireSpacing(); }

References theWireGeometry, and CSCWireGeometry::wireSpacing().

Referenced by FWRecoGeometryESProducer::addCSCGeometry(), CSCWireTopology(), extentOfWirePlane(), CSCGeometryValidate::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.

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

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