DTTSM Class Reference

#include <DTTSM.h>

Public Member Functions
void	addCand (DTTSCand *cand)
	Add a TSS candidate to the TSM, ifs is first/second track flag. More...
void	clear ()
	Clear. More...
const DTConfigTSPhi *	config () const
	Configuration set. More...
	DTTSM (int)
	Constructor. 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...
unsigned	nCand (int ifs) const
	Return the number of input tracks (first/second) 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...
int	number () const
	Return identifier. More...
void	run (int bkmod)
	Run the TSM algorithm. More...
void	setConfig (const DTConfigTSPhi *config)
	Set configuration. More...
DTTSCand *	sortTSM1 (int bkmod)
	Sort 1. More...
DTTSCand *	sortTSM2 (int bkmod)
	Sort 2. More...
	~DTTSM ()
	Destructor. More...

Private Attributes
const DTConfigTSPhi *	_config
int	_ignoreSecondTrack
std::vector< DTTSCand * >	_incand [2]
int	_n
std::vector< DTTSCand * >	_outcand

Detailed Description

Implementation of TSM trigger algorithm

Author

C. Grandi, D. Bonacorsi, S. Marcellini

Definition at line 38 of file DTTSM.h.

Constructor & Destructor Documentation

DTTSM()

DTTSM::DTTSM

(

int

n

)

Constructor.

Definition at line 38 of file DTTSM.cc.

References _incand, _outcand, and DTConfigTSPhi::NTSSTSM.

                  : _n(n), _ignoreSecondTrack(0) {
  // reserve the appropriate amount of space for vectors
  _incand[0].reserve(DTConfigTSPhi::NTSSTSM);
  _incand[1].reserve(DTConfigTSPhi::NTSSTSM);
  _outcand.reserve(2);
}

~DTTSM()

DTTSM::~DTTSM

(

)

Destructor.

Definition at line 48 of file DTTSM.cc.

References clear().

{ clear(); }

Member Function Documentation

addCand()

void DTTSM::addCand

(

DTTSCand *

cand

)

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

Definition at line 256 of file DTTSM.cc.

References _incand, and push_back().

Referenced by DTTSPhi::runTSPhi().

                                  {
  // NEW DESIGN: DTTSM is not configurable!
  //  cand->resetCarry(); // reset carry information
  //  cand->setBitsTsm(); // set quality bits for DTTSM sorting
  _incand[(1 - cand->isFirst())].push_back(cand);
}

clear()

void DTTSM::clear

(

void

)

Clear.

Definition at line 54 of file DTTSM.cc.

References _ignoreSecondTrack, _incand, and _outcand.

Referenced by ~DTTSM().

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

config()

const DTConfigTSPhi* DTTSM::config ( void  ) const

inline

Configuration set.

Definition at line 73 of file DTTSM.h.

References _config.

Referenced by run(), setConfig(), sortTSM1(), and sortTSM2().

{ return _config; }

getDTTSCand()

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

Return requested TS candidate.

Definition at line 273 of file DTTSM.cc.

References _incand, gather_cfg::cout, dqmiodumpmetadata::n, nCand(), and AlCaHLTBitMon_ParallelJobs::p.

Referenced by getTracoT().

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

getTrack()

DTTSCand * DTTSM::getTrack

(

int

n

)

const

Return the requested track.

Definition at line 302 of file DTTSM.cc.

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

Referenced by sortTSM2().

                                     {
  if (n < 1 || n > nTracks()) {
    std::cout << "DTTSM::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 * DTTSM::getTracoT	(	int	ifs,
		unsigned	n
	)		const

Return requested TRACO trigger.

Definition at line 288 of file DTTSM.cc.

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

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

ignoreSecondTrack()

void DTTSM::ignoreSecondTrack ( )

inline

Set a flag to skip sort2.

Definition at line 57 of file DTTSM.h.

References _ignoreSecondTrack.

Referenced by DTTSPhi::ignoreSecondTrack().

{ _ignoreSecondTrack = 1; }

nCand()

unsigned DTTSM::nCand

(

int

ifs

)

const

Return the number of input tracks (first/second)

Definition at line 263 of file DTTSM.cc.

References _incand, and gather_cfg::cout.

Referenced by getDTTSCand(), and getTracoT().

                                   {
  if (ifs < 1 || ifs > 2) {
    std::cout << "DTTSM::nCand: wrong track number: " << ifs;
    std::cout << " 0 returned!" << std::endl;
    return 0;
  }

  return _incand[ifs - 1].size();
}

nFirstT()

int DTTSM::nFirstT ( ) const

inline

Return the number of input first tracks.

Definition at line 79 of file DTTSM.h.

References _incand.

Referenced by run().

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

nSecondT()

int DTTSM::nSecondT ( ) const

inline

Return the number of input second tracks.

Definition at line 82 of file DTTSM.h.

References _incand.

Referenced by run().

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

nTracks()

int DTTSM::nTracks ( ) const

inline

Return the number of sorted tracks.

Definition at line 91 of file DTTSM.h.

References _outcand.

Referenced by getTrack(), and sortTSM2().

{ return _outcand.size(); }

number()

int DTTSM::number ( ) const

inline

Return identifier.

Definition at line 48 of file DTTSM.h.

References _n.

{ return _n; }

run()

void DTTSM::run

(

int

bkmod

)

Run the TSM algorithm.

Definition at line 64 of file DTTSM.cc.

References _incand, _outcand, config(), gather_cfg::cout, debug, first, nFirstT(), nSecondT(), AlCaHLTBitMon_ParallelJobs::p, edm::second(), sortTSM1(), and sortTSM2().

                         {
  if (config()->debug()) {
    std::cout << "DTTSM::run: Processing DTTSM: ";
    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 DTTSM: " << std::endl;
    std::vector<DTTSCand *>::const_iterator p;
    for (p = _incand[0].begin(); p != _incand[0].end(); p++) {
      (*p)->print();
    }
  }
  // end debugging

  DTTSCand *first = sortTSM1(bkmod);
  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 DTTSM: " << std::endl;
    for (p = _incand[1].begin(); p != _incand[1].end(); p++) {
      (*p)->print();
    }
  }
  // end debugging

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

setConfig()

void DTTSM::setConfig ( const DTConfigTSPhi *  config )

inline

Set configuration.

Definition at line 51 of file DTTSM.h.

References _config, and config().

{ _config = config; }

sortTSM1()

DTTSCand * DTTSM::sortTSM1

(

int

bkmod

)

Sort 1.

Definition at line 113 of file DTTSM.cc.

References _incand, funct::abs(), config(), gather_cfg::cout, DTTSCand::isCorr(), DTTSCand::isInner(), DTConfig::NTCTSS, AlCaHLTBitMon_ParallelJobs::p, DTTSCand::setBitsBkmod(), DTTSCand::setBitsTss(), DTTSCand::setSecondTrack(), DTTSCand::TcPos(), DTConfigTSPhi::TsmGhost1Flag(), and DTTSCand::tssNumber().

Referenced by run().

                                   {
  // Do a sort 1
  DTTSCand *best = nullptr;
  DTTSCand *carry = nullptr;
  std::vector<DTTSCand *>::iterator p;
  for (p = _incand[0].begin(); p != _incand[0].end(); p++) {
    DTTSCand *curr = (*p);

    if (bkmod == 1) {         // NORMAL mode ---> sorting on dataword
      curr->setBitsTss();     // maybe not necessary, as they are the same as for
                              // TSS in the default
    } else if (bkmod == 0) {  //  { // BACKUP mode ---> sorting on modified dataword
      curr->setBitsBkmod();
    } else {
      std::cout << "DTTSM::sortTSM1:  bkmod not properly assigned!" << 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;
    }  // else { }
  }

  // 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()->TsmGhost1Corr()) {
      inner_or_corr = carry->isInner() || carry->isCorr();
    } else {
      inner_or_corr = carry->isInner();
    }

    if (config()->TsmGhost1Flag() < 2) {  // Carry isn't always suppressed
      // check if adjacent DTTracoChips
      int adj = (carry->tssNumber() == best->tssNumber() + 1 &&  // next DTTracoChip
                 best->TcPos() == DTConfigTSPhi::NTCTSS && carry->TcPos() == 1) ||
                (carry->tssNumber() == best->tssNumber() - 1 &&  // prev DTTracoChip
                 best->TcPos() == 1 && carry->TcPos() == DTConfigTSPhi::NTCTSS) ||
                (carry->tssNumber() == best->tssNumber() &&  // same DTTracoChip
                 abs(carry->TcPos() - best->TcPos()) == 1);

      if (config()->TsmGhost1Flag() == 0 ||  // Carry always enabled
                                             //       carry->isInner() || //
                                             //       Carry is inner
          inner_or_corr ||                   // Carry is inner or corr
          !adj) {                            // Carry not adj. to best
        // add carry to second tracks to for sort 2
        carry->setSecondTrack();  // change value of first/second track bit
        // NEW DESIGN: DTTSM is not configurable!
        // carry->setBitsTsm();     // set quality bits as for second tracks
        _incand[1].push_back(carry);  // add to list of second tracks
      }
    }
  }
  // best->print();
  return best;
}

sortTSM2()

DTTSCand * DTTSM::sortTSM2

(

int

bkmod

)

Sort 2.

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

Definition at line 179 of file DTTSM.cc.

References _ignoreSecondTrack, _incand, config(), gather_cfg::cout, getTrack(), DTTSCand::isCorr(), DTTSCand::isInner(), nTracks(), AlCaHLTBitMon_ParallelJobs::p, edm::second(), DTTSCand::setBitsBkmod(), DTTSCand::setBitsTss(), DTTSCand::TcPos(), DTConfigTSPhi::TsmGhost2Corr(), DTConfigTSPhi::TsmGhost2Flag(), and DTTSCand::tssNumber().

Referenced by run().

                                   {
  // If second tracks are always suppressed skip processing
  if (config()->TsmGhost2Flag() == 3)
    return nullptr;

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

  // If a first track at the following BX is present, ignore second tracks of
  // any kind
  if (_ignoreSecondTrack) {
    std::vector<DTTSCand *>::iterator p;
    for (p = _incand[1].begin(); p != _incand[1].end(); p++) {
      if ((*p)->isCarry())
        return (*p);
    }
    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 = _incand[1].begin(); p != _incand[1].end(); p++) {
    DTTSCand *curr = (*p);
    // ghost 2 suppression: skip track if suppressed
    // this is not needed if config of DTTSM == config of DTTSS

    bool inner_or_corr;
    if (config()->TsmGhost2Corr()) {
      inner_or_corr = curr->isInner() || curr->isCorr();
    } else {
      inner_or_corr = curr->isInner();
    }

    if (config()->TsmGhost2Flag() != 0) {  // 2nd tracks not always enabled
      if (
          !inner_or_corr &&                                                              // outer and not corr
          (curr->tssNumber() == best->tssNumber() && curr->TcPos() == best->TcPos())) {  // same correlator of 1st track
        if (config()->TsmGhost2Flag() == 2 ||                         // do not look to corr bit of 1st
            ((!best->isCorr()) && config()->TsmGhost2Flag() != 4) ||  // skip if best is not corr
            ((!best->isCorr()) && best->isInner() &&
             config()->TsmGhost2Flag() == 4))  // skip only if best is inner and not corr
        {
          continue;  // skip track
        }
      }
    }

    // added DBSM
    // SM double TSM    if ( bkmod == 1 ) { // NORMAL mode ---> sorting with <
    if (bkmod == 1) {         // NORMAL mode ---> sorting on dataword
      curr->setBitsTss();     // maybe not necessary, as they are the same as for
                              // TSS in the default
    } else if (bkmod == 0) {  //  { // BACKUP mode ---> sorting on modified dataword
      curr->setBitsBkmod();
    } else {
      std::cout << " DTTSM::sortTSM2 bkmod not properly assigned!" << std::endl;
    }

    // added DBSM
    // SM double TSM    if ( bkmod == 1 ) { // NORMAL mode ---> sorting with <

    if (second == nullptr) {
      second = curr;
    } else if ((*curr) < (*second)) {
      second = curr;
    }
  }
  return second;
}

Member Data Documentation

_config

const DTConfigTSPhi* DTTSM::_config

private

Definition at line 97 of file DTTSM.h.

Referenced by config(), and setConfig().

_ignoreSecondTrack

int DTTSM::_ignoreSecondTrack

private

Definition at line 110 of file DTTSM.h.

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

_incand

std::vector<DTTSCand *> DTTSM::_incand[2]

private

Definition at line 104 of file DTTSM.h.

Referenced by addCand(), clear(), DTTSM(), getDTTSCand(), nCand(), nFirstT(), nSecondT(), run(), sortTSM1(), and sortTSM2().

_n

int DTTSM::_n

private

Definition at line 101 of file DTTSM.h.

Referenced by number().

_outcand

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

private

Definition at line 107 of file DTTSM.h.

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