DD4hep  1.30.0
Detector Description Toolkit for High Energy Physics
Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
dd4hep::sim::Geant4RunActionSequence Class Reference

Concrete basic implementation of the Geant4 run action sequencer. More...

#include <Geant4RunAction.h>

Inheritance diagram for dd4hep::sim::Geant4RunActionSequence:
dd4hep::sim::Geant4Action

Public Member Functions

 Geant4RunActionSequence (Geant4Context *context, const std::string &nam)
 Standard constructor. More...
 
virtual ~Geant4RunActionSequence ()
 Default destructor. More...
 
virtual void updateContext (Geant4Context *ctxt) override
 Set or update client context. More...
 
virtual void configureFiber (Geant4Context *thread_context) override
 Set or update client for the use in a new thread fiber. More...
 
Geant4RunActionget (const std::string &name) const
 Get an action by name. More...
 
template<typename Q , typename T >
void callAtBegin (Q *p, void(T::*f)(const G4Run *))
 Register begin-of-run callback. Types Q and T must be polymorph! More...
 
template<typename Q , typename T >
void callAtEnd (Q *p, void(T::*f)(const G4Run *))
 Register end-of-run callback. Types Q and T must be polymorph! More...
 
void adopt (Geant4RunAction *action)
 Add an actor responding to all callbacks. Sequence takes ownership. More...
 
virtual void begin (const G4Run *run)
 Begin-of-run callback. More...
 
virtual void end (const G4Run *run)
 End-of-run callback. More...
 
- Public Member Functions inherited from dd4hep::sim::Geant4Action
 Geant4Action (Geant4Context *context, const std::string &nam)
 Standard constructor. More...
 
long addRef ()
 Increase reference count. More...
 
long release ()
 Decrease reference count. Implicit destruction. More...
 
Geant4Contextcontext () const
 Access the context. More...
 
const std::string & name () const
 Access name of the action. More...
 
const char * c_name () const
 Access name of the action. More...
 
void setName (const std::string &new_name)
 Set the object name. More...
 
PropertyManagerproperties ()
 Access to the properties of the object. More...
 
PrintLevel outputLevel () const
 Access the output level. More...
 
PrintLevel setOutputLevel (PrintLevel new_level)
 Set the output level; returns previous value. More...
 
Geant4UIMessengercontrol () const
 Access to the UI messenger. More...
 
virtual void enableUI ()
 Enable and install UI messenger. More...
 
template<typename T >
Geant4ActiondeclareProperty (const std::string &nam, T &val)
 Declare property. More...
 
template<typename T >
Geant4ActiondeclareProperty (const char *nam, T &val)
 Declare property. More...
 
bool hasProperty (const std::string &name) const
 Check property for existence. More...
 
Propertyproperty (const std::string &name)
 Access single property. More...
 
virtual void installMessengers ()
 Install property control messenger if wanted. More...
 
virtual void installCommandMessenger ()
 Install command control messenger if wanted. More...
 
virtual void installPropertyMessenger ()
 Install property control messenger if wanted. More...
 
void print (const char *fmt,...) const
 Support for messages with variable output level using output level. More...
 
void printM1 (const char *fmt,...) const
 Support for messages with variable output level using output level-1. More...
 
void printM2 (const char *fmt,...) const
 Support for messages with variable output level using output level-2. More...
 
void printP1 (const char *fmt,...) const
 Support for messages with variable output level using output level+1. More...
 
void printP2 (const char *fmt,...) const
 Support for messages with variable output level using output level+2. More...
 
void always (const char *fmt,...) const
 Support of always printed messages. More...
 
void debug (const char *fmt,...) const
 Support of debug messages. More...
 
void info (const char *fmt,...) const
 Support of info messages. More...
 
void warning (const char *fmt,...) const
 Support of warning messages. More...
 
void error (const char *fmt,...) const
 Support of error messages. More...
 
bool return_error (bool return_value, const char *fmt,...) const
 Action to support error messages. More...
 
void fatal (const char *fmt,...) const
 Support of fatal messages. Throws exception. More...
 
void except (const char *fmt,...) const
 Support of exceptions: Print fatal message and throw runtime_error. More...
 
void abortRun (const std::string &exception, const char *fmt,...) const
 Abort Geant4 Run by throwing a G4Exception with type RunMustBeAborted. More...
 
Geant4RunActionSequencerunAction () const
 Access to the main run action sequence from the kernel object. More...
 
Geant4EventActionSequenceeventAction () const
 Access to the main event action sequence from the kernel object. More...
 
Geant4SteppingActionSequencesteppingAction () const
 Access to the main stepping action sequence from the kernel object. More...
 
Geant4TrackingActionSequencetrackingAction () const
 Access to the main tracking action sequence from the kernel object. More...
 
Geant4StackingActionSequencestackingAction () const
 Access to the main stacking action sequence from the kernel object. More...
 
Geant4GeneratorActionSequencegeneratorAction () const
 Access to the main generator action sequence from the kernel object. More...
 

Protected Member Functions

 DDG4_DEFINE_ACTION_CONSTRUCTORS (Geant4RunActionSequence)
 Define standard assignments and constructors. More...
 
- Protected Member Functions inherited from dd4hep::sim::Geant4Action
 DDG4_DEFINE_ACTION_CONSTRUCTORS (Geant4Action)
 Define standard assignments and constructors. More...
 
virtual ~Geant4Action ()
 Default destructor. More...
 

Protected Attributes

CallbackSequence m_begin
 Callback sequence for begin-run action. More...
 
CallbackSequence m_end
 Callback sequence for end-run action. More...
 
Actors< Geant4RunActionm_actors
 The list of action objects to be called. More...
 
- Protected Attributes inherited from dd4hep::sim::Geant4Action
Geant4Contextm_context { nullptr }
 Reference to the Geant4 context. More...
 
Geant4UIMessengerm_control { nullptr }
 Control directory of this action. More...
 
int m_outputLevel { 3 }
 Default property: Output level. More...
 
bool m_needsControl { false }
 Default property: Flag to create control instance. More...
 
std::string m_name { }
 Action name. More...
 
PropertyManager m_properties { }
 Property pool. More...
 
long m_refCount { 1 }
 Reference count. Initial value: 1. More...
 

Detailed Description

Concrete basic implementation of the Geant4 run action sequencer.

Concrete implementation of the Geant4 run action sequence. The sequence dispatches the callbacks at the beginning and the and of a run to all registered Geant4RunAction members and all registered callbacks.

Note Multi-Threading issue: Callbacks and the action list is protected against multiple threads calling the Geant4 callbacks!

Author
M.Frank
Version
1.0

Definition at line 117 of file Geant4RunAction.h.

Constructor & Destructor Documentation

◆ Geant4RunActionSequence()

Geant4RunActionSequence::Geant4RunActionSequence ( Geant4Context context,
const std::string &  nam 
)

Standard constructor.

Definition at line 98 of file Geant4RunAction.cpp.

◆ ~Geant4RunActionSequence()

Geant4RunActionSequence::~Geant4RunActionSequence ( )
virtual

Default destructor.

Definition at line 105 of file Geant4RunAction.cpp.

Member Function Documentation

◆ adopt()

void Geant4RunActionSequence::adopt ( Geant4RunAction action)

Add an actor responding to all callbacks. Sequence takes ownership.

Definition at line 130 of file Geant4RunAction.cpp.

◆ begin()

void Geant4RunActionSequence::begin ( const G4Run *  run)
virtual

Begin-of-run callback.

Pre-track action callback.

Definition at line 141 of file Geant4RunAction.cpp.

◆ callAtBegin()

template<typename Q , typename T >
void dd4hep::sim::Geant4RunActionSequence::callAtBegin ( Q *  p,
void(T::*)(const G4Run *)  f 
)
inline

Register begin-of-run callback. Types Q and T must be polymorph!

Definition at line 144 of file Geant4RunAction.h.

◆ callAtEnd()

template<typename Q , typename T >
void dd4hep::sim::Geant4RunActionSequence::callAtEnd ( Q *  p,
void(T::*)(const G4Run *)  f 
)
inline

Register end-of-run callback. Types Q and T must be polymorph!

Definition at line 149 of file Geant4RunAction.h.

◆ configureFiber()

void Geant4RunActionSequence::configureFiber ( Geant4Context thread_context)
overridevirtual

Set or update client for the use in a new thread fiber.

Reimplemented from dd4hep::sim::Geant4Action.

Definition at line 120 of file Geant4RunAction.cpp.

◆ DDG4_DEFINE_ACTION_CONSTRUCTORS()

dd4hep::sim::Geant4RunActionSequence::DDG4_DEFINE_ACTION_CONSTRUCTORS ( Geant4RunActionSequence  )
protected

Define standard assignments and constructors.

◆ end()

void Geant4RunActionSequence::end ( const G4Run *  run)
virtual

End-of-run callback.

Post-track action callback.

Definition at line 148 of file Geant4RunAction.cpp.

◆ get()

Geant4RunAction * Geant4RunActionSequence::get ( const std::string &  name) const

Get an action by name.

Definition at line 125 of file Geant4RunAction.cpp.

◆ updateContext()

void Geant4RunActionSequence::updateContext ( Geant4Context ctxt)
overridevirtual

Set or update client context.

Reimplemented from dd4hep::sim::Geant4Action.

Definition at line 114 of file Geant4RunAction.cpp.

Member Data Documentation

◆ m_actors

Actors<Geant4RunAction> dd4hep::sim::Geant4RunActionSequence::m_actors
protected

The list of action objects to be called.

Definition at line 125 of file Geant4RunAction.h.

◆ m_begin

CallbackSequence dd4hep::sim::Geant4RunActionSequence::m_begin
protected

Callback sequence for begin-run action.

Definition at line 121 of file Geant4RunAction.h.

◆ m_end

CallbackSequence dd4hep::sim::Geant4RunActionSequence::m_end
protected

Callback sequence for end-run action.

Definition at line 123 of file Geant4RunAction.h.


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