Utility class that identifies a position within the strip tracker geometrical structure, down to the level of an APV25 chip. More...

#include <SiStripDetKey.h>

Inheritance diagram for SiStripDetKey:

Public Member Functions
const uint16_t &	apvPairNumber () const

const uint16_t &	apvWithinPair () const

bool	isConsistent (const SiStripKey &) const override

bool	isEqual (const SiStripKey &) const override

bool	isInvalid () const override

bool	isInvalid (const sistrip::Granularity &) const override

bool	isValid () const override

bool	isValid (const sistrip::Granularity &) const override

const uint16_t &	partition () const

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

	SiStripDetKey ()

	SiStripDetKey (const DetId &det_id, const uint16_t &apv_pair_number=0, const uint16_t &apv_within_pair=0)

	SiStripDetKey (const SiStripDetId &det_id)

	SiStripDetKey (const SiStripDetKey &)

	SiStripDetKey (const SiStripKey &)

	SiStripDetKey (const SiStripKey &, const sistrip::Granularity &)

	SiStripDetKey (const std::string &directory_path)

	SiStripDetKey (const uint16_t &partition)

	SiStripDetKey (const uint32_t &det_key)

void	terse (std::stringstream &ss) const override

Public Member Functions inherited from SiStripKey
const uint16_t &	channel () const

const sistrip::Granularity &	granularity () const

const uint32_t &	key () const

const SiStripKey &	operator= (const SiStripKey &)

const std::string &	path () const

	SiStripKey ()

	SiStripKey (const SiStripKey &)

	SiStripKey (const std::string &directory_path)

	SiStripKey (const uint32_t &key)

virtual	~SiStripKey ()

Private Member Functions
void	initFromKey () override

void	initFromPath () override

void	initFromValue () override

void	initGranularity () override

Private Attributes
uint16_t	apvPairNumber_

uint16_t	apvWithinPair_

uint16_t	partition_

Static Private Attributes
static const uint16_t	partitionMask_ = 0x07

static const uint16_t	partitionOffset_ = 29

Additional Inherited Members
Protected Member Functions inherited from SiStripKey
void	channel (const uint16_t &)

void	granularity (const sistrip::Granularity &)

void	key (const uint32_t &)

void	path (const std::string &)

Detailed Description

Utility class that identifies a position within the strip tracker geometrical structure, down to the level of an APV25 chip.

Author: R.Bainbridge, S.Lowette

NOTA BENE: *** NOT FINISHED ***

can generate another key that is NOT DetId and packs sistrip-specific data in a more condensed way, so that all levels can be encoded with "all" and "invalid" values, down to level of apv. also, need "conversion tool" that re-generates DetId key from this new key. this is only way...!!! maybe can "safeguard" use of this key as a DetId by reserving bits 22-24 as a flag (eg, set all high), so that if an attempt to build DetId using SiStripDetId class, we can understand if key is real DetId or not... what about going to level of apv?... what about levels about module?...

Definition at line 28 of file SiStripDetKey.h.

Constructor & Destructor Documentation

◆ SiStripDetKey() [1/9]

SiStripDetKey::SiStripDetKey ( const uint16_t & partition )

Constructor using partition.

Definition at line 9 of file SiStripDetKey.cc.

     : SiStripKey(), partition_(partition), apvPairNumber_(sistrip::invalid_), apvWithinPair_(sistrip::invalid_) {
   // order is important!
   initFromValue();
   initFromKey();
   initFromPath();
   initGranularity();
 }

References initFromKey(), initFromPath(), initFromValue(), and initGranularity().

◆ SiStripDetKey() [2/9]

SiStripDetKey::SiStripDetKey	(	const DetId &	det_id,
		const uint16_t &	apv_pair_number = `0`,
		const uint16_t &	apv_within_pair = `0`
	)

Constructor using DetId, APV pair and APV pos within pair.

Definition at line 20 of file SiStripDetKey.cc.

     : SiStripKey(), partition_(sistrip::invalid_), apvPairNumber_(apv_pair_number), apvWithinPair_(apv_within_pair) {
   // order is important!
   initFromValue();
   initFromKey();
   initFromPath();
   initGranularity();
 }

References initFromKey(), initFromPath(), initFromValue(), and initGranularity().

◆ SiStripDetKey() [3/9]

SiStripDetKey::SiStripDetKey ( const SiStripDetId & det_id )

Constructor using SiStripDetId.

Definition at line 31 of file SiStripDetKey.cc.

     : SiStripKey(),
       partition_(sistrip::invalid_),
       apvPairNumber_(sistrip::invalid_),
       apvWithinPair_(sistrip::invalid_) {
   // order is important!
   initFromValue();
   initFromKey();
   initFromPath();
   initGranularity();
 }

References initFromKey(), initFromPath(), initFromValue(), and initGranularity().

◆ SiStripDetKey() [4/9]

SiStripDetKey::SiStripDetKey ( const uint32_t & det_key )

Constructor using 32-bit "DET key".

Definition at line 45 of file SiStripDetKey.cc.

     : SiStripKey(det_key),
       partition_(sistrip::invalid_),
       apvPairNumber_(sistrip::invalid_),
       apvWithinPair_(sistrip::invalid_) {
   // order is important!
   initFromKey();
   initFromValue();
   initFromPath();
   initGranularity();
 }

References initFromKey(), initFromPath(), initFromValue(), and initGranularity().

◆ SiStripDetKey() [5/9]

SiStripDetKey::SiStripDetKey ( const std::string & directory_path )

Constructor using directory path.

Definition at line 59 of file SiStripDetKey.cc.

     : SiStripKey(path),
       partition_(sistrip::invalid_),
       apvPairNumber_(sistrip::invalid_),
       apvWithinPair_(sistrip::invalid_) {
   // order is important!
   initFromPath();
   initFromValue();
   initFromKey();
   initGranularity();
 }

References initFromKey(), initFromPath(), initFromValue(), and initGranularity().

◆ SiStripDetKey() [6/9]

SiStripDetKey::SiStripDetKey ( const SiStripDetKey & input )

Copy constructor.

Definition at line 73 of file SiStripDetKey.cc.

     : SiStripKey(),
       partition_(input.partition()),
       apvPairNumber_(input.apvPairNumber()),
       apvWithinPair_(input.apvWithinPair()) {
   key(input.key());
   path(input.path());
   granularity(input.granularity());
 }

References SiStripKey::granularity(), input, SiStripKey::key(), and SiStripKey::path().

◆ SiStripDetKey() [7/9]

SiStripDetKey::SiStripDetKey ( const SiStripKey & input )

Copy constructor using base class.

Definition at line 85 of file SiStripDetKey.cc.

     : SiStripKey(),
       partition_(sistrip::invalid_),
       apvPairNumber_(sistrip::invalid_),
       apvWithinPair_(sistrip::invalid_) {
   const SiStripDetKey& det_key = dynamic_cast<const SiStripDetKey&>(input);
   key(det_key.key());
   path(det_key.path());
   granularity(det_key.granularity());
   partition_ = det_key.partition();
   apvPairNumber_ = det_key.apvPairNumber();
   apvWithinPair_ = det_key.apvWithinPair();
 }

References apvPairNumber(), apvPairNumber_, apvWithinPair(), apvWithinPair_, SiStripKey::granularity(), input, SiStripKey::key(), partition(), partition_, and SiStripKey::path().

◆ SiStripDetKey() [8/9]

SiStripDetKey::SiStripDetKey	(	const SiStripKey &	input,
		const sistrip::Granularity &	gran
	)

Copy to level specified by granularity.

Definition at line 101 of file SiStripDetKey.cc.

     : SiStripKey(), partition_(0), apvPairNumber_(0), apvWithinPair_(0) {
   const SiStripDetKey& det_key = dynamic_cast<const SiStripDetKey&>(input);
   if (gran == sistrip::PARTITION) {
     partition_ = det_key.partition();
   }
  
   initFromValue();
   initFromKey();
   initFromPath();
   initGranularity();
 }

References initFromKey(), initFromPath(), initFromValue(), initGranularity(), input, partition(), sistrip::PARTITION, and partition_.

◆ SiStripDetKey() [9/9]

SiStripDetKey::SiStripDetKey ( )

Default constructor

Definition at line 116 of file SiStripDetKey.cc.

     : SiStripKey(),
       partition_(sistrip::invalid_),
       apvPairNumber_(sistrip::invalid_),
       apvWithinPair_(sistrip::invalid_) {
   ;
 }

Member Function Documentation

◆ apvPairNumber()

const uint16_t & SiStripDetKey::apvPairNumber ( ) const

inline

Returns APV pair number.

Definition at line 135 of file SiStripDetKey.h.

135 { return apvPairNumber_; }

References apvPairNumber_.

Referenced by SiStripDetKey().

◆ apvWithinPair()

const uint16_t & SiStripDetKey::apvWithinPair ( ) const

inline

Returns APV position within pair.

Definition at line 136 of file SiStripDetKey.h.

136 { return apvWithinPair_; }

References apvWithinPair_.

Referenced by SiStripDetKey().

◆ initFromKey()

void SiStripDetKey::initFromKey ( )

overrideprivatevirtual

Reimplemented from SiStripKey.

Definition at line 203 of file SiStripDetKey.cc.

                                 {
   if (key() == sistrip::invalid32_) {
     // ---------- Set DetKey based on member data ----------
  
     // Initialise to null value
     key(0);
  
     // Extract partition
     if (partition_ >= 1 &&  //sistrip::PARTITION_MIN &&
         partition_ <= 4) {  //sistrip::PARTITION_MAX ) {
       key(key() | (partition_ << partitionOffset_));
     } else if (partition_ == 0) {
       key(key() | (partition_ << partitionOffset_));
     } else {
       key(key() | (partitionMask_ << partitionOffset_));
     }
  
   } else {
     // ---------- Set member data based on Det key ----------
  
     partition_ = (key() >> partitionOffset_) & partitionMask_;
  
     if (partition_ == partitionMask_) {
       partition_ = sistrip::invalid_;
     }
   }
 }

References sistrip::invalid32_, sistrip::invalid_, SiStripKey::key(), partition_, partitionMask_, and partitionOffset_.

Referenced by SiStripDetKey().

◆ initFromPath()

void SiStripDetKey::initFromPath ( )

overrideprivatevirtual

Reimplemented from SiStripKey.

Definition at line 233 of file SiStripDetKey.cc.

                                  {
   if (path() == sistrip::null_) {
     // ---------- Set directory path based on member data ----------
  
     std::stringstream dir;
  
     dir << sistrip::root_ << sistrip::dir_ << sistrip::detectorView_ << sistrip::dir_;
  
     // Add partition
     if (partition_) {
       dir << sistrip::partition_ << partition_ << sistrip::dir_;
     }
  
     std::string temp(dir.str());
     path(temp);
  
   } else {
     // ---------- Set member data based on directory path ----------
  
     partition_ = 0;
  
     // Check if root is found
     if (path().find(sistrip::root_) == std::string::npos) {
       std::string temp = path();
       path(std::string(sistrip::root_) + sistrip::dir_ + temp);
     }
  
     size_t curr = 0;  // current string position
     size_t next = 0;  // next string position
     next = path().find(sistrip::detectorView_, curr);
  
     // Extract view
     curr = next;
     if (curr != std::string::npos) {
       next = path().find(sistrip::partition_, curr);
       std::string detector_view(
           path(), curr + (sizeof(sistrip::detectorView_) - 1), next - (sizeof(sistrip::dir_) - 1) - curr);
       // Extract partition
       curr = next;
       if (curr != std::string::npos) {
         next = std::string::npos;
         std::string partition(
             path(), curr + (sizeof(sistrip::partition_) - 1), next - (sizeof(sistrip::dir_) - 1) - curr);
         partition_ = std::atoi(partition.c_str());
       }
     } else {
       std::stringstream ss;
       ss << sistrip::root_ << sistrip::dir_;
       //ss << sistrip::root_ << sistrip::dir_
       //<< sistrip::unknownView_ << sistrip::dir_;
       std::string temp(ss.str());
       path(temp);
     }
   }
 }

References sistrip::detectorView_, DeadROC_duringRun::dir, sistrip::dir_, spr::find(), GetRecoTauVFromDQM_MC_cff::next, sistrip::null_, partition(), sistrip::partition_, partition_, SiStripKey::path(), sistrip::root_, contentValuesCheck::ss, AlCaHLTBitMon_QueryRunRegistry::string, and groupFilesInBlocks::temp.

Referenced by SiStripDetKey().

◆ initFromValue()

void SiStripDetKey::initFromValue ( )

overrideprivatevirtual

Reimplemented from SiStripKey.

Definition at line 194 of file SiStripDetKey.cc.

                                   {
   // partition
   if (partition_ > 4) {
     partition_ = sistrip::invalid_;
   }
 }

References sistrip::invalid_, and partition_.

Referenced by SiStripDetKey().

◆ initGranularity()

void SiStripDetKey::initGranularity ( )

overrideprivatevirtual

Reimplemented from SiStripKey.

Definition at line 291 of file SiStripDetKey.cc.

                                     {
   granularity(sistrip::TRACKER);
   channel(0);
   if (partition_ && partition_ != sistrip::invalid_) {
     granularity(sistrip::PARTITION);
     channel(partition_);
   } else if (partition_ == sistrip::invalid_) {
     granularity(sistrip::UNKNOWN_GRAN);
     channel(sistrip::invalid_);
   }
 }

References SiStripKey::channel(), SiStripKey::granularity(), sistrip::invalid_, sistrip::PARTITION, partition_, sistrip::TRACKER, and sistrip::UNKNOWN_GRAN.

Referenced by SiStripDetKey().

◆ isConsistent()

bool SiStripDetKey::isConsistent ( const SiStripKey & key ) const

overridevirtual

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

Reimplemented from SiStripKey.

Definition at line 138 of file SiStripDetKey.cc.

                                                             {
   const SiStripDetKey& input = dynamic_cast<const SiStripDetKey&>(key);
   if (isEqual(input)) {
     return false;
   } else if ((partition_ == 0 || input.partition() == 0) && (apvPairNumber_ == 0 || input.apvPairNumber() == 0) &&
              (apvWithinPair_ == 0 || input.apvWithinPair() == 0)) {
     return true;
   } else {
     return false;
   }
 }

References apvPairNumber_, apvWithinPair_, input, isEqual(), SiStripKey::key(), and partition_.

◆ isEqual()

bool SiStripDetKey::isEqual ( const SiStripKey & key ) const

overridevirtual

Identifies key objects with identical member data.

Reimplemented from SiStripKey.

Definition at line 126 of file SiStripDetKey.cc.

                                                        {
   const SiStripDetKey& input = dynamic_cast<const SiStripDetKey&>(key);
   if (partition_ == input.partition() && apvPairNumber_ == input.apvPairNumber() &&
       apvWithinPair_ == input.apvWithinPair()) {
     return true;
   } else {
     return false;
   }
 }

References apvPairNumber_, apvWithinPair_, input, SiStripKey::key(), and partition_.

Referenced by isConsistent().

◆ isInvalid() [1/2]

bool SiStripDetKey::isInvalid ( ) const

overridevirtual

Identifies all member data as being invalid.

Reimplemented from SiStripKey.

Definition at line 173 of file SiStripDetKey.cc.

173 { return isInvalid(sistrip::APV); }

References sistrip::APV.

◆ isInvalid() [2/2]

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

overridevirtual

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

Reimplemented from SiStripKey.

Definition at line 177 of file SiStripDetKey.cc.

                                                                   {
   if (gran == sistrip::TRACKER) {
     return false;
   } else if (gran == sistrip::UNDEFINED_GRAN || gran == sistrip::UNKNOWN_GRAN) {
     return false;
   }
  
   if (partition_ == sistrip::invalid_) {
     if (gran == sistrip::PARTITION) {
       return true;
     }
   }
   return false;
 }

References sistrip::invalid_, sistrip::PARTITION, partition_, sistrip::TRACKER, sistrip::UNDEFINED_GRAN, and sistrip::UNKNOWN_GRAN.

◆ isValid() [1/2]

bool SiStripDetKey::isValid ( void ) const

overridevirtual

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

Reimplemented from SiStripKey.

Definition at line 152 of file SiStripDetKey.cc.

152 { return isValid(sistrip::APV); }

References sistrip::APV.

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

◆ isValid() [2/2]

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

overridevirtual

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

Reimplemented from SiStripKey.

Definition at line 156 of file SiStripDetKey.cc.

                                                                 {
   if (gran == sistrip::TRACKER) {
     return true;
   } else if (gran == sistrip::UNDEFINED_GRAN || gran == sistrip::UNKNOWN_GRAN) {
     return false;
   }
  
   if (partition_ != sistrip::invalid_) {
     if (gran == sistrip::PARTITION) {
       return true;
     }
   }
   return false;
 }

References sistrip::invalid_, sistrip::PARTITION, partition_, sistrip::TRACKER, sistrip::UNDEFINED_GRAN, and sistrip::UNKNOWN_GRAN.

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

◆ partition()

const uint16_t & SiStripDetKey::partition ( ) const

inline

Returns partition.

Definition at line 134 of file SiStripDetKey.h.

134 { return partition_; }

References partition_.

Referenced by initFromPath(), print(), SiStripDetKey(), and terse().

◆ print()

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

overridevirtual

Print member data of the key

Reimplemented from SiStripKey.

Definition at line 309 of file SiStripDetKey.cc.

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

References SiStripKey::channel(), TauDecayModes::dec, SiStripEnumsAndStrings::granularity(), SiStripKey::granularity(), isValid(), SiStripKey::key(), partition(), SiStripKey::path(), and contentValuesCheck::ss.

◆ terse()

void SiStripDetKey::terse ( std::stringstream & ss ) const

overridevirtual

A terse summary of the key

Reimplemented from SiStripKey.

Definition at line 305 of file SiStripDetKey.cc.

305 { ss << "DET:partition= " << partition(); }

References partition(), and contentValuesCheck::ss.

Member Data Documentation

◆ apvPairNumber_

uint16_t SiStripDetKey::apvPairNumber_

private

APV pair number [0,1-3,invalid].

Definition at line 120 of file SiStripDetKey.h.

Referenced by apvPairNumber(), isConsistent(), isEqual(), and SiStripDetKey().

◆ apvWithinPair_

uint16_t SiStripDetKey::apvWithinPair_

private

APV position within pair [0,1-2,invalid].

Definition at line 123 of file SiStripDetKey.h.

Referenced by apvWithinPair(), isConsistent(), isEqual(), and SiStripDetKey().

◆ partition_

uint16_t SiStripDetKey::partition_

private

partition [0,1-4,invalid].

Definition at line 117 of file SiStripDetKey.h.

Referenced by initFromKey(), initFromPath(), initFromValue(), initGranularity(), isConsistent(), isEqual(), isInvalid(), isValid(), partition(), and SiStripDetKey().

◆ partitionMask_

const uint16_t SiStripDetKey::partitionMask_ = 0x07

staticprivate

Definition at line 129 of file SiStripDetKey.h.

Referenced by initFromKey().

◆ partitionOffset_

const uint16_t SiStripDetKey::partitionOffset_ = 29

staticprivate

Definition at line 126 of file SiStripDetKey.h.

Referenced by initFromKey().

Public Member Functions

Private Member Functions

Private Attributes

Static Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ SiStripDetKey() [1/9]

◆ SiStripDetKey() [2/9]

◆ SiStripDetKey() [3/9]

◆ SiStripDetKey() [4/9]

◆ SiStripDetKey() [5/9]

◆ SiStripDetKey() [6/9]

◆ SiStripDetKey() [7/9]

◆ SiStripDetKey() [8/9]

◆ SiStripDetKey() [9/9]

Member Function Documentation

◆ apvPairNumber()

◆ apvWithinPair()

◆ initFromKey()

◆ initFromPath()

◆ initFromValue()

◆ initGranularity()

◆ isConsistent()

◆ isEqual()

◆ isInvalid() [1/2]

◆ isInvalid() [2/2]

◆ isValid() [1/2]

◆ isValid() [2/2]

◆ partition()

◆ print()

◆ terse()

Member Data Documentation

◆ apvPairNumber_

◆ apvWithinPair_

◆ partition_

◆ partitionMask_

◆ partitionOffset_