ATLAS Offline Software
Public Member Functions | Public Attributes | Private Member Functions | Private Attributes | List of all members
EL::UnitTestAlg Class Reference

#include <UnitTestAlg.h>

Inheritance diagram for EL::UnitTestAlg:
Collaboration diagram for EL::UnitTestAlg:

Public Member Functions

void testInvariant () const
 effects: test the invariant of this object guarantee: no-fail More...
 
 UnitTestAlg (const std::string &branchName="el_n")
 effects: standard constructor. More...
 
IWorkerwk () const
 description: the worker that is controlling us guarantee: no-fail More...
 
void book (const TH1 &hist)
 book the given histogram More...
 
TH1hist (const std::string &name) const
 get the histogram with the given name More...
 
asg::SgTEventevtStore () const
 get the (main) event store for this algorithm More...
 
virtual const std::string & name () const
 

Public Attributes

bool makeOutput
 description: whether I create an output n-tuple More...
 

Private Member Functions

virtual StatusCode setupJob (Job &job) override
 effects: give the algorithm a chance to intialize the job with anything this algorithm needs. More...
 
virtual StatusCode changeInput (bool firstFile) override
 effects: do all changes to work with a new input file, e.g. More...
 
virtual StatusCode initialize () override
 effects: do everything that needs to be done before running the algorithm, e.g. More...
 
virtual StatusCode histInitialize () override
 effects: this is a pre-initialization routine that is called before changeInput is called. More...
 
virtual StatusCode execute () override
 effects: process the next event guarantee: basic failures: algorithm dependent rationale: the virtual part of Algorithm::process More...
 
virtual StatusCode fileExecute () override
 effects: do all the processing that needs to be done once per file guarantee: basic failures: algorithm dependent rationale: this is to read per-file accounting data, e.g. More...
 
virtual StatusCode finalize () override
 effects: do everything that needs to be done after completing work on this worker guarantee: basic failures: algorithm dependent rationale: currently there is no use foreseen, but this routine is provided regardless rationale: the virtual part of Algorithm::process More...
 
virtual StatusCode histFinalize () override
 effects: this is a post-initialization routine that is called after finalize has been called. More...
 
 ClassDef (UnitTestAlg, 1)
 
virtual StatusCode endOfFile ()
 effects: do the post-processing for each input file guarantee: basic failures: algorithm dependent rationale: this is mainly used for specialized services that need to save partial results for each input file More...
 
virtual StatusCode postExecute ()
 effects: do the post-processing for the event guarantee: basic failures: algorithm dependent rationale: this is mainly used for specialized services that need to get input from subsequent algorithms before filling their event data More...
 
virtual bool hasName (const std::string &name) const
 returns: whether this algorithm has the given name guarantee: basic failures: algorithm dependent rationale: this is to allow an algorithm to be known by multiple names. More...
 
void sysSetupJob (Job &job)
 effects: give the algorithm a chance to intialize the job with anything this algorithm needs. More...
 

Private Attributes

std::string m_name
 description: the name of the variable we are using More...
 
TBranch * m_branch
 description: the branch we are using More...
 
Int_t m_value
 description: the value we are reading from the branch More...
 
TTree * m_tree
 description: the histogram we are creating More...
 
std::string m_fileName
 the name of the file (for testing changeInput) More...
 
bool m_hasInitialize
 whether initialize has been called More...
 
bool m_hasHistInitialize
 whether histInitialize has been called More...
 
unsigned m_calls = 0
 
IWorkerm_wk
 
asg::SgTEventm_evtStorePtr = nullptr
 the value of evtStore More...
 
asg::SgTEvent m_evtStore
 when configured, the object returned by evtStore More...
 
MsgStream * m_msg = nullptr
 the message stream, if it has been instantiated More...
 
std::string m_msgName
 the algorithm name for which the message stream has been instantiated More...
 
int m_msgLevel = 3
 the message level configured More...
 
std::string m_nameCache
 the cache for name More...
 

Detailed Description

Definition at line 33 of file UnitTestAlg.h.

Constructor & Destructor Documentation

◆ UnitTestAlg()

EL::UnitTestAlg::UnitTestAlg ( const std::string &  branchName = "el_n")

effects: standard constructor.

initialize with a branch of type Int_t guarantee: strong failures: low level errors II

Member Function Documentation

◆ book()

void EL::Algorithm::book ( const TH1 hist)
inherited

book the given histogram

Guarantee
strong
Failures
histogram booking error

◆ changeInput()

virtual StatusCode EL::UnitTestAlg::changeInput ( bool  firstFile)
overrideprivatevirtual

effects: do all changes to work with a new input file, e.g.

set new branch addresses. if firstFile is set, this method is called just before init() is called guarantee: basic failures: algorithm dependent

Reimplemented from EL::Algorithm.

◆ ClassDef()

EL::UnitTestAlg::ClassDef ( UnitTestAlg  ,
 
)
private

◆ endOfFile()

virtual StatusCode EL::Algorithm::endOfFile ( )
privatevirtualinherited

effects: do the post-processing for each input file guarantee: basic failures: algorithm dependent rationale: this is mainly used for specialized services that need to save partial results for each input file

Reimplemented in EL::MetricsSvc.

◆ evtStore()

asg::SgTEvent* EL::Algorithm::evtStore ( ) const
inherited

get the (main) event store for this algorithm

This is mostly to mirror the method of the same name in AthAlgorithm, allowing to make the tutorial instructions more dual-use.

Guarantee
strong
Failures
out of memory I
job not configured for xAODs

◆ execute()

virtual StatusCode EL::UnitTestAlg::execute ( )
overrideprivatevirtual

effects: process the next event guarantee: basic failures: algorithm dependent rationale: the virtual part of Algorithm::process

Reimplemented from EL::Algorithm.

◆ fileExecute()

virtual StatusCode EL::UnitTestAlg::fileExecute ( )
overrideprivatevirtual

effects: do all the processing that needs to be done once per file guarantee: basic failures: algorithm dependent rationale: this is to read per-file accounting data, e.g.

the list of lumi-blocks processed

Reimplemented from EL::Algorithm.

◆ finalize()

virtual StatusCode EL::UnitTestAlg::finalize ( )
overrideprivatevirtual

effects: do everything that needs to be done after completing work on this worker guarantee: basic failures: algorithm dependent rationale: currently there is no use foreseen, but this routine is provided regardless rationale: the virtual part of Algorithm::process

Reimplemented from EL::Algorithm.

◆ hasName()

virtual bool EL::Algorithm::hasName ( const std::string &  name) const
privatevirtualinherited

returns: whether this algorithm has the given name guarantee: basic failures: algorithm dependent rationale: this is to allow an algorithm to be known by multiple names.

this is needed for NTupleSvc, so that it can be located with and without the output tree name.

Reimplemented in EL::NTupleSvc.

◆ hist()

TH1* EL::Algorithm::hist ( const std::string &  name) const
inherited

get the histogram with the given name

Guarantee
strong
Failures
histogram not found

◆ histFinalize()

virtual StatusCode EL::UnitTestAlg::histFinalize ( )
overrideprivatevirtual

effects: this is a post-initialization routine that is called after finalize has been called.

guarantee: basic failures: algorithm dependent rationale: unlike finalize(), this method is called all the time, even on empty input files.

Reimplemented from EL::Algorithm.

◆ histInitialize()

virtual StatusCode EL::UnitTestAlg::histInitialize ( )
overrideprivatevirtual

effects: this is a pre-initialization routine that is called before changeInput is called.

guarantee: basic failures: algorithm dependent rationale: unlike initialize(), this method is called all the time, even on empty input files. so you should create any histograms or n-tuples here that subsequent code expects

Reimplemented from EL::Algorithm.

◆ initialize()

virtual StatusCode EL::UnitTestAlg::initialize ( )
overrideprivatevirtual

effects: do everything that needs to be done before running the algorithm, e.g.

create output n-tuples and histograms. this method is called only once right after changeInput(true) is called guarantee: basic failures: algorithm dependent rationale: in principle all this work could be done on changeInput(true). However, providing this method should make it easier for the user to set up all his outputs and to do so only once.

Reimplemented from EL::Algorithm.

◆ msg() [1/2]

MsgStream& EL::Algorithm::msg ( ) const
inherited

messaging interface

this is the interface to work with the standard messaging macros from AsgTools. Instead of enums I pass ints, so that I can avoid the include dependency (forward declarations are only allowed for enum classes AFAIK).

the standard message stream for this object

Guarantee
strong
Failures
code not compiled with AsgTools support

◆ msg() [2/2]

MsgStream& EL::Algorithm::msg ( int  level) const
inherited

the message stream for this object, configured for the given level

Guarantee
strong
Failures
code not compiled with AsgTools support

◆ msgLvl()

bool EL::Algorithm::msgLvl ( int  lvl) const
inherited

whether we are configured to print messages at the given level

Guarantee
no-fail

◆ name()

virtual const std::string& EL::Algorithm::name ( ) const
virtualinherited

◆ postExecute()

virtual StatusCode EL::Algorithm::postExecute ( )
privatevirtualinherited

effects: do the post-processing for the event guarantee: basic failures: algorithm dependent rationale: this is mainly used for specialized services that need to get input from subsequent algorithms before filling their event data

Reimplemented in EL::NTupleSvc.

◆ setMsgLevel()

void EL::Algorithm::setMsgLevel ( int  level)
inherited

set the message level for the message stream for this object

Guarantee
no-fail

◆ setupJob()

virtual StatusCode EL::UnitTestAlg::setupJob ( Job job)
overrideprivatevirtual

effects: give the algorithm a chance to intialize the job with anything this algorithm needs.

this method is automatically called before the algorithm is actually added to the job. guarantee: basic failures: algorithm dependent rationale: this is currently used to give algorithms a chance to register their output datasets, but can also be used for other stuff.

Reimplemented from EL::Algorithm.

◆ sysSetupJob()

void EL::Algorithm::sysSetupJob ( Job job)
privateinherited

effects: give the algorithm a chance to intialize the job with anything this algorithm needs.

this method is automatically called before the algorithm is actually added to the job. guarantee: basic failures: algorithm dependent rationale: this is currently used to give algorithms a chance to register their output datasets, but can also be used for other stuff.

◆ testInvariant()

void EL::UnitTestAlg::testInvariant ( ) const

effects: test the invariant of this object guarantee: no-fail

◆ wk()

IWorker* EL::Algorithm::wk ( ) const
inherited

description: the worker that is controlling us guarantee: no-fail

Member Data Documentation

◆ m_branch

TBranch* EL::UnitTestAlg::m_branch
private

description: the branch we are using

Definition at line 151 of file UnitTestAlg.h.

◆ m_calls

unsigned EL::UnitTestAlg::m_calls = 0
private

Definition at line 178 of file UnitTestAlg.h.

◆ m_evtStore

asg::SgTEvent EL::Algorithm::m_evtStore
mutableprivateinherited

when configured, the object returned by evtStore

Definition at line 329 of file Algorithm.h.

◆ m_evtStorePtr

asg::SgTEvent* EL::Algorithm::m_evtStorePtr = nullptr
mutableprivateinherited

the value of evtStore

Definition at line 325 of file Algorithm.h.

◆ m_fileName

std::string EL::UnitTestAlg::m_fileName
private

the name of the file (for testing changeInput)

Definition at line 167 of file UnitTestAlg.h.

◆ m_hasHistInitialize

bool EL::UnitTestAlg::m_hasHistInitialize
private

whether histInitialize has been called

Definition at line 175 of file UnitTestAlg.h.

◆ m_hasInitialize

bool EL::UnitTestAlg::m_hasInitialize
private

whether initialize has been called

Definition at line 171 of file UnitTestAlg.h.

◆ m_msg

MsgStream* EL::Algorithm::m_msg = nullptr
mutableprivateinherited

the message stream, if it has been instantiated

Definition at line 333 of file Algorithm.h.

◆ m_msgLevel

int EL::Algorithm::m_msgLevel = 3
privateinherited

the message level configured

Definition at line 342 of file Algorithm.h.

◆ m_msgName

std::string EL::Algorithm::m_msgName
mutableprivateinherited

the algorithm name for which the message stream has been instantiated

Definition at line 338 of file Algorithm.h.

◆ m_name

std::string EL::UnitTestAlg::m_name
private

description: the name of the variable we are using

Definition at line 147 of file UnitTestAlg.h.

◆ m_nameCache

std::string EL::Algorithm::m_nameCache
mutableprivateinherited

the cache for name

Definition at line 346 of file Algorithm.h.

◆ m_tree

TTree* EL::UnitTestAlg::m_tree
private

description: the histogram we are creating

description: the tree we are creating

Definition at line 163 of file UnitTestAlg.h.

◆ m_value

Int_t EL::UnitTestAlg::m_value
private

description: the value we are reading from the branch

Definition at line 155 of file UnitTestAlg.h.

◆ m_wk

IWorker* EL::Algorithm::m_wk
privateinherited

Definition at line 321 of file Algorithm.h.

◆ makeOutput

bool EL::UnitTestAlg::makeOutput

description: whether I create an output n-tuple

Definition at line 55 of file UnitTestAlg.h.


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