CommissioningAnalysis Class Reference

Abstract base for derived classes that provide analysis of commissioning histograms. More...

#include <CommissioningAnalysis.h>

Inheritance diagram for CommissioningAnalysis:

Public Types
typedef std::vector< bool >	VBool
typedef std::vector< float >	VFloat
typedef std::vector< uint16_t >	VInt
typedef std::vector< std::string >	VString
typedef std::vector< VBool >	VVBool
typedef std::vector< VFloat >	VVFloat
typedef std::vector< VInt >	VVInt

Public Member Functions
virtual void	addErrorCode (const std::string &error)
	CommissioningAnalysis (const uint32_t &key, const std::string &my_name)
	CommissioningAnalysis (const std::string &my_name)
const uint32_t &	dcuId () const
void	dcuId (const uint32_t &)
const uint32_t &	detId () const
void	detId (const uint32_t &)
const uint32_t &	fecKey () const
void	fecKey (const uint32_t &)
const uint32_t &	fedKey () const
void	fedKey (const uint32_t &)
const VString &	getErrorCodes () const
virtual void	header (std::stringstream &) const
virtual bool	isValid () const
const std::string &	myName () const
virtual void	print (std::stringstream &, uint32_t not_used=0)=0
virtual void	reset ()=0
void	setErrorCodes (const VString &errors)
virtual void	summary (std::stringstream &) const
virtual	~CommissioningAnalysis ()

Private Member Functions
	CommissioningAnalysis ()

Private Attributes
uint32_t	dcuId_
uint32_t	detId_
VString	errors_
uint32_t	fecKey_
uint32_t	fedKey_
std::string	myName_

Detailed Description

Abstract base for derived classes that provide analysis of commissioning histograms.

Author

M.Wingham, R.Bainbridge

Definition at line 18 of file CommissioningAnalysis.h.

Member Typedef Documentation

typedef std::vector<bool> CommissioningAnalysis::VBool

Definition at line 41 of file CommissioningAnalysis.h.

typedef std::vector<float> CommissioningAnalysis::VFloat

Definition at line 33 of file CommissioningAnalysis.h.

typedef std::vector<uint16_t> CommissioningAnalysis::VInt

Definition at line 37 of file CommissioningAnalysis.h.

typedef std::vector<std::string> CommissioningAnalysis::VString

Definition at line 45 of file CommissioningAnalysis.h.

typedef std::vector<VBool> CommissioningAnalysis::VVBool

Definition at line 43 of file CommissioningAnalysis.h.

typedef std::vector<VFloat> CommissioningAnalysis::VVFloat

Definition at line 35 of file CommissioningAnalysis.h.

typedef std::vector<VInt> CommissioningAnalysis::VVInt

Definition at line 39 of file CommissioningAnalysis.h.

Constructor & Destructor Documentation

CommissioningAnalysis::CommissioningAnalysis	(	const uint32_t &	key,
		const std::string &	my_name
	)

Definition at line 9 of file CommissioningAnalysis.cc.

  : fecKey_( key ),
    fedKey_(sistrip::invalid32_),
    dcuId_(sistrip::invalid32_),
    detId_(sistrip::invalid32_),
    myName_(my_name),
    errors_(VString(0,""))
{;}

CommissioningAnalysis::CommissioningAnalysis

(

const std::string &

my_name

)

Definition at line 21 of file CommissioningAnalysis.cc.

  : fecKey_(sistrip::invalid32_),
    fedKey_(sistrip::invalid32_),
    dcuId_(sistrip::invalid32_),
    detId_(sistrip::invalid32_),
    myName_(my_name),
    errors_(VString(0,""))
{;}

virtual CommissioningAnalysis::~CommissioningAnalysis ( )

inlinevirtual

Definition at line 29 of file CommissioningAnalysis.h.

{;}

CommissioningAnalysis::CommissioningAnalysis ( )

inlineprivate

Private default constructor.

Definition at line 110 of file CommissioningAnalysis.h.

{;}

Member Function Documentation

void CommissioningAnalysis::addErrorCode ( const std::string &  error )

inlinevirtual

Adds error codes generated by analyses.

Reimplemented in ApvTimingAnalysis, and DaqScopeModeAnalysis.

Definition at line 155 of file CommissioningAnalysis.h.

References errors_.

Referenced by DaqScopeModeAnalysis::addErrorCode(), ApvTimingAnalysis::addErrorCode(), ApvLatencyAlgorithm::analyse(), FedTimingAlgorithm::analyse(), VpspScanAlgorithm::analyse(), NoiseAlgorithm::analyse(), FastFedCablingAlgorithm::analyse(), PedestalsAlgorithm::analyse(), PedsOnlyAlgorithm::analyse(), OptoScanAlgorithm::analyse(), PedsFullNoiseAlgorithm::analyse(), FedCablingAlgorithm::analyse(), ApvLatencyAlgorithm::extract(), FedTimingAlgorithm::extract(), VpspScanAlgorithm::extract(), SamplingAlgorithm::extract(), CalibrationAlgorithm::extract(), ApvTimingAlgorithm::extract(), NoiseAlgorithm::extract(), PedestalsAlgorithm::extract(), FastFedCablingAlgorithm::extract(), PedsOnlyAlgorithm::extract(), DaqScopeModeAlgorithm::extract(), PedsFullNoiseAlgorithm::extract(), OptoScanAlgorithm::extract(), CalibrationScanAlgorithm::extract(), FedCablingAlgorithm::extract(), and isValid().

{ errors_.push_back(error) ;}

const uint32_t & CommissioningAnalysis::dcuId ( ) const

inline

Returns DCU id.

Definition at line 143 of file CommissioningAnalysis.h.

References dcuId_.

Referenced by FastFedCablingHistosUsingDb::addDcuDetIds(), CommissioningHistosUsingDb::addDcuDetIds(), FastFedCablingHistosUsingDb::connections(), FastFedCablingHistosUsingDb::create(), FastFedCablingAnalysis::header(), isValid(), and FastFedCablingHistosUsingDb::update().

{ return dcuId_; }

void CommissioningAnalysis::dcuId ( const uint32_t &  dcu_id )

inline

Sets DCU id.

Definition at line 151 of file CommissioningAnalysis.h.

References dcuId_.

{ dcuId_ = dcu_id; }

const uint32_t & CommissioningAnalysis::detId ( ) const

inline

Returns DetId.

Definition at line 144 of file CommissioningAnalysis.h.

References detId_.

Referenced by FastFedCablingHistosUsingDb::addDcuDetIds(), CommissioningHistosUsingDb::addDcuDetIds(), FastFedCablingHistosUsingDb::connections(), FastFedCablingAnalysis::header(), and isValid().

{ return detId_; }

void CommissioningAnalysis::detId ( const uint32_t &  det_id )

inline

Sets DetId.

Definition at line 152 of file CommissioningAnalysis.h.

References detId_.

{ detId_ = det_id; }

const uint32_t & CommissioningAnalysis::fecKey ( ) const

inline

Returns FEC key object (encodes control structure).

Definition at line 140 of file CommissioningAnalysis.h.

References fecKey_.

Referenced by FastFedCablingHistosUsingDb::addDcuDetIds(), CommissioningHistosUsingDb::addDcuDetIds(), PedsFullNoiseAlgorithm::analyse(), FastFedCablingHistosUsingDb::connections(), DaqScopeModeHistosUsingDb::create(), VpspScanHistosUsingDb::create(), PedsOnlyHistosUsingDb::create(), NoiseHistosUsingDb::create(), OptoScanHistosUsingDb::create(), PedestalsHistosUsingDb::create(), PedsFullNoiseHistosUsingDb::create(), ApvTimingHistosUsingDb::create(), CalibrationHistosUsingDb::create(), FastFedCablingHistosUsingDb::create(), LatencyHistosUsingDb::create(), FineDelayHistosUsingDb::create(), CommissioningHistograms::data(), FastFedCablingAnalysis::FastFedCablingAnalysis(), FastFedCablingAnalysis::header(), FastFedCablingHistograms::histoAnalysis(), isValid(), CalibrationHistograms::save(), PedsOnlyAnalysis::summary(), VpspScanAnalysis::summary(), PedestalsAnalysis::summary(), NoiseAnalysis::summary(), OptoScanAnalysis::summary(), DaqScopeModeAnalysis::summary(), FastFedCablingAnalysis::summary(), PedsFullNoiseAnalysis::summary(), FastFedCablingHistosUsingDb::update(), and LatencyHistosUsingDb::update().

{ return fecKey_; }

void CommissioningAnalysis::fecKey ( const uint32_t &  key )

inline

Sets FEC key (encodes control structure).

Definition at line 148 of file CommissioningAnalysis.h.

References fecKey_, and crabWrapper::key.

{ fecKey_ = key; }

const uint32_t & CommissioningAnalysis::fedKey ( ) const

inline

Returns FED key object (encodes readout structure).

Definition at line 141 of file CommissioningAnalysis.h.

References fedKey_.

Referenced by CommissioningHistosUsingDb::addDcuDetIds(), FastFedCablingHistosUsingDb::connections(), DaqScopeModeHistosUsingDb::create(), NoiseHistosUsingDb::create(), OptoScanHistosUsingDb::create(), PedestalsHistosUsingDb::create(), PedsFullNoiseHistosUsingDb::create(), PedsOnlyHistosUsingDb::create(), VpspScanHistosUsingDb::create(), ApvTimingHistosUsingDb::create(), FastFedCablingHistosUsingDb::create(), LatencyHistosUsingDb::create(), CalibrationHistosUsingDb::create(), FineDelayHistosUsingDb::create(), CommissioningHistograms::data(), ApvLatencyAlgorithm::extract(), FedTimingAlgorithm::extract(), SamplingAlgorithm::extract(), VpspScanAlgorithm::extract(), CalibrationAlgorithm::extract(), FastFedCablingAlgorithm::extract(), NoiseAlgorithm::extract(), PedestalsAlgorithm::extract(), PedsOnlyAlgorithm::extract(), ApvTimingAlgorithm::extract(), DaqScopeModeAlgorithm::extract(), OptoScanAlgorithm::extract(), PedsFullNoiseAlgorithm::extract(), CalibrationScanAlgorithm::extract(), FedCablingAlgorithm::extract(), FastFedCablingAnalysis::FastFedCablingAnalysis(), FastFedCablingAnalysis::header(), isValid(), PedsOnlyAnalysis::summary(), VpspScanAnalysis::summary(), PedestalsAnalysis::summary(), NoiseAnalysis::summary(), OptoScanAnalysis::summary(), DaqScopeModeAnalysis::summary(), FastFedCablingAnalysis::summary(), summary(), PedsFullNoiseAnalysis::summary(), PedsFullNoiseHistosUsingDb::update(), and FastFedCablingHistosUsingDb::update().

{ return fedKey_; }

void CommissioningAnalysis::fedKey ( const uint32_t &  key )

inline

Sets FED key (encodes readout structure).

Definition at line 149 of file CommissioningAnalysis.h.

References fedKey_, and crabWrapper::key.

{ fedKey_ = key; }

const CommissioningAnalysis::VString & CommissioningAnalysis::getErrorCodes ( ) const

inline

Returns error codes generated by analyses.

Definition at line 138 of file CommissioningAnalysis.h.

References errors_.

Referenced by DaqScopeModeHistosUsingDb::create(), NoiseHistosUsingDb::create(), OptoScanHistosUsingDb::create(), PedestalsHistosUsingDb::create(), PedsFullNoiseHistosUsingDb::create(), PedsOnlyHistosUsingDb::create(), VpspScanHistosUsingDb::create(), ApvTimingHistosUsingDb::create(), CalibrationHistosUsingDb::create(), FastFedCablingHistosUsingDb::create(), LatencyHistosUsingDb::create(), FineDelayHistosUsingDb::create(), DaqScopeModeAnalysis::foundTickMark(), ApvTimingAnalysis::foundTickMark(), DaqScopeModeAnalysis::frameFindingThreshold(), ApvTimingAnalysis::frameFindingThreshold(), PedestalsHistograms::histoAnalysis(), PedsOnlyHistograms::histoAnalysis(), VpspScanHistograms::histoAnalysis(), PedsFullNoiseHistograms::histoAnalysis(), ApvTimingHistograms::histoAnalysis(), DaqScopeModeHistograms::histoAnalysis(), FastFedCablingHistograms::histoAnalysis(), NoiseHistograms::histoAnalysis(), OptoScanHistograms::histoAnalysis(), DaqScopeModeAnalysis::isValid(), NoiseAnalysis::isValid(), ApvTimingAnalysis::isValid(), PedestalsAnalysis::isValid(), PedsOnlyAnalysis::isValid(), VpspScanAnalysis::isValid(), OptoScanAnalysis::isValid(), PedsFullNoiseAnalysis::isValid(), FastFedCablingAnalysis::isValid(), FedCablingAnalysis::isValid(), isValid(), FedCablingAnalysis::print(), PedsOnlyAnalysis::print(), VpspScanAnalysis::print(), NoiseAnalysis::print(), PedestalsAnalysis::print(), OptoScanAnalysis::print(), DaqScopeModeAnalysis::print(), FastFedCablingAnalysis::print(), ApvTimingAnalysis::print(), and PedsFullNoiseAnalysis::print().

{ return errors_; }

void CommissioningAnalysis::header ( std::stringstream &  ss ) const

virtual

Header information for analysis print().

Reimplemented in FastFedCablingAnalysis.

Definition at line 32 of file CommissioningAnalysis.cc.

References SiStripFecKey::ccuAddr(), SiStripFecKey::ccuChan(), dcuId_, TauDecayModes::dec, detId_, SiStripFecKey::fecCrate(), SiStripFedKey::feChan(), fecKey_, SiStripFecKey::fecRing(), SiStripFecKey::fecSlot(), SiStripFedKey::fedChannel(), SiStripFedKey::fedId(), fedKey_, SiStripFedKey::feUnit(), SiStripFecKey::lldChan(), and myName().

Referenced by isValid(), ApvLatencyAnalysis::print(), SamplingAnalysis::print(), FedTimingAnalysis::print(), FedCablingAnalysis::print(), PedsOnlyAnalysis::print(), VpspScanAnalysis::print(), NoiseAnalysis::print(), PedestalsAnalysis::print(), OptoScanAnalysis::print(), DaqScopeModeAnalysis::print(), ApvTimingAnalysis::print(), CalibrationScanAnalysis::print(), PedsFullNoiseAnalysis::print(), and CalibrationAnalysis::print().

                                                              { 
  ss << "[" << myName() << "] Monitorables (65535 means \"invalid\"):" << std::endl;

  //summary(ss);

  SiStripFecKey fec_key( fecKey_ );
  ss << " Crate/FEC/Ring/CCU/Mod/LLD     : " 
     << fec_key.fecCrate() << "/" 
     << fec_key.fecSlot() << "/" 
     << fec_key.fecRing() << "/" 
     << fec_key.ccuAddr() << "/" 
     << fec_key.ccuChan() << "/" 
     << fec_key.lldChan() 
     << std::endl;

  SiStripFedKey fed_key( fedKey_ );
  ss << " FedId/FeUnit/FeChan/FedChannel : " 
     << fed_key.fedId() << "/" 
     << fed_key.feUnit() << "/" 
     << fed_key.feChan() << "/"
     << fed_key.fedChannel()
     << std::endl;
  // if ( fed_key.fedChannel() != sistrip::invalid_ ) { ss << fed_key.fedChannel(); }
  // else { ss << "(invalid)"; }
  // ss << std::endl;
  
//   ss << " FecKey/Fedkey (hex)            : 0x" 
//      << std::hex 
//      << std::setw(8) << std::setfill('0') << fecKey_
//      << " / 0x" 
//      << std::setw(8) << std::setfill('0') << fedKey_
//      << std::dec
//      << std::endl;
  
  ss << " FecKey (hex/dec)               : 0x" 
     << std::hex 
     << std::setw(8) << std::setfill('0') << fecKey_ 
     << " / "
     << std::dec
     << std::setw(10) << std::setfill(' ') << fecKey_ 
     << std::endl;

  ss << " FedKey (hex/dec)               : 0x" 
     << std::hex 
     << std::setw(8) << std::setfill('0') << fedKey_ 
     << " / "
     << std::dec
     << std::setw(10) << std::setfill(' ') << fedKey_ 
     << std::endl;
  
  ss << " DcuId (hex/dec)                : 0x" 
     << std::hex 
     << std::setw(8) << std::setfill('0') << dcuId_ 
     << " / "
     << std::dec
     << std::setw(10) << std::setfill(' ') << dcuId_ 
     << std::endl;

  ss << " DetId (hex/dec)                : 0x" 
     << std::hex 
     << std::setw(8) << std::setfill('0') << detId_ 
     << " / "
     << std::dec
     << std::setw(10) << std::setfill(' ') << detId_ 
     << std::endl;
  
}

virtual bool CommissioningAnalysis::isValid ( void  ) const

inlinevirtual

Identifies if analysis is valid or not.

Reimplemented in CalibrationAnalysis, FastFedCablingAnalysis, FedCablingAnalysis, PedsFullNoiseAnalysis, CalibrationScanAnalysis, ApvTimingAnalysis, NoiseAnalysis, OptoScanAnalysis, PedestalsAnalysis, PedsOnlyAnalysis, VpspScanAnalysis, and DaqScopeModeAnalysis.

Definition at line 51 of file CommissioningAnalysis.h.

References addErrorCode(), dcuId(), detId(), relativeConstraints::error, fecKey(), fedKey(), getErrorCodes(), header(), myName(), print(), reset(), setErrorCodes(), AlCaHLTBitMon_QueryRunRegistry::string, and summary().

Referenced by ntupleDataFormat._Object::_checkIsValid(), LatencyHistosUsingDb::create(), FineDelayHistosUsingDb::create(), core.AutoHandle.AutoHandle::ReallyLoad(), and summary().

{ return true; } 

const std::string & CommissioningAnalysis::myName ( void  ) const

inline

Returns object name.

Definition at line 146 of file CommissioningAnalysis.h.

References myName_.

Referenced by FastFedCablingAnalysis::header(), header(), isValid(), PedsOnlyAnalysis::print(), NoiseAnalysis::print(), PedestalsAnalysis::print(), OptoScanAnalysis::print(), DaqScopeModeAnalysis::print(), PedsFullNoiseAnalysis::print(), ApvTimingAnalysis::refTime(), PedsOnlyAnalysis::summary(), VpspScanAnalysis::summary(), NoiseAnalysis::summary(), PedestalsAnalysis::summary(), OptoScanAnalysis::summary(), DaqScopeModeAnalysis::summary(), FastFedCablingAnalysis::summary(), summary(), and PedsFullNoiseAnalysis::summary().

{ return myName_; }

virtual void CommissioningAnalysis::print ( std::stringstream &  , uint32_t  not_used = 0  )

pure virtual

Prints analysis results.

Implemented in CalibrationAnalysis, PedsFullNoiseAnalysis, ApvTimingAnalysis, CalibrationScanAnalysis, FastFedCablingAnalysis, DaqScopeModeAnalysis, OptoScanAnalysis, NoiseAnalysis, PedestalsAnalysis, VpspScanAnalysis, PedsOnlyAnalysis, FedCablingAnalysis, FedTimingAnalysis, SamplingAnalysis, and ApvLatencyAnalysis.

Referenced by isValid().

virtual void CommissioningAnalysis::reset ( )

pure virtual

Resets analysis member data.

Implemented in CalibrationAnalysis, PedsFullNoiseAnalysis, FastFedCablingAnalysis, DaqScopeModeAnalysis, ApvTimingAnalysis, CalibrationScanAnalysis, OptoScanAnalysis, NoiseAnalysis, PedestalsAnalysis, VpspScanAnalysis, PedsOnlyAnalysis, FedCablingAnalysis, FedTimingAnalysis, SamplingAnalysis, and ApvLatencyAnalysis.

Referenced by MatrixReader.MatrixReader::__init__(), CommissioningAlgorithm::analysis(), isValid(), and MatrixReader.MatrixReader::showRaw().

void CommissioningAnalysis::setErrorCodes ( const VString &  errors )

inline

Sets error codes generated by analyses.

Definition at line 154 of file CommissioningAnalysis.h.

References benchmark_cfg::errors, and errors_.

Referenced by isValid().

{ errors_ = errors; }

void CommissioningAnalysis::summary ( std::stringstream &  ss ) const

virtual

Navigate information for analysis print().

Reimplemented in PedsFullNoiseAnalysis, FastFedCablingAnalysis, DaqScopeModeAnalysis, OptoScanAnalysis, NoiseAnalysis, PedestalsAnalysis, VpspScanAnalysis, and PedsOnlyAnalysis.

Definition at line 102 of file CommissioningAnalysis.cc.

References SiStripFecKey::ccuAddr(), SiStripFecKey::ccuChan(), sistrip::controlView_, sistrip::dir_, sistrip::dqmRoot_, sistrip::EXPERT_HISTO, SiStripFecKey::fecCrate(), fecKey_, SiStripFecKey::fecRing(), SiStripFecKey::fecSlot(), sistrip::FED_KEY, fedKey(), isValid(), sistrip::LLD_CHAN, SiStripFecKey::lldChan(), myName(), callgraph::path, SiStripEnumsAndStrings::runType(), AlCaHLTBitMon_QueryRunRegistry::string, and runGCPTkAlMap::title.

Referenced by isValid().

                                                               { 

  SiStripFecKey fec_key( fecKey_ );
  
  sistrip::RunType type = SiStripEnumsAndStrings::runType( myName() );
  std::string title = SiStripHistoTitle( sistrip::EXPERT_HISTO, 
                     type,
                     sistrip::FED_KEY, 
                     fedKey(),
                     sistrip::LLD_CHAN, 
                     fec_key.lldChan() ).title();
  
  ss << " Summary"
     << ":"
     << ( isValid() ? "Valid" : "Invalid" )
     << ":"
     << sistrip::controlView_ << ":"
     << fec_key.fecCrate() << "/" 
     << fec_key.fecSlot() << "/" 
     << fec_key.fecRing() << "/" 
     << fec_key.ccuAddr() << "/" 
     << fec_key.ccuChan() 
     << ":"
     << sistrip::dqmRoot_ << sistrip::dir_ 
     << "Collate" << sistrip::dir_ 
     << SiStripFecKey( fec_key.fecCrate(),
               fec_key.fecSlot(), 
               fec_key.fecRing(), 
               fec_key.ccuAddr(), 
               fec_key.ccuChan() ).path()
     << ":"
     << title
     << std::endl;
  
}

Member Data Documentation

uint32_t CommissioningAnalysis::dcuId_

private

DCU Id.

Definition at line 123 of file CommissioningAnalysis.h.

Referenced by dcuId(), and header().

uint32_t CommissioningAnalysis::detId_

private

DetId.

Definition at line 126 of file CommissioningAnalysis.h.

Referenced by detId(), and header().

VString CommissioningAnalysis::errors_

private

Error codes.

Definition at line 132 of file CommissioningAnalysis.h.

Referenced by addErrorCode(), getErrorCodes(), and setErrorCodes().

uint32_t CommissioningAnalysis::fecKey_

private

FEC key object.

Definition at line 117 of file CommissioningAnalysis.h.

Referenced by fecKey(), header(), and summary().

uint32_t CommissioningAnalysis::fedKey_

private

FEC key object.

Definition at line 120 of file CommissioningAnalysis.h.

Referenced by fedKey(), and header().

std::string CommissioningAnalysis::myName_

private

Object name.

Definition at line 129 of file CommissioningAnalysis.h.

Referenced by myName().