TrigConfHLTData/TrigConfHLTData/HLTChain.h

Go to the documentation of this file.

/*
  Copyright (C) 2002-2026 CERN for the benefit of the ATLAS collaboration
*/
 
#ifndef TrigConf_HLTChain
#define TrigConf_HLTChain
 
#include "TrigConfL1Data/TrigConfData.h"
#include "TrigConfHLTData/HLTPrescale.h"
#include "TrigConfHLTData/HLTLevel.h"
 
#include <string>
#include <iosfwd>
#include <fstream>
#include <vector>
#include <set>
 
#include <unordered_map>
 
namespace TrigConf {
   class HLTChain;
   class HLTSignature;
   class HLTTriggerType;
   class HLTStreamTag;
   class DiffStruct;
}
   
bool HLTChain_lt(const TrigConf::HLTChain* ch1, const TrigConf::HLTChain* ch2);
   
namespace TrigConf {
 
   std::ostream & operator<<(std::ostream &, const HLTChain &);

   class HLTChain : public TrigConfData {
   public:

      HLTChain( void );

      HLTChain( const std::string& chain_name,
                int chain_counter,
                int chain_version,
                const std::string& level,
                const std::string& lower_chain_name,
                int lower_chain_counter,
                std::vector<HLTSignature*>&& signatureList );

      HLTChain( const HLTChain& ch );

      virtual ~HLTChain() override;
 
 
      // getters
      // cppcheck-suppress returnTempReference; name() returns const-ref to private member
      const std::string&                  chain_name            () const { return name(); }
      int                                 chain_counter         () const { return m_chain_counter; }
      int                                 chain_version         () const { return m_chain_version; }
      const std::string&                  level                 () const { return m_level; }
      HLTLevel                            level_enum            () const { return m_level=="L2"?L2:(m_level=="EF"?EF:HLT); }
      const std::string&                  lower_chain_name      () const { return m_lower_chain_name; }
      int                                 lower_chain_counter   () const { return m_lower_chain_counter; }
      unsigned int                        chain_hash_id         () const { return m_chain_hash_id; }
      unsigned int                        lower_chain_hash_id   () const { return m_lower_chain_hash_id; }
      int                                 EB_after_step         () const { return m_EB_after_step; }
      const std::vector<size_t>&          leg_multiplicities    () const { return m_leg_multiplicities; }
      bool                                hasMultipleLowerChains() const;
      const std::vector<int>&             lower_chain_counters  () const;
      std::vector<unsigned int>           lower_chain_hash_ids  () const;
 
 
      std::vector<HLTTriggerType*>&       triggerTypeList()       { return m_HLTTriggerTypeList; }
      const std::vector<HLTTriggerType*>& triggerTypeList() const { return m_HLTTriggerTypeList; }
 
      // setters
      HLTChain& set_chain_name           ( const std::string&  chain_name);
      HLTChain& set_chain_counter        ( int chain_counter) { m_chain_counter = chain_counter; return *this; }
      HLTChain& set_chain_version        ( int chain_version) { m_chain_version = chain_version; return *this; }
      HLTChain& set_level                ( std::string_view  level) { m_level.assign(level); return *this; }
      HLTChain& set_lower_chain_name     ( const std::string&  lower_chain_name);
      HLTChain& set_lower_chain_counter  ( int lower_chain_counter) { m_lower_chain_counter = lower_chain_counter; return *this; }
      HLTChain& set_lower_chain_counters ( const std::vector<int>& low_ccs) { m_lower_chain_counters = low_ccs; return *this; }
      HLTChain& set_signatureList        ( const std::vector<HLTSignature*>&   sigList);
      HLTChain& set_triggerTypeList      ( const std::vector<HLTTriggerType*>& trigList);
      HLTChain& set_groupList            ( const std::set<std::string>& groups) { m_groups = groups; return *this; }
      HLTChain& set_EB_after_step        ( int EB_after_step ) { m_EB_after_step = EB_after_step; return *this; }
      HLTChain& set_leg_multiplicities   ( const std::vector<size_t>& mult ) { m_leg_multiplicities = mult; return *this; }
 
 
      // signatures
      std::vector<HLTSignature*>&         signatureList()       { return m_HLTSignatureList; }
      const std::vector<HLTSignature*>&   signatureList() const { return m_HLTSignatureList; }
      const std::vector<HLTSignature*>&   signatures()    const { return m_HLTSignatureList; }
      unsigned int                        lastStep() const;
      void                                shiftStepCounter(int shift);
 
 
      // streams
      void addStream(HLTStreamTag*);
      void clearStreams();
      const std::vector<HLTStreamTag*>& streams() const { return m_streams; }
      #ifndef __GCCXML__
      const std::vector<HLTStreamTag*>& streamTagList() const __attribute__ ((deprecated)) { return m_streams; }  //deprecated
      #endif
      const std::vector<HLTStreamTag*>& streams_orig() const { return m_streams_orig; }
      std::pair<bool, float> stream_prescale(const std::string& streamName) const;
 
 
      // groups
      const std::set<std::string>& groups() const { return m_groups; }
      #ifndef __GCCXML__
      const std::set<std::string>& groupList() const __attribute__ ((deprecated)) { return m_groups; }
      #endif
      void addGroup(const std::string& group) { m_groups.insert(group); }
      void clearGroups() { m_groups.clear(); }
 
      // prescales
      HLTChain&              set_prescales( const HLTPrescale& prescales);
      HLTChain&              set_prescale( float prescale)             { m_prescales.setPrescale(prescale); return *this; }
      HLTChain&              set_rerun_prescale( float rerun_prescale) { m_prescales.setRerunPrescale("",rerun_prescale); return *this; }
      HLTChain&              set_pass_through( float pass_through)     { m_prescales.setPassThrough(pass_through); return *this; }
 
      HLTPrescale&           prescales() { return m_prescales; }
      const HLTPrescale&     prescales() const { return m_prescales; }
      float                  prescale() const { return prescales().prescale(); }
      float                  pass_through() const { return prescales().pass_through(); }
      std::pair<bool, float> rerun_prescale(const std::string& targetName) const { return prescales().getRerunPrescale(targetName); }
      #ifndef __GCCXML__
      float                  rerun_prescale() const __attribute__ ((deprecated)) { return prescales().getRerunPrescale("").second; }
      #endif
 
      inline bool operator<(const HLTChain& e) const {
         return m_level[0]>e.m_level[0] || 
            (m_level[0]==e.m_level[0] && m_chain_counter<e.m_chain_counter);
      }
      
      void createSignatureLabels();

      void print(const std::string& indent="", unsigned int detail=1) const override;
 
      void writeXML(std::ofstream & xmlfile);
 
      DiffStruct* compareTo(const HLTChain* o) const;
 
      // for python
      std::string __str__() const override;
 
 
   private:
 
 
      unsigned int      m_chain_hash_id{};       
      int               m_chain_counter{};       
      int               m_chain_version{};       
      std::string       m_level;               
      std::string       m_lower_chain_name;    
      int               m_lower_chain_counter{}; 
      std::vector<int>  m_lower_chain_counters;
      unsigned int      m_lower_chain_hash_id{}; 
      int               m_EB_after_step{};       
      std::vector<size_t> m_leg_multiplicities;
      HLTPrescale       m_prescales;
 
      std::vector<HLTSignature*>                         m_HLTSignatureList;
      std::vector<HLTTriggerType*>                       m_HLTTriggerTypeList;
      std::set<std::string>                              m_groups;
      std::vector<HLTStreamTag*>                         m_streams_orig;
      std::vector<HLTStreamTag*>                         m_streams;
      std::unordered_map<std::string, HLTStreamTag*>   m_streams_map;
 
      friend std::ostream & operator<<(std::ostream &, const HLTChain &);
 
   public:
      
      // temporary object to store the merge information
      struct {
         unsigned int l2{0};
         unsigned int ef{0};
      } mergeCounter;
   };
 
}
 
#endif