Trig::DecisionAccess Class Reference

#include <DecisionAccess.h>

Inheritance diagram for Trig::DecisionAccess:

Collaboration diagram for Trig::DecisionAccess:

Public Member Functions
	DecisionAccess ()
virtual	~DecisionAccess ()
bool	isPassed (const Trig::ChainGroup *chaingroup, unsigned int condition=TrigDefs::Physics) const
	true if given group of chains passed More...
bool	isPassed (const std::string &chain, unsigned int condition) const
	true if given chain passed More...
bool	isPassed (const std::string &chain) const
std::vector< bool >	isPassedForEach (const Trig::ChainGroup *chainGroup, unsigned int condition=TrigDefs::Physics) const
	return decision for each chain in group More...
std::vector< bool >	isPassedForEach (const std::string &chain, unsigned int condition=TrigDefs::Physics) const
	return decision for each chain defined by given pattern More...
unsigned int	isPassedBits (const Trig::ChainGroup *chaingroup) const
	Return expert-level information about the various trigger flags as a bit mask. More...
unsigned int	isPassedBits (const std::string &chain) const
std::vector< unsigned int >	isPassedBitsForEach (const Trig::ChainGroup *chaingroup) const
	Return the result of isPassedBits for each chain in the group. More...
std::vector< unsigned int >	isPassedBitsForEach (const std::string &chain) const
char	getBGCode () const
	get the bunch group code bit X=1: BG X fired (X=0..7) use: bool BGXfired = BGCode & (0x1<<X) More...
FeatureContainer	features (const Trig::ChainGroup *group, unsigned int condition=TrigDefs::Physics) const
	Runs 1, 2. More...
FeatureContainer	features (const std::string &chainName="EF_.*", unsigned int condition=TrigDefs::Physics) const
	Runs 1, 2. More...
template<class T >
Feature< T >	ancestor (const HLT::TriggerElement *te, std::string label="") const
	gives back feature matching (by seeding relation) More...
template<class T >
std::vector< Trig::Feature< T > >	ancestors (const HLT::TriggerElement *te, std::string label="", unsigned int condition=TrigDefs::Physics, const std::string &teName="") const
	gives back features matching (by seeding relation) - will also flatten containers if necessary More...
MsgStream &	msg () const
MsgStream &	msg (const MSG::Level lvl) const
bool	msgLvl (const MSG::Level lvl) const

Private Member Functions
virtual Trig::CacheGlobalMemory *	cgm ()=0
virtual const Trig::CacheGlobalMemory *	cgm () const =0

Static Private Attributes
static asg::AsgTool *s_logger	ATLAS_THREAD_SAFE {nullptr}

Friends
class	Combination

Detailed Description

Definition at line 53 of file DecisionAccess.h.

Constructor & Destructor Documentation

DecisionAccess()

Trig::DecisionAccess::DecisionAccess

(

)

Definition at line 29 of file DecisionAccess.cxx.

{}

~DecisionAccess()

Trig::DecisionAccess::~DecisionAccess ( )

virtual

Definition at line 31 of file DecisionAccess.cxx.

{}

Member Function Documentation

ancestor()

template<class T >

Feature<T> Trig::DecisionAccess::ancestor	(	const HLT::TriggerElement *	te,
		std::string	label = ""
	)		const

gives back feature matching (by seeding relation)

Parameters

te	- is trigger element to start with, not that thanks to conversion operators Feature object can be given here as well

ancestors()

template<class T >

std::vector<Trig::Feature<T> > Trig::DecisionAccess::ancestors	(	const HLT::TriggerElement *	te,
		std::string	label = "",
		unsigned int	condition = TrigDefs::Physics,
		const std::string &	teName = ""
	)		const

gives back features matching (by seeding relation) - will also flatten containers if necessary

Parameters

te	- is trigger element to start with, not that thanks to conversion operators Feature object can be given here as well

associateToEventView() [1/4]

template<class CONTAINER >

std::pair< typename CONTAINER::const_iterator, typename CONTAINER::const_iterator > Trig::DecisionAccess::associateToEventView	(	typename SG::ReadHandle< CONTAINER > &	inViewContainer,
		const ElementLink< TrigRoiDescriptorCollection > &	matchROI
	)		const

Runs 3+.

Returns a range over a container which are associated with a particular EventView instance from online. Instance mapping done via supplied ElementLink<TrigRoiDescriptorCollection>.

Parameters

[in]	inViewContainer	The ReadHandle of the collection which was produced online inside an EventView.
[in]	roi	TrigRoiDescriptor used to seed the desired EventView.

Returns

Pair of iterators spanning a range of indices over the collection accessed through the ReadHandleKey

associateToEventView() [2/4]

template<class CONTAINER >

std::pair< typename CONTAINER::const_iterator, typename CONTAINER::const_iterator > Trig::DecisionAccess::associateToEventView	(	typename SG::ReadHandle< CONTAINER > &	inViewContainer,
		const TrigCompositeUtils::Decision *	decisionObject,
		const std::string &	roiName = TrigCompositeUtils::roiString()
	)		const

Runs 3+.

Returns a range over a container which are associated with a particular EventView instance from online. Instance mapping done via an ElementLink<TrigRoiDescriptorCollection> obtained from the supplied Decision object pointer

Parameters

[in]	inViewContainer	The ReadHandle of the collection which was produced online inside an EventView.
[in]	decisionObject	Decision node from which a TrigRoiDescriptor can be located.
[in]	roiName	Name of the TrigRoiDescriptor inside the Navigation.

Returns

Pair of iterators spanning a range of indices over the collection accessed through the ReadHandleKey

associateToEventView() [3/4]

template<class CONTAINER , class FEATURE_CONTAINER >

std::pair< typename CONTAINER::const_iterator, typename CONTAINER::const_iterator > Trig::DecisionAccess::associateToEventView	(	typename SG::ReadHandle< CONTAINER > &	inViewContainer,
		const TrigCompositeUtils::LinkInfo< FEATURE_CONTAINER >	linkInfo,
		const std::string &	roiName = TrigCompositeUtils::roiString()
	)		const

Runs 3+.

Returns a range over a container which are associated with a particular EventView instance from online. Instance mapping done via an ElementLink<TrigRoiDescriptorCollection> obtained from the supplied LinkInfo

Parameters

[in]	inViewContainer	The ReadHandle of the collection which was produced online inside an EventView.
[in]	linkInfo	LinkInfo from which a TrigRoiDescriptor can be located.
[in]	roiName	Name of the TrigRoiDescriptor inside the Navigation.

Returns

Pair of iterators spanning a range of indices over the collection accessed through the ReadHandleKey

associateToEventView() [4/4]

template<class CONTAINER >

std::pair< typename CONTAINER::const_iterator, typename CONTAINER::const_iterator > Trig::DecisionAccess::associateToEventView	(	typename SG::ReadHandle< CONTAINER > &	inViewContainer,
		const uint32_t	matchIndex,
		const uint32_t	matchKey = 0,
		const bool	isFullscan = false
	)		const

Runs 3+.

Returns a range over a container which are associated with a particular EventView instance from online. Instance mapping done via matchIndex and optional matchKey (leave matchKey = 0 to not cut on this).

Parameters

[in]	inViewContainer	The ReadHandle of the collection which was produced online inside an EventView.
[in]	matchIndex	The index of the desired EventView.
[in]	matchKey	Optional. SGKey of the index of the desired EventView (collection hosting the ROI used to span the Event View)
[in]	isFullscan	Optional. If true, and inViewContainer has no viewIndex decorations, then return iterators over the full span of the inViewContainer instead of throwing an exception. This allows the associateToEventView interface to be used also for non-EventView containers, with the FS ROI used to indicate that the lack of decorations is expected rather than being indicative of a configuration problem.

Returns

Pair of iterators spanning a range of indices over the collection accessed through the ReadHandleKey

cgm() [1/2]

virtual const Trig::CacheGlobalMemory* Trig::DecisionAccess::cgm ( ) const

privatepure virtual

Implemented in Trig::TrigDecisionToolCore.

cgm() [2/2]

virtual Trig::CacheGlobalMemory* Trig::DecisionAccess::cgm ( )

privatepure virtual

Implemented in Trig::TrigDecisionToolCore.

features() [1/5]

template<class CONTAINER >

std::vector< TrigCompositeUtils::LinkInfo<CONTAINER> > Trig::DecisionAccess::features	(	const std::string &	chainGroupName,
		const unsigned int	condition = TrigDefs::Physics,
		const std::string &	containerSGKey = "",
		const unsigned int	featureCollectionMode = TrigDefs::lastFeatureOfType,
		const std::string &	navElementLinkKey = TrigCompositeUtils::featureString(),
		const int	restrictToLegIndex = -1
	)		const

Runs 3+.

Returns features related to given chain

Parameters

[in]	group	Chain group to return features for.
[in]	condition	Condition requirement. Only TrigDefs::Physics and TrigDefs::includeFailedDecisions are supported.
[in]	containerSGKey	Optional requirement to return only features within the specified container name. Not checked if not specified.
[in]	featureCollectionMode	For lastFeatureOfType, stop exploring each route through the navigation once one matching feature has been found.
[in]	navElementLinkKey	Optional name of element link as saved online. The "feature" link is enforced, others may have been added.
[in]	restrictToLegIndex	Optional index of a leg for mult-leg chains. Features will only be returned on the specified leg. Default is all legs.

Returns

Vector of LinkInfo, where each entry wraps an ElementLink to the feature, and the Decision object it came from.

features() [2/5]

Trig::FeatureContainer Trig::DecisionAccess::features	(	const std::string &	chainName = "EF_.*",
		unsigned int	condition = TrigDefs::Physics
	)		const

Runs 1, 2.

Returns features related to given chain

Definition at line 97 of file DecisionAccess.cxx.

                                                                                 {
  const Trig::ChainGroup *g = cgm()->createChainGroup(Trig::convertStringToVector(chain));
  return features(g,condition);
}

features() [3/5]

template<class CONTAINER >

std::vector< TrigCompositeUtils::LinkInfo<CONTAINER> > Trig::DecisionAccess::features	(	const Trig::ChainGroup *	group,
		const unsigned int	condition = TrigDefs::Physics,
		const std::string &	containerSGKey = "",
		const unsigned int	featureCollectionMode = TrigDefs::lastFeatureOfType,
		const std::string &	navElementLinkKey = TrigCompositeUtils::featureString(),
		const int	restrictToLegIndex = -1
	)		const

Runs 3+.

Returns all features related to given chain group

Parameters

[in]	group	Chain group to return features for.
[in]	condition	Condition requirement. Only TrigDefs::Physics and TrigDefs::includeFailedDecisions are supported.
[in]	containerSGKey	Optional requirement to return only features within the specified container name. Not checked if not specified.
[in]	featureCollectionMode	For lastFeatureOfType, stop exploring each route through the navigation once one matching feature has been found.
[in]	navElementLinkKey	Optional name of element link as saved online. The "feature" link is enforced, others may have been added.
[in]	restrictToLegIndex	Optional index of a leg for mult-leg chains. Features will only be returned on the specified leg. Default is all legs.

Returns

Vector of LinkInfo, where each entry wraps an ElementLink to the feature, and the Decision object it came from.

features() [4/5]

Trig::FeatureContainer Trig::DecisionAccess::features	(	const Trig::ChainGroup *	group,
		unsigned int	condition = TrigDefs::Physics
	)		const

Runs 1, 2.

Returns all features related to given chain group

Definition at line 92 of file DecisionAccess.cxx.

                                                                                      {
  return chain->features(condition);
}

features() [5/5]

template<class CONTAINER >

std::vector< TrigCompositeUtils::LinkInfo<CONTAINER> > Trig::DecisionAccess::features

(

const Trig::FeatureRequestDescriptor &

featureRequest

)

const

Runs 3+.

Returns all features related to given chain group

Parameters

[in]

featureRequest

Helper object which encapsulates all configurable options of a request for features from the TDT

Returns

Vector of LinkInfo, where each entry wraps an ElementLink to the feature, and the Decision object it came from.

getBGCode()

char Trig::DecisionAccess::getBGCode

(

)

const

get the bunch group code bit X=1: BG X fired (X=0..7) use: bool BGXfired = BGCode & (0x1<<X)

Definition at line 103 of file DecisionAccess.cxx.

                                    {
  if( ! cgm()->assert_decision() ) {
    ATH_MSG_ERROR("Something went wrong in decoding the trigger decision");
    return 0;
  }
  return cgm()->m_bgCode;
}

isPassed() [1/3]

bool Trig::DecisionAccess::isPassed

(

const std::string &

chain

)

const

Definition at line 48 of file DecisionAccess.cxx.

                                                              {
  return isPassed(chain, TrigDefs::Physics);
}

isPassed() [2/3]

bool Trig::DecisionAccess::isPassed	(	const std::string &	chain,
		unsigned int	condition
	)		const

true if given chain passed

See also

Trig::ChainGroup

TrigDefs::Conditions

Definition at line 40 of file DecisionAccess.cxx.

{
  const Trig::ChainGroup *g = cgm()->createChainGroup(Trig::convertStringToVector(chain));
  return isPassed(g,condition);
}

isPassed() [3/3]

bool Trig::DecisionAccess::isPassed	(	const Trig::ChainGroup *	chaingroup,
		unsigned int	condition = TrigDefs::Physics
	)		const

true if given group of chains passed

See also

Trig::ChainGroup

TrigDefs::Conditions

Definition at line 34 of file DecisionAccess.cxx.

{
  return chainGroup->isPassed(condition);
}

isPassedBits() [1/2]

unsigned int Trig::DecisionAccess::isPassedBits

(

const std::string &

chain

)

const

Definition at line 72 of file DecisionAccess.cxx.

{
  const Trig::ChainGroup *g = cgm()->createChainGroup(Trig::convertStringToVector(chain));
  return isPassedBits(g);
}

isPassedBits() [2/2]

unsigned int Trig::DecisionAccess::isPassedBits

(

const Trig::ChainGroup *

chaingroup

)

const

Return expert-level information about the various trigger flags as a bit mask.

Note: this does not accept a conditions flag – the prescription is always enforceLogicalFlow. The mask can be comprehended using the following constants from TrigDefs:: EF_passedRaw EF_passThrough EF_prescaled EF_resurrected L2_passedRaw L2_passThrough L2_prescaled L2_resurrected L1_isPassedAfterPrescale L1_isPassedBeforePrescale L1_isPassedAfterVeto

Definition at line 67 of file DecisionAccess.cxx.

{
  return chainGroup->isPassedBits();
}

isPassedBitsForEach() [1/2]

std::vector< unsigned int > Trig::DecisionAccess::isPassedBitsForEach

(

const std::string &

chain

)

const

Definition at line 85 of file DecisionAccess.cxx.

{
  const Trig::ChainGroup *g = cgm()->createChainGroup(Trig::convertStringToVector(chain));
  return g->isPassedBitsForEach();
}

isPassedBitsForEach() [2/2]

std::vector< unsigned int > Trig::DecisionAccess::isPassedBitsForEach

(

const Trig::ChainGroup *

chaingroup

)

const

Return the result of isPassedBits for each chain in the group.

Definition at line 79 of file DecisionAccess.cxx.

{
  return chainGroup->isPassedBitsForEach();
}

isPassedForEach() [1/2]

std::vector< bool > Trig::DecisionAccess::isPassedForEach	(	const std::string &	chain,
		unsigned int	condition = TrigDefs::Physics
	)		const

return decision for each chain defined by given pattern

See also

Trig::ChainGroup

TrigDefs::Conditions

Definition at line 60 of file DecisionAccess.cxx.

{
  const Trig::ChainGroup *g = cgm()->createChainGroup(Trig::convertStringToVector(chain));
  return g->isPassedForEach(condition);
}

isPassedForEach() [2/2]

std::vector< bool > Trig::DecisionAccess::isPassedForEach	(	const Trig::ChainGroup *	chainGroup,
		unsigned int	condition = TrigDefs::Physics
	)		const

return decision for each chain in group

See also

Trig::ChainGroup

TrigDefs::Conditions

Definition at line 53 of file DecisionAccess.cxx.

{
  return chainGroup->isPassedForEach(condition);
}

msg() [1/2]

MsgStream& Trig::Logger::msg ( ) const

inlineinherited

Definition at line 29 of file Trigger/TrigAnalysis/TrigDecisionTool/TrigDecisionTool/Logger.h.

                           {
      if (s_logger) return s_logger->msg();
      else throw std::runtime_error("TrigDecisionTool Logger not initialized.");
    }

msg() [2/2]

MsgStream& Trig::Logger::msg ( const MSG::Level  lvl ) const

inlineinherited

Definition at line 33 of file Trigger/TrigAnalysis/TrigDecisionTool/TrigDecisionTool/Logger.h.

{ return msg() << lvl; }

msgLvl()

bool Trig::Logger::msgLvl ( const MSG::Level  lvl ) const

inlineinherited

Definition at line 34 of file Trigger/TrigAnalysis/TrigDecisionTool/TrigDecisionTool/Logger.h.

{ return s_logger && s_logger->msgLvl(lvl); }

Friends And Related Function Documentation

Combination

friend class Combination

friend

Definition at line 269 of file DecisionAccess.h.

Member Data Documentation

ATLAS_THREAD_SAFE

asg::AsgTool* s_logger Trig::Logger::ATLAS_THREAD_SAFE {nullptr}

inlinestaticprivateinherited

Definition at line 38 of file Trigger/TrigAnalysis/TrigDecisionTool/TrigDecisionTool/Logger.h.

---

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

• DecisionAccess.h
• DecisionAccess.cxx