#include <FineDelayHistosUsingDb.h>

Inheritance diagram for FineDelayHistosUsingDb:

Public Member Functions
void	configure (const edm::ParameterSet &, const edm::EventSetup &) override

	FineDelayHistosUsingDb (const edm::ParameterSet &pset, DQMStore , SiStripConfigDb const, edm::ESGetToken< TrackerTopology, TrackerTopologyRcd > tTopoToken, edm::ESGetToken< TrackerGeometry, TrackerDigiGeometryRecord > tkGeomToken)

void	uploadConfigurations () override

	~FineDelayHistosUsingDb () override

Public Member Functions inherited from CommissioningHistosUsingDb
	CommissioningHistosUsingDb (SiStripConfigDb *const, edm::ESGetToken< TrackerTopology, TrackerTopologyRcd > tTopoToken, sistrip::RunType=sistrip::UNDEFINED_RUN_TYPE)

bool	doUploadAnal () const

void	doUploadAnal (bool)

bool	doUploadConf () const

void	doUploadConf (bool)

void	uploadToConfigDb ()

	~CommissioningHistosUsingDb () override

Public Member Functions inherited from CommissioningHistograms
	CommissioningHistograms (const edm::ParameterSet &pset, DQMStore *const, const sistrip::RunType &)

	CommissioningHistograms ()

void	createCollations (const std::vector< std::string > &)

virtual void	createSummaryHisto (const sistrip::Monitorable &, const sistrip::Presentation &, const std::string &top_level_dir, const sistrip::Granularity &)

void	extractHistograms (const std::vector< std::string > &)

virtual void	printAnalyses ()

virtual void	printSummary ()

void	remove (std::string pattern="")

void	save (std::string &filename, uint32_t run_number=0, std::string partitionName="")

virtual	~CommissioningHistograms ()

Public Member Functions inherited from SamplingHistograms
void	histoAnalysis (bool debug) override

	SamplingHistograms (const edm::ParameterSet &pset, DQMStore *, const sistrip::RunType &task=sistrip::APV_LATENCY)

	~SamplingHistograms () override

Private Member Functions
void	computeDelays ()

void	create (SiStripConfigDb::AnalysisDescriptionsV &, Analysis) override

bool	update (SiStripConfigDb::DeviceDescriptionsRange)

void	update (SiStripConfigDb::FedDescriptionsRange)

Private Attributes
bool	cosmic_

std::map< unsigned int, float >	delays_

edm::ESGetToken< TrackerGeometry, TrackerDigiGeometryRecord >	tkGeomToken_

const TrackerGeometry *	tracker_

Additional Inherited Members
Public Types inherited from CommissioningHistograms
typedef std::map< uint32_t, CommissioningAnalysis * >	Analyses

typedef Analyses::iterator	Analysis

typedef dqm::harvesting::DQMStore	DQMStore

typedef SummaryPlotFactory< CommissioningAnalysis * >	Factory

typedef std::map< uint32_t, uint32_t >	FedToFecMap

typedef std::vector< Histo * >	Histos

typedef std::map< uint32_t, Histos >	HistosMap

typedef dqm::harvesting::MonitorElement	MonitorElement

Static Public Member Functions inherited from CommissioningHistograms
static void	copyCustomInformation (DQMStore *const, const std::vector< std::string > &)

static uint32_t	runNumber (DQMStore *const, const std::vector< std::string > &)

static sistrip::RunType	runType (DQMStore *const, const std::vector< std::string > &)

Protected Member Functions inherited from CommissioningHistosUsingDb
virtual void	addDcuDetIds ()

void	buildDetInfo ()

SiStripFedCabling *const	cabling () const

virtual void	createAnalyses (SiStripConfigDb::AnalysisDescriptionsV &)

SiStripConfigDb *const	db () const

std::pair< std::string, DetInfo >	detInfo (const SiStripFecKey &)

bool	deviceIsPresent (const SiStripFecKey &)

void	uploadAnalyses ()

Protected Member Functions inherited from CommissioningHistograms
DQMStore *const	bei () const

void	clearHistosMap ()

Analyses &	data (bool getMaskedData=false)

Factory *const	factory ()

TH1 *	histogram (const sistrip::Monitorable &, const sistrip::Presentation &, const sistrip::View &, const std::string &directory, const uint32_t &xbins, const float &xlow=1. sistrip::invalid_, const float &xhigh=1. sistrip::invalid_)

const HistosMap &	histos () const

const FedToFecMap &	mapping () const

void	printHistosMap ()

const edm::ParameterSet &	pset () const

const sistrip::RunType &	task () const

Protected Attributes inherited from CommissioningHistograms
std::unique_ptr< Factory >	factory_

Detailed Description

Definition at line 14 of file FineDelayHistosUsingDb.h.

Constructor & Destructor Documentation

◆ FineDelayHistosUsingDb()

FineDelayHistosUsingDb::FineDelayHistosUsingDb	(	const edm::ParameterSet &	pset,
		DQMStore *	bei,
		SiStripConfigDb * const	db,
		edm::ESGetToken< TrackerTopology, TrackerTopologyRcd >	tTopoToken,
		edm::ESGetToken< TrackerGeometry, TrackerDigiGeometryRecord >	tkGeomToken
	)

Definition at line 23 of file FineDelayHistosUsingDb.cc.

     : CommissioningHistograms(pset.getParameter<edm::ParameterSet>("FineDelayParameters"), bei, sistrip::FINE_DELAY),
       CommissioningHistosUsingDb(db, tTopoToken, sistrip::FINE_DELAY),
       SamplingHistograms(pset.getParameter<edm::ParameterSet>("FineDelayParameters"), bei, sistrip::FINE_DELAY),
       tkGeomToken_{tkGeomToken},
       tracker_(nullptr) {
   LogTrace(mlDqmClient_) << "[FineDelayHistosUsingDb::" << __func__ << "]"
                          << " Constructing object...";
   delays_.clear();
 }

◆ ~FineDelayHistosUsingDb()

FineDelayHistosUsingDb::~FineDelayHistosUsingDb ( )

override

Definition at line 40 of file FineDelayHistosUsingDb.cc.

References LogTrace, and sistrip::mlDqmClient_.

                                                 {
   LogTrace(mlDqmClient_) << "[FineDelayHistosUsingDb::" << __func__ << "]"
                          << " Destructing object...";
 }

Member Function Documentation

◆ computeDelays()

void FineDelayHistosUsingDb::computeDelays ( )

private

Definition at line 107 of file FineDelayHistosUsingDb.cc.

References c, CommissioningHistosUsingDb::cabling(), cosmic_, CommissioningHistograms::data(), phase2TrackerDigitizer_cfi::delay, delays_, relativeConstraints::empty, SiStripFedCabling::fedConnections(), SiStripFedCabling::fedIds(), TrackerGeometry::idToDetUnit(), crabWrapper::key, PV3DBase< T, PVType, FrameType >::mag(), sistrip::mlDqmClient_, GeomDet::toLocal(), DetId::Tracker, tracker_, x, y, and z.

Referenced by update().

                                            {
   // do nothing if delays_ map is already filled
   if (!delays_.empty())
     return;
 
   // the point from which track should originate
   float x = 0.;
   float y = 0.;
   float z = 0.;
   if (cosmic_) {
     y = 385.;
     z = 20.;
   }  // mean entry point of cosmics
   GlobalPoint referenceP_ = GlobalPoint(x, y, z);
   const double c = 30;  // cm/ns
 
   // the reference parameters (best delay in ns, initial Latency)
   float bestDelay_ = 0.;
   if (!data().empty()) {
     Analyses::const_iterator iter = data().begin();
     bestDelay_ = dynamic_cast<SamplingAnalysis*>(iter->second)->maximum();
   }
 
   // Retrieve FED ids from cabling
   auto ids = cabling()->fedIds();
 
   // loop over the FED ids
   for (auto ifed = ids.begin(); ifed != ids.end(); ++ifed) {
     auto conns = cabling()->fedConnections(*ifed);
     // loop over the connections for that FED
     for (auto iconn = conns.begin(); iconn != conns.end(); ++iconn) {
       // check that this is a tracker module
       if (DetId(iconn->detId()).det() != DetId::Tracker)
         continue;
       // retrieve the position of that module in the tracker using the geometry
       // and use it to compute the distance to the reference point set in the configuration
       if (tracker_) {
         float dist = tracker_->idToDetUnit(DetId(iconn->detId()))->toLocal(referenceP_).mag();
         float tof = dist / c;
         // compute the PLL delay shift for the module as delay + tof
         float delay = bestDelay_ + tof;
         // store that in the map
         delays_[SiStripFecKey(
                     iconn->fecCrate(), iconn->fecSlot(), iconn->fecRing(), iconn->ccuAddr(), iconn->ccuChan(), 0)
                     .key()] = delay;
         edm::LogVerbatim(mlDqmClient_) << "[FineDelayHistosUsingDb::" << __func__
                                        << "] Computed Delay to be added to PLL: " << bestDelay_ << " " << tof << " "
                                        << delay << std::endl;
       } else {
         edm::LogError(mlDqmClient_) << "[FineDelayHistosUsingDb::" << __func__ << "]"
                                     << " Tracker geometry not initialized. Impossible to compute the delays.";
       }
     }
   }
 }

◆ configure()

void FineDelayHistosUsingDb::configure	(	const edm::ParameterSet &	pset,
		const edm::EventSetup &	setup
	)

overridevirtual

Reimplemented from SamplingHistograms.

Definition at line 47 of file FineDelayHistosUsingDb.cc.

References SamplingHistograms::configure(), CommissioningHistosUsingDb::configure(), cosmic_, edm::ParameterSet::getParameter(), CommissioningHistograms::pset(), singleTopDQM_cfi::setup, tkGeomToken_, and tracker_.

                                                                                               {
   CommissioningHistosUsingDb::configure(pset, setup);
   tracker_ = &setup.getData(tkGeomToken_);
   SamplingHistograms::configure(pset, setup);
   cosmic_ = this->pset().getParameter<bool>("cosmic");
 }

◆ create()

void FineDelayHistosUsingDb::create	(	SiStripConfigDb::AnalysisDescriptionsV &	desc,
		Analysis	analysis
	)

overrideprivatevirtual

Reimplemented from CommissioningHistosUsingDb.

Definition at line 311 of file FineDelayHistosUsingDb.cc.

References conversion_template_cfg::anal, CommissioningHistosUsingDb::db(), SiStripConfigDb::dbParams(), submitPVResolutionJobs::desc, SiStripDbParams::partitions(), and createJobs::tmp.

                                                                                                  {
   SamplingAnalysis* anal = dynamic_cast<SamplingAnalysis*>(analysis->second);
   if (!anal) {
     return;
   }
 
   SiStripFecKey fec_key(anal->fecKey());  //@@ analysis->first
   SiStripFedKey fed_key(anal->fedKey());
 
   FineDelayAnalysisDescription* tmp;
   tmp = new FineDelayAnalysisDescription(anal->maximum(),
                                          anal->error(),
                                          0,
                                          0,
                                          0,
                                          0,
                                          0,
                                          0,
                                          db()->dbParams().partitions().begin()->second.partitionName(),
                                          db()->dbParams().partitions().begin()->second.runNumber(),
                                          anal->isValid(),
                                          "",
                                          fed_key.fedId(),
                                          fed_key.feUnit(),
                                          fed_key.feChan(),
                                          fed_key.fedApv());
 
   // Add comments
   typedef std::vector<std::string> Strings;
   Strings errors = anal->getErrorCodes();
   Strings::const_iterator istr = errors.begin();
   Strings::const_iterator jstr = errors.end();
   for (; istr != jstr; ++istr) {
     tmp->addComments(*istr);
   }
 
   // Store description
   desc.push_back(tmp);
 }

◆ update() [1/2]

bool FineDelayHistosUsingDb::update ( SiStripConfigDb::DeviceDescriptionsRange devices )

private

Definition at line 165 of file FineDelayHistosUsingDb.cc.

References generateTowerEtThresholdLUT::addr, SiStripFecKey::ccuAddr(), SiStripFecKey::ccuChan(), computeDelays(), CommissioningHistosUsingDb::db(), phase2TrackerDigitizer_cfi::delay, delays_, submitPVResolutionJobs::desc, SiStripConfigDb::deviceAddress(), SiStripFecKey::fecCrate(), SiStripFecKey::fecRing(), SiStripFecKey::fecSlot(), createfilelist::int, invalid, sistrip::invalid_, SiStripKey::key(), LogTrace, sistrip::mlDqmClient_, and contentValuesCheck::ss.

Referenced by progressbar.ProgressBar::__next__(), MatrixUtil.Matrix::__setitem__(), MatrixUtil.Steps::__setitem__(), dqm-mbProfile.Profile::finish(), progressbar.ProgressBar::finish(), MatrixUtil.Steps::overwrite(), and uploadConfigurations().

                                                                                   {
   // do the core computation of delays per FED connection
   computeDelays();
 
   // Iterate through devices and update device descriptions
   uint16_t updated = 0;
   std::vector<SiStripFecKey> invalid;
   SiStripConfigDb::DeviceDescriptionsV::const_iterator idevice;
   for (idevice = devices.begin(); idevice != devices.end(); idevice++) {
     // Check device type
     if ((*idevice)->getDeviceType() != PLL) {
       continue;
     }
 
     // Cast to retrieve appropriate description object
     pllDescription* desc = dynamic_cast<pllDescription*>(*idevice);
     if (!desc) {
       continue;
     }
 
     // Retrieve device addresses from device description
     const SiStripConfigDb::DeviceAddress& addr = db()->deviceAddress(*desc);
 
     // Construct key from device description
     uint32_t fec_key =
         SiStripFecKey(addr.fecCrate_, addr.fecSlot_, addr.fecRing_, addr.ccuAddr_, addr.ccuChan_, 0).key();
     SiStripFecKey fec_path = SiStripFecKey(fec_key);
 
     // extract the delay from the map
     float delay = desc->getDelayCoarse() * 25 + desc->getDelayFine() * 25. / 24. + delays_[fec_key];
     int delayCoarse = int(delay / 25);
     int delayFine = int(round((delay - 25 * delayCoarse) * 24. / 25.));
     if (delayFine == 24) {
       delayFine = 0;
       ++delayCoarse;
     }
     //  maximum coarse setting
     if (delayCoarse > 15) {
       invalid.push_back(fec_key);
       delayCoarse = sistrip::invalid_;
     }
 
     // Update PLL settings
     if (delayCoarse != sistrip::invalid_ && delayFine != sistrip::invalid_) {
       std::stringstream ss;
       ss << "[FineDelayHistosUsingDb::" << __func__ << "]"
          << " Updating coarse/fine PLL settings"
          << " for Crate/FEC/slot/ring/CCU " << fec_path.fecCrate() << "/" << fec_path.fecSlot() << "/"
          << fec_path.fecRing() << "/" << fec_path.ccuAddr() << "/" << fec_path.ccuChan() << " from "
          << static_cast<uint16_t>(desc->getDelayCoarse()) << "/" << static_cast<uint16_t>(desc->getDelayFine());
       desc->setDelayCoarse(delayCoarse);
       desc->setDelayFine(delayFine);
       updated++;
       ss << " to " << static_cast<uint16_t>(desc->getDelayCoarse()) << "/"
          << static_cast<uint16_t>(desc->getDelayFine());
       LogTrace(mlDqmClient_) << ss.str();
 
     } else {
       LogTrace(mlDqmClient_) << "[FineDelayHistosUsingDb::" << __func__ << "]"
                              << " Unexpected PLL delay settings for Crate/FEC/slot/ring/CCU " << fec_path.fecCrate()
                              << "/" << fec_path.fecSlot() << "/" << fec_path.fecRing() << "/" << fec_path.ccuAddr()
                              << "/" << fec_path.ccuChan();
     }
   }
 
   // Check if invalid settings were found
   if (!invalid.empty()) {
     std::stringstream ss;
     ss << "[FineDelayHistosUsingDb::" << __func__ << "]"
        << " Found PLL coarse setting of 15"
        << " (not allowed!) for following channels"
        << " (Crate/FEC/slot/ring/CCU/LLD): ";
     std::vector<SiStripFecKey>::iterator ikey = invalid.begin();
     std::vector<SiStripFecKey>::iterator jkey = invalid.end();
     for (; ikey != jkey; ++ikey) {
       ss << ikey->fecCrate() << "/" << ikey->fecSlot() << "/" << ikey->fecRing() << "/" << ikey->ccuAddr() << "/"
          << ikey->ccuChan() << ", ";
     }
     edm::LogWarning(mlDqmClient_) << ss.str();
     return false;
   }
 
   edm::LogVerbatim(mlDqmClient_) << "[FineDelayHistosUsingDb::" << __func__ << "]"
                                  << " Updated PLL settings for " << updated << " modules";
   return true;
 }

◆ update() [2/2]

void FineDelayHistosUsingDb::update ( SiStripConfigDb::FedDescriptionsRange feds )

private

Definition at line 254 of file FineDelayHistosUsingDb.cc.

References CommissioningHistosUsingDb::cabling(), computeDelays(), phase2TrackerDigitizer_cfi::delay, delays_, SiStripFedCabling::fedConnections(), SiStripFedCabling::fedIds(), l1tstage2emulator_dqm_sourceclient-live_cfg::feds, spr::find(), createfilelist::int, crabWrapper::key, LogTrace, sistrip::mlDqmClient_, contentValuesCheck::ss, and DetId::Tracker.

Referenced by progressbar.ProgressBar::__next__(), MatrixUtil.Matrix::__setitem__(), MatrixUtil.Steps::__setitem__(), dqm-mbProfile.Profile::finish(), progressbar.ProgressBar::finish(), and MatrixUtil.Steps::overwrite().

                                                                             {
   // do the core computation of delays per FED connection
   computeDelays();
 
   // Retrieve FED ids from cabling
   auto ids = cabling()->fedIds();
 
   // loop over the FED ids
   for (SiStripConfigDb::FedDescriptionsV::const_iterator ifed = feds.begin(); ifed != feds.end(); ifed++) {
     // If FED id not found in list (from cabling), then continue
     if (find(ids.begin(), ids.end(), (*ifed)->getFedId()) == ids.end()) {
       continue;
     }
     auto conns = cabling()->fedConnections((*ifed)->getFedId());
     // loop over the connections for that FED
     for (auto iconn = conns.begin(); iconn != conns.end(); iconn++) {
       // check that this is a tracker module
       if (DetId(iconn->detId()).det() != DetId::Tracker)
         continue;
       // build the Fed9UAddress for that channel. Used to update the description.
       Fed9U::Fed9UAddress fedChannel = Fed9U::Fed9UAddress(iconn->fedCh());
       // retreive the current value for the delays
       int fedDelayCoarse = (*ifed)->getCoarseDelay(fedChannel);
       int fedDelayFine = (*ifed)->getFineDelay(fedChannel);
       int fedDelay = int(fedDelayCoarse * 25. - fedDelayFine * 24. / 25.);
       // extract the delay from the map
       int delay = int(round(
           delays_[SiStripFecKey(
                       iconn->fecCrate(), iconn->fecSlot(), iconn->fecRing(), iconn->ccuAddr(), iconn->ccuChan(), 0)
                       .key()]));
       // compute the FED delay
       // this is done by substracting the best (PLL) delay to the present value (from the db)
       fedDelay -= delay;
       fedDelayCoarse = (fedDelay / 25) + 1;
       fedDelayFine = fedDelayCoarse * 25 - fedDelay;
       if (fedDelayFine == 25) {
         fedDelayFine = 0;
         --fedDelayCoarse;
       }
       // update the FED delay
       std::stringstream ss;
       ss << "[FineDelayHistosUsingDb::" << __func__ << "]"
          << " Updating the FED delay"
          << " for loop FED id/ch " << (*ifed)->getFedId() << "/" << iconn->fedCh() << " from "
          << (*ifed)->getCoarseDelay(fedChannel) << "/" << (*ifed)->getFineDelay(fedChannel) << " to ";
       (*ifed)->setDelay(fedChannel, fedDelayCoarse, fedDelayFine);
       ss << (*ifed)->getCoarseDelay(fedChannel) << "/" << (*ifed)->getFineDelay(fedChannel) << std::endl;
       LogTrace(mlDqmClient_) << ss.str();
     }
   }
 
   edm::LogVerbatim(mlDqmClient_) << "[FineDelayHistosUsingDb::" << __func__ << "]"
                                  << " Updated FED delay for " << ids.size() << " FEDs!";
 }

◆ uploadConfigurations()

void FineDelayHistosUsingDb::uploadConfigurations ( )

overridevirtual

Reimplemented from CommissioningHistosUsingDb.

Definition at line 56 of file FineDelayHistosUsingDb.cc.

References SiStripConfigDb::clearDeviceDescriptions(), SiStripConfigDb::clearFedDescriptions(), CommissioningHistosUsingDb::db(), CommissioningHistosUsingDb::doUploadConf(), l1tstage2emulator_dqm_sourceclient-live_cfg::feds, SiStripConfigDb::getDeviceDescriptions(), SiStripConfigDb::getFedDescriptions(), LogTrace, sistrip::mlDqmClient_, update(), alcaDQMUpload::upload(), SiStripConfigDb::uploadDeviceDescriptions(), and SiStripConfigDb::uploadFedDescriptions().

                                                   {
   if (!db()) {
     edm::LogWarning(mlDqmClient_) << "[FineDelayHistosUsingDb::" << __func__ << "]"
                                   << " NULL pointer to SiStripConfigDb interface!"
                                   << " Aborting upload...";
     return;
   }
 
   // Retrieve and update PLL device descriptions
   db()->clearDeviceDescriptions();
   SiStripConfigDb::DeviceDescriptionsRange devices = db()->getDeviceDescriptions(PLL);
   bool upload = update(devices);
 
   // Check if new PLL settings are valid
   if (!upload) {
     edm::LogWarning(mlDqmClient_) << "[FineDelayHistosUsingDb::" << __func__ << "]"
                                   << " Found invalid PLL settings (coarse > 15)"
                                   << " Aborting update to database...";
     return;
   }
 
   // Upload PLL device descriptions
   if (doUploadConf()) {
     LogTrace(mlDqmClient_) << "[FineDelayHistosUsingDb::" << __func__ << "]"
                            << " Uploading PLL settings to DB...";
     db()->uploadDeviceDescriptions();
     LogTrace(mlDqmClient_) << "[FineDelayHistosUsingDb::" << __func__ << "]"
                            << " Upload of PLL settings to DB finished!";
   } else {
     edm::LogWarning(mlDqmClient_) << "[FineDelayHistosUsingDb::" << __func__ << "]"
                                   << " TEST only! No PLL settings will be uploaded to DB...";
   }
 
   // Update FED descriptions with new ticker thresholds
   db()->clearFedDescriptions();
   SiStripConfigDb::FedDescriptionsRange feds = db()->getFedDescriptions();
   update(feds);
 
   // Update FED descriptions with new ticker thresholds
   if (doUploadConf()) {
     LogTrace(mlDqmClient_) << "[FineDelayHistosUsingDb::" << __func__ << "]"
                            << " Uploading FED ticker thresholds to DB...";
     db()->uploadFedDescriptions();
     LogTrace(mlDqmClient_) << "[FineDelayHistosUsingDb::" << __func__ << "]"
                            << " Upload of FED ticker thresholds to DB finished!";
   } else {
     edm::LogWarning(mlDqmClient_) << "[FineDelayHistosUsingDb::" << __func__ << "]"
                                   << " TEST only! No FED ticker thresholds will be uploaded to DB...";
   }
 }

Member Data Documentation

◆ cosmic_

bool FineDelayHistosUsingDb::cosmic_

private

Definition at line 42 of file FineDelayHistosUsingDb.h.

Referenced by computeDelays(), and configure().

◆ delays_

std::map<unsigned int, float> FineDelayHistosUsingDb::delays_

private

Definition at line 37 of file FineDelayHistosUsingDb.h.

Referenced by computeDelays(), and update().

◆ tkGeomToken_

edm::ESGetToken<TrackerGeometry, TrackerDigiGeometryRecord> FineDelayHistosUsingDb::tkGeomToken_

private

Definition at line 39 of file FineDelayHistosUsingDb.h.

Referenced by configure().

◆ tracker_

const TrackerGeometry* FineDelayHistosUsingDb::tracker_

private

Definition at line 40 of file FineDelayHistosUsingDb.h.

Referenced by computeDelays(), and configure().

Public Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ FineDelayHistosUsingDb()

◆ ~FineDelayHistosUsingDb()

Member Function Documentation

◆ computeDelays()

◆ configure()

◆ create()

◆ update() [1/2]

◆ update() [2/2]

◆ uploadConfigurations()

Member Data Documentation

◆ cosmic_

◆ delays_

◆ tkGeomToken_

◆ tracker_