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::Geant4TrackingActionSequence Class Reference

Concrete implementation of the Geant4 tracking action sequence. More...

#include <Geant4TrackingAction.h>

Inheritance diagram for dd4hep::sim::Geant4TrackingActionSequence:
dd4hep::sim::Geant4Action

Public Member Functions

 Geant4TrackingActionSequence (Geant4Context *context, const std::string &name)
 Standard constructor. More...
 
virtual ~Geant4TrackingActionSequence ()
 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...
 
Geant4TrackingActionget (const std::string &name) const
 Get an action by name. More...
 
template<typename Q , typename T >
void callUpFront (Q *p, void(T::*f)(const G4Track *), CallbackSequence::Location where=CallbackSequence::END)
 Register Pre-track action callback before anything else. More...
 
template<typename Q , typename T >
void callAtBegin (Q *p, void(T::*f)(const G4Track *), CallbackSequence::Location where=CallbackSequence::END)
 Register Pre-track action callback. More...
 
template<typename Q , typename T >
void callAtEnd (Q *p, void(T::*f)(const G4Track *), CallbackSequence::Location where=CallbackSequence::END)
 Register Post-track action callback. More...
 
template<typename Q , typename T >
void callAtFinal (Q *p, void(T::*f)(const G4Track *), CallbackSequence::Location where=CallbackSequence::END)
 Register Post-track action callback. More...
 
void adopt (Geant4TrackingAction *action)
 Add an actor responding to all callbacks. Sequence takes ownership. More...
 
virtual void begin (const G4Track *track)
 Pre-tracking action callback. More...
 
virtual void end (const G4Track *track)
 Post-tracking action 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 (Geant4TrackingActionSequence)
 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_front
 Callback sequence for pre tracking action. More...
 
CallbackSequence m_begin
 Callback sequence for pre tracking action. More...
 
CallbackSequence m_end
 Callback sequence for post tracking action. More...
 
CallbackSequence m_final
 Callback sequence for pre tracking action. More...
 
Actors< Geant4TrackingActionm_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 implementation of the Geant4 tracking action sequence.

The sequence dispatches the callbacks for each tracking action to all registered Geant4SteppingAction members and all registered callbacks.

Note Multi-Threading issue: Neither callbacks not the action list is protected against multiple threads calling the Geant4 callbacks! These must be protected in the user actions themselves.

Author
M.Frank
Version
1.0

Definition at line 114 of file Geant4TrackingAction.h.

Constructor & Destructor Documentation

◆ Geant4TrackingActionSequence()

Geant4TrackingActionSequence::Geant4TrackingActionSequence ( Geant4Context context,
const std::string &  name 
)

Standard constructor.

Definition at line 36 of file Geant4TrackingAction.cpp.

◆ ~Geant4TrackingActionSequence()

Geant4TrackingActionSequence::~Geant4TrackingActionSequence ( )
virtual

Default destructor.

Definition at line 43 of file Geant4TrackingAction.cpp.

Member Function Documentation

◆ adopt()

void Geant4TrackingActionSequence::adopt ( Geant4TrackingAction action)

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

Definition at line 70 of file Geant4TrackingAction.cpp.

◆ begin()

void Geant4TrackingActionSequence::begin ( const G4Track *  track)
virtual

Pre-tracking action callback.

Pre-track action callback.

Definition at line 81 of file Geant4TrackingAction.cpp.

◆ callAtBegin()

template<typename Q , typename T >
void dd4hep::sim::Geant4TrackingActionSequence::callAtBegin ( Q *  p,
void(T::*)(const G4Track *)  f,
CallbackSequence::Location  where = CallbackSequence::END 
)
inline

Register Pre-track action callback.

Definition at line 150 of file Geant4TrackingAction.h.

◆ callAtEnd()

template<typename Q , typename T >
void dd4hep::sim::Geant4TrackingActionSequence::callAtEnd ( Q *  p,
void(T::*)(const G4Track *)  f,
CallbackSequence::Location  where = CallbackSequence::END 
)
inline

Register Post-track action callback.

Definition at line 156 of file Geant4TrackingAction.h.

◆ callAtFinal()

template<typename Q , typename T >
void dd4hep::sim::Geant4TrackingActionSequence::callAtFinal ( Q *  p,
void(T::*)(const G4Track *)  f,
CallbackSequence::Location  where = CallbackSequence::END 
)
inline

Register Post-track action callback.

Definition at line 162 of file Geant4TrackingAction.h.

◆ callUpFront()

template<typename Q , typename T >
void dd4hep::sim::Geant4TrackingActionSequence::callUpFront ( Q *  p,
void(T::*)(const G4Track *)  f,
CallbackSequence::Location  where = CallbackSequence::END 
)
inline

Register Pre-track action callback before anything else.

Definition at line 144 of file Geant4TrackingAction.h.

◆ configureFiber()

void Geant4TrackingActionSequence::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 60 of file Geant4TrackingAction.cpp.

◆ DDG4_DEFINE_ACTION_CONSTRUCTORS()

dd4hep::sim::Geant4TrackingActionSequence::DDG4_DEFINE_ACTION_CONSTRUCTORS ( Geant4TrackingActionSequence  )
protected

Define standard assignments and constructors.

◆ end()

void Geant4TrackingActionSequence::end ( const G4Track *  track)
virtual

Post-tracking action callback.

Post-track action callback.

Definition at line 88 of file Geant4TrackingAction.cpp.

◆ get()

Geant4TrackingAction * Geant4TrackingActionSequence::get ( const std::string &  name) const

Get an action by name.

Definition at line 65 of file Geant4TrackingAction.cpp.

◆ updateContext()

void Geant4TrackingActionSequence::updateContext ( Geant4Context ctxt)
overridevirtual

Set or update client context.

Reimplemented from dd4hep::sim::Geant4Action.

Definition at line 54 of file Geant4TrackingAction.cpp.

Member Data Documentation

◆ m_actors

Actors<Geant4TrackingAction> dd4hep::sim::Geant4TrackingActionSequence::m_actors
protected

The list of action objects to be called.

Definition at line 125 of file Geant4TrackingAction.h.

◆ m_begin

CallbackSequence dd4hep::sim::Geant4TrackingActionSequence::m_begin
protected

Callback sequence for pre tracking action.

Definition at line 119 of file Geant4TrackingAction.h.

◆ m_end

CallbackSequence dd4hep::sim::Geant4TrackingActionSequence::m_end
protected

Callback sequence for post tracking action.

Definition at line 121 of file Geant4TrackingAction.h.

◆ m_final

CallbackSequence dd4hep::sim::Geant4TrackingActionSequence::m_final
protected

Callback sequence for pre tracking action.

Definition at line 123 of file Geant4TrackingAction.h.

◆ m_front

CallbackSequence dd4hep::sim::Geant4TrackingActionSequence::m_front
protected

Callback sequence for pre tracking action.

Definition at line 117 of file Geant4TrackingAction.h.


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