ATLAS Offline Software
Classes | Public Types | Public Member Functions | Public Attributes | Protected Member Functions | Protected Attributes | Private Types | Private Member Functions | Private Attributes | List of all members
PprMonitorAlgorithm Class Reference

#include <PprMonitorAlgorithm.h>

Inheritance diagram for PprMonitorAlgorithm:
Collaboration diagram for PprMonitorAlgorithm:

Classes

struct  MonitorTT
 Struct to contain PPM trigger tower info. More...
 

Public Types

enum  Environment_t {
  Environment_t::user = 0, Environment_t::online, Environment_t::tier0, Environment_t::tier0Raw,
  Environment_t::tier0ESD, Environment_t::AOD, Environment_t::altprod
}
 Specifies the processing environment. More...
 
enum  DataType_t {
  DataType_t::userDefined = 0, DataType_t::monteCarlo, DataType_t::collisions, DataType_t::cosmics,
  DataType_t::heavyIonCollisions
}
 Specifies what type of input data is being monitored. More...
 

Public Member Functions

 PprMonitorAlgorithm (const std::string &name, ISvcLocator *pSvcLocator)
 
virtual ~PprMonitorAlgorithm ()=default
 
virtual StatusCode initialize () override
 initialize More...
 
virtual StatusCode fillHistograms (const EventContext &ctx) const override
 adds event to the monitoring histograms More...
 
virtual StatusCode execute (const EventContext &ctx) const override
 Applies filters and trigger requirements. More...
 
void fill (const ToolHandle< GenericMonitoringTool > &groupHandle, std::vector< std::reference_wrapper< Monitored::IMonitoredVariable >> &&variables) const
 Fills a vector of variables to a group by reference. More...
 
void fill (const ToolHandle< GenericMonitoringTool > &groupHandle, const std::vector< std::reference_wrapper< Monitored::IMonitoredVariable >> &variables) const
 Fills a vector of variables to a group by reference. More...
 
template<typename... T>
void fill (const ToolHandle< GenericMonitoringTool > &groupHandle, T &&... variables) const
 Fills a variadic list of variables to a group by reference. More...
 
void fill (const std::string &groupName, std::vector< std::reference_wrapper< Monitored::IMonitoredVariable >> &&variables) const
 Fills a vector of variables to a group by name. More...
 
void fill (const std::string &groupName, const std::vector< std::reference_wrapper< Monitored::IMonitoredVariable >> &variables) const
 Fills a vector of variables to a group by name. More...
 
template<typename... T>
void fill (const std::string &groupName, T &&... variables) const
 Fills a variadic list of variables to a group by name. More...
 
Environment_t environment () const
 Accessor functions for the environment. More...
 
Environment_t envStringToEnum (const std::string &str) const
 Convert the environment string from the python configuration to an enum object. More...
 
DataType_t dataType () const
 Accessor functions for the data type. More...
 
DataType_t dataTypeStringToEnum (const std::string &str) const
 Convert the data type string from the python configuration to an enum object. More...
 
const ToolHandle< GenericMonitoringTool > & getGroup (const std::string &name) const
 Get a specific monitoring tool from the tool handle array. More...
 
const ToolHandle< Trig::TrigDecisionTool > & getTrigDecisionTool () const
 Get the trigger decision tool member. More...
 
bool trigChainsArePassed (const std::vector< std::string > &vTrigNames) const
 Check whether triggers are passed. More...
 
SG::ReadHandle< xAOD::EventInfo > GetEventInfo (const EventContext &) const
 Return a ReadHandle for an EventInfo object (get run/event numbers, etc.) More...
 
virtual float lbAverageInteractionsPerCrossing (const EventContext &ctx=Gaudi::Hive::currentContext()) const
 Calculate the average mu, i.e. More...
 
virtual float lbInteractionsPerCrossing (const EventContext &ctx=Gaudi::Hive::currentContext()) const
 Calculate instantaneous number of interactions, i.e. More...
 
virtual float lbAverageLuminosity (const EventContext &ctx=Gaudi::Hive::currentContext()) const
 Calculate average luminosity (in ub-1 s-1 => 10^30 cm-2 s-1). More...
 
virtual float lbLuminosityPerBCID (const EventContext &ctx=Gaudi::Hive::currentContext()) const
 Calculate the instantaneous luminosity per bunch crossing. More...
 
virtual double lbDuration (const EventContext &ctx=Gaudi::Hive::currentContext()) const
 Calculate the duration of the luminosity block (in seconds) More...
 
virtual float lbAverageLivefraction (const EventContext &ctx=Gaudi::Hive::currentContext()) const
 Calculate the average luminosity livefraction. More...
 
virtual float livefractionPerBCID (const EventContext &ctx=Gaudi::Hive::currentContext()) const
 Calculate the live fraction per bunch crossing ID. More...
 
virtual double lbLumiWeight (const EventContext &ctx=Gaudi::Hive::currentContext()) const
 Calculate the average integrated luminosity multiplied by the live fraction. More...
 
virtual StatusCode parseList (const std::string &line, std::vector< std::string > &result) const
 Parse a string into a vector. More...
 
virtual StatusCode sysInitialize () override
 Override sysInitialize. More...
 
virtual bool isClonable () const override
 Specify if the algorithm is clonable. More...
 
virtual unsigned int cardinality () const override
 Cardinality (Maximum number of clones that can exist) special value 0 means that algorithm is reentrant. More...
 
virtual StatusCode sysExecute (const EventContext &ctx) override
 Execute an algorithm. More...
 
virtual const DataObjIDColl & extraOutputDeps () const override
 Return the list of extra output dependencies. More...
 
virtual bool filterPassed (const EventContext &ctx) const
 
virtual void setFilterPassed (bool state, const EventContext &ctx) const
 
ServiceHandle< StoreGateSvc > & evtStore ()
 The standard StoreGateSvc (event store) Returns (kind of) a pointer to the StoreGateSvc. More...
 
const ServiceHandle< StoreGateSvc > & evtStore () const
 The standard StoreGateSvc (event store) Returns (kind of) a pointer to the StoreGateSvc. More...
 
const ServiceHandle< StoreGateSvc > & detStore () const
 The standard StoreGateSvc/DetectorStore Returns (kind of) a pointer to the StoreGateSvc. More...
 
virtual StatusCode sysStart () override
 Handle START transition. More...
 
virtual std::vector< Gaudi::DataHandle * > inputHandles () const override
 Return this algorithm's input handles. More...
 
virtual std::vector< Gaudi::DataHandle * > outputHandles () const override
 Return this algorithm's output handles. More...
 
Gaudi::Details::PropertyBase & declareProperty (Gaudi::Property< T > &t)
 
Gaudi::Details::PropertyBase * declareProperty (const std::string &name, SG::VarHandleKey &hndl, const std::string &doc, const SG::VarHandleKeyType &)
 Declare a new Gaudi property. More...
 
Gaudi::Details::PropertyBase * declareProperty (const std::string &name, SG::VarHandleBase &hndl, const std::string &doc, const SG::VarHandleType &)
 Declare a new Gaudi property. More...
 
Gaudi::Details::PropertyBase * declareProperty (const std::string &name, SG::VarHandleKeyArray &hndArr, const std::string &doc, const SG::VarHandleKeyArrayType &)
 
Gaudi::Details::PropertyBase * declareProperty (const std::string &name, T &property, const std::string &doc, const SG::NotHandleType &)
 Declare a new Gaudi property. More...
 
Gaudi::Details::PropertyBase * declareProperty (const std::string &name, T &property, const std::string &doc="none")
 Declare a new Gaudi property. More...
 
void updateVHKA (Gaudi::Details::PropertyBase &)
 
MsgStream & msg () const
 
MsgStream & msg (const MSG::Level lvl) const
 
bool msgLvl (const MSG::Level lvl) const
 

Public Attributes

 flags
 
 MaxEvents
 
 Files
 
 HISTFileName
 
 cfg
 
 PprMonitorCfg
 
 OutputLevel
 
 withDetails
 
 True
 
 summariseProps
 

Protected Member Functions

void renounceArray (SG::VarHandleKeyArray &handlesArray)
 remove all handles from I/O resolution More...
 
std::enable_if_t< std::is_void_v< std::result_of_t< decltype(&T::renounce)(T)> > &&!std::is_base_of_v< SG::VarHandleKeyArray, T > &&std::is_base_of_v< Gaudi::DataHandle, T >, void > renounce (T &h)
 
void extraDeps_update_handler (Gaudi::Details::PropertyBase &ExtraDeps)
 Add StoreName to extra input/output deps as needed. More...
 

Protected Attributes

ToolHandleArray< GenericMonitoringTool > m_tools {this,"GMTools",{}}
 Array of Generic Monitoring Tools. More...
 
PublicToolHandle< Trig::TrigDecisionTool > m_trigDecTool {this, "TrigDecisionTool",""}
 Tool to tell whether a specific trigger is passed. More...
 
ToolHandleArray< IDQFilterTool > m_DQFilterTools {this,"FilterTools",{}}
 Array of Data Quality filter tools. More...
 
SG::ReadCondHandleKey< LuminosityCondData > m_lumiDataKey {this,"LuminosityCondDataKey","LuminosityCondData","SG Key of LuminosityCondData object"}
 
SG::ReadCondHandleKey< LBDurationCondData > m_lbDurationDataKey {this,"LBDurationCondDataKey","LBDurationCondData","SG Key of LBDurationCondData object"}
 
SG::ReadCondHandleKey< TrigLiveFractionCondData > m_trigLiveFractionDataKey {this,"TrigLiveFractionCondDataKey","TrigLiveFractionCondData", "SG Key of TrigLiveFractionCondData object"}
 
AthMonitorAlgorithm::Environment_t m_environment
 Instance of the Environment_t enum. More...
 
AthMonitorAlgorithm::DataType_t m_dataType
 Instance of the DataType_t enum. More...
 
Gaudi::Property< std::string > m_environmentStr {this,"Environment","user"}
 Environment string pulled from the job option and converted to enum. More...
 
Gaudi::Property< std::string > m_dataTypeStr {this,"DataType","userDefined"}
 DataType string pulled from the job option and converted to enum. More...
 
Gaudi::Property< std::string > m_triggerChainString {this,"TriggerChain",""}
 Trigger chain string pulled from the job option and parsed into a vector. More...
 
std::vector< std::string > m_vTrigChainNames
 Vector of trigger chain names parsed from trigger chain string. More...
 
Gaudi::Property< std::string > m_fileKey {this,"FileKey",""}
 Internal Athena name for file. More...
 
Gaudi::Property< bool > m_useLumi {this,"EnableLumi",false}
 Allows use of various luminosity functions. More...
 
Gaudi::Property< float > m_defaultLBDuration {this,"DefaultLBDuration",60.}
 Default duration of one lumi block. More...
 
Gaudi::Property< int > m_detailLevel {this,"DetailLevel",0}
 Sets the level of detail used in the monitoring. More...
 
SG::ReadHandleKey< xAOD::EventInfo > m_EventInfoKey {this,"EventInfoKey","EventInfo"}
 Key for retrieving EventInfo from StoreGate. More...
 

Private Types

typedef std::vector< int > ErrorVector
 
typedef std::vector< std::reference_wrapper< Monitored::IMonitoredVariable > > MonVarVec_t
 
typedef ServiceHandle< StoreGateSvc > StoreGateSvc_t
 

Private Member Functions

StatusCode makePPMTower (const xAOD::TriggerTower_v2 *tt, std::vector< MonitorTT > &vecMonTT) const
 Helper functions. More...
 
double recTime (const std::vector< short unsigned int > &vFADC, int cut) const
 
std::string getPartition (int layer, double eta) const
 
StatusCode fillPPMEtaPhi (MonitorTT &monTT, const std::string &groupName, const std::string &weightName, double weight=1.) const
 
StatusCode fillPPMPhi (MonitorTT &monTT, const std::string &groupName) const
 
Gaudi::Details::PropertyBase & declareGaudiProperty (Gaudi::Property< T > &hndl, const SG::VarHandleKeyType &)
 specialization for handling Gaudi::Property<SG::VarHandleKey> More...
 
Gaudi::Details::PropertyBase & declareGaudiProperty (Gaudi::Property< T > &hndl, const SG::VarHandleKeyArrayType &)
 specialization for handling Gaudi::Property<SG::VarHandleKeyArray> More...
 
Gaudi::Details::PropertyBase & declareGaudiProperty (Gaudi::Property< T > &hndl, const SG::VarHandleType &)
 specialization for handling Gaudi::Property<SG::VarHandleBase> More...
 
Gaudi::Details::PropertyBase & declareGaudiProperty (Gaudi::Property< T > &t, const SG::NotHandleType &)
 specialization for handling everything that's not a Gaudi::Property<SG::VarHandleKey> or a <SG::VarHandleKeyArray> More...
 

Private Attributes

StringProperty m_packageName {this,"PackageName","PprMonitor","group name for histogramming"}
 
SG::ReadHandleKey< xAOD::TriggerTowerContainer > m_xAODTriggerTowerContainerName {this, "BS_xAODTriggerTowerContainer",LVL1::TrigT1CaloDefs::xAODTriggerTowerLocation,"Trigger Tower Container"}
 container keys including steering parameter and description More...
 
Gaudi::Property< double > m_phiScaleTT {this, "phiScaleTT", 32./M_PI, "Scale factor to convert trigger tower phi to integer binning"}
 Properties. More...
 
Gaudi::Property< int > m_TT_ADC_HitMap_Thresh {this, "TT_ADC_HitMap_Thresh", 50, "ADC cut for hit maps"}
 
Gaudi::Property< int > m_SliceNo {this, "SliceNo", 15, "Number of possible time slices in the readout"}
 
Gaudi::Property< int > m_EMFADCCut {this, "EMFADCCut", 40, "EM FADC cut for signal"}
 
Gaudi::Property< int > m_TT_ADC_Pedestal {this, "ADCPedestal", 32, "Nominal pedestal value"}
 
Gaudi::Property< std::vector< int > > m_TT_HitMap_ThreshVec {this, "LUTHitMap_ThreshVec", {0, 1, 3, 5, 10, 20, 30, 50}, "Thresholds for LUT hitmaps"}
 
std::map< std::string, int > m_groupTimeslice_EM
 Groups for GenericMonitoringArrays. More...
 
std::map< std::string, int > m_groupTimeslice_HAD
 
SG::WriteHandleKey< std::vector< int > > m_errorLocation {this,"ErrorLocationPPM","L1CaloPPMErrorVector","ErrorVector"}
 
std::mutex m_mutex {}
 
std::map< uint32_t, int > m_errorLB_tt_counter ATLAS_THREAD_SAFE
 
std::string m_name
 
std::unordered_map< std::string, size_t > m_toolLookupMap
 
const ToolHandle< GenericMonitoringTool > m_dummy
 
Gaudi::Property< bool > m_enforceExpressTriggers
 
DataObjIDColl m_extendedExtraObjects
 Extra output dependency collection, extended by AthAlgorithmDHUpdate to add symlinks. More...
 
StoreGateSvc_t m_evtStore
 Pointer to StoreGate (event store by default) More...
 
StoreGateSvc_t m_detStore
 Pointer to StoreGate (detector store by default) More...
 
std::vector< SG::VarHandleKeyArray * > m_vhka
 
bool m_varHandleArraysDeclared
 

Detailed Description

Definition at line 12 of file PprMonitorAlgorithm.h.

Member Typedef Documentation

◆ ErrorVector

typedef std::vector<int> PprMonitorAlgorithm::ErrorVector
private

Definition at line 51 of file PprMonitorAlgorithm.h.

◆ MonVarVec_t

typedef std::vector<std::reference_wrapper<Monitored::IMonitoredVariable> > AthMonitorAlgorithm::MonVarVec_t
privateinherited

Definition at line 365 of file AthMonitorAlgorithm.h.

◆ StoreGateSvc_t

typedef ServiceHandle<StoreGateSvc> AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::StoreGateSvc_t
privateinherited

Definition at line 388 of file AthCommonDataStore.h.

Member Enumeration Documentation

◆ DataType_t

enum AthMonitorAlgorithm::DataType_t
stronginherited

Specifies what type of input data is being monitored.

An enumeration of the different types of data the monitoring application may be running over. This can be used to select which histograms to produce, e.g. to prevent the production of colliding-beam histograms when running on cosmic-ray data. Strings of the same names may be given as jobOptions.

Enumerator
userDefined 
monteCarlo 
collisions 
cosmics 
heavyIonCollisions 

Definition at line 191 of file AthMonitorAlgorithm.h.

191  {
192  userDefined = 0,
193  monteCarlo,
194  collisions,
195  cosmics,
196  heavyIonCollisions,
197  };

◆ Environment_t

enum AthMonitorAlgorithm::Environment_t
stronginherited

Specifies the processing environment.

The running environment may be used to select which histograms are produced, and where they are located in the output. For example, the output paths of the histograms are different for the "user", "online" and the various offline flags. Strings of the same names may be given as jobOptions.

Enumerator
user 
online 
tier0 
tier0Raw 
tier0ESD 
AOD 
altprod 

Definition at line 172 of file AthMonitorAlgorithm.h.

172  {
173  user = 0,
174  online,
175  tier0,
176  tier0Raw,
177  tier0ESD,
178  AOD,
179  altprod,
180  };

Constructor & Destructor Documentation

◆ PprMonitorAlgorithm()

PprMonitorAlgorithm::PprMonitorAlgorithm ( const std::string &  name,
ISvcLocator *  pSvcLocator 
)

Definition at line 18 of file PprMonitorAlgorithm.cxx.

19  : AthMonitorAlgorithm(name,pSvcLocator)
20 {
21 }

◆ ~PprMonitorAlgorithm()

virtual PprMonitorAlgorithm::~PprMonitorAlgorithm ( )
virtualdefault

Member Function Documentation

◆ cardinality()

unsigned int AthReentrantAlgorithm::cardinality ( ) const
overridevirtualinherited

Cardinality (Maximum number of clones that can exist) special value 0 means that algorithm is reentrant.

Override this to return 0 for reentrant algorithms.

Override this to return 0 for reentrant algorithms.

Definition at line 55 of file AthReentrantAlgorithm.cxx.

56 {
57  return 0;
58 }

◆ dataType()

DataType_t AthMonitorAlgorithm::dataType ( ) const
inlineinherited

Accessor functions for the data type.

Returns
the current value of the class's DataType_t instance.

Definition at line 221 of file AthMonitorAlgorithm.h.

221 { return m_dataType; }

◆ dataTypeStringToEnum()

AthMonitorAlgorithm::DataType_t AthMonitorAlgorithm::dataTypeStringToEnum ( const std::string &  str) const
inherited

Convert the data type string from the python configuration to an enum object.

Returns
a value in the DataType_t enumeration which matches the input string.

Definition at line 140 of file AthMonitorAlgorithm.cxx.

140  {
141  // convert the string to all lowercase
142  std::string lowerCaseStr = str;
143  std::transform(lowerCaseStr.begin(), lowerCaseStr.end(), lowerCaseStr.begin(), ::tolower);
144 
145  // check if it matches one of the enum choices
146  if( lowerCaseStr == "userdefined" ) {
147  return DataType_t::userDefined;
148  } else if( lowerCaseStr == "montecarlo" ) {
149  return DataType_t::monteCarlo;
150  } else if( lowerCaseStr == "collisions" ) {
151  return DataType_t::collisions;
152  } else if( lowerCaseStr == "cosmics" ) {
153  return DataType_t::cosmics;
154  } else if( lowerCaseStr == "heavyioncollisions" ) {
155  return DataType_t::heavyIonCollisions;
156  } else { // otherwise, warn the user and return "userDefined"
157  ATH_MSG_WARNING("AthMonitorAlgorithm::dataTypeStringToEnum(): Unknown data type "
158  <<str<<", returning userDefined.");
159  return DataType_t::userDefined;
160  }
161 }

◆ declareGaudiProperty() [1/4]

Gaudi::Details::PropertyBase& AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::declareGaudiProperty ( Gaudi::Property< T > &  hndl,
const SG::VarHandleKeyArrayType &   
)
inlineprivateinherited

specialization for handling Gaudi::Property<SG::VarHandleKeyArray>

Definition at line 170 of file AthCommonDataStore.h.

172  {
173  return *AthCommonDataStore<PBASE>::declareProperty(hndl.name(),
174  hndl.value(),
175  hndl.documentation());
176 
177  }

◆ declareGaudiProperty() [2/4]

Gaudi::Details::PropertyBase& AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::declareGaudiProperty ( Gaudi::Property< T > &  hndl,
const SG::VarHandleKeyType &   
)
inlineprivateinherited

specialization for handling Gaudi::Property<SG::VarHandleKey>

Definition at line 156 of file AthCommonDataStore.h.

158  {
159  return *AthCommonDataStore<PBASE>::declareProperty(hndl.name(),
160  hndl.value(),
161  hndl.documentation());
162 
163  }

◆ declareGaudiProperty() [3/4]

Gaudi::Details::PropertyBase& AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::declareGaudiProperty ( Gaudi::Property< T > &  hndl,
const SG::VarHandleType &   
)
inlineprivateinherited

specialization for handling Gaudi::Property<SG::VarHandleBase>

Definition at line 184 of file AthCommonDataStore.h.

186  {
187  return *AthCommonDataStore<PBASE>::declareProperty(hndl.name(),
188  hndl.value(),
189  hndl.documentation());
190  }

◆ declareGaudiProperty() [4/4]

Gaudi::Details::PropertyBase& AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::declareGaudiProperty ( Gaudi::Property< T > &  t,
const SG::NotHandleType &   
)
inlineprivateinherited

specialization for handling everything that's not a Gaudi::Property<SG::VarHandleKey> or a <SG::VarHandleKeyArray>

Definition at line 199 of file AthCommonDataStore.h.

200  {
201  return PBASE::declareProperty(t);
202  }

◆ declareProperty() [1/6]

Gaudi::Details::PropertyBase* AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::declareProperty ( const std::string &  name,
SG::VarHandleBase &  hndl,
const std::string &  doc,
const SG::VarHandleType &   
)
inlineinherited

Declare a new Gaudi property.

Parameters
nameName of the property.
hndlObject holding the property value.
docDocumentation string for the property.

This is the version for types that derive from SG::VarHandleBase. The property value object is put on the input and output lists as appropriate; then we forward to the base class.

Definition at line 245 of file AthCommonDataStore.h.

249  {
250  this->declare(hndl.vhKey());
251  hndl.vhKey().setOwner(this);
252 
253  return PBASE::declareProperty(name,hndl,doc);
254  }

◆ declareProperty() [2/6]

Gaudi::Details::PropertyBase* AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::declareProperty ( const std::string &  name,
SG::VarHandleKey &  hndl,
const std::string &  doc,
const SG::VarHandleKeyType &   
)
inlineinherited

Declare a new Gaudi property.

Parameters
nameName of the property.
hndlObject holding the property value.
docDocumentation string for the property.

This is the version for types that derive from SG::VarHandleKey. The property value object is put on the input and output lists as appropriate; then we forward to the base class.

Definition at line 221 of file AthCommonDataStore.h.

225  {
226  this->declare(hndl);
227  hndl.setOwner(this);
228 
229  return PBASE::declareProperty(name,hndl,doc);
230  }

◆ declareProperty() [3/6]

Gaudi::Details::PropertyBase* AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::declareProperty ( const std::string &  name,
SG::VarHandleKeyArray &  hndArr,
const std::string &  doc,
const SG::VarHandleKeyArrayType &   
)
inlineinherited

Definition at line 259 of file AthCommonDataStore.h.

263  {
264 
265  // std::ostringstream ost;
266  // ost << Algorithm::name() << " VHKA declareProp: " << name
267  // << " size: " << hndArr.keys().size()
268  // << " mode: " << hndArr.mode()
269  // << " vhka size: " << m_vhka.size()
270  // << "\n";
271  // debug() << ost.str() << endmsg;
272 
273  hndArr.setOwner(this);
274  m_vhka.push_back(&hndArr);
275 
276  Gaudi::Details::PropertyBase* p = PBASE::declareProperty(name, hndArr, doc);
277  if (p != 0) {
278  p->declareUpdateHandler(&AthCommonDataStore<PBASE>::updateVHKA, this);
279  } else {
280  ATH_MSG_ERROR("unable to call declareProperty on VarHandleKeyArray "
281  << name);
282  }
283 
284  return p;
285 
286  }

◆ declareProperty() [4/6]

Gaudi::Details::PropertyBase* AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::declareProperty ( const std::string &  name,
T &  property,
const std::string &  doc,
const SG::NotHandleType &   
)
inlineinherited

Declare a new Gaudi property.

Parameters
nameName of the property.
propertyObject holding the property value.
docDocumentation string for the property.

This is the generic version, for types that do not derive from SG::VarHandleKey. It just forwards to the base class version of declareProperty.

Definition at line 333 of file AthCommonDataStore.h.

337  {
338  return PBASE::declareProperty(name, property, doc);
339  }

◆ declareProperty() [5/6]

Gaudi::Details::PropertyBase* AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::declareProperty ( const std::string &  name,
T &  property,
const std::string &  doc = "none" 
)
inlineinherited

Declare a new Gaudi property.

Parameters
nameName of the property.
propertyObject holding the property value.
docDocumentation string for the property.

This dispatches to either the generic declareProperty or the one for VarHandle/Key/KeyArray.

Definition at line 352 of file AthCommonDataStore.h.

355  {
356  typedef typename SG::HandleClassifier<T>::type htype;
357  return declareProperty (name, property, doc, htype());
358  }

◆ declareProperty() [6/6]

Gaudi::Details::PropertyBase& AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::declareProperty ( Gaudi::Property< T > &  t)
inlineinherited

Definition at line 145 of file AthCommonDataStore.h.

145  {
146  typedef typename SG::HandleClassifier<T>::type htype;
147  return AthCommonDataStore<PBASE>::declareGaudiProperty(t, htype());
148  }

◆ detStore()

const ServiceHandle<StoreGateSvc>& AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::detStore ( ) const
inlineinherited

The standard StoreGateSvc/DetectorStore Returns (kind of) a pointer to the StoreGateSvc.

Definition at line 95 of file AthCommonDataStore.h.

95 { return m_detStore; }

◆ environment()

Environment_t AthMonitorAlgorithm::environment ( ) const
inlineinherited

Accessor functions for the environment.

Returns
the current value of the class's Environment_t instance.

Definition at line 205 of file AthMonitorAlgorithm.h.

205 { return m_environment; }

◆ envStringToEnum()

AthMonitorAlgorithm::Environment_t AthMonitorAlgorithm::envStringToEnum ( const std::string &  str) const
inherited

Convert the environment string from the python configuration to an enum object.

Returns
a value in the Environment_t enumeration which matches the input string.

Definition at line 112 of file AthMonitorAlgorithm.cxx.

112  {
113  // convert the string to all lowercase
114  std::string lowerCaseStr = str;
115  std::transform(lowerCaseStr.begin(), lowerCaseStr.end(), lowerCaseStr.begin(), ::tolower);
116 
117  // check if it matches one of the enum choices
118  if( lowerCaseStr == "user" ) {
119  return Environment_t::user;
120  } else if( lowerCaseStr == "online" ) {
121  return Environment_t::online;
122  } else if( lowerCaseStr == "tier0" ) {
123  return Environment_t::tier0;
124  } else if( lowerCaseStr == "tier0raw" ) {
125  return Environment_t::tier0Raw;
126  } else if( lowerCaseStr == "tier0esd" ) {
127  return Environment_t::tier0ESD;
128  } else if( lowerCaseStr == "aod" ) {
129  return Environment_t::AOD;
130  } else if( lowerCaseStr == "altprod" ) {
131  return Environment_t::altprod;
132  } else { // otherwise, warn the user and return "user"
133  ATH_MSG_WARNING("AthMonitorAlgorithm::envStringToEnum(): Unknown environment "
134  <<str<<", returning user.");
135  return Environment_t::user;
136  }
137 }

◆ evtStore() [1/2]

ServiceHandle<StoreGateSvc>& AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::evtStore ( )
inlineinherited

The standard StoreGateSvc (event store) Returns (kind of) a pointer to the StoreGateSvc.

Definition at line 85 of file AthCommonDataStore.h.

85 { return m_evtStore; }

◆ evtStore() [2/2]

const ServiceHandle<StoreGateSvc>& AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::evtStore ( ) const
inlineinherited

The standard StoreGateSvc (event store) Returns (kind of) a pointer to the StoreGateSvc.

Definition at line 90 of file AthCommonDataStore.h.

90 { return m_evtStore; }

◆ execute()

StatusCode AthMonitorAlgorithm::execute ( const EventContext &  ctx) const
overridevirtualinherited

Applies filters and trigger requirements.

Then, calls fillHistograms().

Parameters
ctxevent context for reentrant Athena call
Returns
StatusCode

Definition at line 73 of file AthMonitorAlgorithm.cxx.

73  {
74 
75  // Checks that all of the DQ filters are passed. If any one of the filters
76  // fails, return SUCCESS code and do not fill the histograms with the event.
77  for ( const auto& filterItr : m_DQFilterTools ) {
78  if (!filterItr->accept()) {
79  ATH_MSG_DEBUG("Event rejected due to filter tool.");
80  return StatusCode::SUCCESS;
81  }
82  }
83 
84  // Trigger: If there is a decision tool and the chains fail, skip the event.
85  if ( !m_trigDecTool.empty() && !trigChainsArePassed(m_vTrigChainNames) ) {
86  ATH_MSG_DEBUG("Event rejected due to trigger filter.");
87  return StatusCode::SUCCESS;
88  }
89 
90  ATH_MSG_DEBUG("Event accepted!");
91  return fillHistograms(ctx);
92 }

◆ extraDeps_update_handler()

void AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::extraDeps_update_handler ( Gaudi::Details::PropertyBase &  ExtraDeps)
protectedinherited

Add StoreName to extra input/output deps as needed.

use the logic of the VarHandleKey to parse the DataObjID keys supplied via the ExtraInputs and ExtraOuputs Properties to add the StoreName if it's not explicitly given

◆ extraOutputDeps()

const DataObjIDColl & AthReentrantAlgorithm::extraOutputDeps ( ) const
overridevirtualinherited

Return the list of extra output dependencies.

This list is extended to include symlinks implied by inheritance relations.

Definition at line 79 of file AthReentrantAlgorithm.cxx.

80 {
81  // If we didn't find any symlinks to add, just return the collection
82  // from the base class. Otherwise, return the extended collection.
83  if (!m_extendedExtraObjects.empty()) {
84  return m_extendedExtraObjects;
85  }
86  return Algorithm::extraOutputDeps();
87 }

◆ fillHistograms()

StatusCode PprMonitorAlgorithm::fillHistograms ( const EventContext &  ctx) const
overridevirtual

adds event to the monitoring histograms

User will overwrite this function. Histogram booking is no longer done in C++. This function is called in execute once the filters are all passed.

Parameters
ctxforwarded from execute
Returns
StatusCode

Implements AthMonitorAlgorithm.

Definition at line 45 of file PprMonitorAlgorithm.cxx.

45  {
46 
47  ATH_MSG_DEBUG("PprMonitorAlgorithm::fillHistograms");
48 
49  // Retrieve event info from SG
50 
51  uint32_t bunchCrossing = 0;
52  bunchCrossing = ctx.eventID().bunch_crossing_id();
53  ATH_MSG_DEBUG("BCID: " << bunchCrossing);
54  const long long eventNumber = ctx.eventID().event_number();
55  ATH_MSG_DEBUG("Event Number" << eventNumber);
56 
57 
58  // Retrieve Trigger Towers from SG
59  SG::ReadHandle<xAOD::TriggerTowerContainer> triggerTowerTES(m_xAODTriggerTowerContainerName, ctx);
60  if(!triggerTowerTES.isValid()){
61  ATH_MSG_ERROR("No Trigger Tower container found in TES "<< m_xAODTriggerTowerContainerName);
62  return StatusCode::FAILURE;
63  }
64 
65  // Create a vector of trigger towers with quantities to be monitored
66  std::vector<MonitorTT> vecMonTT; // All towers
67 
68  // Loop over trigger tower container
69  // Create the trigger tower objects and calculate scaled phi
70  for (const xAOD::TriggerTower* tt : *triggerTowerTES) {
71  ATH_CHECK( makePPMTower(tt, vecMonTT) );
72  }
73 
74  // Error vector for global overview
75  ErrorVector overview(8);
76  // Trigger tower error flag
77  bool triggerTowerHasError = false;
78 
79  // Loop over the trigger tower objects and fill the histograms
80 
81  for (auto& myTower : vecMonTT) {
82  ATH_MSG_DEBUG("PprMonitorAlgorithm looping over TTs");
83  // -------- LUT --------
84  int cpET = (myTower.tower)->cpET();
85  int jepET = myTower.jepET;
86  int layer = (myTower.tower)->layer();
87  bool isEM = (layer == 0);
88  bool isHAD = (layer == 1);
89  std::string layerName = (layer == 0) ? "EM" : "HAD";
90 
91  ATH_MSG_DEBUG("isEM " << isEM << " isHAD " << isHAD << " layerName " << layerName);
92  ATH_MSG_DEBUG("cpET: " << cpET << " jepET: " << jepET);
93 
94  // The variables to plot
95  auto eta_TT = Monitored::Scalar<double>("eta_TT", myTower.tower->eta());
96  auto cpET_TT = Monitored::Scalar<int>("cpET_TT", cpET);
97  auto jepET_TT = Monitored::Scalar<int>("jepET_TT", jepET);
98  auto BCID = Monitored::Scalar<uint32_t>("BCID", bunchCrossing);
99 
100  // The cutmasks
101  auto mask_EM = Monitored::Scalar<bool>("mask_EM", isEM);
102  auto mask_HAD = Monitored::Scalar<bool>("mask_HAD", isHAD);
103  auto mask_cpET_0 = Monitored::Scalar<bool>("mask_cpET_0", cpET > 0 );
104  auto mask_jepET_0 = Monitored::Scalar<bool>("mask_jepET_0", jepET > 0 );
105  auto mask_cpET_5 = Monitored::Scalar<bool>("mask_cpET_5", cpET > 5);
106  auto mask_jepET_5 = Monitored::Scalar<bool>("mask_jepET_5", jepET > 5);
107 
108  // Fill LUT histograms (layer-independent)
109  std::string groupName = "groupLUTCP";
110  fill(groupName, BCID, mask_cpET_5); // ppm_1d_tt_lutcp_LutPerBCN
111 
112  groupName = "groupLUTJEP";
113  fill(groupName, BCID, mask_jepET_5); // ppm_1d_tt_lutjep_LutPerBCN
114 
115  // Layer-dependent LUT-CP plots (EM or HAD)
116  groupName = "groupLUTCP_";
117  groupName.append(layerName);
118 
119  // Fill LUT-CP eta and ET distributions
120  // ppm_em_1d_tt_lutcp_Eta, ppm_had_1d_tt_lutcp_Eta
121  // ppm_em_1d_tt_lutcp_Et, ppm_had_1d_tt_lutcp_Et
122  fill(groupName, eta_TT, cpET_TT, mask_cpET_0);
123 
124  // Fill LUT-CP phi distributions
125  // ppm_em_1d_tt_lutcp_Phi, ppm_had_1d_tt_lutcp_Phi
126  if (cpET > 0) {
127  ATH_CHECK( fillPPMPhi(myTower, groupName) );
128 
129  // Fill LUT-CP eta-phi maps
130  // ppm_em_2d_etaPhi_tt_lutcp_AverageEt, ppm_had_2d_etaPhi_tt_lutcp_AverageEt
131  if (cpET > 5) {
132  ATH_CHECK( fillPPMEtaPhi(myTower, groupName, "cpET_TT_2D", cpET) );
133  }
134  }
135 
136  // LUT hitmaps per threshold
137  // ppm_em_2d_etaPhi_tt_lutcp_Threshold, ppm_had_2d_etaPhi_tt_lutcp_Threshold
138 
139  for (int th : m_TT_HitMap_ThreshVec) {
140  groupName = "groupLUTCP_"+layerName+"_"+std::to_string(th)+"_LB";
141  ATH_MSG_DEBUG("Filling group " << groupName);
142  ATH_MSG_DEBUG("cpET > " << th << " ? " << (cpET > th));
143  if (cpET > th) {
144  ATH_CHECK( fillPPMEtaPhi(myTower, groupName, "", 1.) );
145  }
146  }
147 
148  // LUT-JEP
149  groupName = "groupLUTJEP_";
150  groupName.append(layerName);
151 
152  // Fill LUT-JEP eta and ET distributions
153  // ppm_em_1d_tt_lutjep_Eta, ppm_had_1d_tt_lutjep_Eta
154  // ppm_em_1d_tt_lutjep_Et, ppm_had_1d_tt_lutjep_Et
155  fill(groupName, eta_TT, jepET_TT, mask_jepET_0); // LUT-JEP eta and ET distributions
156 
157  // Fill LUT-JEP phi distributions
158  // ppm_em_1d_tt_lutjep_Phi, ppm_had_1d_tt_lutjep_Phi
159  if (jepET > 0) {
160  ATH_CHECK( fillPPMPhi(myTower, groupName) );
161 
162  // Fill LUT-JEP eta-phi maps
163  // ppm_em_2d_etaPhi_tt_lutjep_AverageEt, ppm_had_2d_etaPhi_tt_lutjep_AverageEt
164  if (jepET > 5) {
165  ATH_CHECK( fillPPMEtaPhi(myTower, groupName, "jepET_TT_2D", jepET) );
166  }
167  }
168 
169  // LUT hitmaps per threshold
170  // ppm_em_2d_etaPhi_tt_lutjep_Threshold, ppm_had_2d_etaPhi_tt_lutcp_Threshold
171 
172  for (int th : m_TT_HitMap_ThreshVec) {
173  groupName = "groupLUTJEP_"+layerName+"_"+std::to_string(th)+"_LB";
174  ATH_MSG_DEBUG("Filling group " << groupName);
175  ATH_MSG_DEBUG("jepET > " << th << " ? " << (jepET > th));
176  if (jepET > th) {
177  ATH_CHECK( fillPPMEtaPhi(myTower, groupName, "", 1.) );
178  }
179 
180  }
181 
182  // -------- ADC hitmaps per timeslice --------
183  unsigned int tslice = (myTower.tower)->adcPeak();
184  unsigned int adcSize = ((myTower.tower)->adc()).size();
185 
186  // Number of triggered timeslice
187  groupName = "groupTimeslice_";
188  groupName.append(layerName);
189 
190  auto adcPeak = Monitored::Scalar<unsigned int>("adcPeak", tslice);
191  fill(groupName, adcPeak);
192 
193  if (tslice < adcSize) {
194  groupName = "groupADC_";
195  groupName.append(layerName);
196  const int ADC = ((myTower.tower)->adc())[tslice];
197  if (ADC > m_TT_ADC_HitMap_Thresh) {
198  // Fills both ppm_em_2d_etaPhi_tt_adc_HitMap (unweighted) and ppm_em_2d_etaPhi_tt_adc_ProfileHitMap (weighted) at the same time
199  ATH_CHECK(fillPPMEtaPhi(myTower, groupName, "adcTT", ADC));
200  }
201  }
202 
203  // -------- Timing of FADC signal --------
204 
205  int max = myTower.maxADC;
206  int maxADCPlus1 = max + 1;
207  auto maxADC = Monitored::Scalar<unsigned int>("maxADC", max);
208 
209  groupName = "groupTimeslice_";
210  groupName.append(layerName);
211 
212  if (max >= 0.) {
213  fill(groupName, maxADC);
214  ATH_CHECK(fillPPMEtaPhi(myTower, groupName, "maxADCPlus1", maxADCPlus1));
215  }
216 
217  // -------- Bits of BCID logic word --------
218 
219  // ppm_2d_tt_adc_BcidBits
220  groupName = "groupTimeslice";
221 
222  auto bcidBits = Monitored::Scalar<int>("bcidBits", 0);
223  auto adcBCID = Monitored::Scalar<int>("adcBCID", 0);
224 
225  short unsigned int peak = (myTower.tower)->peak();
226 
227  if (cpET > 0 && tslice < adcSize) { // Defined above in ADC hitmaps per timeslice block
228 
229  adcBCID = ((myTower.tower)->adc())[tslice];
230  uint8_t bcidWord = (myTower.tower)->bcidVec()[peak];
231 
232  if (bcidWord == char(0) || bcidWord == char(1)) { // None (40 MHz)
233  bcidBits = 0;
234  fill(groupName, bcidBits, adcBCID);
235  }
236  else if (bcidWord == char(2) || bcidWord == char(3)) { // satBC only
237  bcidBits = 1;
238  fill(groupName, bcidBits, adcBCID);
239  }
240  else if (bcidWord == char(4) || bcidWord == char(5)) { // PF only
241  bcidBits = 2;
242  fill(groupName, bcidBits, adcBCID);
243  }
244  else if (bcidWord == char(6) || bcidWord == char(7)) { // satBC & PF
245  bcidBits = 3;
246  fill(groupName, bcidBits, adcBCID);
247  }
248  if (bcidWord == char(5) || bcidWord == char(7)) { // sat80BC & PF
249  bcidBits = 4;
250  fill(groupName, bcidBits, adcBCID);
251  }
252  if (bcidWord == char(3) || bcidWord == char(7)) { // sat80BC & sat40BC
253  bcidBits = 5;
254  fill(groupName, bcidBits, adcBCID);
255  }
256  if (bcidWord == char(1)) { // sat80BC only
257  bcidBits = 6;
258  fill(groupName, bcidBits, adcBCID);
259  }
260  }
261 
262 
263  // -------- High/low threshold pass cases (Sat80) --------
264  // ppm_1d_tt_adc_HLCase
265 
266  if (cpET > 0 && tslice < adcSize && peak < (myTower.tower)->sat80Vec().size()) {
267  auto sat80Word = Monitored::Scalar<int>("sat80Word", (myTower.tower)->sat80Vec()[peak]);
268  for(unsigned int i = 0; i < 8; i++) {
269  if (sat80Word == char(i)) fill(groupName, sat80Word);
270  }
271  }
272 
273 
274  // -------- Signal shape profile --------
275  // ppm_1d_tt_adc_SignalProfile
276 
277  const std::vector<short unsigned int> &vADC((myTower.tower)->adc());
278 
279  if (cpET > 0) {
280 
281  const std::string part = getPartition(layer, myTower.tower->eta());
282  std::vector<short unsigned int>::const_iterator it = vADC.begin();
283  std::vector<short unsigned int>::const_iterator itE = vADC.end();
284 
285  for (int s = 0; it!= itE && s < m_SliceNo; ++it, ++s) {
286  auto slice = Monitored::Scalar<int>("slice", s);
287  auto wADC = Monitored::Scalar<int>("wADC", *it);
288  if (isEM) fill(m_tools[m_groupTimeslice_EM.at(part)], slice, wADC);
289  else fill(m_tools[m_groupTimeslice_HAD.at(part)], slice, wADC);
290  }
291  } // End if cpeT > 0 (signal shape block)
292 
293 
294 
295  // -------- Pedestal correction over-/underflow --------
296 
297  // ppm_em_1d_pedOverflow_Eta, ppm_had_1d_pedOverflow_Eta
298  // ppm_em_1d_pedUnderflow_Eta, ppm_had_1d_pedUnderflow_Eta
299 
300  groupName = "groupErrors_";
301  groupName.append(layerName);
302 
303  bool isPedCorrOverflow = false;
304  bool isPedCorrUnderflow = false;
305 
306  for (auto pedCorr : (myTower.tower)->correction()) {
307  if ( pedCorr >= 511 ) isPedCorrOverflow = true;
308  else if ( pedCorr <= -512 ) isPedCorrUnderflow = true;
309  }
310 
311  auto mask_PedCorrOverflow = Monitored::Scalar<bool>("mask_PedCorrOverflow", isPedCorrOverflow);
312  auto mask_PedCorrUnderflow = Monitored::Scalar<bool>("mask_PedCorrUnderflow", isPedCorrUnderflow);
313 
314  fill(groupName, eta_TT, mask_PedCorrOverflow, mask_PedCorrUnderflow);
315 
316 
317  //------------ SubStatus Word errors ----------------
318 
319  // set maximum number of error events per lumiblock(per type) to avoid histograms with many x-bins
320  // Inspired by https://gitlab.cern.ch/atlas/athena/-/blob/22.0/Trigger/TrigT1/TrigT1CaloMonitoring/src/CpmSimMonitorAlgorithm.cxx#L267
321  const int maxErrorsPerLB = 10;
322  auto currentLumiblock = GetEventInfo(ctx)->lumiBlock();
323 
324  using LVL1::DataError;
325  if ( (myTower.tower)->errorWord()) {
326  const LVL1::DataError err((myTower.tower)->errorWord());
327  const L1CaloCoolChannelId coolId((myTower.tower)->coolId());
328  const int crate = coolId.crate();
329  const int module = coolId.module();
330  const int ypos = (crate < 4) ? module + crate * 16 : module + (crate - 4) * 16;
331 
332  auto eventMonitor= Monitored::Scalar<std::string>("eventMonitor", std::to_string(eventNumber));
333  auto y_2D = Monitored::Scalar<int>("y_2D", ypos);
334 
335  {
336  std::lock_guard<std::mutex> lock(m_mutex);
337 
338 
339  for (int bit = 0; bit < 8; ++bit) {
340  auto bit_2D = Monitored::Scalar<int>("bit_2D", bit);
341 
342  if (err.get(bit + DataError::ChannelDisabled)) {
343  if (crate < 4) fill("groupErrorField03", bit_2D, y_2D );
344  else fill("groupErrorField47", bit_2D, y_2D );
345  if (m_errorLB_tt_counter[currentLumiblock]<maxErrorsPerLB && (!triggerTowerHasError)) {
346  fill("groupASICErrorEventNumbers", eventMonitor, bit_2D );
347  m_errorLB_tt_counter[currentLumiblock]+=1;
348  triggerTowerHasError = true;
349  }
350  }
351 
352  if (err.get(bit + DataError::GLinkParity)) {
353  if (crate < 4) fill("groupStatus03", bit_2D, y_2D );
354  else fill("groupStatus47", bit_2D, y_2D );
355  fill("group1DErrorSummary", bit_2D);
356 
357  if ((m_errorLB_tt_counter[currentLumiblock]<maxErrorsPerLB) && (!triggerTowerHasError)) {
358  fill("groupErrorEventNumbers", eventMonitor, bit_2D );
359  m_errorLB_tt_counter[currentLumiblock]+=1;
360  triggerTowerHasError = true;
361  }
362 
363  }
364  }
365 
366  if (err.get(DataError::ChannelDisabled) ||
367  err.get(DataError::MCMAbsent))
368  overview[crate] |= 1;
369 
370  if (err.get(DataError::Timeout) || err.get(DataError::ASICFull) ||
371  err.get(DataError::EventMismatch) ||
372  err.get(DataError::BunchMismatch) ||
373  err.get(DataError::FIFOCorrupt) || err.get(DataError::PinParity))
374  overview[crate] |= (1 << 1);
375 
376  if (err.get(DataError::GLinkParity) ||
377  err.get(DataError::GLinkProtocol) ||
378  err.get(DataError::FIFOOverflow) ||
379  err.get(DataError::ModuleError) || err.get(DataError::GLinkDown) ||
380  err.get(DataError::GLinkTimeout) || err.get(DataError::BCNMismatch))
381  overview[crate] |= (1 << 2);
382 
383  }
384 
385  }
386 
387 
388 
389 
390  } // End loop over tower objects
391 
392  // Save error vector for global summary
393  {
394  auto save = std::make_unique<ErrorVector>(overview);
395  auto* result = SG::makeHandle(m_errorLocation, ctx).put(std::move(save));
396  if (!result) {
397  ATH_MSG_ERROR("Error recording PPM vector in TES");
398  return StatusCode::FAILURE;
399  }
400  }
401 
402 
403 
404 
405  return StatusCode::SUCCESS;
406 }

◆ fillPPMEtaPhi()

StatusCode PprMonitorAlgorithm::fillPPMEtaPhi ( MonitorTT &  monTT,
const std::string &  groupName,
const std::string &  weightName,
double  weight = 1. 
) const
private

Definition at line 521 of file PprMonitorAlgorithm.cxx.

524  {
525 
526  // Number of bins filled in phi depends on eta due to electronics coverage
527 
528  // KW to do: fill in shrinkEtaBins part
529  double phiMod = monTT.phiScaled; // Integer binning for 2D plots
530  double etaMod = monTT.tower->eta();
531  const double absEta = std::abs(etaMod);
532 
533  const std::vector<double> offset32 = {1.5, 0.5, -0.5, -1.5};
534  const std::vector<double> offset25 = {0.5, -0.5};
535  std::vector<double> offset = {};
536 
537  if (absEta > 3.2) {
538  // Fill four bins in phi
539  phiMod = std::floor(phiMod/4)*4. + 2.;
540  offset = offset32;
541  }
542  else if (absEta > 2.5) {
543  // Fill two bins in phi
544  phiMod = std::floor(phiMod/2)*2. + 1.;
545  offset = offset25;
546  }
547  else {
548  offset = {0.};
549  }
550 
551  // Fill the histograms
552  for (auto phiOffset : offset) {
553 
554  auto etaTT_2D = Monitored::Scalar<double>("etaTT_2D", etaMod);
555  auto phiTT_2D = Monitored::Scalar<double>("phiTT_2D", phiMod + phiOffset);
556  auto weight_2D = Monitored::Scalar<double>(weightName, weight); // Weight for filling 2D profile histograms; name must be included in python histogram definition
557  ATH_MSG_DEBUG("etaTT_2D: " << etaTT_2D << " phiTT_2D: " << phiTT_2D << " weight_2D: " << weight_2D);
558  ATH_MSG_DEBUG("groupName: " << groupName);
559  fill(groupName, etaTT_2D, phiTT_2D, weight_2D);
560 
561  }
562 
563  return StatusCode::SUCCESS;
564 }

◆ fillPPMPhi()

StatusCode PprMonitorAlgorithm::fillPPMPhi ( MonitorTT &  monTT,
const std::string &  groupName 
) const
private

Definition at line 566 of file PprMonitorAlgorithm.cxx.

567  {
568 
569  // Number of bins filled in phi depends on eta due to electronics coverage
570 
571  const double phi = monTT.tower->phi(); // Using the actual phi value for 1D plots
572  const double absEta = std::abs(monTT.tower->eta());
573 
574  const std::vector<double> offset32 = {1.5, 0.5, -0.5, -1.5};
575  const std::vector<double> offset25 = {0.5, -0.5};
576  std::vector<double> offset = {};
577 
578  double phi1d = phi;
579 
580  if (absEta > 3.2) {
581  // Fill four bins in phi
582  offset = offset32;
583  }
584  else if (absEta > 2.5) {
585  // Fill two bins in phi
586  offset = offset25;
587  }
588  else {
589  // Fill one phi bin
590  offset = {0.};
591  }
592 
593  // Fill the histogram
594  for (auto phiOffset : offset) {
595  phi1d = phi + phiOffset/m_phiScaleTT;
596  auto phiTT_1D = Monitored::Scalar<double>("phiTT_1D", phi1d);
597  fill(groupName, phiTT_1D);
598  }
599 
600  return StatusCode::SUCCESS;
601 
602 }

◆ filterPassed()

virtual bool AthReentrantAlgorithm::filterPassed ( const EventContext &  ctx) const
inlinevirtualinherited

Definition at line 135 of file AthReentrantAlgorithm.h.

135  {
136  return execState( ctx ).filterPassed();
137  }

◆ GetEventInfo()

SG::ReadHandle< xAOD::EventInfo > AthMonitorAlgorithm::GetEventInfo ( const EventContext &  ctx) const
inherited

Return a ReadHandle for an EventInfo object (get run/event numbers, etc.)

Parameters
ctxEventContext for the event
Returns
a SG::ReadHandle<xAOD::EventInfo>

Definition at line 107 of file AthMonitorAlgorithm.cxx.

107  {
108  return SG::ReadHandle<xAOD::EventInfo>(m_EventInfoKey, ctx);
109 }

◆ getGroup()

const ToolHandle< GenericMonitoringTool > & AthMonitorAlgorithm::getGroup ( const std::string &  name) const
inherited

Get a specific monitoring tool from the tool handle array.

Finds a specific GenericMonitoringTool instance from the list of monitoring tools (a ToolHandleArray). Throws a FATAL warning if the object found is empty.

Parameters
namestring name of the desired tool
Returns
reference to the desired monitoring tool

Definition at line 164 of file AthMonitorAlgorithm.cxx.

164  {
165  // get the pointer to the tool, and check that it exists
166  auto idx = m_toolLookupMap.find(name);
167  if (ATH_LIKELY(idx != m_toolLookupMap.end())) {
168  return m_tools[idx->second];
169  }
170  else {
171  if (!isInitialized()) {
172  ATH_MSG_FATAL(
173  "It seems that the AthMonitorAlgorithm::initialize was not called "
174  "in derived class initialize method");
175  } else {
176  std::string available = std::accumulate(
177  m_toolLookupMap.begin(), m_toolLookupMap.end(), std::string(""),
178  [](const std::string& s, auto h) { return s + "," + h.first; });
179  ATH_MSG_FATAL("The tool " << name << " could not be found in the tool array of the "
180  << "monitoring algorithm " << m_name << ". This probably reflects a discrepancy between "
181  << "your python configuration and c++ filling code. Note: your available groups are {"
182  << available << "}.");
183  }
184  }
185  return m_dummy;
186 }

◆ getPartition()

std::string PprMonitorAlgorithm::getPartition ( int  layer,
double  eta 
) const
private

Definition at line 479 of file PprMonitorAlgorithm.cxx.

479  {
480 
481  std::string part = "";
482  if (layer == 0) { // EM layer
483  if (eta < -3.2)
484  part = "LArFCAL1C";
485  else if (eta < -1.5)
486  part = "LArEMECC";
487  else if (eta < -1.4)
488  part = "LArOverlapC";
489  else if (eta < 0.0)
490  part = "LArEMBC";
491  else if (eta < 1.4)
492  part = "LArEMBA";
493  else if (eta < 1.5)
494  part = "LArOverlapA";
495  else if (eta < 3.2)
496  part = "LArEMECA";
497  else
498  part = "LArFCAL1A";
499  } else { // HAD layer
500  if (eta < -3.2)
501  part = "LArFCAL23C";
502  else if (eta < -1.5)
503  part = "LArHECC";
504  else if (eta < -0.9)
505  part = "TileEBC";
506  else if (eta < 0.0)
507  part = "TileLBC";
508  else if (eta < 0.9)
509  part = "TileLBA";
510  else if (eta < 1.5)
511  part = "TileEBA";
512  else if (eta < 3.2)
513  part = "LArHECA";
514  else
515  part = "LArFCAL23A";
516  }
517  return part;
518 }

◆ getTrigDecisionTool()

const ToolHandle< Trig::TrigDecisionTool > & AthMonitorAlgorithm::getTrigDecisionTool ( ) const
inherited

Get the trigger decision tool member.

The trigger decision tool is used to check whether a specific trigger is passed by an event.

Returns
m_trigDecTool

Definition at line 189 of file AthMonitorAlgorithm.cxx.

189  {
190  return m_trigDecTool;
191 }

◆ initialize()

StatusCode PprMonitorAlgorithm::initialize ( )
overridevirtual

initialize

Returns
StatusCode

Reimplemented from AthMonitorAlgorithm.

Definition at line 23 of file PprMonitorAlgorithm.cxx.

23  {
24 
25  ATH_MSG_DEBUG("PprMonitorAlgorithm::initialize");
26  ATH_MSG_DEBUG("Package Name "<< m_packageName);
27  ATH_MSG_DEBUG("m_xAODTriggerTowerContainerName "<< m_xAODTriggerTowerContainerName);
28  ATH_MSG_DEBUG("m_TT_ADC_HitMap_Thresh " << m_TT_ADC_HitMap_Thresh);
29 
30  // We initialise all the containers that we need
31  ATH_CHECK( AthMonitorAlgorithm::initialize() );
32  ATH_CHECK( m_xAODTriggerTowerContainerName.initialize() );
33  ATH_CHECK(m_errorLocation.initialize());
34 
35  // Initialize the groups for GenericMonitoringArrays
36  std::vector<std::string> partitionsEM = {"LArFCAL1C", "LArEMECC", "LArOverlapC", "LArEMBC", "LArEMBA", "LArOverlapA", "LArEMECA", "LArFCAL1A"};
37  m_groupTimeslice_EM = Monitored::buildToolMap<int>(m_tools, "groupTimeslice_EM", partitionsEM);
38 
39  std::vector<std::string> partitionsHAD = {"LArFCAL23C", "LArHECC", "TileEBC", "TileLBC", "TileLBA", "TileEBA", "LArHECA", "LArFCAL23A"};
40  m_groupTimeslice_HAD = Monitored::buildToolMap<int>(m_tools, "groupTimeslice_HAD", partitionsHAD);
41 
42  return StatusCode::SUCCESS;
43 }

◆ inputHandles()

virtual std::vector<Gaudi::DataHandle*> AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::inputHandles ( ) const
overridevirtualinherited

Return this algorithm's input handles.

We override this to include handle instances from key arrays if they have not yet been declared. See comments on updateVHKA.

◆ isClonable()

bool AthReentrantAlgorithm::isClonable ( ) const
overridevirtualinherited

Specify if the algorithm is clonable.

Reentrant algorithms are clonable.

Reimplemented in Simulation::BeamEffectsAlg, InDet::SiTrackerSpacePointFinder, InDet::SCT_Clusterization, InDet::SiSPSeededTrackFinder, SCTRawDataProvider, InDet::GNNSeedingTrackMaker, SCT_PrepDataToxAOD, RoIBResultToxAOD, SCT_CablingCondAlgFromCoraCool, SCT_ReadCalibDataTestAlg, SCT_CablingCondAlgFromText, InDet::SiSPGNNTrackMaker, SCT_ReadCalibChipDataTestAlg, SCT_TestCablingAlg, SCT_ConfigurationConditionsTestAlg, ITkPixelCablingAlg, SCTEventFlagWriter, SCT_ConditionsSummaryTestAlg, SCT_ModuleVetoTestAlg, SCT_MonitorConditionsTestAlg, SCT_LinkMaskingTestAlg, SCT_MajorityConditionsTestAlg, SCT_RODVetoTestAlg, SCT_SensorsTestAlg, SCT_TdaqEnabledTestAlg, SCT_SiliconConditionsTestAlg, SCTSiLorentzAngleTestAlg, SCT_ByteStreamErrorsTestAlg, SCT_ConditionsParameterTestAlg, SCT_FlaggedConditionTestAlg, SCT_StripVetoTestAlg, SCT_RawDataToxAOD, and SCTSiPropertiesTestAlg.

Definition at line 44 of file AthReentrantAlgorithm.cxx.

45 {
46  // Reentrant algorithms are clonable.
47  return true;
48 }

◆ makePPMTower()

StatusCode PprMonitorAlgorithm::makePPMTower ( const xAOD::TriggerTower_v2 *  tt,
std::vector< MonitorTT > &  vecMonTT 
) const
private

Helper functions.

Definition at line 408 of file PprMonitorAlgorithm.cxx.

410 {
411  // Geometry
412  const double phi = tt->phi();
413  double phiMod = phi * m_phiScaleTT;
414 
415  // LUT JEP
416  int jepET = 0;
417  const std::vector<uint_least8_t>& jepETvec = tt->lut_jep();
418  if (jepETvec.size() > 0) jepET = tt->jepET();
419 
420  // ADC timeslice
421  const std::vector<short unsigned int> &ADC( tt->adc() );
422  double max = recTime(ADC, m_EMFADCCut);
423 
424  // Fill TT quantities
425  MonitorTT monTT;
426  monTT.tower = tt;
427  monTT.phiScaled = phiMod;
428  monTT.jepET = jepET;
429  monTT.maxADC = max;
430  vecMonTT.push_back(monTT);
431 
432  return StatusCode::SUCCESS;
433 }

◆ msg() [1/2]

MsgStream& AthCommonMsg< Gaudi::Algorithm >::msg ( ) const
inlineinherited

Definition at line 24 of file AthCommonMsg.h.

24  {
25  return this->msgStream();
26  }

◆ msg() [2/2]

MsgStream& AthCommonMsg< Gaudi::Algorithm >::msg ( const MSG::Level  lvl) const
inlineinherited

Definition at line 27 of file AthCommonMsg.h.

27  {
28  return this->msgStream(lvl);
29  }

◆ msgLvl()

bool AthCommonMsg< Gaudi::Algorithm >::msgLvl ( const MSG::Level  lvl) const
inlineinherited

Definition at line 30 of file AthCommonMsg.h.

30  {
31  return this->msgLevel(lvl);
32  }

◆ outputHandles()

virtual std::vector<Gaudi::DataHandle*> AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::outputHandles ( ) const
overridevirtualinherited

Return this algorithm's output handles.

We override this to include handle instances from key arrays if they have not yet been declared. See comments on updateVHKA.

◆ parseList()

StatusCode AthMonitorAlgorithm::parseList ( const std::string &  line,
std::vector< std::string > &  result 
) const
virtualinherited

Parse a string into a vector.

The input string is a single long string of all of the trigger names. It parses this string and turns it into a vector, where each element is one trigger or trigger category.

Parameters
lineThe input string.
resultThe parsed output vector of strings.
Returns
StatusCode

Definition at line 336 of file AthMonitorAlgorithm.cxx.

336  {
337  std::string item;
338  std::stringstream ss(line);
339 
340  ATH_MSG_DEBUG( "AthMonitorAlgorithm::parseList()" );
341 
342  while ( std::getline(ss, item, ',') ) {
343  std::stringstream iss(item); // remove whitespace
344  iss >> item;
345  result.push_back(item);
346  }
347 
348  return StatusCode::SUCCESS;
349 }

◆ recTime()

double PprMonitorAlgorithm::recTime ( const std::vector< short unsigned int > &  vFADC,
int  cut 
) const
private

Definition at line 436 of file PprMonitorAlgorithm.cxx.

436  {
437 
438  int max = -1;
439  const int slices = vFADC.size();
440  if (slices > 0) {
441  max = 0.;
442  int maxAdc = vFADC[0];
443  for (int sl = 1; sl < slices; ++sl) {
444  if (vFADC[sl] > maxAdc) {
445  maxAdc = vFADC[sl];
446  max = sl;
447  } else if (vFADC[sl] == maxAdc)
448  max = -1;
449  }
450  if (maxAdc == 0)
451  max = -1;
452  }
453  if (max >= 0) {
454  int slbeg = max - 2;
455  if (slbeg < 0)
456  slbeg = 0;
457  int slend = max + 3;
458  if (slend > slices)
459  slend = slices;
460  int sum = 0;
461  int min = 999999;
462  for (int sl = slbeg; sl < slend; ++sl) {
463  int val = vFADC[sl];
464  if (val < m_TT_ADC_Pedestal)
465  val = m_TT_ADC_Pedestal;
466  sum += val;
467  if (val < min)
468  min = val;
469  }
470  sum -= (slend - slbeg) * min;
471  if (sum <= cut)
472  max = -1;
473  }
474 
475  return double(max);
476 }

◆ renounce()

std::enable_if_t<std::is_void_v<std::result_of_t<decltype(&T::renounce)(T)> > && !std::is_base_of_v<SG::VarHandleKeyArray, T> && std::is_base_of_v<Gaudi::DataHandle, T>, void> AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::renounce ( T &  h)
inlineprotectedinherited

Definition at line 380 of file AthCommonDataStore.h.

381  {
382  h.renounce();
383  PBASE::renounce (h);
384  }

◆ renounceArray()

void AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::renounceArray ( SG::VarHandleKeyArray &  handlesArray)
inlineprotectedinherited

remove all handles from I/O resolution

Definition at line 364 of file AthCommonDataStore.h.

364  {
365  handlesArray.renounce();
366  }

◆ setFilterPassed()

virtual void AthReentrantAlgorithm::setFilterPassed ( bool  state,
const EventContext &  ctx 
) const
inlinevirtualinherited

Definition at line 139 of file AthReentrantAlgorithm.h.

139  {
140  execState( ctx ).setFilterPassed( state );
141  }

◆ sysExecute()

StatusCode AthReentrantAlgorithm::sysExecute ( const EventContext &  ctx)
overridevirtualinherited

Execute an algorithm.

We override this in order to work around an issue with the Algorithm base class storing the event context in a member variable that can cause crashes in MT jobs.

Definition at line 67 of file AthReentrantAlgorithm.cxx.

68 {
69  return Gaudi::Algorithm::sysExecute (ctx);
70 }

◆ sysInitialize()

StatusCode AthReentrantAlgorithm::sysInitialize ( )
overridevirtualinherited

Override sysInitialize.

Override sysInitialize from the base class.

Loop through all output handles, and if they're WriteCondHandles, automatically register them and this Algorithm with the CondSvc

Scan through all outputHandles, and if they're WriteCondHandles, register them with the CondSvc

Reimplemented from AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >.

Reimplemented in InputMakerBase, and HypoBase.

Definition at line 96 of file AthReentrantAlgorithm.cxx.

96  {
97  StatusCode sc=AthCommonDataStore<AthCommonMsg<Gaudi::Algorithm>>::sysInitialize();
98 
99  if (sc.isFailure()) {
100  return sc;
101  }
102 
103  ServiceHandle<ICondSvc> cs("CondSvc",name());
104  for (auto h : outputHandles()) {
105  if (h->isCondition() && h->mode() == Gaudi::DataHandle::Writer) {
106  // do this inside the loop so we don't create the CondSvc until needed
107  if ( cs.retrieve().isFailure() ) {
108  ATH_MSG_WARNING("no CondSvc found: won't autoreg WriteCondHandles");
109  return StatusCode::SUCCESS;
110  }
111  if (cs->regHandle(this,*h).isFailure()) {
112  sc = StatusCode::FAILURE;
113  ATH_MSG_ERROR("unable to register WriteCondHandle " << h->fullKey()
114  << " with CondSvc");
115  }
116  }
117  }
118  return sc;
119 }

◆ sysStart()

virtual StatusCode AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::sysStart ( )
overridevirtualinherited

Handle START transition.

We override this in order to make sure that conditions handle keys can cache a pointer to the conditions container.

◆ trigChainsArePassed()

bool AthMonitorAlgorithm::trigChainsArePassed ( const std::vector< std::string > &  vTrigNames) const
inherited

Check whether triggers are passed.

For the event, use the trigger decision tool to check that at least one of the triggers listed in the supplied vector is passed.

Parameters
vTrigNamesList of trigger names.
Returns
If empty input, default to true. If at least one trigger is specified, returns whether at least one trigger was passed.

Definition at line 194 of file AthMonitorAlgorithm.cxx.

194  {
195 
196 
197  // If no triggers were given, return true.
198  if (vTrigNames.empty()) return true;
199 
200 
201  // Trigger: Check if this Algorithm is being run as an Express Stream job.
202  // Events are entering the express stream are chosen randomly, and by chain,
203  // Hence an additional check should be aplied to see if the chain(s)
204  // monitored here are responsible for the event being selected for
205  // the express stream.
206 
207  const auto group = m_trigDecTool->getChainGroup(vTrigNames);
208  if (m_enforceExpressTriggers){
209  const auto passedBits = m_trigDecTool->isPassedBits(group);
210  bool expressPass = passedBits & TrigDefs::Express_passed; //bitwise AND
211  if(!expressPass) {
212  return false;
213  }
214  }
215 
216  // monitor the event if any of the chains in the chain group passes the event.
217  return group->isPassed();
218 
219 }

◆ updateVHKA()

void AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::updateVHKA ( Gaudi::Details::PropertyBase &  )
inlineinherited

Definition at line 308 of file AthCommonDataStore.h.

308  {
309  // debug() << "updateVHKA for property " << p.name() << " " << p.toString()
310  // << " size: " << m_vhka.size() << endmsg;
311  for (auto &a : m_vhka) {
312  std::vector<SG::VarHandleKey*> keys = a->keys();
313  for (auto k : keys) {
314  k->setOwner(this);
315  }
316  }
317  }

Member Data Documentation

◆ ATLAS_THREAD_SAFE

std::map<uint32_t, int> m_errorLB_tt_counter PprMonitorAlgorithm::ATLAS_THREAD_SAFE
mutableprivate

Definition at line 72 of file PprMonitorAlgorithm.h.

◆ cfg

PprMonitorAlgorithm.cfg

Definition at line 421 of file PprMonitorAlgorithm.py.

◆ Files

PprMonitorAlgorithm.Files

Definition at line 414 of file PprMonitorAlgorithm.py.

◆ flags

PprMonitorAlgorithm.flags

Definition at line 411 of file PprMonitorAlgorithm.py.

◆ HISTFileName

PprMonitorAlgorithm.HISTFileName

Definition at line 415 of file PprMonitorAlgorithm.py.

◆ m_dataType

AthMonitorAlgorithm::DataType_t AthMonitorAlgorithm::m_dataType
protectedinherited

Instance of the DataType_t enum.

Definition at line 351 of file AthMonitorAlgorithm.h.

◆ m_dataTypeStr

Gaudi::Property<std::string> AthMonitorAlgorithm::m_dataTypeStr {this,"DataType","userDefined"}
protectedinherited

DataType string pulled from the job option and converted to enum.

Definition at line 353 of file AthMonitorAlgorithm.h.

◆ m_defaultLBDuration

Gaudi::Property<float> AthMonitorAlgorithm::m_defaultLBDuration {this,"DefaultLBDuration",60.}
protectedinherited

Default duration of one lumi block.

Definition at line 360 of file AthMonitorAlgorithm.h.

◆ m_detailLevel

Gaudi::Property<int> AthMonitorAlgorithm::m_detailLevel {this,"DetailLevel",0}
protectedinherited

Sets the level of detail used in the monitoring.

Definition at line 361 of file AthMonitorAlgorithm.h.

◆ m_detStore

StoreGateSvc_t AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::m_detStore
privateinherited

Pointer to StoreGate (detector store by default)

Definition at line 393 of file AthCommonDataStore.h.

◆ m_DQFilterTools

ToolHandleArray<IDQFilterTool> AthMonitorAlgorithm::m_DQFilterTools {this,"FilterTools",{}}
protectedinherited

Array of Data Quality filter tools.

Definition at line 341 of file AthMonitorAlgorithm.h.

◆ m_dummy

const ToolHandle<GenericMonitoringTool> AthMonitorAlgorithm::m_dummy
privateinherited

Definition at line 369 of file AthMonitorAlgorithm.h.

◆ m_EMFADCCut

Gaudi::Property<int> PprMonitorAlgorithm::m_EMFADCCut {this, "EMFADCCut", 40, "EM FADC cut for signal"}
private

Definition at line 39 of file PprMonitorAlgorithm.h.

◆ m_enforceExpressTriggers

Gaudi::Property<bool> AthMonitorAlgorithm::m_enforceExpressTriggers
privateinherited
Initial value:
{this,
"EnforceExpressTriggers", false,
"Requires that matched triggers made the event enter the express stream"}

Definition at line 372 of file AthMonitorAlgorithm.h.

◆ m_environment

AthMonitorAlgorithm::Environment_t AthMonitorAlgorithm::m_environment
protectedinherited

Instance of the Environment_t enum.

Definition at line 350 of file AthMonitorAlgorithm.h.

◆ m_environmentStr

Gaudi::Property<std::string> AthMonitorAlgorithm::m_environmentStr {this,"Environment","user"}
protectedinherited

Environment string pulled from the job option and converted to enum.

Definition at line 352 of file AthMonitorAlgorithm.h.

◆ m_errorLocation

SG::WriteHandleKey<std::vector<int> > PprMonitorAlgorithm::m_errorLocation {this,"ErrorLocationPPM","L1CaloPPMErrorVector","ErrorVector"}
private

Definition at line 49 of file PprMonitorAlgorithm.h.

◆ m_EventInfoKey

SG::ReadHandleKey<xAOD::EventInfo> AthMonitorAlgorithm::m_EventInfoKey {this,"EventInfoKey","EventInfo"}
protectedinherited

Key for retrieving EventInfo from StoreGate.

Definition at line 362 of file AthMonitorAlgorithm.h.

◆ m_evtStore

StoreGateSvc_t AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::m_evtStore
privateinherited

Pointer to StoreGate (event store by default)

Definition at line 390 of file AthCommonDataStore.h.

◆ m_extendedExtraObjects

DataObjIDColl AthReentrantAlgorithm::m_extendedExtraObjects
privateinherited

Extra output dependency collection, extended by AthAlgorithmDHUpdate to add symlinks.

Empty if no symlinks were found.

Definition at line 153 of file AthReentrantAlgorithm.h.

◆ m_fileKey

Gaudi::Property<std::string> AthMonitorAlgorithm::m_fileKey {this,"FileKey",""}
protectedinherited

Internal Athena name for file.

Definition at line 358 of file AthMonitorAlgorithm.h.

◆ m_groupTimeslice_EM

std::map<std::string,int> PprMonitorAlgorithm::m_groupTimeslice_EM
private

Groups for GenericMonitoringArrays.

Definition at line 44 of file PprMonitorAlgorithm.h.

◆ m_groupTimeslice_HAD

std::map<std::string,int> PprMonitorAlgorithm::m_groupTimeslice_HAD
private

Definition at line 45 of file PprMonitorAlgorithm.h.

◆ m_lbDurationDataKey

SG::ReadCondHandleKey<LBDurationCondData> AthMonitorAlgorithm::m_lbDurationDataKey {this,"LBDurationCondDataKey","LBDurationCondData","SG Key of LBDurationCondData object"}
protectedinherited

Definition at line 345 of file AthMonitorAlgorithm.h.

◆ m_lumiDataKey

SG::ReadCondHandleKey<LuminosityCondData> AthMonitorAlgorithm::m_lumiDataKey {this,"LuminosityCondDataKey","LuminosityCondData","SG Key of LuminosityCondData object"}
protectedinherited

Definition at line 343 of file AthMonitorAlgorithm.h.

◆ m_mutex

std::mutex PprMonitorAlgorithm::m_mutex {}
mutableprivate

Definition at line 71 of file PprMonitorAlgorithm.h.

◆ m_name

std::string AthMonitorAlgorithm::m_name
privateinherited

Definition at line 366 of file AthMonitorAlgorithm.h.

◆ m_packageName

StringProperty PprMonitorAlgorithm::m_packageName {this,"PackageName","PprMonitor","group name for histogramming"}
private

Definition at line 29 of file PprMonitorAlgorithm.h.

◆ m_phiScaleTT

Gaudi::Property<double> PprMonitorAlgorithm::m_phiScaleTT {this, "phiScaleTT", 32./M_PI, "Scale factor to convert trigger tower phi to integer binning"}
private

Properties.

Definition at line 36 of file PprMonitorAlgorithm.h.

◆ m_SliceNo

Gaudi::Property<int> PprMonitorAlgorithm::m_SliceNo {this, "SliceNo", 15, "Number of possible time slices in the readout"}
private

Definition at line 38 of file PprMonitorAlgorithm.h.

◆ m_toolLookupMap

std::unordered_map<std::string, size_t> AthMonitorAlgorithm::m_toolLookupMap
privateinherited

Definition at line 367 of file AthMonitorAlgorithm.h.

◆ m_tools

ToolHandleArray<GenericMonitoringTool> AthMonitorAlgorithm::m_tools {this,"GMTools",{}}
protectedinherited

Array of Generic Monitoring Tools.

Definition at line 338 of file AthMonitorAlgorithm.h.

◆ m_trigDecTool

PublicToolHandle<Trig::TrigDecisionTool> AthMonitorAlgorithm::m_trigDecTool {this, "TrigDecisionTool",""}
protectedinherited

Tool to tell whether a specific trigger is passed.

Definition at line 340 of file AthMonitorAlgorithm.h.

◆ m_triggerChainString

Gaudi::Property<std::string> AthMonitorAlgorithm::m_triggerChainString {this,"TriggerChain",""}
protectedinherited

Trigger chain string pulled from the job option and parsed into a vector.

Definition at line 355 of file AthMonitorAlgorithm.h.

◆ m_trigLiveFractionDataKey

SG::ReadCondHandleKey<TrigLiveFractionCondData> AthMonitorAlgorithm::m_trigLiveFractionDataKey {this,"TrigLiveFractionCondDataKey","TrigLiveFractionCondData", "SG Key of TrigLiveFractionCondData object"}
protectedinherited

Definition at line 347 of file AthMonitorAlgorithm.h.

◆ m_TT_ADC_HitMap_Thresh

Gaudi::Property<int> PprMonitorAlgorithm::m_TT_ADC_HitMap_Thresh {this, "TT_ADC_HitMap_Thresh", 50, "ADC cut for hit maps"}
private

Definition at line 37 of file PprMonitorAlgorithm.h.

◆ m_TT_ADC_Pedestal

Gaudi::Property<int> PprMonitorAlgorithm::m_TT_ADC_Pedestal {this, "ADCPedestal", 32, "Nominal pedestal value"}
private

Definition at line 40 of file PprMonitorAlgorithm.h.

◆ m_TT_HitMap_ThreshVec

Gaudi::Property<std::vector<int> > PprMonitorAlgorithm::m_TT_HitMap_ThreshVec {this, "LUTHitMap_ThreshVec", {0, 1, 3, 5, 10, 20, 30, 50}, "Thresholds for LUT hitmaps"}
private

Definition at line 41 of file PprMonitorAlgorithm.h.

◆ m_useLumi

Gaudi::Property<bool> AthMonitorAlgorithm::m_useLumi {this,"EnableLumi",false}
protectedinherited

Allows use of various luminosity functions.

Definition at line 359 of file AthMonitorAlgorithm.h.

◆ m_varHandleArraysDeclared

bool AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::m_varHandleArraysDeclared
privateinherited

Definition at line 399 of file AthCommonDataStore.h.

◆ m_vhka

std::vector<SG::VarHandleKeyArray*> AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::m_vhka
privateinherited

Definition at line 398 of file AthCommonDataStore.h.

◆ m_vTrigChainNames

std::vector<std::string> AthMonitorAlgorithm::m_vTrigChainNames
protectedinherited

Vector of trigger chain names parsed from trigger chain string.

Definition at line 356 of file AthMonitorAlgorithm.h.

◆ m_xAODTriggerTowerContainerName

SG::ReadHandleKey<xAOD::TriggerTowerContainer> PprMonitorAlgorithm::m_xAODTriggerTowerContainerName {this, "BS_xAODTriggerTowerContainer",LVL1::TrigT1CaloDefs::xAODTriggerTowerLocation,"Trigger Tower Container"}
private

container keys including steering parameter and description

Definition at line 32 of file PprMonitorAlgorithm.h.

◆ MaxEvents

PprMonitorAlgorithm.MaxEvents

Definition at line 412 of file PprMonitorAlgorithm.py.

◆ OutputLevel

PprMonitorAlgorithm.OutputLevel

Definition at line 429 of file PprMonitorAlgorithm.py.

◆ PprMonitorCfg

PprMonitorAlgorithm.PprMonitorCfg

Definition at line 425 of file PprMonitorAlgorithm.py.

◆ summariseProps

PprMonitorAlgorithm.summariseProps

Definition at line 431 of file PprMonitorAlgorithm.py.

◆ True

PprMonitorAlgorithm.True

Definition at line 431 of file PprMonitorAlgorithm.py.

◆ withDetails

PprMonitorAlgorithm.withDetails

Definition at line 431 of file PprMonitorAlgorithm.py.

The documentation for this class was generated from the following files:
LArG4FSStartPointFilter.part
part
Definition: LArG4FSStartPointFilter.py:21
AthMonitorAlgorithm::Environment_t::tier0Raw
@ tier0Raw
ATH_MSG_FATAL
#define ATH_MSG_FATAL(x)
Definition: AthMsgStreamMacros.h:34
checkFileSG.line
line
Definition: checkFileSG.py:75
python.SystemOfUnits.s
int s
Definition: SystemOfUnits.py:131
MonDataType::ADC
@ ADC
LVL1::DataError
Error data.
Definition: DataError.h:27
get_generator_info.result
result
Definition: get_generator_info.py:21
python.PerfMonSerializer.p
def p
Definition: PerfMonSerializer.py:743
max
#define max(a, b)
Definition: cfImp.cxx:41
PowhegControl_ttHplus_NLO.ss
ss
Definition: PowhegControl_ttHplus_NLO.py:83
phi
Scalar phi() const
phi method
Definition: AmgMatrixBasePlugin.h:64
xAOD::uint8_t
uint8_t
Definition: Muon_v1.cxx:575
AthMonitorAlgorithm::m_trigDecTool
PublicToolHandle< Trig::TrigDecisionTool > m_trigDecTool
Tool to tell whether a specific trigger is passed.
Definition: AthMonitorAlgorithm.h:340
PprMonitorAlgorithm::m_TT_ADC_HitMap_Thresh
Gaudi::Property< int > m_TT_ADC_HitMap_Thresh
Definition: PprMonitorAlgorithm.h:37
AthMonitorAlgorithm::Environment_t::tier0
@ tier0
AthMonitorAlgorithm::Environment_t::AOD
@ AOD
xAOD::uint32_t
setEventNumber uint32_t
Definition: EventInfo_v1.cxx:127
eta
Scalar eta() const
pseudorapidity method
Definition: AmgMatrixBasePlugin.h:79
PprMonitorAlgorithm::m_TT_ADC_Pedestal
Gaudi::Property< int > m_TT_ADC_Pedestal
Definition: PprMonitorAlgorithm.h:40
SG::ReadHandle
Definition: StoreGate/StoreGate/ReadHandle.h:70
AthCommonDataStore::declareProperty
Gaudi::Details::PropertyBase & declareProperty(Gaudi::Property< T > &t)
Definition: AthCommonDataStore.h:145
accumulate
bool accumulate(AccumulateMap &map, std::vector< module_t > const &modules, FPGATrackSimMatrixAccumulator const &acc)
Accumulates an accumulator (e.g.
Definition: FPGATrackSimMatrixAccumulator.cxx:22
RunTileMonitoring.groupName
groupName
Definition: RunTileMonitoring.py:158
xAOD::char
char
Definition: TrigDecision_v1.cxx:38
AthMonitorAlgorithm::m_vTrigChainNames
std::vector< std::string > m_vTrigChainNames
Vector of trigger chain names parsed from trigger chain string.
Definition: AthMonitorAlgorithm.h:356
AthCommonDataStore::renounce
std::enable_if_t< std::is_void_v< std::result_of_t< decltype(&T::renounce)(T)> > &&!std::is_base_of_v< SG::VarHandleKeyArray, T > &&std::is_base_of_v< Gaudi::DataHandle, T >, void > renounce(T &h)
Definition: AthCommonDataStore.h:380
AthMonitorAlgorithm::m_EventInfoKey
SG::ReadHandleKey< xAOD::EventInfo > m_EventInfoKey
Key for retrieving EventInfo from StoreGate.
Definition: AthMonitorAlgorithm.h:362
skel.it
it
Definition: skel.GENtoEVGEN.py:423
AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::m_evtStore
StoreGateSvc_t m_evtStore
Pointer to StoreGate (event store by default)
Definition: AthCommonDataStore.h:390
AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::m_vhka
std::vector< SG::VarHandleKeyArray * > m_vhka
Definition: AthCommonDataStore.h:398
AthMonitorAlgorithm::m_toolLookupMap
std::unordered_map< std::string, size_t > m_toolLookupMap
Definition: AthMonitorAlgorithm.h:367
AthMonitorAlgorithm::m_environment
AthMonitorAlgorithm::Environment_t m_environment
Instance of the Environment_t enum.
Definition: AthMonitorAlgorithm.h:350
PprMonitorAlgorithm::makePPMTower
StatusCode makePPMTower(const xAOD::TriggerTower_v2 *tt, std::vector< MonitorTT > &vecMonTT) const
Helper functions.
Definition: PprMonitorAlgorithm.cxx:408
PprMonitorAlgorithm::m_xAODTriggerTowerContainerName
SG::ReadHandleKey< xAOD::TriggerTowerContainer > m_xAODTriggerTowerContainerName
container keys including steering parameter and description
Definition: PprMonitorAlgorithm.h:32
read_hist_ntuple.t
t
Definition: read_hist_ntuple.py:5
AthMonitorAlgorithm::trigChainsArePassed
bool trigChainsArePassed(const std::vector< std::string > &vTrigNames) const
Check whether triggers are passed.
Definition: AthMonitorAlgorithm.cxx:194
AthMonitorAlgorithm::Environment_t::user
@ user
TruthTest.itE
itE
Definition: TruthTest.py:25
AthenaPoolTestRead.sc
sc
Definition: AthenaPoolTestRead.py:27
SG::VarHandleKeyArray::setOwner
virtual void setOwner(IDataHandleHolder *o)=0
AthMonitorAlgorithm::m_dummy
const ToolHandle< GenericMonitoringTool > m_dummy
Definition: AthMonitorAlgorithm.h:369
dqt_zlumi_pandas.weight
int weight
Definition: dqt_zlumi_pandas.py:200
PixelByteStreamErrors::BCID
@ BCID
Definition: PixelByteStreamErrors.h:13
SG::makeHandle
SG::ReadCondHandle< T > makeHandle(const SG::ReadCondHandleKey< T > &key, const EventContext &ctx=Gaudi::Hive::currentContext())
Definition: ReadCondHandle.h:269
python.setupRTTAlg.size
int size
Definition: setupRTTAlg.py:39
PyPoolBrowser.item
item
Definition: PyPoolBrowser.py:129
python.PyAthena.module
module
Definition: PyAthena.py:134
PprMonitorAlgorithm::recTime
double recTime(const std::vector< short unsigned int > &vFADC, int cut) const
Definition: PprMonitorAlgorithm.cxx:436
TileSynchronizeBch.online
online
Definition: TileSynchronizeBch.py:88
checkTP.save
def save(self, fileName="./columbo.out")
Definition: checkTP.py:178
PprMonitorAlgorithm::m_TT_HitMap_ThreshVec
Gaudi::Property< std::vector< int > > m_TT_HitMap_ThreshVec
Definition: PprMonitorAlgorithm.h:41
python.TriggerHandler.th
th
Definition: TriggerHandler.py:296
AthCommonDataStore
Definition: AthCommonDataStore.h:52
AthMonitorAlgorithm::m_DQFilterTools
ToolHandleArray< IDQFilterTool > m_DQFilterTools
Array of Data Quality filter tools.
Definition: AthMonitorAlgorithm.h:341
ATH_MSG_ERROR
#define ATH_MSG_ERROR(x)
Definition: AthMsgStreamMacros.h:33
convertTimingResiduals.sum
sum
Definition: convertTimingResiduals.py:55
dqt_zlumi_pandas.err
err
Definition: dqt_zlumi_pandas.py:193
AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::outputHandles
virtual std::vector< Gaudi::DataHandle * > outputHandles() const override
Return this algorithm's output handles.
perfmonmt-refit.slice
slice
Definition: perfmonmt-refit.py:52
sim_rttUpdate.user
def user
Definition: sim_rttUpdate.py:662
lumiFormat.i
int i
Definition: lumiFormat.py:92
PprMonitorAlgorithm::fillPPMPhi
StatusCode fillPPMPhi(MonitorTT &monTT, const std::string &groupName) const
Definition: PprMonitorAlgorithm.cxx:566
AthMonitorAlgorithm::DataType_t::heavyIonCollisions
@ heavyIonCollisions
EL::StatusCode
::StatusCode StatusCode
StatusCode definition for legacy code.
Definition: PhysicsAnalysis/D3PDTools/EventLoop/EventLoop/StatusCode.h:22
ATH_MSG_DEBUG
#define ATH_MSG_DEBUG(x)
Definition: AthMsgStreamMacros.h:29
PprMonitorAlgorithm::m_mutex
std::mutex m_mutex
Definition: PprMonitorAlgorithm.h:71
TRT::Hit::layer
@ layer
Definition: HitInfo.h:79
tolower
void tolower(std::string &s)
Definition: AthenaSummarySvc.cxx:113
AthMonitorAlgorithm::fillHistograms
virtual StatusCode fillHistograms(const EventContext &ctx) const =0
adds event to the monitoring histograms
xAOD::TriggerTower_v2
Description of TriggerTower_v2.
Definition: TriggerTower_v2.h:49
Amg::transform
Amg::Vector3D transform(Amg::Vector3D &v, Amg::Transform3D &tr)
Transform a point from a Trasformation3D.
Definition: GeoPrimitivesHelpers.h:156
PprMonitorAlgorithm::m_packageName
StringProperty m_packageName
Definition: PprMonitorAlgorithm.h:29
BindingsTest.cut
cut
This script demonstrates how to call a C++ class from Python Also how to use PyROOT is shown.
Definition: BindingsTest.py:13
ATH_CHECK
#define ATH_CHECK
Definition: AthCheckMacros.h:40
PprMonitorAlgorithm::getPartition
std::string getPartition(int layer, double eta) const
Definition: PprMonitorAlgorithm.cxx:479
AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::m_detStore
StoreGateSvc_t m_detStore
Pointer to StoreGate (detector store by default)
Definition: AthCommonDataStore.h:393
xAOD::eventNumber
eventNumber
Definition: EventInfo_v1.cxx:124
AthMonitorAlgorithm::fill
void fill(const ToolHandle< GenericMonitoringTool > &groupHandle, std::vector< std::reference_wrapper< Monitored::IMonitoredVariable >> &&variables) const
Fills a vector of variables to a group by reference.
python.BuildSignatureFlags.cosmics
AthConfigFlags cosmics(AthConfigFlags flags, str instanceName, str recoMode)
Definition: BuildSignatureFlags.py:472
SG::VarHandleKey::initialize
StatusCode initialize(bool used=true)
If this object is used as a property, then this should be called during the initialize phase.
Definition: AthToolSupport/AsgDataHandles/Root/VarHandleKey.cxx:103
xAOD::double
double
Definition: CompositeParticle_v1.cxx:159
AthMonitorAlgorithm::GetEventInfo
SG::ReadHandle< xAOD::EventInfo > GetEventInfo(const EventContext &) const
Return a ReadHandle for an EventInfo object (get run/event numbers, etc.)
Definition: AthMonitorAlgorithm.cxx:107
AthMonitorAlgorithm::m_dataType
AthMonitorAlgorithm::DataType_t m_dataType
Instance of the DataType_t enum.
Definition: AthMonitorAlgorithm.h:351
AthReentrantAlgorithm::m_extendedExtraObjects
DataObjIDColl m_extendedExtraObjects
Extra output dependency collection, extended by AthAlgorithmDHUpdate to add symlinks.
Definition: AthReentrantAlgorithm.h:153
min
#define min(a, b)
Definition: cfImp.cxx:40
SG::VarHandleKeyArray::renounce
virtual void renounce()=0
AthMonitorAlgorithm::DataType_t::cosmics
@ cosmics
SG::HandleClassifier::type
std::conditional< std::is_base_of< SG::VarHandleKeyArray, T >::value, VarHandleKeyArrayType, type2 >::type type
Definition: HandleClassifier.h:54
PprMonitorAlgorithm::m_EMFADCCut
Gaudi::Property< int > m_EMFADCCut
Definition: PprMonitorAlgorithm.h:39
AthMonitorAlgorithm::m_tools
ToolHandleArray< GenericMonitoringTool > m_tools
Array of Generic Monitoring Tools.
Definition: AthMonitorAlgorithm.h:338
AthMonitorAlgorithm::Environment_t::online
@ online
PprMonitorAlgorithm::m_groupTimeslice_HAD
std::map< std::string, int > m_groupTimeslice_HAD
Definition: PprMonitorAlgorithm.h:45
merge_scale_histograms.doc
string doc
Definition: merge_scale_histograms.py:9
name
std::string name
Definition: Control/AthContainers/Root/debug.cxx:195
ActsTrk::to_string
std::string to_string(const DetectorType &type)
Definition: GeometryDefs.h:34
AthMonitorAlgorithm::Environment_t::tier0ESD
@ tier0ESD
AthMonitorAlgorithm::Environment_t::altprod
@ altprod
AthReentrantAlgorithm::sysInitialize
virtual StatusCode sysInitialize() override
Override sysInitialize.
Definition: AthReentrantAlgorithm.cxx:96
PprMonitorAlgorithm::ErrorVector
std::vector< int > ErrorVector
Definition: PprMonitorAlgorithm.h:51
AthMonitorAlgorithm::m_enforceExpressTriggers
Gaudi::Property< bool > m_enforceExpressTriggers
Definition: AthMonitorAlgorithm.h:372
item
Definition: ItemListSvc.h:43
AthMonitorAlgorithm::initialize
virtual StatusCode initialize() override
initialize
Definition: AthMonitorAlgorithm.cxx:18
PprMonitorAlgorithm::m_phiScaleTT
Gaudi::Property< double > m_phiScaleTT
Properties.
Definition: PprMonitorAlgorithm.h:36
L1CaloCoolChannelId
Definition: L1CaloCoolChannelId.h:10
ATH_LIKELY
#define ATH_LIKELY(x)
Definition: AthUnlikelyMacros.h:16
PprMonitorAlgorithm::fillPPMEtaPhi
StatusCode fillPPMEtaPhi(MonitorTT &monTT, const std::string &groupName, const std::string &weightName, double weight=1.) const
Definition: PprMonitorAlgorithm.cxx:521
a
TList * a
Definition: liststreamerinfos.cxx:10
CaloLCW_tf.group
group
Definition: CaloLCW_tf.py:28
h
python.CaloScaleNoiseConfig.str
str
Definition: CaloScaleNoiseConfig.py:78
ReadFloatFromCool.adc
adc
Definition: ReadFloatFromCool.py:48
ATH_MSG_WARNING
#define ATH_MSG_WARNING(x)
Definition: AthMsgStreamMacros.h:32
AthMonitorAlgorithm::DataType_t::collisions
@ collisions
Pythia8_RapidityOrderMPI.val
val
Definition: Pythia8_RapidityOrderMPI.py:14
PprMonitorAlgorithm::m_groupTimeslice_EM
std::map< std::string, int > m_groupTimeslice_EM
Groups for GenericMonitoringArrays.
Definition: PprMonitorAlgorithm.h:44
AthMonitorAlgorithm::m_name
std::string m_name
Definition: AthMonitorAlgorithm.h:366
convertTimingResiduals.offset
offset
Definition: convertTimingResiduals.py:71
LArNewCalib_DelayDump_OFC_Cali.idx
idx
Definition: LArNewCalib_DelayDump_OFC_Cali.py:69
AthMonitorAlgorithm::AthMonitorAlgorithm
AthMonitorAlgorithm(const std::string &name, ISvcLocator *pSvcLocator)
Constructor.
Definition: AthMonitorAlgorithm.cxx:7
TauGNNUtils::Variables::absEta
bool absEta(const xAOD::TauJet &tau, double &out)
Definition: TauGNNUtils.cxx:232
SG::VarHandleBase::vhKey
SG::VarHandleKey & vhKey()
Return a non-const reference to the HandleKey.
Definition: StoreGate/src/VarHandleBase.cxx:616
declareProperty
#define declareProperty(n, p, h)
Definition: BaseFakeBkgTool.cxx:15
str
Definition: BTagTrackIpAccessor.cxx:11
python.Bindings.keys
keys
Definition: Control/AthenaPython/python/Bindings.py:790
LHEF::Writer
Pythia8::Writer Writer
Definition: Prophecy4fMerger.cxx:12
Monitored::Scalar
Declare a monitored scalar variable.
Definition: MonitoredScalar.h:34
fillSCTHists.etaMod
etaMod
Definition: fillSCTHists.py:23
AthMonitorAlgorithm::DataType_t::userDefined
@ userDefined
StateLessPT_NewConfig.Timeout
Timeout
Definition: StateLessPT_NewConfig.py:297
PprMonitorAlgorithm::m_errorLocation
SG::WriteHandleKey< std::vector< int > > m_errorLocation
Definition: PprMonitorAlgorithm.h:49
TileDCSDataPlotter.tt
tt
Definition: TileDCSDataPlotter.py:874
AthCommonDataStore::declareGaudiProperty
Gaudi::Details::PropertyBase & declareGaudiProperty(Gaudi::Property< T > &hndl, const SG::VarHandleKeyType &)
specialization for handling Gaudi::Property<SG::VarHandleKey>
Definition: AthCommonDataStore.h:156
keylayer_zslicemap.slices
slices
Definition: keylayer_zslicemap.py:112
AthMonitorAlgorithm::DataType_t::monteCarlo
@ monteCarlo
PprMonitorAlgorithm::m_SliceNo
Gaudi::Property< int > m_SliceNo
Definition: PprMonitorAlgorithm.h:38
fitman.k
k
Definition: fitman.py:528
ServiceHandle< ICondSvc >
collisions
Definition: collisions.py:1
Generated on Tue Jul 2 2024 21:56:14 for ATLAS Offline Software by   doxygen 1.8.18