#include <DTLinearDriftFromDBAlgo.h>

Inheritance diagram for DTLinearDriftFromDBAlgo:

Public Member Functions
bool	compute (const DTLayer *layer, const DTDigi &digi, LocalPoint &leftPoint, LocalPoint &rightPoint, LocalError &error) const override

bool	compute (const DTLayer *layer, const DTRecHit1D &recHit1D, const float &angle, DTRecHit1D &newHit1D) const override

bool	compute (const DTLayer *layer, const DTRecHit1D &recHit1D, const float &angle, const GlobalPoint &globPos, DTRecHit1D &newHit1D) const override

	DTLinearDriftFromDBAlgo (const edm::ParameterSet &config, edm::ConsumesCollector cc)
	Constructor. More...

void	setES (const edm::EventSetup &setup) override
	Pass the Event Setup to the algo at each event. More...

	~DTLinearDriftFromDBAlgo () override
	Destructor. More...

Public Member Functions inherited from DTRecHitBaseAlgo
	DTRecHitBaseAlgo (const edm::ParameterSet &config, edm::ConsumesCollector)
	Constructor. More...

virtual edm::OwnVector< DTRecHit1DPair >	reconstruct (const DTLayer *layer, const DTLayerId &layerId, const DTDigiCollection::Range &digiRange)
	Build all hits in the range associated to the layerId, at the 1st step. More...

virtual	~DTRecHitBaseAlgo ()
	Destructor. More...

Private Member Functions
virtual bool	compute (const DTLayer *layer, const DTWireId &wireId, const float digiTime, const GlobalPoint &globPos, LocalPoint &leftPoint, LocalPoint &rightPoint, LocalError &error, int step) const

virtual bool	compute (const DTLayer *layer, const DTWireId &wireId, const float digiTime, const GlobalPoint &globPos, DTRecHit1D &newHit1D, int step) const

Private Attributes
const bool	debug

const bool	doVdriftCorr

const MagneticField *	field

edm::ESGetToken< MagneticField, IdealMagneticFieldRecord >	fieldToken_

const float	maxTime

const float	minTime

const DTMtime *	mTimeMap

edm::ESGetToken< DTMtime, DTMtimeRcd >	mTimeMapToken_

int	nominalB

bool	readLegacyTTrigDB

bool	readLegacyVDriftDB

const bool	stepTwoFromDigi

const DTRecoConditions *	uncertMap

edm::ESGetToken< DTRecoConditions, DTRecoConditionsUncertRcd >	uncertMapToken_

bool	useUncertDB

const DTRecoConditions *	vDriftMap

edm::ESGetToken< DTRecoConditions, DTRecoConditionsVdriftRcd >	vDriftMapToken_

Additional Inherited Members
Protected Attributes inherited from DTRecHitBaseAlgo
std::unique_ptr< DTTTrigBaseSync >	theSync

Detailed Description

Concrete implementation of DTRecHitBaseAlgo. Compute drift distance using constant drift velocity read from database.

Author: S.Bolognesi - INFN Torino

Definition at line 23 of file DTLinearDriftFromDBAlgo.h.

Constructor & Destructor Documentation

◆ DTLinearDriftFromDBAlgo()

DTLinearDriftFromDBAlgo::DTLinearDriftFromDBAlgo	(	const edm::ParameterSet &	config,
		edm::ConsumesCollector	cc
	)

Constructor.

Definition at line 28 of file DTLinearDriftFromDBAlgo.cc.

References edm::ConsumesCollector::esConsumes(), mTimeMapToken_, readLegacyVDriftDB, uncertMapToken_, useUncertDB, and vDriftMapToken_.

     : DTRecHitBaseAlgo(config, cc),
       mTimeMap(nullptr),
       vDriftMap(nullptr),
       field(nullptr),
       fieldToken_(cc.esConsumes()),
       nominalB(-1),
       minTime(config.getParameter<double>("minTime")),
       maxTime(config.getParameter<double>("maxTime")),
       doVdriftCorr(config.getParameter<bool>("doVdriftCorr")),
       // Option to force going back to digi time at Step 2
       stepTwoFromDigi(config.getParameter<bool>("stepTwoFromDigi")),
       useUncertDB(config.getParameter<bool>("useUncertDB")),
       readLegacyTTrigDB(config.getParameter<bool>("readLegacyTTrigDB")),
       readLegacyVDriftDB(config.getParameter<bool>("readLegacyVDriftDB")),
       // Set verbose output
       debug(config.getUntrackedParameter<bool>("debug")) {
   if (readLegacyVDriftDB) {
     mTimeMapToken_ = cc.esConsumes();
   } else {
     vDriftMapToken_ = cc.esConsumes();
   }
   if (useUncertDB) {
     uncertMapToken_ = cc.esConsumes();
   }
 }

◆ ~DTLinearDriftFromDBAlgo()

DTLinearDriftFromDBAlgo::~DTLinearDriftFromDBAlgo ( )

override

Destructor.

Definition at line 55 of file DTLinearDriftFromDBAlgo.cc.

55 {}

Member Function Documentation

◆ compute() [1/5]

bool DTLinearDriftFromDBAlgo::compute	(	const DTLayer *	layer,
		const DTDigi &	digi,
		LocalPoint &	leftPoint,
		LocalPoint &	rightPoint,
		LocalError &	error
	)		const

overridevirtual

First step in computation of Left/Right hits from a Digi. The results are the local position (in DTLayer frame) of the Left and Right hit, and the error (which is common). Returns false on failure. The hit is assumed to be at the wire center.

Implements DTRecHitBaseAlgo.

Definition at line 99 of file DTLinearDriftFromDBAlgo.cc.

References relativeConstraints::error, phase1PixelTopology::layer, DTDigi::time(), and DTDigi::wire().

Referenced by compute().

                                                                                                                       {
   // Get the wireId
   DTLayerId layerId = layer->id();
   const DTWireId wireId(layerId, digi.wire());
 
   // Get Wire position
   if (!layer->specificTopology().isWireValid(digi.wire()))
     return false;
   LocalPoint locWirePos(layer->specificTopology().wirePosition(digi.wire()), 0, 0);
   const GlobalPoint globWirePos = layer->toGlobal(locWirePos);
 
   return compute(layer, wireId, digi.time(), globWirePos, leftPoint, rightPoint, error, 1);
 }

◆ compute() [2/5]

bool DTLinearDriftFromDBAlgo::compute	(	const DTLayer *	layer,
		const DTRecHit1D &	recHit1D,
		const float &	angle,
		DTRecHit1D &	newHit1D
	)		const

overridevirtual

Second step in hit position computation. It is the same as first step since the angular information is not used NOTE: Only position and error of the new hit are modified

Implements DTRecHitBaseAlgo.

Definition at line 115 of file DTLinearDriftFromDBAlgo.cc.

References compute(), DTRecHit1D::digiTime(), phase1PixelTopology::layer, DTRecHit1D::localPosition(), DTRecHit1D::localPositionError(), DTRecHit1D::setPositionAndError(), stepTwoFromDigi, DTWireId::wire(), and DTRecHit1D::wireId().

                                                                   {
   if (!stepTwoFromDigi) {
     newHit1D.setPositionAndError(recHit1D.localPosition(), recHit1D.localPositionError());
     return true;
   }
 
   const DTWireId wireId = recHit1D.wireId();
 
   // Get Wire position
   if (!layer->specificTopology().isWireValid(wireId.wire()))
     return false;
   LocalPoint locWirePos(layer->specificTopology().wirePosition(wireId.wire()), 0, 0);
   const GlobalPoint globWirePos = layer->toGlobal(locWirePos);
 
   return compute(layer, wireId, recHit1D.digiTime(), globWirePos, newHit1D, 2);
 }

◆ compute() [3/5]

bool DTLinearDriftFromDBAlgo::compute	(	const DTLayer *	layer,
		const DTRecHit1D &	recHit1D,
		const float &	angle,
		const GlobalPoint &	globPos,
		DTRecHit1D &	newHit1D
	)		const

overridevirtual

Third (and final) step in hits position computation. Also the hit position along the wire is available and can be used to correct the drift time for particle TOF and propagation of signal along the wire. NOTE: Only position and error of the new hit are modified

Implements DTRecHitBaseAlgo.

Definition at line 136 of file DTLinearDriftFromDBAlgo.cc.

References compute(), DTRecHit1D::digiTime(), phase1PixelTopology::layer, and DTRecHit1D::wireId().

                                                                   {
   return compute(layer, recHit1D.wireId(), recHit1D.digiTime(), globPos, newHit1D, 3);
 }

◆ compute() [4/5]

bool DTLinearDriftFromDBAlgo::compute	(	const DTLayer *	layer,
		const DTWireId &	wireId,
		const float	digiTime,
		const GlobalPoint &	globPos,
		LocalPoint &	leftPoint,
		LocalPoint &	rightPoint,
		LocalError &	error,
		int	step
	)		const

privatevirtual

cf. http://arxiv.org/PS_cache/arxiv/pdf/0911/0911.4895v2.pdf

Definition at line 145 of file DTLinearDriftFromDBAlgo.cc.

References funct::abs(), writedatasetfile::args, DTVelocityUnits::cm_per_ns, debug, doVdriftCorr, shallow::drift(), relativeConstraints::error, DTRecoConditions::get(), DTMtime::get(), DTLinearDriftAlgo_cfi::hitResolution, phase1PixelTopology::layer, maxTime, mTimeMap, nominalB, readLegacyVDriftDB, DTChamberId::station(), DTSuperLayerId::superLayer(), DTLayerId::superlayerId(), DTRecHitBaseAlgo::theSync, uncertMap, useUncertDB, vDriftMap, DTChamberId::wheel(), DTWireId::wire(), PV3DBase< T, PVType, FrameType >::x(), PV3DBase< T, PVType, FrameType >::y(), and PV3DBase< T, PVType, FrameType >::z().

                                                       {
   // Subtract the offset to the digi time accordingly to the DTTTrigBaseSync concrete instance
   float driftTime = digiTime - theSync->offset(layer, wireId, globPos);
 
   // check for out-of-time
   if (driftTime < minTime || driftTime > maxTime) {
     if (debug)
       edm::LogWarning("DTLocalReco") << "[DTLinearDriftFromDBAlgo]*** Drift time out of window for in-time hits "
                                      << driftTime << endl;
 
     if (step == 1) {  //FIXME: protection against failure at 2nd and 3rd steps, must be checked!!!
       // Hits are interpreted as coming from out-of-time pile-up and recHit
       // is ignored.
       return false;
     }
   }
 
   // Small negative times interpreted as hits close to the wire.
   if (driftTime < 0.)
     driftTime = 0;
 
   // Read the vDrift and reso for this wire
   float vDrift = 0;
   float hitResolution = 0;
 
   if (readLegacyVDriftDB) {
     // vdrift is cm/ns , resolution is cm
     mTimeMap->get(wireId.superlayerId(),
                   vDrift,
                   hitResolution,  // Value from vdrift DB; replaced below if useUncertDB card is set
                   DTVelocityUnits::cm_per_ns);
   } else {
     // For v2, we will pass also: double args[1] = {(layer->toLocal(globPos)).y()};
     vDrift = vDriftMap->get(wireId);
   }
 
   if (useUncertDB) {
     // Read the uncertainty from the DB for the given channel and step
     double args[1] = {double(step - 1)};
     hitResolution = uncertMap->get(wireId, args);
   }
 
   //only in step 3
   if (doVdriftCorr && step == 3 && nominalB != 0) {
     if (abs(wireId.wheel()) == 2 && wireId.station() == 1 && wireId.superLayer() != 2) {
       // Variation of vdrift along Y due to B field,
       // vdrift is lower  a negative Y (lower global |Z|)
       const float k_param = 1.2e-04;
       LocalPoint local_pos = layer->toLocal(globPos);
       vDrift = vDrift * (1. - k_param * local_pos.y());
     }
   }
 
   // Compute the drift distance
   float drift = driftTime * vDrift;
 
   // Get Wire position
   if (!layer->specificTopology().isWireValid(wireId.wire()))
     return false;
   LocalPoint locWirePos(layer->specificTopology().wirePosition(wireId.wire()), 0, 0);
   //Build the two possible points and the error on the position
   leftPoint = LocalPoint(locWirePos.x() - drift, locWirePos.y(), locWirePos.z());
   rightPoint = LocalPoint(locWirePos.x() + drift, locWirePos.y(), locWirePos.z());
   error = LocalError(hitResolution * hitResolution, 0., 0.);
 
   if (debug) {
     edm::LogWarning("DTLocalReco") << "[DTLinearDriftFromDBAlgo] Compute drift distance, for digi at wire: " << wireId
                                    << endl
                                    << "       Step:           " << step << endl
                                    << "       Digi time:      " << digiTime << endl
                                    << "       Drift time:     " << driftTime << endl
                                    << "       Drift distance: " << drift << endl
                                    << "       Hit Resolution: " << hitResolution << endl
                                    << "       Left point:     " << leftPoint << endl
                                    << "       Right point:    " << rightPoint << endl
                                    << "       Error:          " << error << endl;
   }
 
   return true;
 }

◆ compute() [5/5]

bool DTLinearDriftFromDBAlgo::compute	(	const DTLayer *	layer,
		const DTWireId &	wireId,
		const float	digiTime,
		const GlobalPoint &	globPos,
		DTRecHit1D &	newHit1D,
		int	step
	)		const

privatevirtual

Definition at line 235 of file DTLinearDriftFromDBAlgo.cc.

References compute(), relativeConstraints::error, Exception, phase1PixelTopology::layer, DTEnums::Left, DTRecHit1D::localPosition(), DTRecHit1D::lrSide(), DTEnums::Right, DTRecHit1D::setPositionAndError(), PV3DBase< T, PVType, FrameType >::x(), PV3DBase< T, PVType, FrameType >::y(), and PV3DBase< T, PVType, FrameType >::z().

                                                       {
   LocalPoint leftPoint;
   LocalPoint rightPoint;
   LocalError error;
 
   if (compute(layer, wireId, digiTime, globPos, leftPoint, rightPoint, error, step)) {
     // Set the position and the error of the rechit which is being updated
     switch (newHit1D.lrSide()) {
       case DTEnums::Left: {
         // Keep the original y position of newHit1D: for step==3, it's the
         // position along the wire. Needed for rotation alignment
         LocalPoint leftPoint3D(leftPoint.x(), newHit1D.localPosition().y(), leftPoint.z());
         newHit1D.setPositionAndError(leftPoint3D, error);
         break;
       }
 
       case DTEnums::Right: {
         // as above: 3d position
         LocalPoint rightPoint3D(rightPoint.x(), newHit1D.localPosition().y(), rightPoint.z());
         newHit1D.setPositionAndError(rightPoint3D, error);
         break;
       }
 
       default:
         throw cms::Exception("InvalidDTCellSide") << "[DTLinearDriftFromDBAlgo] Compute at Step " << step
                                                   << ", Hit side " << newHit1D.lrSide() << " is invalid!" << endl;
         return false;
     }
 
     return true;
   } else {
     return false;
   }
 }

◆ setES()

void DTLinearDriftFromDBAlgo::setES ( const edm::EventSetup & setup )

overridevirtual

Pass the Event Setup to the algo at each event.

Implements DTRecHitBaseAlgo.

Definition at line 57 of file DTLinearDriftFromDBAlgo.cc.

References debug, Exception, field, fieldToken_, mTimeMap, mTimeMapToken_, nominalB, MagneticField::nominalValue(), readLegacyVDriftDB, singleTopDQM_cfi::setup, DTRecHitBaseAlgo::theSync, uncertMap, uncertMapToken_, useUncertDB, vDriftMap, vDriftMapToken_, DTRecoConditions::version(), BeamSplash_cfg::version, and DTMtime::version().

                                                            {
   if (debug)
     edm::LogVerbatim("DTLocalReco") << "[DTLinearDriftFromDBAlgo] setES called" << endl;
   theSync->setES(setup);
   // Get the map of ttrig from the Setup
   if (readLegacyVDriftDB) {
     mTimeMap = &setup.getData(mTimeMapToken_);
     vDriftMap = nullptr;
   } else {
     vDriftMap = &setup.getData(vDriftMapToken_);
     mTimeMap = nullptr;
 
     // Consistency check: no parametrization is implemented for the time being
     int version = vDriftMap->version();
     if (version != 1) {
       throw cms::Exception("Configuration") << "only version 1 is presently supported for VDriftDB";
     }
   }
 
   field = &setup.getData(fieldToken_);
   nominalB = field->nominalValue();
 
   if (useUncertDB) {
     uncertMap = &setup.getData(uncertMapToken_);
     if (uncertMap->version() > 1)
       edm::LogError("NotImplemented") << "DT Uncertainty DB version unsupported: " << uncertMap->version();
   }
 
   if (debug) {
     if (readLegacyVDriftDB) {
       edm::LogVerbatim("DTLocalReco") << "[DTLinearDriftFromDBAlgo] meanTimer version: " << mTimeMap->version() << endl;
     } else {
       edm::LogVerbatim("DTLocalReco") << "[DTLinearDriftFromDBAlgo] vDrift version: " << vDriftMap->version() << endl;
     }
 
     if (useUncertDB)
       edm::LogVerbatim("DTLocalReco") << "                          uncertDB  version: " << uncertMap->version()
                                       << endl;
   }
 }

Member Data Documentation

◆ debug

const bool DTLinearDriftFromDBAlgo::debug

private

Definition at line 123 of file DTLinearDriftFromDBAlgo.h.

Referenced by compute(), runTauIdMVA.TauIDEmbedder::loadMVA_WPs_run2_2017(), runTauIdMVA.TauIDEmbedder::runTauID(), and setES().

◆ doVdriftCorr

const bool DTLinearDriftFromDBAlgo::doVdriftCorr

private

Definition at line 108 of file DTLinearDriftFromDBAlgo.h.

Referenced by compute().

◆ field

const MagneticField* DTLinearDriftFromDBAlgo::field

private

Definition at line 93 of file DTLinearDriftFromDBAlgo.h.

Referenced by setES().

◆ fieldToken_

edm::ESGetToken<MagneticField, IdealMagneticFieldRecord> DTLinearDriftFromDBAlgo::fieldToken_

private

Definition at line 94 of file DTLinearDriftFromDBAlgo.h.

Referenced by setES().

◆ maxTime

const float DTLinearDriftFromDBAlgo::maxTime

private

Definition at line 105 of file DTLinearDriftFromDBAlgo.h.

Referenced by compute().

◆ minTime

const float DTLinearDriftFromDBAlgo::minTime

private

Definition at line 102 of file DTLinearDriftFromDBAlgo.h.

◆ mTimeMap

const DTMtime* DTLinearDriftFromDBAlgo::mTimeMap

private

Definition at line 85 of file DTLinearDriftFromDBAlgo.h.

Referenced by compute(), and setES().

◆ mTimeMapToken_

edm::ESGetToken<DTMtime, DTMtimeRcd> DTLinearDriftFromDBAlgo::mTimeMapToken_

private

Definition at line 86 of file DTLinearDriftFromDBAlgo.h.

Referenced by DTLinearDriftFromDBAlgo(), and setES().

◆ nominalB

int DTLinearDriftFromDBAlgo::nominalB

private

Definition at line 95 of file DTLinearDriftFromDBAlgo.h.

Referenced by compute(), and setES().

◆ readLegacyTTrigDB

bool DTLinearDriftFromDBAlgo::readLegacyTTrigDB

private

Definition at line 119 of file DTLinearDriftFromDBAlgo.h.

◆ readLegacyVDriftDB

bool DTLinearDriftFromDBAlgo::readLegacyVDriftDB

private

Definition at line 120 of file DTLinearDriftFromDBAlgo.h.

Referenced by compute(), DTLinearDriftFromDBAlgo(), and setES().

◆ stepTwoFromDigi

const bool DTLinearDriftFromDBAlgo::stepTwoFromDigi

private

Definition at line 112 of file DTLinearDriftFromDBAlgo.h.

Referenced by compute().

◆ uncertMap

const DTRecoConditions* DTLinearDriftFromDBAlgo::uncertMap

private

Definition at line 98 of file DTLinearDriftFromDBAlgo.h.

Referenced by compute(), and setES().

◆ uncertMapToken_

edm::ESGetToken<DTRecoConditions, DTRecoConditionsUncertRcd> DTLinearDriftFromDBAlgo::uncertMapToken_

private

Definition at line 99 of file DTLinearDriftFromDBAlgo.h.

Referenced by DTLinearDriftFromDBAlgo(), and setES().

◆ useUncertDB

bool DTLinearDriftFromDBAlgo::useUncertDB

private

Definition at line 116 of file DTLinearDriftFromDBAlgo.h.

Referenced by compute(), DTLinearDriftFromDBAlgo(), and setES().

◆ vDriftMap

const DTRecoConditions* DTLinearDriftFromDBAlgo::vDriftMap

private

Definition at line 89 of file DTLinearDriftFromDBAlgo.h.

Referenced by compute(), and setES().

◆ vDriftMapToken_

edm::ESGetToken<DTRecoConditions, DTRecoConditionsVdriftRcd> DTLinearDriftFromDBAlgo::vDriftMapToken_

private

Definition at line 90 of file DTLinearDriftFromDBAlgo.h.

Referenced by DTLinearDriftFromDBAlgo(), and setES().

Public Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ DTLinearDriftFromDBAlgo()

◆ ~DTLinearDriftFromDBAlgo()

Member Function Documentation

◆ compute() [1/5]

◆ compute() [2/5]

◆ compute() [3/5]

◆ compute() [4/5]

◆ compute() [5/5]

◆ setES()

Member Data Documentation

◆ debug

◆ doVdriftCorr

◆ field

◆ fieldToken_

◆ maxTime

◆ minTime

◆ mTimeMap

◆ mTimeMapToken_

◆ nominalB

◆ readLegacyTTrigDB

◆ readLegacyVDriftDB

◆ stepTwoFromDigi

◆ uncertMap

◆ uncertMapToken_

◆ useUncertDB

◆ vDriftMap

◆ vDriftMapToken_