DTTSS Class Reference

#include <DTTSS.h>

Public Member Functions
void	addDTTSCand (DTTSCand *cand)
	Add a TS candidate to the TSS, ifs is first/second track flag. More...
void	clear ()
	Clear. More...
const DTConfigTSPhi *	config () const
	Configuration set. More...
	DTTSS (int)
	Constructor. More...
DTTSCand *	getCarry () const
	Return the carry (for debugging) More...
DTTSCand *	getDTTSCand (int ifs, unsigned n) const
	Return requested TS candidate. More...
DTTSCand *	getTrack (int n) const
	Return the requested track. More...
const DTTracoTrigData *	getTracoT (int ifs, unsigned n) const
	Return requested TRACO trigger. More...
void	ignoreSecondTrack ()
	Set a flag to skip sort2. More...
std::string	logWord (int n) const
	Return the requested log word. More...
int	nFirstT () const
	Return the number of input first tracks. More...
int	nSecondT () const
	Return the number of input second tracks. More...
int	nTracks () const
	Return the number of sorted tracks. More...
unsigned	nTracoT (int ifs) const
	Return the number of input tracks (first/second) More...
int	number () const
	Return identifier. More...
void	run ()
	Run the TSS algorithm. More...
void	setConfig (const DTConfigTSPhi *config)
	Set configuration. More...
DTTSCand *	sortTSS1 ()
	Sort 1. More...
DTTSCand *	sortTSS2 ()
	Sort 2. More...
	~DTTSS ()
	Destructor. More...

Private Attributes
const DTConfigTSPhi *	_config
int	_ignoreSecondTrack
std::string	_logWord1
std::string	_logWord2
int	_n
std::vector< DTTSCand * >	_outcand
std::vector< DTTSCand * >	_tctrig [2]

Detailed Description

Implementation of TSS trigger algorithm

Author

C. Grandi, D. Bonacorsi, S. Marcellini

Definition at line 36 of file DTTSS.h.

Constructor & Destructor Documentation

DTTSS()

DTTSS::DTTSS

(

int

n

)

Constructor.

Definition at line 36 of file DTTSS.cc.

References _logWord1, and _logWord2.

                  : _n(n), _ignoreSecondTrack(0) {
  // reserve the appropriate amount of space for vectors
  //_tctrig[0].reserve(DTConfigTSPhi::NTCTSS);
  //_tctrig[1].reserve(DTConfigTSPhi::NTCTSS);
  //_outcand.reserve(2);
  _logWord1 = "1/----";
  _logWord2 = "2/----";
}

~DTTSS()

DTTSS::~DTTSS

(

)

Destructor.

Definition at line 48 of file DTTSS.cc.

References clear().

{ clear(); }

Member Function Documentation

addDTTSCand()

void DTTSS::addDTTSCand

(

DTTSCand *

cand

)

Add a TS candidate to the TSS, ifs is first/second track flag.

Definition at line 274 of file DTTSS.cc.

References _tctrig.

Referenced by DTTSPhi::addTracoT().

                                      {
  int ifs = (cand->isFirst()) ? 0 : 1;
  //  std::cout << "SM DTTSS::addDTTSCand ifs = " << ifs << std::endl;
  _tctrig[ifs].push_back(cand);
}

clear()

void DTTSS::clear

(

void

)

Clear.

Definition at line 54 of file DTTSS.cc.

References _ignoreSecondTrack, _logWord1, _logWord2, _outcand, and _tctrig.

Referenced by ~DTTSS().

                  {
  _ignoreSecondTrack = 0;
  for (int itk = 0; itk <= 1; itk++) {
    // content of _tctrig is deleted in the DTTSPhi
    _tctrig[itk].clear();
  }
  // content of _outcand is deleted in the DTTSPhi
  _outcand.clear();

  // log words
  _logWord1 = "1/----";
  _logWord2 = "2/----";
}

config()

const DTConfigTSPhi* DTTSS::config ( void  ) const

inline

Configuration set.

Definition at line 69 of file DTTSS.h.

References _config.

Referenced by DTTSCand::config(), run(), setConfig(), sortTSS1(), and sortTSS2().

{ return _config; }

getCarry()

DTTSCand * DTTSS::getCarry

(

)

const

Return the carry (for debugging)

Definition at line 328 of file DTTSS.cc.

References _tctrig, and AlCaHLTBitMon_ParallelJobs::p.

                                {
  std::vector<DTTSCand *>::const_iterator p;
  for (p = _tctrig[1].begin(); p != _tctrig[1].end(); p++)
    if ((*p)->isCarry())
      return (*p);
  return nullptr;
}

getDTTSCand()

DTTSCand * DTTSS::getDTTSCand	(	int	ifs,
		unsigned	n
	)		const

Return requested TS candidate.

Definition at line 289 of file DTTSS.cc.

References _tctrig, gather_cfg::cout, dqmiodumpmetadata::n, nTracoT(), and AlCaHLTBitMon_ParallelJobs::p.

Referenced by getTracoT().

                                                      {
  if (ifs < 1 || ifs > 2) {
    std::cout << "DTTSS::getDTTSCand: wrong track number: " << ifs;
    std::cout << " empty pointer returned!" << std::endl;
    return nullptr;
  }
  if (n < 1 || n > nTracoT(ifs)) {
    std::cout << "DTTSS::getDTTSCand: requested trigger not present: " << n;
    std::cout << " empty pointer returned!" << std::endl;
    return nullptr;
  }
  std::vector<DTTSCand *>::const_iterator p = _tctrig[ifs - 1].begin() + n - 1;
  return (*p);
}

getTrack()

DTTSCand * DTTSS::getTrack

(

int

n

)

const

Return the requested track.

Definition at line 318 of file DTTSS.cc.

References _outcand, gather_cfg::cout, dqmiodumpmetadata::n, nTracks(), and AlCaHLTBitMon_ParallelJobs::p.

Referenced by sortTSS2().

                                     {
  if (n < 1 || n > nTracks()) {
    std::cout << "DTTSS::getTrack: requested track not present: " << n;
    std::cout << " empty pointer returned!" << std::endl;
    return nullptr;
  }
  std::vector<DTTSCand *>::const_iterator p = _outcand.begin() + n - 1;
  return (*p);
}

getTracoT()

const DTTracoTrigData * DTTSS::getTracoT	(	int	ifs,
		unsigned	n
	)		const

Return requested TRACO trigger.

Definition at line 304 of file DTTSS.cc.

References gather_cfg::cout, getDTTSCand(), dqmiodumpmetadata::n, nTracoT(), and DTTSCand::tracoTr().

                                                                 {
  if (ifs < 1 || ifs > 2) {
    std::cout << "DTTSS::getTracoT: wrong track number: " << ifs;
    std::cout << " empty pointer returned!" << std::endl;
    return nullptr;
  }
  if (n < 1 || n > nTracoT(ifs)) {
    std::cout << "DTTSS::getTracoT: requested trigger not present: " << n;
    std::cout << " empty pointer returned!" << std::endl;
    return nullptr;
  }
  return getDTTSCand(ifs, n)->tracoTr();
}

ignoreSecondTrack()

void DTTSS::ignoreSecondTrack ( )

inline

Set a flag to skip sort2.

Definition at line 51 of file DTTSS.h.

References _ignoreSecondTrack.

Referenced by DTTSPhi::ignoreSecondTrack().

{ _ignoreSecondTrack = 1; }

logWord()

std::string DTTSS::logWord

(

int

n

)

const

Return the requested log word.

Definition at line 336 of file DTTSS.cc.

References _logWord1, _logWord2, gather_cfg::cout, dqmiodumpmetadata::n, and AlCaHLTBitMon_QueryRunRegistry::string.

                                    {
  std::string lw = "";
  switch (n) {
    case 1:
      lw = _logWord1;
      break;
    case 2:
      lw = _logWord2;
      break;
    default:
      std::cout << "DTTSS::logWord: requested track not present: " << n;
      std::cout << " empty string returned!" << std::endl;
  }
  return lw;
}

nFirstT()

int DTTSS::nFirstT ( ) const

inline

Return the number of input first tracks.

Definition at line 75 of file DTTSS.h.

References _tctrig.

Referenced by run().

{ return _tctrig[0].size(); }

nSecondT()

int DTTSS::nSecondT ( ) const

inline

Return the number of input second tracks.

Definition at line 78 of file DTTSS.h.

References _tctrig.

Referenced by run().

{ return _tctrig[1].size(); }

nTracks()

int DTTSS::nTracks ( ) const

inline

Return the number of sorted tracks.

Definition at line 90 of file DTTSS.h.

References _outcand.

Referenced by getTrack(), and sortTSS2().

{ return _outcand.size(); }

nTracoT()

unsigned DTTSS::nTracoT

(

int

ifs

)

const

Return the number of input tracks (first/second)

Definition at line 280 of file DTTSS.cc.

References _tctrig, and gather_cfg::cout.

Referenced by getDTTSCand(), and getTracoT().

                                     {
  if (ifs < 1 || ifs > 2) {
    std::cout << "DTTSS::nTracoT: wrong track number: " << ifs;
    std::cout << " 0 returned!" << std::endl;
    return 0;
  }
  return _tctrig[ifs - 1].size();
}

number()

int DTTSS::number ( ) const

inline

Return identifier.

Definition at line 66 of file DTTSS.h.

References _n.

Referenced by DTTSPhi::addTracoT(), and DTTSCand::tssNumber().

{ return _n; }

run()

void DTTSS::run

(

)

Run the TSS algorithm.

Definition at line 68 of file DTTSS.cc.

References _n, _outcand, _tctrig, config(), gather_cfg::cout, debug, first, nFirstT(), nSecondT(), AlCaHLTBitMon_ParallelJobs::p, edm::second(), sortTSS1(), and sortTSS2().

                {
  if (config()->debug()) {
    std::cout << "DTTSS::run: Processing DTTSS number " << _n << " : ";
    std::cout << nFirstT() << " first & " << nSecondT() << " second tracks" << std::endl;
  }

  if (nFirstT() < 1)
    return;  // skip if no first tracks
  //
  // SORT 1
  //
  // debugging
  if (config()->debug()) {
    std::cout << "Vector of first tracks in DTTSS: " << std::endl;
    std::vector<DTTSCand *>::const_iterator p;
    for (p = _tctrig[0].begin(); p != _tctrig[0].end(); p++) {
      (*p)->print();
    }
  }
  // end debugging

  DTTSCand *first = sortTSS1();
  if (first != nullptr) {
    _outcand.push_back(first);
  }

  if (nSecondT() < 1)
    return;  // skip if no second tracks
  //
  // SORT 2
  //
  // debugging
  if (config()->debug()) {
    std::vector<DTTSCand *>::const_iterator p;
    std::cout << "Vector of second tracks (including carry) in DTTSS: " << std::endl;
    for (p = _tctrig[1].begin(); p != _tctrig[1].end(); p++) {
      (*p)->print();
    }
  }
  // end debugging

  DTTSCand *second = sortTSS2();
  if (second != nullptr) {
    _outcand.push_back(second);
  }
}

setConfig()

void DTTSS::setConfig ( const DTConfigTSPhi *  config )

inline

Set configuration.

Definition at line 48 of file DTTSS.h.

References _config, and config().

{ _config = config; }

sortTSS1()

DTTSCand * DTTSS::sortTSS1

(

)

Sort 1.

Definition at line 115 of file DTTSS.cc.

References _logWord1, _tctrig, funct::abs(), config(), DTTSCand::dataword(), DTTSCand::isCorr(), DTTSCand::isFirst(), DTTSCand::isInner(), AlCaHLTBitMon_ParallelJobs::p, DTTSCand::setBitsTss(), DTTSCand::setSecondTrack(), DTTSCand::TcPos(), and DTConfigTSPhi::TssGhost1Corr().

Referenced by run().

                          {
  // Do a sort 1
  DTTSCand *best = nullptr;
  DTTSCand *carry = nullptr;
  std::vector<DTTSCand *>::iterator p;
  for (p = _tctrig[0].begin(); p != _tctrig[0].end(); p++) {
    DTTSCand *curr = (*p) ? (*p) : nullptr;
    // SM sector collector Set bits for tss
    curr->setBitsTss();
    if (curr->dataword() == 0x1ff)
      continue;
    _logWord1[1 + curr->TcPos()] = (curr->isFirst()) ? '1' : '2';
    //     std::cout << "Running TSS: --->curr->dataword() sort 1 " <<
    //     curr->dataword()  << std::endl;
    if (best == nullptr) {
      best = curr;
    } else if ((*curr) <= (*best)) {
      carry = best;
      best = curr;
    } else if (carry == nullptr) {
      carry = curr;
    } else if ((*curr) <= (*carry)) {
      carry = curr;
    }
  }

  // Ghost 1 suppression: use carry only if not suppressed

  if (carry != nullptr) {  // A carry is present

    // Carry enabled if correlated and TRACO is next to best
    bool inner_or_corr;
    if (config()->TssGhost1Corr()) {
      inner_or_corr = carry->isInner() || carry->isCorr();

    } else {
      inner_or_corr = carry->isInner();
    }
    if (config()->TssGhost1Flag() < 2 && (                                      // Carry isn't always suppressed
                                             config()->TssGhost1Flag() == 0 ||  // Carry always enabled
                                             //       carry->isInner() ||                    // Carry is inner
                                             inner_or_corr ||                           // carry is inner or corr
                                             abs(carry->TcPos() - best->TcPos()) != 1)  // Carry not adj. to best
    ) {
      // add carry to second tracks for sort 2
      carry->setSecondTrack();      // change value of first/second track bit
      carry->setBitsTss();          // set quality bits as for second tracks
      _tctrig[1].push_back(carry);  // add to list of second tracks
    } else {
      _logWord1[1 + carry->TcPos()] = 'g';
    }
  }

  /*
  if(carry!=0 && config()->TssGhost1Flag()<2){ // Carry isn't always suppressed
    if(config()->TssGhost1Flag()==0 ||           // Carry always enabled
       carry->isInner() ||                       // Carry is inner
       abs(carry->TcPos()-best->TcPos())!=1) {   // Carry not adj. to best
       // add carry to second tracks to for sort 2
      carry->setSecondTrack(); // change value of first/second track bit
      carry->setBitsTss();     // set quality bits as for second tracks
      _tctrig[1].push_back(carry); // add to list of second tracks
    }
  }
  */
  // std::cout << " best TSS sort 1 = " << best->dataword() << std::endl;
  // std::cout << " SM end of TSS sort 1: best = " <<  std::endl;
  // best->print();

  return best;
}

sortTSS2()

DTTSCand * DTTSS::sortTSS2

(

)

Sort 2.

curr->isInner() && // outer track

Definition at line 187 of file DTTSS.cc.

References _ignoreSecondTrack, _logWord2, _tctrig, config(), gather_cfg::cout, DTTSCand::dataword(), getTrack(), DTTSCand::isCarry(), DTTSCand::isCorr(), DTTSCand::isFirst(), DTTSCand::isInner(), nTracks(), AlCaHLTBitMon_ParallelJobs::p, edm::second(), DTTSCand::setBitsTss(), DTTSCand::TcPos(), DTConfigTSPhi::TssGhost2Corr(), and DTConfigTSPhi::TssGhost2Flag().

Referenced by run().

                          {
  // Check if there are second tracks
  if (nTracks() < 1) {
    std::cout << "DTTSS::DTTSSsort2: called with no first track.";
    std::cout << " empty pointer returned!" << std::endl;
    return nullptr;
  }

  if (_ignoreSecondTrack) {
    // At the time being if a a first track at the following BX is present,
    // the carry is thrown
    //    std::vector<DTTSCand*>::iterator p;
    //    for(p=_tctrig[1].begin(); p!=_tctrig[1].end(); p++) {
    //      if((*p)->isCarry()) return (*p);
    //    }
    // Fill log word
    std::vector<DTTSCand *>::iterator p;
    for (p = _tctrig[1].begin(); p != _tctrig[1].end(); p++)
      if (!(*p)->isCarry())
        _logWord2[1 + (*p)->TcPos()] = 'o';  // out of time
    return nullptr;
  }

  // If second tracks are always suppressed skip processing
  if (config()->TssGhost2Flag() == 3) {
    // Fill log word
    std::vector<DTTSCand *>::iterator p;
    for (p = _tctrig[1].begin(); p != _tctrig[1].end(); p++)
      _logWord2[1 + (*p)->TcPos()] = 'G';
    return nullptr;
  }

  // If no first tracks at the following BX, do a sort 2
  DTTSCand *best = getTrack(1);
  DTTSCand *second = nullptr;
  std::vector<DTTSCand *>::iterator p;
  for (p = _tctrig[1].begin(); p != _tctrig[1].end(); p++) {
    DTTSCand *curr = (*p);
    // SM sector collector set bits for tss
    curr->setBitsTss();
    //     std::cout << "Running TSS sort 2: --- curr->dataword() "  <<
    //     curr->dataword()  << std::endl;
    if (!curr->isCarry()) {
      _logWord2[1 + curr->TcPos()] = (curr->isFirst()) ? '1' : '2';
      if (curr->dataword() == 0x1ff)
        continue;
    }
    // ghost 2 suppression: skip track if suppressed
    if (config()->TssGhost2Flag() != 0) {  // 2nd tracks not always enabled

      bool inner_or_corr;
      if (config()->TssGhost2Corr()) {
        inner_or_corr = curr->isInner() || curr->isCorr();

      } else {
        inner_or_corr = curr->isInner();
      }

      if (
          !inner_or_corr &&                                           // outer and not corr
          curr->TcPos() == best->TcPos()) {                           // same correlator of 1st track
        if (config()->TssGhost2Flag() == 2 ||                         // do not look to corr bit of 1st
            ((!best->isCorr()) && config()->TssGhost2Flag() != 4) ||  // skip if best is not corr
            ((!best->isCorr()) && best->isInner() &&
             config()->TssGhost2Flag() == 4))  // skip only if best is inner and not corr
        {
          _logWord2[1 + curr->TcPos()] = 'G';
          //      std::cout << " skip sort 2 in TSS" << std::endl;
          continue;  // skip track
        }
      }
    }
    if (second == nullptr) {
      second = curr;
    } else if ((*curr) <= (*second)) {
      second = curr;
    }
  }
  //  if(!second==0) {std::cout << " best sort 2 = " << second->dataword() <<
  //  std::endl;
  //   std::cout << " SM end of TSS sort 2: second = " <<  std::endl;
  //   second->print(); }

  return second;
}

Member Data Documentation

_config

const DTConfigTSPhi* DTTSS::_config

private

Definition at line 99 of file DTTSS.h.

Referenced by config(), and setConfig().

_ignoreSecondTrack

int DTTSS::_ignoreSecondTrack

private

Definition at line 111 of file DTTSS.h.

Referenced by clear(), ignoreSecondTrack(), and sortTSS2().

_logWord1

std::string DTTSS::_logWord1

private

Definition at line 114 of file DTTSS.h.

Referenced by clear(), DTTSS(), logWord(), and sortTSS1().

_logWord2

std::string DTTSS::_logWord2

private

Definition at line 115 of file DTTSS.h.

Referenced by clear(), DTTSS(), logWord(), and sortTSS2().

_n

int DTTSS::_n

private

Definition at line 102 of file DTTSS.h.

Referenced by number(), and run().

_outcand

std::vector<DTTSCand *> DTTSS::_outcand

private

Definition at line 108 of file DTTSS.h.

Referenced by clear(), getTrack(), nTracks(), and run().

_tctrig

std::vector<DTTSCand *> DTTSS::_tctrig[2]

private

Definition at line 105 of file DTTSS.h.

Referenced by addDTTSCand(), clear(), getCarry(), getDTTSCand(), nFirstT(), nSecondT(), nTracoT(), run(), sortTSS1(), and sortTSS2().