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

(

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

(

)

Destructor.

Definition at line 48 of file DTTSM.cc.

References clear().

{ clear(); }

Member Function Documentation

void DTTSM::addCand

(

DTTSCand *

cand

)

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

Definition at line 268 of file DTTSM.cc.

References _incand, and DTTSCand::isFirst().

Referenced by DTTSPhi::runTSPhi(), and setConfig().

                                  {
  // 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);
}

void DTTSM::clear

(

void

)

Clear.

Definition at line 54 of file DTTSM.cc.

References _ignoreSecondTrack, _incand, and _outcand.

Referenced by ignoreSecondTrack(), and ~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();
}

const DTConfigTSPhi* DTTSM::config ( void  ) const

inline

Configuration set.

Definition at line 74 of file DTTSM.h.

References _config, and nCand().

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

{ return _config; }

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

Return requested TS candidate.

Definition at line 285 of file DTTSM.cc.

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

Referenced by getTracoT(), and nSecondT().

                                                      {
  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);
}

DTTSCand * DTTSM::getTrack

(

int

n

)

const

Return the requested track.

Definition at line 314 of file DTTSM.cc.

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

Referenced by nTracks(), and 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);
}

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

Return requested TRACO trigger.

Definition at line 300 of file DTTSM.cc.

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

Referenced by nSecondT().

                                                                 {
  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();
}

void DTTSM::ignoreSecondTrack ( )

inline

Set a flag to skip sort2.

Definition at line 58 of file DTTSM.h.

References _ignoreSecondTrack, clear(), run(), sortTSM1(), and sortTSM2().

Referenced by DTTSPhi::ignoreSecondTrack().

{ _ignoreSecondTrack = 1; }

unsigned DTTSM::nCand

(

int

ifs

)

const

Return the number of input tracks (first/second)

Definition at line 275 of file DTTSM.cc.

References _incand, and gather_cfg::cout.

Referenced by config(), 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();
}

int DTTSM::nFirstT ( ) const

inline

Return the number of input first tracks.

Definition at line 80 of file DTTSM.h.

References _incand.

Referenced by run().

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

int DTTSM::nSecondT ( ) const

inline

Return the number of input second tracks.

Definition at line 83 of file DTTSM.h.

References _incand, getDTTSCand(), getTracoT(), and gen::n.

Referenced by run().

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

int DTTSM::nTracks ( ) const

inline

Return the number of sorted tracks.

Definition at line 92 of file DTTSM.h.

References _outcand, and getTrack().

Referenced by getTrack(), and sortTSM2().

{ return _outcand.size(); }

int DTTSM::number ( ) const

inline

Return identifier.

Definition at line 49 of file DTTSM.h.

References _n.

{ return _n; }

void DTTSM::run

(

int

bkmod

)

Run the TSM algorithm.

Definition at line 64 of file DTTSM.cc.

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

Referenced by ignoreSecondTrack().

                         {

  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);
  }
}

void DTTSM::setConfig ( const DTConfigTSPhi *  config )

inline

Set configuration.

Definition at line 52 of file DTTSM.h.

References _config, addCand(), and config().

{ _config = config; }

DTTSCand * DTTSM::sortTSM1

(

int

bkmod

)

Sort 1.

Definition at line 117 of file DTTSM.cc.

References _incand, funct::abs(), begin, 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 ignoreSecondTrack(), and 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;
}

DTTSCand * DTTSM::sortTSM2

(

int

bkmod

)

Sort 2.

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

Definition at line 186 of file DTTSM.cc.

References _ignoreSecondTrack, _incand, begin, 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 ignoreSecondTrack(), and 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

const DTConfigTSPhi* DTTSM::_config

private

Definition at line 98 of file DTTSM.h.

Referenced by config(), and setConfig().

int DTTSM::_ignoreSecondTrack

private

Definition at line 111 of file DTTSM.h.

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

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

private

Definition at line 105 of file DTTSM.h.

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

int DTTSM::_n

private

Definition at line 102 of file DTTSM.h.

Referenced by number().

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

private

Definition at line 108 of file DTTSM.h.

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