Trigger Summary Information input bits input bits from subdetectors ftdl (Final Trigger Decision Logic) bits output bits of trigger logic psnm (Prescale and Mask) bits prescaled ftdl bits timType types of trigger timing source defined in b2tt firmware. More...

#include <TRGSummary.h>

Inheritance diagram for TRGSummary:

Public Types
enum	ETimingType { TTYP_ECL = 0 , TTYP_PID1 = 4 , TTYP_PID2 = 8 , TTYP_PID3 = 12 , TTYP_SELF = 2 , TTYP_RSV1 = 6 , TTYP_RSV2 = 10 , TTYP_RSV3 = 14 , TTYP_TOP = 1 , TTYP_CDC = 3 , TTYP_DPHY = 5 , TTYP_RAND = 7 , TTYP_TEST = 9 , TTYP_RSV4 = 11 , TTYP_POIS = 13 , TTYP_NONE = 15 }
	types of trigger timing source defined in b2tt firmware More...

enum	ETimingQuality { TTYQ_NONE = 0 , TTYQ_CORS = 1 , TTYQ_FINE = 2 , TTYQ_SFIN = 3 }
	trigger timing type quality More...

Public Member Functions
	TRGSummary ()=default
	default constructor: xxx

	TRGSummary (unsigned int inputBits[10], unsigned int ftdlBits[10], unsigned int psnmBits[10], ETimingType timType)
	constructor: xxx

bool	test () const
	check whether any psnm bit is set

bool	testInput (unsigned int bit) const
	check whether an input bit is set

bool	testInput (const std::string &name) const
	check whether an input bit is set

bool	testFtdl (unsigned int bit) const
	check whether a ftdl bit is set

bool	testFtdl (const std::string &name) const
	check whether a ftdl bit is set

bool	testPsnm (unsigned int bit) const
	check whether a psnm bit is set

bool	testPsnm (const std::string &name) const
	check whether a psnm bit is set

bool	isPoissonInInjectionVeto () const
	check whether poisson random trigger is within injection veto

void	setPoissonInInjectionVeto ()
	set true if poisson random trigger is within injection veto

void	setTRGSummary (int i, int word)
	set the Final Trigger Decision Logic bit

void	setPreScale (int i, int bit, int pre)
	set the prescale factor of each bit

void	setInputBits (int i, int word)
	set the input bits

void	setFtdlBits (int i, int word)
	set the ftdl bits, the same as setTRGSummary(int i, int word)

void	setPsnmBits (int i, int word)
	set the Prescaled ftdl bits

unsigned int	getTRGSummary (int i) const
	get the trigger result, each word has 32 bits

unsigned int	getPreScale (int i, int bit) const
	get the prescale factor which the bit is corresponding

void	setTimType (ETimingType timType)
	set the timType

void	setTimQuality (ETimingQuality timQuality)
	set the timQuality

unsigned int	getInputBits (const unsigned i) const
	get input bits

unsigned int	getFtdlBits (const unsigned i) const
	get ftdl bits (directly determined by the trigger conditions)

unsigned int	getPsnmBits (const unsigned i) const
	get psnm bits (prescaled ftdl bits)

ETimingType	getTimType () const
	get timing source information

ETimingQuality	getTimQuality () const
	get timing source quality

std::string	getInfoHTML () const override
	Return a short summary of this object's contents in HTML format.

unsigned int	getInputBitNumber (const std::string &name) const
	get number of an input trigger bit

unsigned int	getOutputBitNumber (const std::string &name) const
	get number of an output trigger bit

void	addRelationTo (const RelationsInterface< BASE > *object, float weight=1.0, const std::string &namedRelation="") const
	Add a relation from this object to another object (with caching).

void	addRelationTo (const TObject *object, float weight=1.0, const std::string &namedRelation="") const
	Add a relation from this object to another object (no caching, can be quite slow).

void	copyRelations (const RelationsInterface< BASE > *sourceObj)
	Copies all relations of sourceObj (pointing from or to sourceObj) to this object (including weights).

template<class TO >
RelationVector< TO >	getRelationsTo (const std::string &name="", const std::string &namedRelation="") const
	Get the relations that point from this object to another store array.

template<class FROM >
RelationVector< FROM >	getRelationsFrom (const std::string &name="", const std::string &namedRelation="") const
	Get the relations that point from another store array to this object.

template<class T >
RelationVector< T >	getRelationsWith (const std::string &name="", const std::string &namedRelation="") const
	Get the relations between this object and another store array.

template<class TO >
TO *	getRelatedTo (const std::string &name="", const std::string &namedRelation="") const
	Get the object to which this object has a relation.

template<class FROM >
FROM *	getRelatedFrom (const std::string &name="", const std::string &namedRelation="") const
	Get the object from which this object has a relation.

template<class T >
T *	getRelated (const std::string &name="", const std::string &namedRelation="") const
	Get the object to or from which this object has a relation.

template<class TO >
std::pair< TO *, float >	getRelatedToWithWeight (const std::string &name="", const std::string &namedRelation="") const
	Get first related object & weight of relation pointing to an array.

template<class FROM >
std::pair< FROM *, float >	getRelatedFromWithWeight (const std::string &name="", const std::string &namedRelation="") const
	Get first related object & weight of relation pointing from an array.

template<class T >
std::pair< T *, float >	getRelatedWithWeight (const std::string &name="", const std::string &namedRelation="") const
	Get first related object & weight of relation pointing from/to an array.

virtual std::string	getName () const
	Return a short name that describes this object, e.g.

std::string	getInfo () const
	Return a short summary of this object's contents in raw text format.

std::string	getArrayName () const
	Get name of array this object is stored in, or "" if not found.

int	getArrayIndex () const
	Returns this object's array index (in StoreArray), or -1 if not found.

Static Public Attributes
static const unsigned int	c_trgWordSize = 32
	size of a l1 trigger word

static const unsigned int	c_ntrgWords = 10
	number of l1 trigger words

Protected Member Functions
TClonesArray *	getArrayPointer () const
	Returns the pointer to the raw DataStore array holding this object (protected since these arrays are easy to misuse).

Private Member Functions
std::string	outputBitWithColor (bool bit) const
	return the td part of an HTML table with green of the bit is > 0

	ClassDefOverride (TRGSummary, 7)
	Trigger Summary Information including bit (input, ftdl, psnm), timing and trigger source.

	ClassDef (RelationsInterface, 0)
	defines interface for accessing relations of objects in StoreArray.

Private Attributes
unsigned int	m_inputBits [c_ntrgWords] = {0}
	input bits from subdetectors

unsigned int	m_ftdlBits [c_ntrgWords] = {0}
	ftdl (Final Trigger Decision Logic) bits.

unsigned int	m_psnmBits [c_ntrgWords] = {0}
	psnm (PreScale aNd Mask) bits.

ETimingType	m_timType = TTYP_NONE
	types of trigger timing source defined in b2tt firmware

ETimingQuality	m_timQuality = TTYQ_NONE
	trigger timing type quality

unsigned int	m_prescaleBits [c_ntrgWords][c_trgWordSize] = {{0}}
	the prescale factor of each bit

bool	m_isPoissonInInjectionVeto = false
	Poisson random trigger in injection veto or not.

DataStore::StoreEntry *	m_cacheDataStoreEntry
	Cache of the data store entry to which this object belongs.

int	m_cacheArrayIndex
	Cache of the index in the TClonesArray to which this object belongs.

Static Private Attributes
static const int	c_Version = 1
	version of this code

Detailed Description

Trigger Summary Information input bits input bits from subdetectors ftdl (Final Trigger Decision Logic) bits output bits of trigger logic psnm (Prescale and Mask) bits prescaled ftdl bits timType types of trigger timing source defined in b2tt firmware.

Definition at line 32 of file TRGSummary.h.

Member Enumeration Documentation

◆ ETimingQuality

enum ETimingQuality

trigger timing type quality

Definition at line 79 of file TRGSummary.h.

                        {
      /* Non. Must not happen for TOP/ECL/CDC timing events */
      TTYQ_NONE = 0,
      /* Coarse */
      TTYQ_CORS = 1,
      /* Fine */
      TTYQ_FINE = 2,
      /* Super Fine */
      TTYQ_SFIN = 3,
    };

◆ ETimingType

enum ETimingType

types of trigger timing source defined in b2tt firmware

Enumerator
TTYP_ECL	events triggered by ECL timing
TTYP_PID1	reserved (not defined yet)
TTYP_PID2	reserved (not defined yet)
TTYP_PID3	reserved (not defined yet)
TTYP_SELF	events triggered by self trigger
TTYP_RSV1	reserved (not defined yet)
TTYP_RSV2	reserved (not defined yet)
TTYP_RSV3	reserved (not defined yet)
TTYP_TOP	events triggered by TOP timing
TTYP_CDC	events triggered by CDC timing
TTYP_DPHY	delayed physics events for background
TTYP_RAND	random trigger events
TTYP_TEST	test pulse input
TTYP_RSV4	reserved (not defined yet)
TTYP_POIS	poisson random trigger
TTYP_NONE	reserved (not defined yet)

Definition at line 43 of file TRGSummary.h.

                     {
      TTYP_ECL  = 0,
      TTYP_PID1 = 4,
      TTYP_PID2 = 8,
      TTYP_PID3 = 12,
      TTYP_SELF = 2,
      TTYP_RSV1 = 6,
      TTYP_RSV2 = 10,
      TTYP_RSV3 = 14,
      TTYP_TOP = 1,
      TTYP_CDC = 3,
      TTYP_DPHY = 5,
      TTYP_RAND = 7,
      TTYP_TEST = 9,
      TTYP_RSV4 = 11,
      TTYP_POIS = 13,
      TTYP_NONE = 15
    };

Constructor & Destructor Documentation

◆ TRGSummary()

TRGSummary	(	unsigned int	inputBits[10],
		unsigned int	ftdlBits[10],
		unsigned int	psnmBits[10],
		ETimingType	timType
	)

constructor: xxx

Definition at line 23 of file TRGSummary.cc.

{
  for (int i = 0; i < 10; i++) {
    m_inputBits[i] = inputBits[i];
    m_ftdlBits[i] = ftdlBits[i];
    m_psnmBits[i] = psnmBits[i];
  }
  m_timType = timType;
}

Member Function Documentation

◆ addRelationTo() [1/2]

void addRelationTo	(	const RelationsInterface< BASE > *	object,
		float	weight = `1.0`,
		const std::string &	namedRelation = `""`
	)		const

inlineinherited

Add a relation from this object to another object (with caching).

Parameters

object	The object to which the relation should point.
weight	The weight of the relation.
namedRelation	Additional name for the relation, or "" for the default naming

Definition at line 142 of file RelationsObject.h.

    {
      if (object)
        DataStore::Instance().addRelation(this, m_cacheDataStoreEntry, m_cacheArrayIndex,
                                          object, object->m_cacheDataStoreEntry, object->m_cacheArrayIndex, weight, namedRelation);
    }

◆ addRelationTo() [2/2]

void addRelationTo	(	const TObject *	object,
		float	weight = `1.0`,
		const std::string &	namedRelation = `""`
	)		const

inlineinherited

Add a relation from this object to another object (no caching, can be quite slow).

Parameters

object	The object to which the relation should point.
weight	The weight of the relation.
namedRelation	Additional name for the relation, or "" for the default naming

Definition at line 155 of file RelationsObject.h.

    {
      StoreEntry* toEntry = nullptr;
      int toIndex = -1;
      DataStore::Instance().addRelation(this, m_cacheDataStoreEntry, m_cacheArrayIndex, object, toEntry, toIndex, weight, namedRelation);
    }

◆ copyRelations()

void copyRelations ( const RelationsInterface< BASE > * sourceObj )

inlineinherited

Copies all relations of sourceObj (pointing from or to sourceObj) to this object (including weights).

Useful if you want to make a complete copy of a StoreArray object to make modifications to it, but retain all information on linked objects.

Note: this only works if sourceObj inherits from the same base (e.g. RelationsObject), and only for related objects that also inherit from the same base.

Definition at line 170 of file RelationsObject.h.

    {
      if (!sourceObj)
        return;
      auto fromRels = sourceObj->getRelationsFrom<RelationsInterface<BASE>>("ALL");
      for (unsigned int iRel = 0; iRel < fromRels.size(); iRel++) {
        fromRels.object(iRel)->addRelationTo(this, fromRels.weight(iRel));
      }
 
      auto toRels = sourceObj->getRelationsTo<RelationsInterface<BASE>>("ALL");
      for (unsigned int iRel = 0; iRel < toRels.size(); iRel++) {
        this->addRelationTo(toRels.object(iRel), toRels.weight(iRel));
      }
    }

◆ getArrayIndex()

int getArrayIndex ( ) const

inlineinherited

Returns this object's array index (in StoreArray), or -1 if not found.

Definition at line 385 of file RelationsObject.h.

    {
      DataStore::Instance().findStoreEntry(this, m_cacheDataStoreEntry, m_cacheArrayIndex);
      return m_cacheArrayIndex;
    }

◆ getArrayName()

std::string getArrayName ( ) const

inlineinherited

Get name of array this object is stored in, or "" if not found.

Definition at line 377 of file RelationsObject.h.

    {
      DataStore::Instance().findStoreEntry(this, m_cacheDataStoreEntry, m_cacheArrayIndex);
      return m_cacheDataStoreEntry ? m_cacheDataStoreEntry->name : "";
    }

◆ getArrayPointer()

TClonesArray * getArrayPointer ( ) const

inlineprotectedinherited

Returns the pointer to the raw DataStore array holding this object (protected since these arrays are easy to misuse).

Definition at line 418 of file RelationsObject.h.

    {
      DataStore::Instance().findStoreEntry(this, m_cacheDataStoreEntry, m_cacheArrayIndex);
      if (!m_cacheDataStoreEntry)
        return nullptr;
      return m_cacheDataStoreEntry->getPtrAsArray();
    }

◆ getFtdlBits()

unsigned int getFtdlBits ( const unsigned i ) const

inline

get ftdl bits (directly determined by the trigger conditions)

Parameters

i	index: 0, 1, 2 for bit 0-31, 32-63, 64-95, respectively.

Returns: ftdl bits

Definition at line 195 of file TRGSummary.h.

    {
      return m_ftdlBits[i];
    }

◆ getInfo()

std::string getInfo ( ) const

inlineinherited

Return a short summary of this object's contents in raw text format.

Returns the contents of getInfoHTML() while translating line-breaks etc.

Note: : You don't need to implement this function (it's not virtual), getInfoHTML() is enough.

Definition at line 370 of file RelationsObject.h.

    {
      return _RelationsInterfaceImpl::htmlToPlainText(getInfoHTML());
    }

◆ getInfoHTML()

std::string getInfoHTML ( ) const

overridevirtual

Return a short summary of this object's contents in HTML format.

Reimplemented from RelationsInterface< BASE >.

Definition at line 124 of file TRGSummary.cc.

{
  std::stringstream htmlOutput;
 
  htmlOutput << "<table>";
  htmlOutput
      << "<tr><td></td><td bgcolor='#cccccc'>GDL Input</td><td bgcolor='#cccccc' colspan='2'>GDL Output</td></tr>";
  htmlOutput
      << "<tr><td>Bit</td><td>Input Bits</td><td>Final Trg DL</td><td>Prescaled Trg and Mask</td></tr>";
 
  for (unsigned int currentBit = 0;
       currentBit < (c_ntrgWords * c_trgWordSize); currentBit++) {
    htmlOutput << "<tr>";
 
    const auto currentWord = currentBit / c_trgWordSize;
    const auto currentBitInWord = currentBit % c_trgWordSize;
 
    const auto ftdlBit =
      (getFtdlBits(currentWord) & ((unsigned int)1 << currentBitInWord)) > 0;
    const auto psnmBit =
      (getPsnmBits(currentWord) & ((unsigned int)1 << currentBitInWord)) > 0;
    const auto inputBit = (getInputBits(currentWord)
                           & ((unsigned int)1 << currentBitInWord)) > 0;
 
    htmlOutput << "<td>" << currentBit << "(word " << currentWord << " bit "
               << currentBitInWord << ")</td>";
    htmlOutput << outputBitWithColor(inputBit);
    htmlOutput << outputBitWithColor(ftdlBit);
    htmlOutput << outputBitWithColor(psnmBit);
    htmlOutput << "</tr>";
  }
  htmlOutput << "</table>";
 
  return htmlOutput.str();
}

◆ getInputBitNumber()

unsigned int getInputBitNumber ( const std::string & name ) const

get number of an input trigger bit

Parameters

name	input trigger bit name

Returns: input trigger bit number

Definition at line 77 of file TRGSummary.cc.

{
  // Instead of returning a magic number, let's throw an exception:
  // this will help us to distinguish "trigger not fired" cases
  // from "trigger not found" at analysis level.
  static DBObjPtr<TRGGDLDBInputBits> inputBits;
 
  if (not inputBits) {
    B2WARNING("The mapping of input trigger names does not exist in the given globaltags");
    throw std::runtime_error("No input trigger map in the given globaltags");
  }
 
  for (unsigned int bit = 0; bit < c_trgWordSize * c_ntrgWords; bit++) {
    if (std::string(inputBits->getinbitname((int)bit)) == name) {
      return bit;
    }
  }
 
  B2WARNING("The requested input trigger name does not exist" << LogVar("name", name));
  throw std::invalid_argument("The requested input trigger name does not exist: " + name);
}

◆ getInputBits()

unsigned int getInputBits ( const unsigned i ) const

inline

get input bits

Parameters

i	index: 0, 1, 2 for bit 0-31, 32-63, 64-95, respectively.

Returns: input bits

Definition at line 186 of file TRGSummary.h.

    {
      return m_inputBits[i];
    }

◆ getName()

virtual std::string getName ( ) const

inlinevirtualinherited

Return a short name that describes this object, e.g.

pi+ for an MCParticle.

Reimplemented in Particle, MCParticle, and SpacePoint.

Definition at line 344 of file RelationsObject.h.

344{ return ""; }

◆ getOutputBitNumber()

unsigned int getOutputBitNumber ( const std::string & name ) const

get number of an output trigger bit

Parameters

name	output trigger bit name

Returns: output trigger bit number

Definition at line 99 of file TRGSummary.cc.

{
  // Instead of returning a magic number, let's throw an exception:
  // this will help us to distinguish "trigger not fired" cases
  // from "trigger not found" at analysis level.
  static DBObjPtr<TRGGDLDBFTDLBits> ftdlBits;
 
  if (not ftdlBits) {
    B2WARNING("The mapping of output trigger names does not exist in the given globaltags");
    throw std::runtime_error("No input trigger map in the given globaltags");
  }
 
  for (unsigned int bit = 0; bit < c_trgWordSize * c_ntrgWords; bit++) {
    if (std::string(ftdlBits->getoutbitname((int)bit)) == name) {
      return bit;
    }
  }
 
  B2WARNING("The requested output trigger name does not exist" << LogVar("name", name));
  // Instead of returning a magic number, let's throw an exception:
  // this will help us to distinguish "trigger not fired" cases
  // from "trigger not found" at analysis level.
  throw std::invalid_argument("The requested input trigger name does not exist: " + name);
}

◆ getPreScale()

unsigned int getPreScale	(	int	i,
		int	bit
	)		const

inline

get the prescale factor which the bit is corresponding

Definition at line 174 of file TRGSummary.h.

174{return m_prescaleBits[i][bit];}

Belle2::TRGSummary::m_prescaleBits

unsigned int m_prescaleBits[c_ntrgWords][c_trgWordSize]

the prescale factor of each bit

Definition: TRGSummary.h:268

◆ getPsnmBits()

unsigned int getPsnmBits ( const unsigned i ) const

inline

get psnm bits (prescaled ftdl bits)

Parameters

i	index: 0, 1, 2 for bit 0-31, 32-63, 64-95, respectively.

Returns: psnm bits

Definition at line 204 of file TRGSummary.h.

    {
      return m_psnmBits[i];
    }

◆ getRelated()

T * getRelated	(	const std::string &	name = `""`,
		const std::string &	namedRelation = `""`
	)		const

inlineinherited

Get the object to or from which this object has a relation.

Template Parameters

T	The class of objects to or from which the relation points.

Parameters

name	The name of the store array to or from which the relation points. If empty the default store array name for class T will be used. If the special name "ALL" is given all store arrays containing objects of type T are considered.
namedRelation	Additional name for the relation, or "" for the default naming

Returns: The first related object or a null pointer.

Definition at line 278 of file RelationsObject.h.

    {
      return static_cast<T*>(DataStore::Instance().getRelationWith(DataStore::c_BothSides, this, m_cacheDataStoreEntry, m_cacheArrayIndex,
                             T::Class(), name, namedRelation).object);
    }

◆ getRelatedFrom()

FROM * getRelatedFrom	(	const std::string &	name = `""`,
		const std::string &	namedRelation = `""`
	)		const

inlineinherited

Get the object from which this object has a relation.

Template Parameters

FROM	The class of objects from which the relation points.

Parameters

name	The name of the store array from which the relation points. If empty the default store array name for class FROM will be used. If the special name "ALL" is given all store arrays containing objects of type FROM are considered.
namedRelation	Additional name for the relation, or "" for the default naming

Returns: The first related object or a null pointer.

Definition at line 263 of file RelationsObject.h.

    {
      return static_cast<FROM*>(DataStore::Instance().getRelationWith(DataStore::c_FromSide, this, m_cacheDataStoreEntry,
                                m_cacheArrayIndex, FROM::Class(), name, namedRelation).object);
    }

◆ getRelatedFromWithWeight()

std::pair< FROM *, float > getRelatedFromWithWeight	(	const std::string &	name = `""`,
		const std::string &	namedRelation = `""`
	)		const

inlineinherited

Get first related object & weight of relation pointing from an array.

Template Parameters

FROM	The class of objects from which the relation points.

Parameters

name	The name of the store array from which the relation points. If empty the default store array name for class FROM will be used. If the special name "ALL" is given all store arrays containing objects of type FROM are considered.
namedRelation	Additional name for the relation, or "" for the default naming

Returns: Pair of first related object and the relation weight, or (NULL, 1.0) if none found.

Definition at line 314 of file RelationsObject.h.

    {
      RelationEntry entry = DataStore::Instance().getRelationWith(DataStore::c_FromSide, this, m_cacheDataStoreEntry, m_cacheArrayIndex,
                                                                  FROM::Class(), name, namedRelation);
      return std::make_pair(static_cast<FROM*>(entry.object), entry.weight);
    }

◆ getRelatedTo()

TO * getRelatedTo	(	const std::string &	name = `""`,
		const std::string &	namedRelation = `""`
	)		const

inlineinherited

Get the object to which this object has a relation.

Template Parameters

TO	The class of objects to which the relation points.

Parameters

name	The name of the store array to which the relation points. If empty the default store array name for class TO will be used. If the special name "ALL" is given all store arrays containing objects of type TO are considered.
namedRelation	Additional name for the relation, or "" for the default naming

Returns: The first related object or a null pointer.

Definition at line 248 of file RelationsObject.h.

    {
      return static_cast<TO*>(DataStore::Instance().getRelationWith(DataStore::c_ToSide, this, m_cacheDataStoreEntry, m_cacheArrayIndex,
                              TO::Class(), name, namedRelation).object);
    }

◆ getRelatedToWithWeight()

std::pair< TO *, float > getRelatedToWithWeight	(	const std::string &	name = `""`,
		const std::string &	namedRelation = `""`
	)		const

inlineinherited

Get first related object & weight of relation pointing to an array.

Template Parameters

TO	The class of objects to which the relation points.

Parameters

name	The name of the store array to which the relation points. If empty the default store array name for class TO will be used. If the special name "ALL" is given all store arrays containing objects of type TO are considered.
namedRelation	Additional name for the relation, or "" for the default naming

Returns: Pair of first related object and the relation weight, or (NULL, 1.0) if none found.

Definition at line 297 of file RelationsObject.h.

    {
      RelationEntry entry = DataStore::Instance().getRelationWith(DataStore::c_ToSide, this, m_cacheDataStoreEntry, m_cacheArrayIndex,
                                                                  TO::Class(), name, namedRelation);
      return std::make_pair(static_cast<TO*>(entry.object), entry.weight);
    }

◆ getRelatedWithWeight()

std::pair< T *, float > getRelatedWithWeight	(	const std::string &	name = `""`,
		const std::string &	namedRelation = `""`
	)		const

inlineinherited

Get first related object & weight of relation pointing from/to an array.

Template Parameters

T	The class of objects to or from which the relation points.

Parameters

name	The name of the store array to or from which the relation points. If empty the default store array name for class T will be used. If the special name "ALL" is given all store arrays containing objects of type T are considered.
namedRelation	Additional name for the relation, or "" for the default naming

Returns: Pair of first related object and the relation weight, or (NULL, 1.0) if none found.

Definition at line 331 of file RelationsObject.h.

    {
      RelationEntry entry = DataStore::Instance().getRelationWith(DataStore::c_BothSides, this, m_cacheDataStoreEntry, m_cacheArrayIndex,
                                                                  T::Class(), name, namedRelation);
      return std::make_pair(static_cast<T*>(entry.object), entry.weight);
    }

◆ getRelationsFrom()

RelationVector< FROM > getRelationsFrom	(	const std::string &	name = `""`,
		const std::string &	namedRelation = `""`
	)		const

inlineinherited

Get the relations that point from another store array to this object.

Template Parameters

FROM	The class of objects from which the relations point.

Parameters

name	The name of the store array from which the relations point. If empty the default store array name for class FROM will be used. If the special name "ALL" is given all store arrays containing objects of type FROM are considered.
namedRelation	Additional name for the relation, or "" for the default naming

Returns: A vector of relations.

Definition at line 212 of file RelationsObject.h.

    {
      return RelationVector<FROM>(DataStore::Instance().getRelationsWith(DataStore::c_FromSide, this, m_cacheDataStoreEntry,
                                  m_cacheArrayIndex, FROM::Class(), name, namedRelation));
    }

◆ getRelationsTo()

RelationVector< TO > getRelationsTo	(	const std::string &	name = `""`,
		const std::string &	namedRelation = `""`
	)		const

inlineinherited

Get the relations that point from this object to another store array.

Template Parameters

TO	The class of objects to which the relations point.

Parameters

name	The name of the store array to which the relations point. If empty the default store array name for class TO will be used. If the special name "ALL" is given all store arrays containing objects of type TO are considered.
namedRelation	Additional name for the relation, or "" for the default naming

Returns: A vector of relations.

Definition at line 197 of file RelationsObject.h.

    {
      return RelationVector<TO>(DataStore::Instance().getRelationsWith(DataStore::c_ToSide, this, m_cacheDataStoreEntry,
                                m_cacheArrayIndex, TO::Class(), name, namedRelation));
    }

◆ getRelationsWith()

RelationVector< T > getRelationsWith	(	const std::string &	name = `""`,
		const std::string &	namedRelation = `""`
	)		const

inlineinherited

Get the relations between this object and another store array.

Relations in both directions are returned.

Template Parameters

T	The class of objects to or from which the relations point.

Parameters

name	The name of the store array to or from which the relations point. If empty the default store array name for class T will be used. If the special name "ALL" is given all store arrays containing objects of type T are considered.
namedRelation	Additional name for the relation, or "" for the default naming

Returns: A vector of relations.

Definition at line 230 of file RelationsObject.h.

    {
      return RelationVector<T>(DataStore::Instance().getRelationsWith(DataStore::c_BothSides, this, m_cacheDataStoreEntry,
                               m_cacheArrayIndex, T::Class(), name, namedRelation));
    }

◆ getTimQuality()

ETimingQuality getTimQuality ( ) const

inline

get timing source quality

Returns: timing type quality

Definition at line 220 of file TRGSummary.h.

    {
      return m_timQuality;
    }

◆ getTimType()

ETimingType getTimType ( ) const

inline

get timing source information

Returns: timing source type

Definition at line 212 of file TRGSummary.h.

    {
      return m_timType;
    }

◆ getTRGSummary()

unsigned int getTRGSummary ( int i ) const

inline

get the trigger result, each word has 32 bits

Definition at line 171 of file TRGSummary.h.

171{return m_ftdlBits[i];}

◆ isPoissonInInjectionVeto()

bool isPoissonInInjectionVeto ( ) const

inline

check whether poisson random trigger is within injection veto

Returns: True if poisson random trigger is within injection veto

Definition at line 143 of file TRGSummary.h.

    {
      return m_isPoissonInInjectionVeto;
    }

◆ outputBitWithColor()

std::string outputBitWithColor ( bool bit ) const

private

return the td part of an HTML table with green of the bit is > 0

Definition at line 162 of file TRGSummary.cc.

{
  const std::string colorNeutral = gROOT->GetColor(kWhite)->AsHexString();
  const std::string colorAccept = gROOT->GetColor(kGreen)->AsHexString();
 
  std::string color = bit > 0 ? colorAccept : colorNeutral;
  std::stringstream outStream;
  outStream << "<td bgcolor=\"" << color << "\">" << bit << "</td>";
  return outStream.str();
}

◆ setFtdlBits()

void setFtdlBits	(	int	i,
		int	word
	)

inline

set the ftdl bits, the same as setTRGSummary(int i, int word)

Definition at line 165 of file TRGSummary.h.

165{m_ftdlBits[i] = word;}

◆ setInputBits()

void setInputBits	(	int	i,
		int	word
	)

inline

set the input bits

Definition at line 162 of file TRGSummary.h.

162{m_inputBits[i] = word;}

◆ setPoissonInInjectionVeto()

void setPoissonInInjectionVeto ( )

inline

set true if poisson random trigger is within injection veto

Definition at line 150 of file TRGSummary.h.

    {
      m_isPoissonInInjectionVeto = true;
    }

◆ setPreScale()

void setPreScale	(	int	i,
		int	bit,
		int	pre
	)

inline

set the prescale factor of each bit

Definition at line 159 of file TRGSummary.h.

159{m_prescaleBits[i][bit] = pre;}

◆ setPsnmBits()

void setPsnmBits	(	int	i,
		int	word
	)

inline

set the Prescaled ftdl bits

Definition at line 168 of file TRGSummary.h.

168{m_psnmBits[i] = word;}

◆ setTimQuality()

void setTimQuality ( ETimingQuality timQuality )

inline

set the timQuality

Definition at line 180 of file TRGSummary.h.

180{m_timQuality = timQuality;}

◆ setTimType()

void setTimType ( ETimingType timType )

inline

set the timType

Definition at line 177 of file TRGSummary.h.

177{m_timType = timType;}

◆ setTRGSummary()

void setTRGSummary	(	int	i,
		int	word
	)

inline

set the Final Trigger Decision Logic bit

Definition at line 156 of file TRGSummary.h.

156{ m_ftdlBits[i] = word;}

◆ test()

bool test ( ) const

check whether any psnm bit is set

Returns: True if triggered by L1

Definition at line 36 of file TRGSummary.cc.

{
  for (unsigned int word = 0; word < c_ntrgWords; word++) {
    if (m_psnmBits[word] != 0) return true;
  }
  return false;
}

◆ testFtdl() [1/2]

bool testFtdl ( const std::string & name ) const

inline

check whether a ftdl bit is set

Parameters

name	name of ftdl bit.

Returns: True if the bit is set

Definition at line 126 of file TRGSummary.h.

126{return testFtdl(getOutputBitNumber(name));}

Belle2::TRGSummary::getOutputBitNumber

unsigned int getOutputBitNumber(const std::string &name) const

get number of an output trigger bit

Definition: TRGSummary.cc:99

Belle2::TRGSummary::testFtdl

bool testFtdl(unsigned int bit) const

check whether a ftdl bit is set

Definition: TRGSummary.cc:55

◆ testFtdl() [2/2]

bool testFtdl ( unsigned int bit ) const

check whether a ftdl bit is set

Parameters

bit	index of ftdl bit.

Returns: True if the bit is set

Definition at line 55 of file TRGSummary.cc.

{
  if (bit >= c_trgWordSize * c_ntrgWords) {
    B2ERROR("Requested ftdl trigger bit number is out of range" << LogVar("bit", bit));
    throw std::out_of_range("The requested FTDL trigger bit is out of range: " + std::to_string(bit));
  }
  int iWord = bit / c_trgWordSize;
  int iBit = bit % c_trgWordSize;
  return (m_ftdlBits[iWord] & (1u << iBit)) != 0;
}

◆ testInput() [1/2]

bool testInput ( const std::string & name ) const

inline

check whether an input bit is set

Parameters

name	name of input bit.

Returns: True if the bit is set

Definition at line 114 of file TRGSummary.h.

114{return testInput(getInputBitNumber(name));}

Belle2::TRGSummary::getInputBitNumber

unsigned int getInputBitNumber(const std::string &name) const

get number of an input trigger bit

Definition: TRGSummary.cc:77

Belle2::TRGSummary::testInput

bool testInput(unsigned int bit) const

check whether an input bit is set

Definition: TRGSummary.cc:44

◆ testInput() [2/2]

bool testInput ( unsigned int bit ) const

check whether an input bit is set

Parameters

bit	index of input bit.

Returns: True if the bit is set

Definition at line 44 of file TRGSummary.cc.

{
  if (bit >= c_trgWordSize * c_ntrgWords) {
    B2ERROR("Requested input trigger bit number is out of range" << LogVar("bit", bit));
    throw std::out_of_range("The requested input trigger bit is out of range: " + std::to_string(bit));
  }
  int iWord = bit / c_trgWordSize;
  int iBit = bit % c_trgWordSize;
  return (m_inputBits[iWord] & (1u << iBit)) != 0;
}

◆ testPsnm() [1/2]

bool testPsnm ( const std::string & name ) const

inline

check whether a psnm bit is set

Parameters

name	name of psnm bit.

Returns: True if the bit is set

Definition at line 138 of file TRGSummary.h.

138{return testPsnm(getOutputBitNumber(name));}

Belle2::TRGSummary::testPsnm

bool testPsnm(unsigned int bit) const

check whether a psnm bit is set

Definition: TRGSummary.cc:66

◆ testPsnm() [2/2]

bool testPsnm ( unsigned int bit ) const

check whether a psnm bit is set

Parameters

bit	index of psnm bit.

Returns: True if the bit is set

Definition at line 66 of file TRGSummary.cc.

{
  if (bit >= c_trgWordSize * c_ntrgWords) {
    B2ERROR("Requested psnm trigger bit number is out of range" << LogVar("bit", bit));
    throw std::out_of_range("The requested PSNM trigger bit is out of range: " + std::to_string(bit));
  }
  int iWord = bit / c_trgWordSize;
  int iBit = bit % c_trgWordSize;
  return (m_psnmBits[iWord] & (1u << iBit)) != 0;
}

Member Data Documentation

◆ c_ntrgWords

const unsigned int c_ntrgWords = 10

static

number of l1 trigger words

Definition at line 40 of file TRGSummary.h.

◆ c_trgWordSize

const unsigned int c_trgWordSize = 32

static

size of a l1 trigger word

Definition at line 37 of file TRGSummary.h.

◆ c_Version

const int c_Version = 1

staticprivate

version of this code

Definition at line 248 of file TRGSummary.h.

◆ m_cacheArrayIndex

int m_cacheArrayIndex

mutableprivateinherited

Cache of the index in the TClonesArray to which this object belongs.

Definition at line 432 of file RelationsObject.h.

◆ m_cacheDataStoreEntry

DataStore::StoreEntry* m_cacheDataStoreEntry

mutableprivateinherited

Cache of the data store entry to which this object belongs.

Definition at line 429 of file RelationsObject.h.

◆ m_ftdlBits

unsigned int m_ftdlBits[c_ntrgWords] = {0}

private

ftdl (Final Trigger Decision Logic) bits.

Outputs of trigger logic

Definition at line 254 of file TRGSummary.h.

◆ m_inputBits

unsigned int m_inputBits[c_ntrgWords] = {0}

private

input bits from subdetectors

Definition at line 251 of file TRGSummary.h.

◆ m_isPoissonInInjectionVeto

bool m_isPoissonInInjectionVeto = false

private

Poisson random trigger in injection veto or not.

Definition at line 271 of file TRGSummary.h.

◆ m_prescaleBits

unsigned int m_prescaleBits[c_ntrgWords][c_trgWordSize] = {{0}}

private

the prescale factor of each bit

Definition at line 268 of file TRGSummary.h.

◆ m_psnmBits

unsigned int m_psnmBits[c_ntrgWords] = {0}

private

psnm (PreScale aNd Mask) bits.

Prescaled ftdl bits For instance, if the prescale factor is 20 of a ftdl bit, only 1/20 of its psnm bit would be fired.

Definition at line 259 of file TRGSummary.h.

◆ m_timQuality

ETimingQuality m_timQuality = TTYQ_NONE

private

trigger timing type quality

Definition at line 265 of file TRGSummary.h.

◆ m_timType

ETimingType m_timType = TTYP_NONE

private

types of trigger timing source defined in b2tt firmware

Definition at line 262 of file TRGSummary.h.

The documentation for this class was generated from the following files:

mdst/dataobjects/include/TRGSummary.h
mdst/dataobjects/src/TRGSummary.cc

Public Types

Public Member Functions

Static Public Attributes

Protected Member Functions

Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Member Enumeration Documentation

◆ ETimingQuality

◆ ETimingType

Constructor & Destructor Documentation

◆ TRGSummary()

Member Function Documentation

◆ addRelationTo() [1/2]

◆ addRelationTo() [2/2]

◆ copyRelations()

◆ getArrayIndex()

◆ getArrayName()

◆ getArrayPointer()

◆ getFtdlBits()

◆ getInfo()

◆ getInfoHTML()

◆ getInputBitNumber()

◆ getInputBits()

◆ getName()

◆ getOutputBitNumber()

◆ getPreScale()

◆ getPsnmBits()

◆ getRelated()

◆ getRelatedFrom()

◆ getRelatedFromWithWeight()

◆ getRelatedTo()

◆ getRelatedToWithWeight()

◆ getRelatedWithWeight()

◆ getRelationsFrom()

◆ getRelationsTo()

◆ getRelationsWith()

◆ getTimQuality()

◆ getTimType()

◆ getTRGSummary()

◆ isPoissonInInjectionVeto()

◆ outputBitWithColor()

◆ setFtdlBits()

◆ setInputBits()

◆ setPoissonInInjectionVeto()

◆ setPreScale()

◆ setPsnmBits()

◆ setTimQuality()

◆ setTimType()

◆ setTRGSummary()

◆ test()

◆ testFtdl() [1/2]

◆ testFtdl() [2/2]

◆ testInput() [1/2]

◆ testInput() [2/2]

◆ testPsnm() [1/2]

◆ testPsnm() [2/2]

Member Data Documentation

◆ c_ntrgWords

◆ c_trgWordSize

◆ c_Version

◆ m_cacheArrayIndex

◆ m_cacheDataStoreEntry

◆ m_ftdlBits

◆ m_inputBits

◆ m_isPoissonInInjectionVeto

◆ m_prescaleBits

◆ m_psnmBits

◆ m_timQuality

◆ m_timType