CSCReadoutMapping Class Reference

#include <CSCReadoutMapping.h>

Inheritance diagram for CSCReadoutMapping:

Classes
struct	CSCLabel

Public Member Functions
void	addRecord (int endcap, int station, int ring, int chamber, int vmecrate, int dmb, int tmb, int tsector, int cscid, int ddu, int dcc)
int	chamber (int endcap, int station, int vmecrate, int dmb, int tmb) const
int	crate (const CSCDetId &) const
	returns vmecrate given CSCDetId More...
	CSCReadoutMapping ()
	Default constructor. More...
int	dccId (const CSCDetId &) const
	returns DCC# given CSCDetId More...
int	dduId (const CSCDetId &) const
	returns DDU# given CSCDetId More...
bool	debugV (void) const
CSCDetId	detId (int endcap, int station, int vmecrate, int dmb, int tmb, int cfeb, int layer=0) const
int	dmbId (const CSCDetId &) const
	returns dmbId given CSCDetId More...
virtual void	fill (const edm::ParameterSet &)=0
CSCLabel	findHardwareId (const CSCDetId &) const
	returns hardware ids given chamber id More...
const std::string &	myName (void) const
void	setDebugV (bool dbg)
virtual	~CSCReadoutMapping ()
	Destructor. More...

Private Member Functions
virtual int	hwId (int endcap, int station, int vme, int dmb, int tmb) const =0
template<class Archive >
void	serialize (Archive &ar, const unsigned int version)
int	swId (int endcap, int station, int ring, int chamber) const

Private Attributes
bool	debugV_
std::map< int, int >	hw2sw_
std::vector< CSCLabel >	mapping_
std::string	myName_
std::map< int, CSCLabel >	sw2hw_

Friends
class	boost::serialization::access
template<typename CondSerializationT , typename Enabled >
struct	cond::serialization::access

Detailed Description

Author

Tim Cox Abstract class to define mapping between CSC readout hardware ids and other labels.

Defines the ids and labels in the mapping and supplies translation interface. A derived class must define how hardware labels map to a unique integer. A derived, concrete, class must define from where the mapping information comes.

Definition at line 26 of file CSCReadoutMapping.h.

Constructor & Destructor Documentation

CSCReadoutMapping::CSCReadoutMapping

(

)

Default constructor.

Definition at line 5 of file CSCReadoutMapping.cc.

: myName_("CSCReadoutMapping"), debugV_( false ) {}

CSCReadoutMapping::~CSCReadoutMapping ( )

virtual

Destructor.

Definition at line 7 of file CSCReadoutMapping.cc.

{}

Member Function Documentation

void CSCReadoutMapping::addRecord	(	int	endcap,
		int	station,
		int	ring,
		int	chamber,
		int	vmecrate,
		int	dmb,
		int	tmb,
		int	tsector,
		int	cscid,
		int	ddu,
		int	dcc
	)

Add one record of info to mapping

reverse mapping for software -> hadrware labels

Definition at line 50 of file CSCReadoutMapping.cc.

References hw2sw_, hwId(), mapping_, sw2hw_, and swId().

Referenced by CSCReadoutMappingFromFile::fill().

                                                                                      {

  CSCLabel newRecord( endcap, station, ring, chamber, vmecrate, dmb, tmb, tsector, cscid, ddu, dcc );
  mapping_.push_back( newRecord );
  int hid = hwId( endcap, station, vmecrate, dmb, tmb );
  int sid = swId( endcap, station, ring, chamber);
  // LogDebug("CSC") << " map hw " << hid << " to sw " << sid;
  if ( hw2sw_.insert( std::make_pair(hid, sid) ).second ) {
    // LogDebug("CSC") << " insert pair succeeded.";
  }
  else {
    edm::LogError("CSC") << " already have key = " << hid;
  }
  sw2hw_.insert( std::make_pair(sid, newRecord) );

} 

int CSCReadoutMapping::chamber	(	int	endcap,
		int	station,
		int	vmecrate,
		int	dmb,
		int	tmb
	)		const

Return chamber label corresponding to readout ids vme, tmb and dmb for given endcap endcap = 1 (+z), 2 (-z), station, vme crate number, dmb slot number, tmb slot number.

Definition at line 9 of file CSCReadoutMapping.cc.

References hw2sw_, and hwId().

Referenced by detId(), findHardwareId(), and geometryXMLparser.CSCAlignable::index().

                                                                                         {
  // Build hw id from input, find sw id to match
  int cid = 0;
  int hid = hwId( endcap, station, vme, dmb, tmb );
  // Search for that hw id in mapping
  std::map<int,int>::const_iterator it = hw2sw_.find( hid );
  if ( it != hw2sw_.end() ) {
    cid = it->second;
    //    std::cout << "hwid = " << hid << ", swid = " << cid << std::endl;
    //    LogDebug("CSC") << " for requested hw id = " << hid << ", found sw id = " << cid;
  }
  else {
    edm::LogError("CSC") << " cannot find requested hw id = " << hid << " in mapping.";
  }
  return cid;
}

int CSCReadoutMapping::crate

(

const CSCDetId &

id

)

const

returns vmecrate given CSCDetId

Definition at line 90 of file CSCReadoutMapping.cc.

References findHardwareId(), and CSCReadoutMapping::CSCLabel::vmecrate_.

                                                      {
  CSCLabel hid = findHardwareId(id);
  return hid.vmecrate_;
}

int CSCReadoutMapping::dccId

(

const CSCDetId &

id

)

const

returns DCC# given CSCDetId

Definition at line 102 of file CSCReadoutMapping.cc.

References CSCReadoutMapping::CSCLabel::dcc_, and findHardwareId().

                                                      {
  CSCLabel hid = findHardwareId(id);
  return hid.dcc_;
}

int CSCReadoutMapping::dduId

(

const CSCDetId &

id

)

const

returns DDU# given CSCDetId

Definition at line 98 of file CSCReadoutMapping.cc.

References CSCReadoutMapping::CSCLabel::ddu_, and findHardwareId().

                                                      {
  CSCLabel hid = findHardwareId(id);
  return hid.ddu_;
}

bool CSCReadoutMapping::debugV ( void  ) const

inline

Status of debug printout flag

Definition at line 108 of file CSCReadoutMapping.h.

{ return debugV_; }

CSCDetId CSCReadoutMapping::detId	(	int	endcap,
		int	station,
		int	vmecrate,
		int	dmb,
		int	tmb,
		int	cfeb,
		int	layer = 0
	)		const

Return CSCDetId for layer corresponding to readout ids vme, tmb, and dmb for given endcap and layer no. 1-6, or for chamber if no layer no. supplied. Args: endcap = 1 (+z), 2 (-z), station, vme crate number, dmb slot number, tmb slot number, cfeb number (so we can identify ME1a/b within ME11), layer number

Definition at line 26 of file CSCReadoutMapping.cc.

References CSCDetId::chamber(), chamber(), CSCDetId::endcap(), relativeConstraints::ring, CSCDetId::ring(), and CSCDetId::station().

                          {

  // Find CSCDetId index of chamber corresponding to the hardware readout arguments
  int cid = chamber( endcap, station, vme, dmb, tmb );

  // Decode the individual labels
  // ... include endcap & station for MTCC when they are unique in the mapping file
  // and so do not need to be specified as input arguments
      endcap  = CSCDetId::endcap( cid );
      station = CSCDetId::station( cid );
  int chamber = CSCDetId::chamber( cid );
  int ring    = CSCDetId::ring( cid );

  // Now sort out ME1a from ME11-combined
  // cfeb =0-3 for ME1b, cfeb=4 for ME1a (pre-LS1) cfeb=4-6 (post-LS1)
  if ( station == 1  && ring == 1 && cfeb >= 4 && cfeb <= 6 ) {
      // This is ME1a region
      ring = 4; // reset from 1 to 4 which flags ME1a
  }
  
  return CSCDetId( endcap, station, ring, chamber, layer );
}

int CSCReadoutMapping::dmbId

(

const CSCDetId &

id

)

const

returns dmbId given CSCDetId

Definition at line 94 of file CSCReadoutMapping.cc.

References CSCReadoutMapping::CSCLabel::dmb_, and findHardwareId().

                                                      {
  CSCLabel hid = findHardwareId(id);
  return hid.dmb_;
}

virtual void CSCReadoutMapping::fill ( const edm::ParameterSet &  )

pure virtual

Fill mapping store

Implemented in CSCReadoutMappingFromFile.

CSCReadoutMapping::CSCLabel CSCReadoutMapping::findHardwareId

(

const CSCDetId &

id

)

const

returns hardware ids given chamber id

Search for that sw id in mapping

Definition at line 74 of file CSCReadoutMapping.cc.

References chamber(), makeMuonMisalignmentScenario::endcap, CSCDetId::rawIdMaker(), relativeConstraints::ring, relativeConstraints::station, and sw2hw_.

Referenced by crate(), dccId(), dduId(), and dmbId().

                                                                                    {
  CSCLabel hid;
  int sid=CSCDetId::rawIdMaker(id.endcap(), id.station(), id.ring(), id.chamber(), 0 );  
  std::map<int,CSCLabel>::const_iterator it = sw2hw_.find( sid );
  if ( it != sw2hw_.end() ) {
    hid = it->second;
    //    std::cout << "hwid = " << hid << ", swid = " << cid << std::endl;
    //    LogDebug("CSC") << " for requested hw id = " << hid << ", found sw id = " << cid;
  }
  else {
    edm::LogError("CSC") << " cannot find requested sw id = " << id << " in mapping.";
  }
  return hid;
}

virtual int CSCReadoutMapping::hwId ( int  endcap, int  station, int  vme, int  dmb, int  tmb  ) const

privatepure virtual

Build a unique integer out of the readout electronics labels.

In general this must depend on endcap and station, as well as vme crate number and dmb slot number. And possibly tmb slot?

Implemented in CSCReadoutMappingForSliceTest.

Referenced by addRecord(), and chamber().

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

inline

Return class name

Definition at line 113 of file CSCReadoutMapping.h.

References relativeConstraints::chamber, makeMuonMisalignmentScenario::endcap, relativeConstraints::ring, and relativeConstraints::station.

{ return myName_; }

template<class Archive >

void CSCReadoutMapping::serialize ( Archive &  ar, const unsigned int  version  )

private

void CSCReadoutMapping::setDebugV ( bool  dbg )

inline

Set debug printout flag

Definition at line 103 of file CSCReadoutMapping.h.

{ debugV_ = dbg; }

int CSCReadoutMapping::swId ( int  endcap, int  station, int  ring, int  chamber  ) const

private

Build a unique integer out of chamber labels.

We'll probably use rawId of CSCDetId... You know it makes sense!

Definition at line 69 of file CSCReadoutMapping.cc.

References CSCDetId::rawIdMaker().

Referenced by addRecord().

                                                                                  {
  // Software id is just CSCDetId for the chamber - but no distinction within ME11
  return CSCDetId::rawIdMaker( endcap, station, ring, chamber, 0 ); // usual detid for chamber, i.e. layer=0
}

Friends And Related Function Documentation

friend class boost::serialization::access

friend

Definition at line 139 of file CSCReadoutMapping.h.

template<typename CondSerializationT , typename Enabled >

friend struct cond::serialization::access

friend

Definition at line 139 of file CSCReadoutMapping.h.

Member Data Documentation

bool CSCReadoutMapping::debugV_

private

Definition at line 133 of file CSCReadoutMapping.h.

std::map< int, int > CSCReadoutMapping::hw2sw_

private

Definition at line 135 of file CSCReadoutMapping.h.

Referenced by addRecord(), and chamber().

std::vector< CSCLabel > CSCReadoutMapping::mapping_

private

Definition at line 134 of file CSCReadoutMapping.h.

Referenced by addRecord().

std::string CSCReadoutMapping::myName_

private

Definition at line 132 of file CSCReadoutMapping.h.

std::map< int, CSCLabel > CSCReadoutMapping::sw2hw_

private

Definition at line 136 of file CSCReadoutMapping.h.

Referenced by addRecord(), and findHardwareId().