Iguana LATEST
Implementation Guardian of Analysis Algorithms
Loading...
Searching...
No Matches
iguana::clas12::EventBuilderFilter Class Reference

#include <Algorithm.h>

Detailed Description

Algorithm: Filter the particle bank (REC::Particle, or similar) bank by PID from the Event Builder

Input and Output Banks:
See Run function(s) for the banks that are processed by this algorithm.
Type: Filter
This algorithm will filter input bank(s).
Configuration Options:
YAML configuration, which includes the default option values:
clas12::EventBuilderFilter:
# the name of the particle bank, only used for users of `hipo::banklist`;
# e.g., set it to 'MC::Particle' if you prefer
particle_bank: 'REC::Particle'
# list of PDG codes to filter for
pids: [ 11, 211, -211 ]

Definition at line 11 of file Algorithm.h.

Public Member Functions

bool Filter (int const pid) const
 Action Function: checks if the PDG pid is a part of the list of user-specified PDGs
std::deque< bool > Filter (std::vector< int > const pids) const
 Action Function: checks if the PDG pid is a part of the list of user-specified PDGs
bool Run (hipo::bank &particleBank) const
 Run Function: Process an event's hipo::bank objects
Public Member Functions inherited from iguana::Algorithm
 Algorithm (std::string_view name)
hipo::banklist::size_type GetBankIndex (hipo::banklist &banks, std::string const &bank_name) const noexcept(false)
std::unique_ptr< YAMLReader > const & GetConfig () const
hipo::bank GetCreatedBank (std::string const &bank_name="") const noexcept(false)
hipo::banklist::size_type GetCreatedBankIndex (hipo::banklist &banks) const noexcept(false)
std::string GetCreatedBankName () const noexcept(false)
std::vector< std::string > GetCreatedBankNames () const noexcept(false)
hipo::schema GetCreatedBankSchema (std::string const &bank_name="") const noexcept(false)
unsigned int GetCreatedBankVariant () const
template<typename OPTION_TYPE>
OPTION_TYPE GetOptionScalar (YAMLReader::node_path_t node_path={}) const
template<typename OPTION_TYPE>
std::set< OPTION_TYPE > GetOptionSet (YAMLReader::node_path_t node_path={}) const
template<typename OPTION_TYPE>
std::vector< OPTION_TYPE > GetOptionVector (YAMLReader::node_path_t node_path={}) const
std::unique_ptr< RCDBReader > & GetRCDBReader ()
virtual bool Run (hipo::banklist &banks) const final
 Run Function: Process an event's hipo::banklist
void SetConfig (std::unique_ptr< YAMLReader > &&yaml_config)
void SetConfigDirectory (std::string const &name)
void SetConfigFile (std::string const &name)
void SetName (std::string_view name)
template<typename OPTION_TYPE>
OPTION_TYPE SetOption (std::string const &key, const OPTION_TYPE val)
 Set an option specified by the user.
virtual void Start () final
 Start Function: Initialize this algorithm before any events are processed, with the intent to process either hipo::bank objects or bank rows, rather than full hipo::banklist objects
virtual void Start (hipo::banklist &banks) final
 Start Function: Initialize this algorithm before any events are processed, with the intent to process hipo::banklist objects
virtual void Stop () final
 Stop Function: Finalize this algorithm after all events are processed.
Public Member Functions inherited from iguana::Object
 Object (std::string_view name="", Logger::Level lev=Logger::DEFAULT_LEVEL)
std::unique_ptr< Logger > & GetLog ()
std::string GetName () const
std::unique_ptr< Logger > & Log ()
void SetLogLevel (Logger::Level const lev)
void SetLogLevel (std::string_view lev)
void SetName (std::string_view name)

Additional Inherited Members

Protected Member Functions inherited from iguana::Algorithm
hipo::schema CreateBank (hipo::banklist &banks, hipo::banklist::size_type &bank_idx, std::string const &bank_name) noexcept(false)
hipo::bank & GetBank (hipo::banklist &banks, hipo::banklist::size_type const idx, std::string const &expected_bank_name="") const noexcept(false)
void ShowBank (hipo::bank const &bank, std::string_view message="", Logger::Level const level=Logger::trace) const
void ShowBanks (hipo::banklist const &banks, std::string_view message="", Logger::Level const level=Logger::trace) const
void StartRCDBReader ()
 Instantiate the RCDBReader instance for this algorithm.
void ThrowSinceRenamed (std::string const &new_name, std::string const &version) const noexcept(false)
Protected Attributes inherited from iguana::Algorithm
std::string m_class_name
 Class name of this algorithm.
unsigned int m_created_bank_variant {0}
std::string m_default_config_file
 Default configuration file name.
std::mutex m_mutex
 A mutex for this algorithm.
std::unique_ptr< RCDBReaderm_rcdb
 RCDB reader.
bool m_rows_only
 If true, algorithm can only operate on bank rows; Algorithm::GetBank, and therefore Algorithm::Run, cannot be called.
std::string o_user_config_dir
std::string o_user_config_file
Protected Attributes inherited from iguana::Object
std::unique_ptr< Loggerm_log
 Logger instance for this object
std::string m_name
 The name of this object.
Inheritance diagram for iguana::clas12::EventBuilderFilter:
Inheritance graph

Member Function Documentation

◆ Filter() [1/2]

bool iguana::clas12::EventBuilderFilter::Filter ( int const pid) const

Action Function: checks if the PDG pid is a part of the list of user-specified PDGs

Function Type
scalar filter
Parameters
pidthe particle PDG to check
Returns
true if pid is one the user wants

◆ Filter() [2/2]

std::deque< bool > iguana::clas12::EventBuilderFilter::Filter ( std::vector< int > const pids) const

Action Function: checks if the PDG pid is a part of the list of user-specified PDGs

Function Type
vector filter
Note
This vector action function overloads a corresponding scalar action function; see that scalar action function for more documentation.
Parameters
pidsthe list of particle PDGs to check
Returns
list of booleans which are true for pids the user wants

◆ Run()

bool iguana::clas12::EventBuilderFilter::Run ( hipo::bank & particleBank) const

Run Function: Process an event's hipo::bank objects

The parameter list explains which banks are input ("in"), output ("out"), or both ("in,out").

Parameters
[in,out]particleBankparticle bank (e.g., REC::Particle), which will be filtered
Returns
false if all particles are filtered out

The documentation for this class was generated from the following file:
  • /__w/iguana/iguana/iguana_src/src/iguana/algorithms/clas12/EventBuilderFilter/Algorithm.h