CTPPSGeometry Class Reference

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

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 *)
	build up from DetGeomDesc structure More...
	CTPPSGeometry ()
	CTPPSGeometry (const DetGeomDesc *gd)
	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...
const DetGeomDesc *	getRP (unsigned int id) const
	returns geometry of a RP box More...
const DetGeomDesc *	getRPNoThrow (unsigned int id) const
const std::set< unsigned int > &	getRPsInStation (unsigned int) const
	after checks returns set of RP ids corresponding to the given station id More...
CLHEP::Hep3Vector	getRPTranslation (unsigned int id) const
const DetGeomDesc *	getSensor (unsigned int id) const
	returns geometry of a detector performs necessary checks, returns NULL if fails More...
const DetGeomDesc *	getSensorNoThrow (unsigned int id) const
const std::set< unsigned int > &	getSensorsInRP (unsigned int) const
	after checks returns set of sensor ids corresponding to the given RP id More...
CLHEP::Hep3Vector	getSensorTranslation (unsigned int id) const
const std::set< unsigned int > &	getStationsInArm (unsigned int) const
	after checks returns set of station ids corresponding to the given arm id More...
CLHEP::Hep3Vector	globalToLocal (const DetGeomDesc *, const CLHEP::Hep3Vector &) const
CLHEP::Hep3Vector	globalToLocal (unsigned int, const CLHEP::Hep3Vector &) const
CLHEP::Hep3Vector	globalToLocalDirection (unsigned int id, const CLHEP::Hep3Vector &) const
CLHEP::Hep3Vector	localToGlobal (const DetGeomDesc *, const CLHEP::Hep3Vector &) const
CLHEP::Hep3Vector	localToGlobal (unsigned int, const CLHEP::Hep3Vector &) const
CLHEP::Hep3Vector	localToGlobalDirection (unsigned int id, const CLHEP::Hep3Vector &) const
	~CTPPSGeometry ()

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 33 of file CTPPSGeometry.h.

Member Typedef Documentation

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

Definition at line 38 of file CTPPSGeometry.h.

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

Definition at line 36 of file CTPPSGeometry.h.

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

Definition at line 37 of file CTPPSGeometry.h.

Constructor & Destructor Documentation

CTPPSGeometry::CTPPSGeometry ( )

inline

Definition at line 40 of file CTPPSGeometry.h.

{}

CTPPSGeometry::~CTPPSGeometry ( )

inline

Definition at line 41 of file CTPPSGeometry.h.

{}

CTPPSGeometry::CTPPSGeometry ( const DetGeomDesc *  gd )

inline

build up from DetGeomDesc

Definition at line 44 of file CTPPSGeometry.h.

References addRP(), addSensor(), build(), getRP(), getRPNoThrow(), getSensor(), getSensorNoThrow(), and noexcept.

{ build( gd ); }

Member Function Documentation

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 77 of file CTPPSGeometry.cc.

References triggerObjects_cff::id, and rps_map_.

Referenced by build(), and CTPPSGeometry().

{
  if ( rps_map_.find( id ) != rps_map_.end() ) return false;

  rps_map_[id] = gD;
  return true;
}

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 66 of file CTPPSGeometry.cc.

References triggerObjects_cff::id, and sensors_map_.

Referenced by build(), and CTPPSGeometry().

{
  if ( sensors_map_.find( id ) != sensors_map_.end() ) return false;

  sensors_map_[id] = gD;
  return true;
}

RPDeviceMapType::const_iterator CTPPSGeometry::beginRP ( ) const

inline

begin iterator over RPs

Definition at line 77 of file CTPPSGeometry.h.

References rps_map_.

Referenced by CTPPSGeometryInfo::printGeometry().

{ return rps_map_.begin(); }

mapType::const_iterator CTPPSGeometry::beginSensor ( ) const

inline

begin iterator over sensors

Definition at line 72 of file CTPPSGeometry.h.

References sensors_map_.

Referenced by CTPPSGeometryInfo::printGeometry().

{ return sensors_map_.begin(); }

void CTPPSGeometry::build

(

const DetGeomDesc *

gD

)

build up from DetGeomDesc structure

Definition at line 15 of file CTPPSGeometry.cc.

References addRP(), addSensor(), edmScanValgrind::buffer, AlCaHLTBitMon_QueryRunRegistry::comp, DetGeomDesc::components(), edmIntegrityCheck::d, DDD_CTPPS_DIAMONDS_RP_NAME, DDD_CTPPS_DIAMONDS_SEGMENT_NAME, DDD_CTPPS_PIXELS_RP_NAME, DDD_CTPPS_PIXELS_SENSOR_NAME, 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_, DetGeomDesc::geographicalID(), CTPPSDetId::getArmId(), CTPPSDetId::getRPId(), CTPPSDetId::getStationId(), DetGeomDesc::name(), year_2016_postTS2_cff::rpId, rps_in_station_, rps_map_, sensors_map_, and stations_in_arm_.

Referenced by CTPPSGeometry().

{
  // 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();

    // 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 )
      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 );
  }

  // build sets
  for ( const auto& it : sensors_map_ ) {
    const CTPPSDetId detId( it.first );
    const CTPPSDetId rpId = detId.getRPId();
    const CTPPSDetId stId = detId.getStationId();
    const CTPPSDetId armId = detId.getArmId();

    stations_in_arm_[armId].insert( armId );
    rps_in_station_[stId].insert( rpId );
    dets_in_rp_[rpId].insert( detId );
  }
}

RPDeviceMapType::const_iterator CTPPSGeometry::endRP ( ) const

inline

end iterator over RPs

Definition at line 79 of file CTPPSGeometry.h.

References getRPsInStation(), getRPTranslation(), getSensorsInRP(), getSensorTranslation(), getStationsInArm(), globalToLocal(), globalToLocalDirection(), localToGlobal(), localToGlobalDirection(), and rps_map_.

Referenced by CTPPSGeometryInfo::printGeometry().

{ return rps_map_.end(); }

mapType::const_iterator CTPPSGeometry::endSensor ( ) const

inline

end iterator over sensors

Definition at line 74 of file CTPPSGeometry.h.

References sensors_map_.

Referenced by CTPPSGeometryInfo::printGeometry().

{ return sensors_map_.end(); }

const DetGeomDesc * CTPPSGeometry::getRP

(

unsigned int

id

)

const

returns geometry of a RP box

Definition at line 113 of file CTPPSGeometry.cc.

References Exception, and getRPNoThrow().

Referenced by CTPPSGeometry(), getRPTranslation(), and TotemRPUVPatternFinder::produce().

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

const DetGeomDesc * CTPPSGeometry::getRPNoThrow

(

unsigned int

id

)

const

Definition at line 126 of file CTPPSGeometry.cc.

References rps_map_.

Referenced by CTPPSGeometry(), and getRP().

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

  return it->second;
}

const std::set< unsigned int > & CTPPSGeometry::getRPsInStation

(

unsigned int

id

)

const

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

Definition at line 149 of file CTPPSGeometry.cc.

References rps_in_station_.

Referenced by endRP().

{
  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;
}

CLHEP::Hep3Vector CTPPSGeometry::getRPTranslation

(

unsigned int

id

)

const

returns position of a RP box

Parameters

id

RP id

Definition at line 228 of file CTPPSGeometry.cc.

References getRP().

Referenced by TotemRPDQMSource::analyze(), CTPPSProtonReconstructionPlotter::CalculateTimingTrackingDistance(), endRP(), TotemRPLocalTrackFitter::produce(), CTPPSProtonProducer::produce(), and CTPPSPixelLocalTrackProducer::produce().

{
  auto gd = getRP( id );
  return CLHEP::Hep3Vector( gd->translation().x(), gd->translation().y(), gd->translation().z() );
}

const DetGeomDesc * CTPPSGeometry::getSensor

(

unsigned int

id

)

const

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

Definition at line 88 of file CTPPSGeometry.cc.

References Exception, g, and getSensorNoThrow().

Referenced by TotemRPDQMSource::analyze(), TotemTimingDQMSource::analyze(), CTPPSDiamondRecHitProducerAlgorithm::build(), RPixPlaneCombinatoryTracking::calculatePointOnDetector(), channelAlignedWithTrack(), CTPPSGeometry(), CTPPSDiamondDQMSource::dqmBeginRun(), RPixRoadFinder::findPattern(), RPixPlaneCombinatoryTracking::findTracks(), getSensorTranslation(), globalToLocal(), globalToLocalDirection(), localToGlobal(), localToGlobalDirection(), and CTPPSDirectProtonSimulation::processProton().

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

const DetGeomDesc * CTPPSGeometry::getSensorNoThrow

(

unsigned int

id

)

const

Definition at line 101 of file CTPPSGeometry.cc.

References sensors_map_.

Referenced by TotemTimingRecHitProducerAlgorithm::build(), CTPPSGeometry(), TotemTimingDQMSource::dqmBeginRun(), and getSensor().

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

const std::set< unsigned int > & CTPPSGeometry::getSensorsInRP

(

unsigned int

id

)

const

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

Definition at line 160 of file CTPPSGeometry.cc.

References dets_in_rp_.

Referenced by endRP(), and CTPPSDirectProtonSimulation::processProton().

{
  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;
}

CLHEP::Hep3Vector CTPPSGeometry::getSensorTranslation

(

unsigned int

id

)

const

returns translation (position) of a detector

Parameters

id

sensor id

Definition at line 219 of file CTPPSGeometry.cc.

References getSensor().

Referenced by endRP(), and TotemRPLocalTrackFitterAlgorithm::prepareReconstAlgebraData().

{
  auto gd = getSensor( id );
  return CLHEP::Hep3Vector( gd->translation().x(), gd->translation().y(), gd->translation().z() );
}

const std::set< unsigned int > & CTPPSGeometry::getStationsInArm

(

unsigned int

id

)

const

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

Definition at line 138 of file CTPPSGeometry.cc.

References stations_in_arm_.

Referenced by endRP().

{
  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;
}

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

Definition at line 187 of file CTPPSGeometry.cc.

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

Referenced by TotemRPDQMSource::analyze(), endRP(), globalToLocal(), and CTPPSDirectProtonSimulation::processProton().

{
  return gd->rotation().Inverse() * ( r - CLHEP::Hep3Vector( gd->translation().x(), gd->translation().y(), gd->translation().z() ) );
}

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

Definition at line 195 of file CTPPSGeometry.cc.

References getSensor(), and globalToLocal().

{
  return globalToLocal( getSensor( id ), r );
}

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

direction transformations between global and local reference frames

Parameters

id

sensor id

Definition at line 211 of file CTPPSGeometry.cc.

References dir, getSensor(), and DetGeomDesc::rotation().

Referenced by endRP().

{
  return getSensor( id )->rotation().Inverse() * dir;
}

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

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

Definition at line 171 of file CTPPSGeometry.cc.

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

Referenced by RPixPlaneCombinatoryTracking::calculatePointOnDetector(), endRP(), RPixRoadFinder::findPattern(), localToGlobal(), CTPPSGeometryInfo::printGeometry(), and CTPPSDirectProtonSimulation::processProton().

{
  return gd->rotation() * r + CLHEP::Hep3Vector( gd->translation().x(), gd->translation().y(), gd->translation().z() );
}

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

Definition at line 179 of file CTPPSGeometry.cc.

References getSensor(), and localToGlobal().

{
  return localToGlobal( getSensor( id ), r );
}

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

direction transformations between local and global reference frames

Parameters

id

sensor id

Definition at line 203 of file CTPPSGeometry.cc.

References dir, getSensor(), and DetGeomDesc::rotation().

Referenced by TotemRPDQMSource::analyze(), endRP(), and TotemRPLocalTrackFitterAlgorithm::prepareReconstAlgebraData().

{
  return getSensor( id )->rotation() * dir;
}

Member Data Documentation

mapSetType CTPPSGeometry::dets_in_rp_

protected

Definition at line 124 of file CTPPSGeometry.h.

Referenced by build(), and getSensorsInRP().

mapSetType CTPPSGeometry::rps_in_station_

protected

Definition at line 124 of file CTPPSGeometry.h.

Referenced by build(), and getRPsInStation().

RPDeviceMapType CTPPSGeometry::rps_map_

protected

map: rp id –> DetGeomDesc

Definition at line 120 of file CTPPSGeometry.h.

Referenced by addRP(), beginRP(), build(), endRP(), and getRPNoThrow().

mapType CTPPSGeometry::sensors_map_

protected

map: sensor id –> DetGeomDesc

Definition at line 117 of file CTPPSGeometry.h.

Referenced by addSensor(), beginSensor(), build(), endSensor(), and getSensorNoThrow().

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 124 of file CTPPSGeometry.h.

Referenced by build(), and getStationsInArm().