The manager class for TOTEM RP geometry. More...

#include <CTPPSGeometry.h>

Public Types
typedef std::map< unsigned int, std::set< unsigned int > >	mapSetType

typedef std::map< unsigned int, const DetGeomDesc * >	mapType

typedef std::map< int, const DetGeomDesc * >	RPDeviceMapType

using	Vector = DetGeomDesc::Translation

Public Member Functions
bool	addRP (unsigned int id, const DetGeomDesc *&)
	adds a RP box to a map More...

bool	addSensor (unsigned int, const DetGeomDesc *&)
	adds an item to the map (detector ID --> DetGeomDesc) performs necessary checks More...

RPDeviceMapType::const_iterator	beginRP () const
	begin iterator over RPs More...

mapType::const_iterator	beginSensor () const
	begin iterator over sensors More...

void	build (const DetGeomDesc *, unsigned int verbosity)
	build up from DetGeomDesc structure More...

	CTPPSGeometry (const DetGeomDesc *gd, unsigned int verbosity)
	build up from DetGeomDesc More...

RPDeviceMapType::const_iterator	endRP () const
	end iterator over RPs More...

mapType::const_iterator	endSensor () const
	end iterator over sensors More...

Vector	globalToLocal (const DetGeomDesc *, const Vector &) const

Vector	globalToLocal (unsigned int, const Vector &) const

Vector	globalToLocalDirection (unsigned int id, const Vector &) const

Vector	localToGlobal (const DetGeomDesc *, const Vector &) const

Vector	localToGlobal (unsigned int, const Vector &) const

Vector	localToGlobalDirection (unsigned int id, const Vector &) const

const DetGeomDesc *	rp (unsigned int id) const
	returns geometry of a RP box More...

const DetGeomDesc *	rpNoThrow (unsigned int id) const noexcept

const std::set< unsigned int > &	rpsInStation (unsigned int) const
	after checks returns set of RP ids corresponding to the given station id More...

Vector	rpTranslation (unsigned int id) const

const DetGeomDesc *	sensor (unsigned int id) const
	returns geometry of a detector performs necessary checks, returns NULL if fails More...

const DetGeomDesc *	sensorNoThrow (unsigned int id) const noexcept

const std::set< unsigned int > &	sensorsInRP (unsigned int) const
	after checks returns set of sensor ids corresponding to the given RP id More...

Vector	sensorTranslation (unsigned int id) const

const std::set< unsigned int > &	stationsInArm (unsigned int) const
	after checks returns set of station ids corresponding to the given arm id More...

Protected Attributes
mapSetType	dets_in_rp_

mapSetType	rps_in_station_

RPDeviceMapType	rps_map_
	map: rp id --> DetGeomDesc More...

mapType	sensors_map_
	map: sensor id --> DetGeomDesc More...

mapSetType	stations_in_arm_
	map: parent ID -> set of subelements E.g. stations_in_arm_ is map of arm ID -> set of stations (in that arm) More...

Detailed Description

The manager class for TOTEM RP geometry.

This is kind of "public relation class" for the tree structure of DetGeomDesc. It provides convenient interface to answer frequently asked questions about the geometry of TOTEM Roman Pots. These questions are of type:

What is the geometry (shift, roatation, material, etc.) of detector with id xxx?
If RP ID is xxx, which are the sensorss inside this pot?
If hit position in local detector coordinate system is xxx, what is the hit position in global c.s.?
etc. (see the comments in definition bellow)

Definition at line 29 of file CTPPSGeometry.h.

Member Typedef Documentation

◆ mapSetType

typedef std::map<unsigned int, std::set<unsigned int> > CTPPSGeometry::mapSetType

Definition at line 37 of file CTPPSGeometry.h.

◆ mapType

typedef std::map<unsigned int, const DetGeomDesc*> CTPPSGeometry::mapType

Definition at line 35 of file CTPPSGeometry.h.

◆ RPDeviceMapType

typedef std::map<int, const DetGeomDesc*> CTPPSGeometry::RPDeviceMapType

Definition at line 36 of file CTPPSGeometry.h.

◆ Vector

using CTPPSGeometry::Vector = DetGeomDesc::Translation

Definition at line 39 of file CTPPSGeometry.h.

Constructor & Destructor Documentation

◆ CTPPSGeometry()

CTPPSGeometry::CTPPSGeometry	(	const DetGeomDesc *	gd,
		unsigned int	verbosity
	)

inline

build up from DetGeomDesc

Definition at line 42 of file CTPPSGeometry.h.

Member Function Documentation

◆ addRP()

bool CTPPSGeometry::addRP	(	unsigned int	id,
		const DetGeomDesc *&	gD
	)

adds a RP box to a map

Returns: true if successful, false if the RP is already present

Definition at line 81 of file CTPPSGeometry.cc.

                                                                  {
   if (rps_map_.find(id) != rps_map_.end())
     return false;
  
   rps_map_[id] = gD;
   return true;

References triggerObjects_cff::id, and rps_map_.

Referenced by build().

◆ addSensor()

bool CTPPSGeometry::addSensor	(	unsigned int	id,
		const DetGeomDesc *&	gD
	)

adds an item to the map (detector ID --> DetGeomDesc) performs necessary checks

Returns: true if successful, false if the sensor is already present

Definition at line 71 of file CTPPSGeometry.cc.

                                                                      {
   if (sensors_map_.find(id) != sensors_map_.end())
     return false;
  
   sensors_map_[id] = gD;
   return true;

References triggerObjects_cff::id, and sensors_map_.

Referenced by build().

◆ beginRP()

RPDeviceMapType::const_iterator CTPPSGeometry::beginRP ( ) const

inline

begin iterator over RPs

Definition at line 75 of file CTPPSGeometry.h.

◆ beginSensor()

mapType::const_iterator CTPPSGeometry::beginSensor ( ) const

inline

begin iterator over sensors

Definition at line 70 of file CTPPSGeometry.h.

◆ build()

void CTPPSGeometry::build	(	const DetGeomDesc *	gD,
		unsigned int	verbosity
	)

build up from DetGeomDesc structure

Definition at line 14 of file CTPPSGeometry.cc.

                                                                        {
   // reset
   sensors_map_.clear();
   rps_map_.clear();
   stations_in_arm_.clear();
   rps_in_station_.clear();
   dets_in_rp_.clear();
  
   // propagate through the GeometricalDet structure and add all detectors to 'sensors_map_'
   std::deque<const DetGeomDesc*> buffer;
   buffer.emplace_back(gD);
   while (!buffer.empty()) {
     const DetGeomDesc* d = buffer.front();
     buffer.pop_front();
  
     // verbosity printout
     if (verbosity == 2) {
       d->print();
     }
  
     // check if it is a sensor
     if (d->name() == DDD_TOTEM_RP_SENSOR_NAME ||
         std::regex_match(d->name(), std::regex(DDD_TOTEM_TIMING_SENSOR_TMPL)) ||
         d->name() == DDD_CTPPS_DIAMONDS_SEGMENT_NAME || d->name() == DDD_CTPPS_UFSD_SEGMENT_NAME ||
         d->name() == DDD_CTPPS_PIXELS_SENSOR_NAME || d->name() == DDD_CTPPS_PIXELS_SENSOR_NAME_2x2)
       addSensor(d->geographicalID(), d);
  
     // check if it is a RP
     if (d->name() == DDD_TOTEM_RP_RP_NAME || d->name() == DDD_TOTEM_TIMING_RP_NAME ||
         d->name() == DDD_CTPPS_DIAMONDS_RP_NAME || d->name() == DDD_CTPPS_PIXELS_RP_NAME)
       addRP(d->geographicalID(), d);
  
     for (const auto& comp : d->components())
       buffer.emplace_back(comp);
   }
  
   // verbosity printout
   if (verbosity) {
     edm::LogVerbatim("CTPPSGeometry::build")
         << "sensors_map_.size() = " << sensors_map_.size() << ", rps_map_.size() = " << rps_map_.size() << std::endl;
   }
  
   // build sets
   for (const auto& it : sensors_map_) {
     const CTPPSDetId detId(it.first);
     const CTPPSDetId rpId = detId.rpId();
     const CTPPSDetId stId = detId.stationId();
     const CTPPSDetId armId = detId.armId();
  
     stations_in_arm_[armId].insert(armId);
     rps_in_station_[stId].insert(rpId);
     dets_in_rp_[rpId].insert(detId);
   }

References addRP(), addSensor(), CTPPSDetId::armId(), edmScanValgrind::buffer, AlCaHLTBitMon_QueryRunRegistry::comp, ztail::d, DDD_CTPPS_DIAMONDS_RP_NAME, DDD_CTPPS_DIAMONDS_SEGMENT_NAME, DDD_CTPPS_PIXELS_RP_NAME, DDD_CTPPS_PIXELS_SENSOR_NAME, DDD_CTPPS_PIXELS_SENSOR_NAME_2x2, DDD_CTPPS_UFSD_SEGMENT_NAME, DDD_TOTEM_RP_RP_NAME, DDD_TOTEM_RP_SENSOR_NAME, DDD_TOTEM_TIMING_RP_NAME, DDD_TOTEM_TIMING_SENSOR_TMPL, dets_in_rp_, profile_2016_postTS2_cff::rpId, CTPPSDetId::rpId(), rps_in_station_, rps_map_, sensors_map_, CTPPSDetId::stationId(), stations_in_arm_, and ctppsCommonDQMSource_cfi::verbosity.

◆ endRP()

RPDeviceMapType::const_iterator CTPPSGeometry::endRP ( ) const

inline

end iterator over RPs

Definition at line 77 of file CTPPSGeometry.h.

◆ endSensor()

mapType::const_iterator CTPPSGeometry::endSensor ( ) const

inline

end iterator over sensors

Definition at line 72 of file CTPPSGeometry.h.

72 { return rps_map_.begin(); }

References rps_map_.

◆ globalToLocal() [1/2]

CTPPSGeometry::Vector CTPPSGeometry::globalToLocal	(	const DetGeomDesc *	gd,
		const Vector &	r
	)		const

Definition at line 170 of file CTPPSGeometry.cc.

171 {

172 return gd->rotation().Inverse() * (r - gd->translation());

References alignCSCRings::r, DetGeomDesc::rotation(), and DetGeomDesc::translation().

Referenced by globalToLocal().

◆ globalToLocal() [2/2]

CTPPSGeometry::Vector CTPPSGeometry::globalToLocal	(	unsigned int	id,
		const Vector &	r
	)		const

Definition at line 176 of file CTPPSGeometry.cc.

177 {

178 return globalToLocal(sensor(id), r);

References globalToLocal(), alignCSCRings::r, and sensor().

◆ globalToLocalDirection()

CTPPSGeometry::Vector CTPPSGeometry::globalToLocalDirection	(	unsigned int	id,
		const Vector &	dir
	)		const

direction transformations between global and local reference frames

Parameters

id sensor id

Definition at line 188 of file CTPPSGeometry.cc.

189 {

190 return sensor(id)->rotation().Inverse() * dir;

References DeadROC_duringRun::dir, DetGeomDesc::rotation(), and sensor().

◆ localToGlobal() [1/2]

CTPPSGeometry::Vector CTPPSGeometry::localToGlobal	(	const DetGeomDesc *	gd,
		const Vector &	r
	)		const

coordinate transformations between local<-->global reference frames dimensions in mm sensor id expected

Definition at line 158 of file CTPPSGeometry.cc.

159 {

160 return gd->rotation() * r + gd->translation();

References alignCSCRings::r, DetGeomDesc::rotation(), and DetGeomDesc::translation().

Referenced by RPixPlaneCombinatoryTracking::calculatePointOnDetector(), RPixRoadFinder::findPattern(), and localToGlobal().

◆ localToGlobal() [2/2]

CTPPSGeometry::Vector CTPPSGeometry::localToGlobal	(	unsigned int	id,
		const Vector &	r
	)		const

Definition at line 164 of file CTPPSGeometry.cc.

165 {

166 return localToGlobal(sensor(id), r);

References localToGlobal(), alignCSCRings::r, and sensor().

◆ localToGlobalDirection()

CTPPSGeometry::Vector CTPPSGeometry::localToGlobalDirection	(	unsigned int	id,
		const Vector &	dir
	)		const

direction transformations between local and global reference frames

Parameters

id sensor id

Definition at line 182 of file CTPPSGeometry.cc.

183 {

184 return sensor(id)->rotation() * dir;

References DeadROC_duringRun::dir, DetGeomDesc::rotation(), and sensor().

Referenced by TotemRPLocalTrackFitterAlgorithm::prepareReconstAlgebraData().

◆ rp()

const DetGeomDesc * CTPPSGeometry::rp ( unsigned int id ) const

returns geometry of a RP box

Definition at line 111 of file CTPPSGeometry.cc.

                                                           {
   auto rp = rpNoThrow(id);
   if (nullptr == rp) {
     throw cms::Exception("CTPPSGeometry") << "Not found RP device with ID " << id << ", i.e. " << CTPPSDetId(id);
   }
   return rp;

References Exception, and rpNoThrow().

Referenced by rpTranslation().

◆ rpNoThrow()

const DetGeomDesc * CTPPSGeometry::rpNoThrow ( unsigned int id ) const

noexcept

Definition at line 121 of file CTPPSGeometry.cc.

                                                                           {
   auto it = rps_map_.find(id);
   if (it == rps_map_.end()) {
     return nullptr;
   }
  
   return it->second;

Referenced by rp().

◆ rpsInStation()

const std::set< unsigned int > & CTPPSGeometry::rpsInStation ( unsigned int id ) const

after checks returns set of RP ids corresponding to the given station id

Definition at line 140 of file CTPPSGeometry.cc.

                                                                              {
   auto it = rps_in_station_.find(id);
   if (it == rps_in_station_.end())
     throw cms::Exception("CTPPSGeometry") << "Station with ID " << id << " not found.";
   return it->second;

References rps_in_station_.

◆ rpTranslation()

CTPPSGeometry::Vector CTPPSGeometry::rpTranslation ( unsigned int id ) const

returns position of a RP box

Parameters

id RP id

Definition at line 201 of file CTPPSGeometry.cc.

                                                                       {
   auto gd = rp(id);
   return gd->translation();

References rp().

Referenced by CTPPSProtonProducer::produce().

◆ sensor()

const DetGeomDesc * CTPPSGeometry::sensor ( unsigned int id ) const

returns geometry of a detector performs necessary checks, returns NULL if fails

Definition at line 91 of file CTPPSGeometry.cc.

                                                               {
   auto g = sensorNoThrow(id);
   if (nullptr == g) {
     throw cms::Exception("CTPPSGeometry") << "Not found detector with ID " << id << ", i.e. " << CTPPSDetId(id);
   }
   return g;

References Exception, g, and sensorNoThrow().

Referenced by RPixPlaneCombinatoryTracking::calculatePointOnDetector(), RPixRoadFinder::findPattern(), RPixPlaneCombinatoryTracking::findTracks(), globalToLocal(), globalToLocalDirection(), localToGlobal(), localToGlobalDirection(), sensorTranslation(), and IdealResult::solve().

◆ sensorNoThrow()

const DetGeomDesc * CTPPSGeometry::sensorNoThrow ( unsigned int id ) const

noexcept

Definition at line 101 of file CTPPSGeometry.cc.

                                                                               {
   auto it = sensors_map_.find(id);
   if (it == sensors_map_.end()) {
     return nullptr;
   }
   return it->second;

Referenced by sensor().

◆ sensorsInRP()

const std::set< unsigned int > & CTPPSGeometry::sensorsInRP ( unsigned int id ) const

after checks returns set of sensor ids corresponding to the given RP id

Definition at line 149 of file CTPPSGeometry.cc.

                                                                             {
   auto it = dets_in_rp_.find(id);
   if (it == dets_in_rp_.end())
     throw cms::Exception("CTPPSGeometry") << "RP with ID " << id << " not found.";
   return it->second;

References dets_in_rp_.

◆ sensorTranslation()

CTPPSGeometry::Vector CTPPSGeometry::sensorTranslation ( unsigned int id ) const

returns translation (position) of a detector

Parameters

id sensor id

Definition at line 194 of file CTPPSGeometry.cc.

                                                                           {
   auto gd = sensor(id);
   return gd->translation();

References sensor().

Referenced by TotemRPLocalTrackFitterAlgorithm::prepareReconstAlgebraData().

◆ stationsInArm()

const std::set< unsigned int > & CTPPSGeometry::stationsInArm ( unsigned int id ) const

after checks returns set of station ids corresponding to the given arm id

Definition at line 131 of file CTPPSGeometry.cc.

                                                                               {
   auto it = stations_in_arm_.find(id);
   if (it == stations_in_arm_.end())
     throw cms::Exception("CTPPSGeometry") << "Arm with ID " << id << " not found.";
   return it->second;

References stations_in_arm_.

Member Data Documentation

◆ dets_in_rp_

mapSetType CTPPSGeometry::dets_in_rp_

protected

Definition at line 122 of file CTPPSGeometry.h.

Referenced by build(), and sensorsInRP().

◆ rps_in_station_

mapSetType CTPPSGeometry::rps_in_station_

protected

Definition at line 122 of file CTPPSGeometry.h.

Referenced by build(), and rpsInStation().

◆ rps_map_

RPDeviceMapType CTPPSGeometry::rps_map_

protected

map: rp id --> DetGeomDesc

Definition at line 118 of file CTPPSGeometry.h.

Referenced by addRP(), build(), and endSensor().

◆ sensors_map_

mapType CTPPSGeometry::sensors_map_

protected

map: sensor id --> DetGeomDesc

Definition at line 115 of file CTPPSGeometry.h.

Referenced by addSensor(), and build().

◆ stations_in_arm_

mapSetType CTPPSGeometry::stations_in_arm_

protected

map: parent ID -> set of subelements E.g. stations_in_arm_ is map of arm ID -> set of stations (in that arm)

Definition at line 122 of file CTPPSGeometry.h.

Referenced by build(), and stationsInArm().

Public Types

Public Member Functions

Protected Attributes

Detailed Description

Member Typedef Documentation

◆ mapSetType

◆ mapType

◆ RPDeviceMapType

◆ Vector

Constructor & Destructor Documentation

◆ CTPPSGeometry()

Member Function Documentation

◆ addRP()

◆ addSensor()

◆ beginRP()

◆ beginSensor()

◆ build()

◆ endRP()

◆ endSensor()

◆ globalToLocal() [1/2]

◆ globalToLocal() [2/2]

◆ globalToLocalDirection()

◆ localToGlobal() [1/2]

◆ localToGlobal() [2/2]

◆ localToGlobalDirection()

◆ rp()

◆ rpNoThrow()

◆ rpsInStation()

◆ rpTranslation()

◆ sensor()

◆ sensorNoThrow()

◆ sensorsInRP()

◆ sensorTranslation()

◆ stationsInArm()

Member Data Documentation

◆ dets_in_rp_

◆ rps_in_station_

◆ rps_map_

◆ sensors_map_

◆ stations_in_arm_