tmtt::TrackerModule Class Reference

#include <TrackerModule.h>

Classes
struct	ModuleTypeCfg

Public Types
enum	BarrelModuleType { tiltedMinusZ = 1, tiltedPlusZ = 2, flat = 3 }

Public Member Functions
bool	barrel () const
unsigned int	calcModuleType (float pitch, float space, bool barrel, bool tiltedBarrel, bool psModule) const
const DetId &	detId () const
unsigned int	endcapRing () const
unsigned int	layerId () const
unsigned int	layerIdReduced () const
float	maxPhi () const
float	maxR () const
float	maxZ () const
float	minPhi () const
float	minR () const
float	minZ () const
unsigned int	moduleTypeID () const
unsigned int	nStrips () const
bool	outerModuleAtSmallerR () const
float	paramB () const
float	pitchOverSep () const
bool	psModule () const
unsigned int	rawDetId () const
unsigned int	rawStackedDetId () const
float	sensorSpacing () const
float	sensorWidth () const
float	sigmaPar () const
float	sigmaPerp () const
const PixelGeomDetUnit *	specDet () const
const PixelTopology *	specTopol () const
const DetId &	stackedDetId () const
float	stripLength () const
float	stripPitch () const
float	theta () const
float	tiltAngle () const
bool	tiltedBarrel () const
	TrackerModule (const TrackerGeometry *trackerGeometry, const TrackerTopology *trackerTopology, const ModuleTypeCfg &moduleTypeCfg, const DetId &detId)

Static Public Member Functions
static unsigned int	calcLayerIdReduced (unsigned int layerId)

Private Attributes
bool	barrel_
DetId	detId_
unsigned int	endcapRing_
unsigned int	layerId_
unsigned int	layerIdReduced_
float	moduleMaxPhi_
float	moduleMaxR_
float	moduleMaxZ_
float	moduleMinPhi_
float	moduleMinR_
float	moduleMinZ_
ModuleTypeCfg	moduleTypeCfg_
unsigned int	moduleTypeID_
unsigned int	nStrips_
bool	outerModuleAtSmallerR_
bool	psModule_
float	sensorSpacing_
float	sensorWidth_
const PixelGeomDetUnit *	specDet_
const PixelTopology *	specTopol_
DetId	stackedDetId_
float	stripLength_
float	stripPitch_
float	tiltAngle_
bool	tiltedBarrel_

Static Private Attributes
static const float	invRoot12 = sqrt(1. / 12.)

Detailed Description

Definition at line 24 of file TrackerModule.h.

Member Enumeration Documentation

BarrelModuleType

enum tmtt::TrackerModule::BarrelModuleType

Enumerator
tiltedMinusZ
tiltedPlusZ
flat

Definition at line 26 of file TrackerModule.h.

{ tiltedMinusZ = 1, tiltedPlusZ = 2, flat = 3 };

Constructor & Destructor Documentation

TrackerModule()

tmtt::TrackerModule::TrackerModule	(	const TrackerGeometry *	trackerGeometry,
		const TrackerTopology *	trackerTopology,
		const ModuleTypeCfg &	moduleTypeCfg,
		const DetId &	detId
	)

Definition at line 26 of file TrackerModule.cc.

References funct::abs(), barrel_, Surface::bounds(), calcLayerIdReduced(), calcModuleType(), PbPb_ZMuSkimMuonDPG_cff::deltaR, l1tTrackerHTMiss_cfi::deltaZ, detId(), detId_, endcapRing_, TrackerGeometry::getDetectorType(), TrackerGeometry::idToDetUnit(), TrackerTopology::layer(), layerId_, layerIdReduced_, PV3DBase< T, PVType, FrameType >::mag(), SiStripPI::max, SiStripPI::min, moduleMaxPhi_, moduleMaxR_, moduleMaxZ_, moduleMinPhi_, moduleMinR_, moduleMinZ_, moduleTypeID_, PixelTopology::nrows(), nStrips_, outerModuleAtSmallerR_, TrackerTopology::partnerDetId(), PV3DBase< T, PVType, FrameType >::perp(), TrackerGeometry::Ph2PSP, PV3DBase< T, PVType, FrameType >::phi(), PixelTopology::pitch(), GeomDet::position(), psModule_, HLT_2024v14_cff::R0, sensorSpacing_, sensorWidth_, TrackerTopology::side(), specDet_, PixelGeomDetUnit::specificTopology(), specTopol_, mathSSE::sqrt(), TrackerTopology::stack(), stackedDetId_, stripLength_, stripPitch_, DetId::subdetId(), GeomDet::surface(), StripSubdetector::TIB, TrackerTopology::tidRing(), TrackerTopology::tidWheel(), tiltAngle_, tiltedBarrel_, StripSubdetector::TOB, TrackerTopology::tobSide(), PV3DBase< T, PVType, FrameType >::z(), and Z0.

      : moduleTypeCfg_(moduleTypeCfg) {
    detId_ = detId;                                 // Det ID of lower sensor in stacked module.
    stackedDetId_ = trackerTopology->stack(detId);  // Det ID of stacked module.

    // Get min & max (r,phi,z) coordinates of the centre of the two sensors containing this stub.
    const GeomDetUnit* det0 = trackerGeometry->idToDetUnit(detId);
    const GeomDetUnit* det1 = trackerGeometry->idToDetUnit(trackerTopology->partnerDetId(detId));
    specDet_ = dynamic_cast<const PixelGeomDetUnit*>(det0);
    specTopol_ = dynamic_cast<const PixelTopology*>(&(specDet_->specificTopology()));

    float R0 = det0->position().perp();
    float R1 = det1->position().perp();
    float PHI0 = det0->position().phi();
    float PHI1 = det1->position().phi();
    float Z0 = det0->position().z();
    float Z1 = det1->position().z();
    moduleMinR_ = std::min(R0, R1);
    moduleMaxR_ = std::max(R0, R1);
    moduleMinPhi_ = std::min(PHI0, PHI1);
    moduleMaxPhi_ = std::max(PHI0, PHI1);
    moduleMinZ_ = std::min(Z0, Z1);
    moduleMaxZ_ = std::max(Z0, Z1);

    // Note if modules are flipped back-to-front.
    outerModuleAtSmallerR_ = (det0->position().mag() > det1->position().mag());

    // Note if module is PS or 2S, and whether in barrel or endcap.
    // From Geometry/TrackerGeometryBuilder/README.md
    psModule_ = (trackerGeometry->getDetectorType(detId) == TrackerGeometry::ModuleType::Ph2PSP);
    barrel_ = detId.subdetId() == StripSubdetector::TOB || detId.subdetId() == StripSubdetector::TIB;

    // Encode layer ID (barrel layers: 1-6, endcap disks: 11-15 + 21-25)
    if (barrel_) {
      layerId_ = trackerTopology->layer(detId);  // barrel layer 1-6 encoded as 1-6
    } else {
      layerId_ = 10 * trackerTopology->side(detId) + trackerTopology->tidWheel(detId);
    }
    // Get reduced layer ID (in range 1-7), requiring only 3 bits for firmware.
    layerIdReduced_ = TrackerModule::calcLayerIdReduced(layerId_);

    // Note module ring in endcap
    endcapRing_ = barrel_ ? 0 : trackerTopology->tidRing(detId);
    if (not barrel_) {
      // Apply bodge, since Topology class annoyingly starts ring count at 1, even in endcap wheels where
      // inner rings are absent.
      unsigned int iWheel = trackerTopology->tidWheel(detId);
      if (iWheel >= 3 && iWheel <= 5)
        endcapRing_ += 3;
    }

    // Note if tilted barrel module & get tilt angle (in range 0 to PI).
    tiltedBarrel_ = barrel_ && (trackerTopology->tobSide(detId) != BarrelModuleType::flat);
    float deltaR = std::abs(R1 - R0);
    float deltaZ = (R1 - R0 > 0) ? (Z1 - Z0) : -(Z1 - Z0);
    tiltAngle_ = atan(deltaR / deltaZ);

    // Get sensor strip or pixel pitch using innermost sensor of pair.

    const Bounds& bounds = det0->surface().bounds();
    sensorWidth_ = bounds.width();  // Width of sensitive region of sensor (= stripPitch * nStrips).
    sensorSpacing_ = sqrt((moduleMaxR_ - moduleMinR_) * (moduleMaxR_ - moduleMinR_) +
                          (moduleMaxZ_ - moduleMinZ_) * (moduleMaxZ_ - moduleMinZ_));
    nStrips_ = specTopol_->nrows();  // No. of strips in sensor
    std::pair<float, float> pitch = specTopol_->pitch();
    stripPitch_ = pitch.first;    // Strip pitch (or pixel pitch along shortest axis)
    stripLength_ = pitch.second;  //  Strip length (or pixel pitch along longest axis)

    // Get module type ID defined by firmware.

    moduleTypeID_ = TrackerModule::calcModuleType(stripPitch_, sensorSpacing_, barrel_, tiltedBarrel_, psModule_);
  }

Member Function Documentation

barrel()

bool tmtt::TrackerModule::barrel ( ) const

inline

Definition at line 65 of file TrackerModule.h.

References barrel_.

Referenced by calcModuleType().

{ return barrel_; }

calcLayerIdReduced()

static unsigned int tmtt::TrackerModule::calcLayerIdReduced ( unsigned int  layerId )

inlinestatic

Definition at line 100 of file TrackerModule.h.

References Exception, and layerId().

Referenced by hph::Setup::Setup(), and TrackerModule().

                                                                 {
      // Don't bother distinguishing two endcaps, as no track can have stubs in both.
      unsigned int lay = (layerId < 20) ? layerId : layerId - 10;

      // No genuine track can have stubs in both barrel layer 6 and endcap disk 11 etc., so merge their layer IDs.
      if (lay == 6)
        lay = 11;
      else if (lay == 5)
        lay = 12;
      else if (lay == 4)
        lay = 13;
      else if (lay == 3)
        lay = 15;
      // At this point, the reduced layer ID can have values of 1, 2, 11, 12, 13, 14, 15. So correct to put in range 1-7.
      if (lay > 10)
        lay -= 8;

      if (lay < 1 || lay > 7)
        throw cms::Exception("LogicError") << "TrackerModule: Reduced layer ID out of expected range";

      return lay;
    }

calcModuleType()

unsigned int tmtt::TrackerModule::calcModuleType	(	float	pitch,
		float	space,
		bool	barrel,
		bool	tiltedBarrel,
		bool	psModule
	)		const

Definition at line 104 of file TrackerModule.cc.

References funct::abs(), barrel(), tmtt::TrackerModule::ModuleTypeCfg::barrelVsType, ALPAKA_ACCELERATOR_NAMESPACE::brokenline::constexpr(), mps_fire::i, moduleTypeCfg_, tmtt::TrackerModule::ModuleTypeCfg::pitchVsType, psModule(), tmtt::TrackerModule::ModuleTypeCfg::psVsType, tmtt::TrackerModule::ModuleTypeCfg::spaceVsType, submitPVValidationJobs::t, submitPVValidationJobs::text, tiltedBarrel(), and tmtt::TrackerModule::ModuleTypeCfg::tiltedVsType.

Referenced by TrackerModule().

                                                                                     {
    // Calculate unique module type ID, allowing sensor pitch/seperation of module to be determined in FW.

    unsigned int moduleType = 999;
    constexpr float tol = 0.001;  // Tolerance

    for (unsigned int i = 0; i < moduleTypeCfg_.pitchVsType.size(); i++) {
      if (std::abs(pitch - moduleTypeCfg_.pitchVsType[i]) < tol &&
          std::abs(space - moduleTypeCfg_.spaceVsType[i]) < tol && barrel == moduleTypeCfg_.barrelVsType[i] &&
          tiltedBarrel == moduleTypeCfg_.tiltedVsType[i] && psModule == moduleTypeCfg_.psVsType[i]) {
        moduleType = i;
      }
    }

    if (moduleType == 999) {
      std::stringstream text;
      text << "WARNING: TrackerModule found tracker module type unknown to firmware: pitch=" << pitch
           << " separation=" << space << " barrel=" << barrel << " tilted=" << tiltedBarrel << " PS=" << psModule;
      std::call_once(
          printOnce, [](string t) { edm::LogWarning("L1track") << t; }, text.str());
    }
    return moduleType;
  }

detId()

const DetId& tmtt::TrackerModule::detId ( ) const

inline

Definition at line 44 of file TrackerModule.h.

References detId_.

Referenced by tmtt::Stub::degradeResolution(), TrackerModule(), and tmtt::StubWindowSuggest::updateStoredWindow().

{ return detId_; }

endcapRing()

unsigned int tmtt::TrackerModule::endcapRing ( ) const

inline

Definition at line 71 of file TrackerModule.h.

References endcapRing_.

{ return endcapRing_; }

layerId()

unsigned int tmtt::TrackerModule::layerId ( ) const

inline

Definition at line 67 of file TrackerModule.h.

References layerId_.

Referenced by calcLayerIdReduced().

{ return layerId_; }

layerIdReduced()

unsigned int tmtt::TrackerModule::layerIdReduced ( ) const

inline

Definition at line 69 of file TrackerModule.h.

References layerIdReduced_.

{ return layerIdReduced_; }

maxPhi()

float tmtt::TrackerModule::maxPhi ( ) const

inline

Definition at line 56 of file TrackerModule.h.

References moduleMaxPhi_.

{ return moduleMaxPhi_; }

maxR()

float tmtt::TrackerModule::maxR ( ) const

inline

Definition at line 54 of file TrackerModule.h.

References moduleMaxR_.

{ return moduleMaxR_; }

maxZ()

float tmtt::TrackerModule::maxZ ( ) const

inline

Definition at line 58 of file TrackerModule.h.

References moduleMaxZ_.

{ return moduleMaxZ_; }

minPhi()

float tmtt::TrackerModule::minPhi ( ) const

inline

Definition at line 55 of file TrackerModule.h.

References moduleMinPhi_.

{ return moduleMinPhi_; }

minR()

float tmtt::TrackerModule::minR ( ) const

inline

Definition at line 53 of file TrackerModule.h.

References moduleMinR_.

{ return moduleMinR_; }

minZ()

float tmtt::TrackerModule::minZ ( ) const

inline

Definition at line 57 of file TrackerModule.h.

References moduleMinZ_.

{ return moduleMinZ_; }

moduleTypeID()

unsigned int tmtt::TrackerModule::moduleTypeID ( ) const

inline

Definition at line 95 of file TrackerModule.h.

References moduleTypeID_.

{ return moduleTypeID_; }

nStrips()

unsigned int tmtt::TrackerModule::nStrips ( ) const

inline

Definition at line 81 of file TrackerModule.h.

References nStrips_.

{ return nStrips_; }

outerModuleAtSmallerR()

bool tmtt::TrackerModule::outerModuleAtSmallerR ( ) const

inline

Definition at line 62 of file TrackerModule.h.

References outerModuleAtSmallerR_.

Referenced by tmtt::Stub::Stub().

{ return outerModuleAtSmallerR_; }

paramB()

float tmtt::TrackerModule::paramB ( ) const

inline

Definition at line 93 of file TrackerModule.h.

References funct::abs(), funct::cos(), funct::sin(), theta(), and tiltAngle().

{ return std::abs(cos(theta() - tiltAngle()) / sin(theta())); }

pitchOverSep()

float tmtt::TrackerModule::pitchOverSep ( ) const

inline

Definition at line 91 of file TrackerModule.h.

References sensorSpacing_, and stripPitch_.

Referenced by tmtt::Stub::calcDphiOverBend().

{ return stripPitch_ / sensorSpacing_; }

psModule()

bool tmtt::TrackerModule::psModule ( ) const

inline

Definition at line 64 of file TrackerModule.h.

References psModule_.

Referenced by calcModuleType().

{ return psModule_; }

rawDetId()

unsigned int tmtt::TrackerModule::rawDetId ( ) const

inline

Definition at line 45 of file TrackerModule.h.

References detId_, and DetId::rawId().

{ return detId_.rawId(); }

rawStackedDetId()

unsigned int tmtt::TrackerModule::rawStackedDetId ( ) const

inline

Definition at line 48 of file TrackerModule.h.

References DetId::rawId(), and stackedDetId_.

{ return stackedDetId_.rawId(); }

sensorSpacing()

float tmtt::TrackerModule::sensorSpacing ( ) const

inline

Definition at line 79 of file TrackerModule.h.

References sensorSpacing_.

{ return sensorSpacing_; }

sensorWidth()

float tmtt::TrackerModule::sensorWidth ( ) const

inline

Definition at line 77 of file TrackerModule.h.

References sensorWidth_.

Referenced by tmtt::Stub::Stub().

{ return sensorWidth_; }

sigmaPar()

float tmtt::TrackerModule::sigmaPar ( ) const

inline

Definition at line 89 of file TrackerModule.h.

References invRoot12, and stripLength_.

{ return invRoot12 * stripLength_; }

sigmaPerp()

float tmtt::TrackerModule::sigmaPerp ( ) const

inline

Definition at line 87 of file TrackerModule.h.

References invRoot12, and stripPitch_.

{ return invRoot12 * stripPitch_; }

specDet()

const PixelGeomDetUnit* tmtt::TrackerModule::specDet ( ) const

inline

Definition at line 50 of file TrackerModule.h.

References specDet_.

Referenced by tmtt::Stub::Stub().

{ return specDet_; }

specTopol()

const PixelTopology* tmtt::TrackerModule::specTopol ( ) const

inline

Definition at line 51 of file TrackerModule.h.

References specTopol_.

Referenced by tmtt::Stub::Stub().

{ return specTopol_; }

stackedDetId()

const DetId& tmtt::TrackerModule::stackedDetId ( ) const

inline

Definition at line 47 of file TrackerModule.h.

References stackedDetId_.

{ return stackedDetId_; }

stripLength()

float tmtt::TrackerModule::stripLength ( ) const

inline

Definition at line 85 of file TrackerModule.h.

References stripLength_.

{ return stripLength_; }

stripPitch()

float tmtt::TrackerModule::stripPitch ( ) const

inline

Definition at line 83 of file TrackerModule.h.

References stripPitch_.

{ return stripPitch_; }

theta()

float tmtt::TrackerModule::theta ( void  ) const

inline

Definition at line 60 of file TrackerModule.h.

References moduleMinR_, and moduleMinZ_.

Referenced by paramB(), and Tau.Tau::zImpact().

{ return atan2(moduleMinR_, moduleMinZ_); }

tiltAngle()

float tmtt::TrackerModule::tiltAngle ( ) const

inline

Definition at line 75 of file TrackerModule.h.

References tiltAngle_.

Referenced by tmtt::Stub::calcDphiOverBend(), and paramB().

{ return tiltAngle_; }

tiltedBarrel()

bool tmtt::TrackerModule::tiltedBarrel ( ) const

inline

Definition at line 73 of file TrackerModule.h.

References tiltedBarrel_.

Referenced by calcModuleType().

{ return tiltedBarrel_; }

Member Data Documentation

barrel_

bool tmtt::TrackerModule::barrel_

private

Definition at line 139 of file TrackerModule.h.

Referenced by barrel(), and TrackerModule().

detId_

DetId tmtt::TrackerModule::detId_

private

Definition at line 127 of file TrackerModule.h.

Referenced by detId(), rawDetId(), and TrackerModule().

endcapRing_

unsigned int tmtt::TrackerModule::endcapRing_

private

Definition at line 142 of file TrackerModule.h.

Referenced by endcapRing(), and TrackerModule().

invRoot12

const float tmtt::TrackerModule::invRoot12 = sqrt(1. / 12.)

staticprivate

Definition at line 154 of file TrackerModule.h.

Referenced by sigmaPar(), and sigmaPerp().

layerId_

unsigned int tmtt::TrackerModule::layerId_

private

Definition at line 140 of file TrackerModule.h.

Referenced by layerId(), and TrackerModule().

layerIdReduced_

unsigned int tmtt::TrackerModule::layerIdReduced_

private

Definition at line 141 of file TrackerModule.h.

Referenced by layerIdReduced(), and TrackerModule().

moduleMaxPhi_

float tmtt::TrackerModule::moduleMaxPhi_

private

Definition at line 134 of file TrackerModule.h.

Referenced by maxPhi(), and TrackerModule().

moduleMaxR_

float tmtt::TrackerModule::moduleMaxR_

private

Definition at line 132 of file TrackerModule.h.

Referenced by maxR(), and TrackerModule().

moduleMaxZ_

float tmtt::TrackerModule::moduleMaxZ_

private

Definition at line 136 of file TrackerModule.h.

Referenced by maxZ(), and TrackerModule().

moduleMinPhi_

float tmtt::TrackerModule::moduleMinPhi_

private

Definition at line 133 of file TrackerModule.h.

Referenced by minPhi(), and TrackerModule().

moduleMinR_

float tmtt::TrackerModule::moduleMinR_

private

Definition at line 131 of file TrackerModule.h.

Referenced by minR(), theta(), and TrackerModule().

moduleMinZ_

float tmtt::TrackerModule::moduleMinZ_

private

Definition at line 135 of file TrackerModule.h.

Referenced by minZ(), theta(), and TrackerModule().

moduleTypeCfg_

ModuleTypeCfg tmtt::TrackerModule::moduleTypeCfg_

private

Definition at line 152 of file TrackerModule.h.

Referenced by calcModuleType().

moduleTypeID_

unsigned int tmtt::TrackerModule::moduleTypeID_

private

Definition at line 150 of file TrackerModule.h.

Referenced by moduleTypeID(), and TrackerModule().

nStrips_

unsigned int tmtt::TrackerModule::nStrips_

private

Definition at line 147 of file TrackerModule.h.

Referenced by nStrips(), and TrackerModule().

outerModuleAtSmallerR_

bool tmtt::TrackerModule::outerModuleAtSmallerR_

private

Definition at line 137 of file TrackerModule.h.

Referenced by outerModuleAtSmallerR(), and TrackerModule().

psModule_

bool tmtt::TrackerModule::psModule_

private

Definition at line 138 of file TrackerModule.h.

Referenced by psModule(), and TrackerModule().

sensorSpacing_

float tmtt::TrackerModule::sensorSpacing_

private

Definition at line 146 of file TrackerModule.h.

Referenced by pitchOverSep(), sensorSpacing(), and TrackerModule().

sensorWidth_

float tmtt::TrackerModule::sensorWidth_

private

Definition at line 145 of file TrackerModule.h.

Referenced by sensorWidth(), and TrackerModule().

specDet_

const PixelGeomDetUnit* tmtt::TrackerModule::specDet_

private

Definition at line 129 of file TrackerModule.h.

Referenced by specDet(), and TrackerModule().

specTopol_

const PixelTopology* tmtt::TrackerModule::specTopol_

private

Definition at line 130 of file TrackerModule.h.

Referenced by specTopol(), and TrackerModule().

stackedDetId_

DetId tmtt::TrackerModule::stackedDetId_

private

Definition at line 128 of file TrackerModule.h.

Referenced by rawStackedDetId(), stackedDetId(), and TrackerModule().

stripLength_

float tmtt::TrackerModule::stripLength_

private

Definition at line 149 of file TrackerModule.h.

Referenced by sigmaPar(), stripLength(), and TrackerModule().

stripPitch_

float tmtt::TrackerModule::stripPitch_

private

Definition at line 148 of file TrackerModule.h.

Referenced by pitchOverSep(), sigmaPerp(), stripPitch(), and TrackerModule().

tiltAngle_

float tmtt::TrackerModule::tiltAngle_

private

Definition at line 144 of file TrackerModule.h.

Referenced by tiltAngle(), and TrackerModule().

tiltedBarrel_

bool tmtt::TrackerModule::tiltedBarrel_

private

Definition at line 143 of file TrackerModule.h.

Referenced by tiltedBarrel(), and TrackerModule().