SiStripKey Class Reference

Base utility class that identifies a position within a logical structure of the strip tracker. More...

#include <SiStripKey.h>

Inheritance diagram for SiStripKey:

Public Member Functions
const uint16_t &	channel () const
const sistrip::Granularity &	granularity () const
virtual bool	isConsistent (const SiStripKey &) const
virtual bool	isEqual (const SiStripKey &) const
virtual bool	isInvalid () const
virtual bool	isInvalid (const sistrip::Granularity &) const
virtual bool	isValid () const
virtual bool	isValid (const sistrip::Granularity &) const
const uint32_t &	key () const
const SiStripKey &	operator= (const SiStripKey &)
const std::string &	path () const
virtual void	print (std::stringstream &ss) const
	SiStripKey (const uint32_t &key)
	SiStripKey (const std::string &directory_path)
	SiStripKey (const SiStripKey &)
	SiStripKey ()
virtual void	terse (std::stringstream &ss) const
virtual	~SiStripKey ()

Protected Member Functions
void	channel (const uint16_t &)
void	granularity (const sistrip::Granularity &)
virtual void	initFromKey ()
virtual void	initFromPath ()
virtual void	initFromValue ()
virtual void	initGranularity ()
void	key (const uint32_t &)
void	path (const std::string &)

Private Attributes
uint16_t	channel_
sistrip::Granularity	granularity_
uint32_t	key_
std::string	path_

Detailed Description

Base utility class that identifies a position within a logical structure of the strip tracker.

Author

R.Bainbridge

Definition at line 23 of file SiStripKey.h.

Constructor & Destructor Documentation

SiStripKey::SiStripKey

(

const uint32_t &

key

)

Constructor using 32-bit "key".

Definition at line 9 of file SiStripKey.cc.

    : key_(key), path_(sistrip::null_), granularity_(sistrip::UNDEFINED_GRAN), channel_(sistrip::invalid_) {
  ;
}

SiStripKey::SiStripKey

(

const std::string &

directory_path

)

Constructor using directory path.

Definition at line 16 of file SiStripKey.cc.

    : key_(sistrip::invalid32_), path_(path), granularity_(sistrip::UNDEFINED_GRAN), channel_(sistrip::invalid_) {
  ;
}

SiStripKey::SiStripKey

(

const SiStripKey &

input

)

Copy constructor.

Definition at line 23 of file SiStripKey.cc.

    : key_(input.key()), path_(input.path()), granularity_(input.granularity()), channel_(input.channel()) {
  ;
}

SiStripKey::SiStripKey

(

)

Default constructor.

Definition at line 43 of file SiStripKey.cc.

    : key_(sistrip::invalid32_),
      path_(sistrip::null_),
      granularity_(sistrip::UNDEFINED_GRAN),
      channel_(sistrip::invalid_) {
  ;
}

virtual SiStripKey::~SiStripKey ( )

inlinevirtual

Virtual destructor.

Definition at line 43 of file SiStripKey.h.

{ ; }

Member Function Documentation

const uint16_t & SiStripKey::channel ( ) const

inline

Returns channel for key granularity.

Definition at line 123 of file SiStripKey.h.

References channel_.

Referenced by CommissioningHistosUsingDb::deviceIsPresent(), SummaryGeneratorControlView::fill(), SiStripCommissioningSource::fillCablingHistos(), SiStripDetKey::initGranularity(), SiStripFecKey::initGranularity(), SiStripFedKey::initGranularity(), isEqual(), operator=(), SiStripNullKey::print(), print(), SiStripDetKey::print(), SiStripFecKey::print(), SiStripFedKey::print(), SiStripHistoTitle::SiStripHistoTitle(), ApvTimingHistosUsingDb::update(), VpspScanHistosUsingDb::update(), OptoScanHistosUsingDb::update(), and CalibrationHistosUsingDb::update().

{ return channel_; }

void SiStripKey::channel ( const uint16_t &  chan )

inlineprotected

Definition at line 128 of file SiStripKey.h.

References officialStyle::chan, and channel_.

{ channel_ = chan; }

const sistrip::Granularity & SiStripKey::granularity ( ) const

inline

Returns granularity to which key is unambiguous.

Definition at line 122 of file SiStripKey.h.

References granularity_.

Referenced by CommissioningHistograms::extractHistograms(), SiStripDetKey::initGranularity(), SiStripFecKey::initGranularity(), SiStripFedKey::initGranularity(), isEqual(), operator=(), SiStripNullKey::print(), print(), SiStripDetKey::print(), SiStripFecKey::print(), SiStripFedKey::print(), SiStripDetKey::SiStripDetKey(), SiStripFecKey::SiStripFecKey(), SiStripFedKey::SiStripFedKey(), and SiStripHistoTitle::SiStripHistoTitle().

{ return granularity_; }

void SiStripKey::granularity ( const sistrip::Granularity &  gran )

inlineprotected

Definition at line 127 of file SiStripKey.h.

References granularity_.

{ granularity_ = gran; }

virtual void SiStripKey::initFromKey ( )

inlineprotectedvirtual

Reimplemented in SiStripFedKey, SiStripFecKey, SiStripDetKey, and SiStripNullKey.

Definition at line 93 of file SiStripKey.h.

{ ; }

virtual void SiStripKey::initFromPath ( )

inlineprotectedvirtual

Reimplemented in SiStripFedKey, SiStripFecKey, SiStripDetKey, and SiStripNullKey.

Definition at line 94 of file SiStripKey.h.

{ ; }

virtual void SiStripKey::initFromValue ( )

inlineprotectedvirtual

Reimplemented in SiStripFedKey, SiStripFecKey, SiStripDetKey, and SiStripNullKey.

Definition at line 92 of file SiStripKey.h.

{ ; }

virtual void SiStripKey::initGranularity ( )

inlineprotectedvirtual

Reimplemented in SiStripFedKey, SiStripFecKey, SiStripDetKey, and SiStripNullKey.

Definition at line 95 of file SiStripKey.h.

{ ; }

bool SiStripKey::isConsistent ( const SiStripKey &  input ) const

virtual

"Consistent" means identical and/or null (ie, "all") data.

Reimplemented in SiStripFedKey, SiStripFecKey, SiStripDetKey, and SiStripNullKey.

Definition at line 64 of file SiStripKey.cc.

References isEqual().

{ return isEqual(input); }

bool SiStripKey::isEqual ( const SiStripKey &  input ) const

virtual

Identifies key objects with identical member data.

Reimplemented in SiStripFedKey, SiStripFecKey, SiStripDetKey, and SiStripNullKey.

Definition at line 53 of file SiStripKey.cc.

References channel(), channel_, granularity(), granularity_, key(), key_, path(), and path_.

Referenced by isConsistent().

                                                      {
  if (key_ == input.key() && path_ == input.path() && granularity_ == input.granularity() &&
      channel_ == input.channel()) {
    return true;
  } else {
    return false;
  }
}

bool SiStripKey::isInvalid ( ) const

virtual

Identifies all member data as being invalid.

Reimplemented in SiStripFedKey, SiStripFecKey, SiStripDetKey, and SiStripNullKey.

Definition at line 79 of file SiStripKey.cc.

References channel_, granularity_, sistrip::invalid32_, sistrip::invalid_, key_, sistrip::null_, path_, and sistrip::UNDEFINED_GRAN.

Referenced by isInvalid().

                                 {
  return (key_ == sistrip::invalid32_ || path_ == sistrip::null_ || granularity_ == sistrip::UNDEFINED_GRAN ||
          channel_ == sistrip::invalid_);
}

bool SiStripKey::isInvalid ( const sistrip::Granularity &  gran ) const

virtual

All member data to level of "Granularity" are invalid. If sistrip::Granularity is "undefined", returns true.

Reimplemented in SiStripFedKey, SiStripFecKey, SiStripDetKey, and SiStripNullKey.

Definition at line 86 of file SiStripKey.cc.

References isInvalid().

{ return isInvalid(); }

bool SiStripKey::isValid ( void  ) const

virtual

Identifies all member data as being "valid" or null ("all").

Reimplemented in SiStripFedKey, SiStripFecKey, SiStripDetKey, and SiStripNullKey.

Definition at line 68 of file SiStripKey.cc.

References channel_, granularity_, sistrip::invalid32_, sistrip::invalid_, key_, sistrip::null_, path_, and sistrip::UNDEFINED_GRAN.

Referenced by ntupleDataFormat._Object::_checkIsValid(), isValid(), and core.AutoHandle.AutoHandle::ReallyLoad().

                               {
  return (key_ != sistrip::invalid32_ && path_ != sistrip::null_ && granularity_ != sistrip::UNDEFINED_GRAN &&
          channel_ != sistrip::invalid_);
}

bool SiStripKey::isValid ( const sistrip::Granularity &  gran ) const

virtual

All member data to level of "Granularity" are valid. If sistrip::Granularity is "undefined", returns false.

Reimplemented in SiStripFedKey, SiStripFecKey, SiStripDetKey, and SiStripNullKey.

Definition at line 75 of file SiStripKey.cc.

References isValid().

Referenced by ntupleDataFormat._Object::_checkIsValid(), and core.AutoHandle.AutoHandle::ReallyLoad().

{ return isValid(); }

const uint32_t & SiStripKey::key ( ) const

inline

Returns 32-bit key.

Definition at line 120 of file SiStripKey.h.

References key_.

Referenced by FedCablingAlgorithm::analyse(), FineDelayTask::book(), LatencyTask::book(), CommissioningHistosUsingDb::buildDetInfo(), SiStripFedCablingBuilderFromDb::buildFecCablingFromDetIds(), ViewTranslator::buildMaps(), CommissioningHistosUsingDb::detInfo(), CalibrationScanSummaryFactory::extract(), CalibrationSummaryFactory::extract(), CommissioningHistograms::extractHistograms(), SiStripCommissioningSource::fillCablingHistos(), SiStripDetKey::initFromKey(), SiStripFecKey::initFromKey(), SiStripFedKey::initFromKey(), SiStripFecKey::initFromValue(), SiStripDetKey::isConsistent(), SiStripFecKey::isConsistent(), SiStripFedKey::isConsistent(), isEqual(), SiStripDetKey::isEqual(), SiStripFecKey::isEqual(), SiStripFedKey::isEqual(), key(), SiStripFedCablingFakeESSource::make(), ConsistentWithKey::operator()(), operator<(), operator=(), SiStripNullKey::print(), print(), SiStripDetKey::print(), SiStripFecKey::print(), SiStripFedKey::print(), SiStripConfigDb::printAnalysisDescriptions(), SiStripConfigDb::printDeviceDescriptions(), SiStripDetKey::SiStripDetKey(), SiStripFecKey::SiStripFecKey(), SiStripFedKey::SiStripFedKey(), SiStripHistoTitle::SiStripHistoTitle(), PedsOnlyAnalysis::summary(), VpspScanAnalysis::summary(), NoiseAnalysis::summary(), PedestalsAnalysis::summary(), OptoScanAnalysis::summary(), DaqScopeModeAnalysis::summary(), FastFedCablingAnalysis::summary(), PedsFullNoiseAnalysis::summary(), DaqScopeModeHistosUsingDb::update(), OptoScanHistosUsingDb::update(), PedsOnlyHistosUsingDb::update(), ApvTimingHistosUsingDb::update(), VpspScanHistosUsingDb::update(), PedsFullNoiseHistosUsingDb::update(), PedestalsHistosUsingDb::update(), NoiseHistosUsingDb::update(), LatencyHistosUsingDb::update(), FastFedCablingHistosUsingDb::update(), CalibrationHistosUsingDb::update(), and FineDelayHistosUsingDb::update().

{ return key_; }

void SiStripKey::key ( const uint32_t &  key )

inlineprotected

Definition at line 125 of file SiStripKey.h.

References key(), and key_.

{ key_ = key; }

const SiStripKey & SiStripKey::operator=

(

const SiStripKey &

rhs

)

Assignment.

Definition at line 30 of file SiStripKey.cc.

References channel(), channel_, granularity(), granularity_, key(), key_, path(), and path_.

                                                             {
  if (this == &rhs) {
    return *this;
  }
  key_ = rhs.key();
  path_ = rhs.path();
  granularity_ = rhs.granularity();
  channel_ = rhs.channel();
  return *this;
}

const std::string & SiStripKey::path ( ) const

inline

Returns directory path.

Definition at line 121 of file SiStripKey.h.

References path_.

Referenced by CommissioningHistosUsingDb::addDcuDetIds(), SiStripTFile::addDevice(), FineDelayTask::book(), LatencyTask::book(), SPYHistograms::bookFEDHistograms(), CommissioningHistograms::copyCustomInformation(), SummaryGeneratorControlView::fill(), SummaryGeneratorReadoutView::fill(), SiStripDetKey::initFromPath(), SiStripFecKey::initFromPath(), SiStripFedKey::initFromPath(), isEqual(), operator=(), path(), SiStripNullKey::print(), print(), SiStripDetKey::print(), SiStripFecKey::print(), SiStripFedKey::print(), CommissioningHistograms::runNumber(), CommissioningHistograms::runType(), SiStripDetKey::SiStripDetKey(), SiStripFecKey::SiStripFecKey(), SiStripFedKey::SiStripFedKey(), and FastFedCablingAnalysis::summary().

{ return path_; }

void SiStripKey::path ( const std::string &  path )

inlineprotected

Definition at line 126 of file SiStripKey.h.

References path(), and path_.

{ path_ = path; }

void SiStripKey::print ( std::stringstream &  ss ) const

virtual

Print member data of the key

Reimplemented in SiStripFedKey, SiStripFecKey, SiStripDetKey, and SiStripNullKey.

Definition at line 90 of file SiStripKey.cc.

References channel(), TauDecayModes::dec, SiStripEnumsAndStrings::granularity(), granularity(), key(), and path().

Referenced by operator<<().

                                                {
  ss << " [SiStripKey::print]" << std::endl
     << std::hex << " 32-bit key  : 0x" << std::setfill('0') << std::setw(8) << key() << std::endl
     << std::setfill(' ') << std::dec << " Directory   : " << path() << std::endl
     << " Granularity : " << SiStripEnumsAndStrings::granularity(granularity()) << std::endl
     << " Channel     : " << channel();
}

virtual void SiStripKey::terse ( std::stringstream &  ss ) const

inlinevirtual

A terse summary of the key

Reimplemented in SiStripFedKey, SiStripFecKey, SiStripDetKey, and SiStripNullKey.

Definition at line 87 of file SiStripKey.h.

{ ; }

Member Data Documentation

uint16_t SiStripKey::channel_

private

Channel of key granularity.

Definition at line 115 of file SiStripKey.h.

Referenced by channel(), isEqual(), isInvalid(), isValid(), and operator=().

sistrip::Granularity SiStripKey::granularity_

private

Granularity to which FED key is unambiguous.

Definition at line 112 of file SiStripKey.h.

Referenced by granularity(), isEqual(), isInvalid(), isValid(), and operator=().

uint32_t SiStripKey::key_

private

32-bit key.

Definition at line 106 of file SiStripKey.h.

Referenced by isEqual(), isInvalid(), isValid(), key(), and operator=().

std::string SiStripKey::path_

private

Directory path.

Definition at line 109 of file SiStripKey.h.

Referenced by isEqual(), isInvalid(), isValid(), operator=(), and path().