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

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

#include <Geant4SteppingAction.h>

Inheritance diagram for dd4hep::sim::Geant4SteppingActionSequence:
dd4hep::sim::Geant4Action

Public Member Functions

 Geant4SteppingActionSequence (Geant4Context *context, const std::string &name)
 Standard constructor. More...
 
virtual ~Geant4SteppingActionSequence ()
 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...
 
Geant4SteppingActionget (const std::string &name) const
 Get an action by name. More...
 
template<typename Q , typename T >
void call (Q *p, void(T::*f)(const G4Step *, G4SteppingManager *))
 Register stepping action callback. Types Q and T must be polymorph! More...
 
void adopt (Geant4SteppingAction *action)
 Add an actor responding to all callbacks. Sequence takes ownership. More...
 
virtual void operator() (const G4Step *step, G4SteppingManager *mgr)
 User stepping 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 (Geant4SteppingActionSequence)
 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_calls
 Callback sequence for user stepping action calls. More...
 
Actors< Geant4SteppingActionm_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 stepping action sequence.

The sequence dispatches the callbacks for each stepping 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 104 of file Geant4SteppingAction.h.

Constructor & Destructor Documentation

◆ Geant4SteppingActionSequence()

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

Standard constructor.

Definition at line 82 of file Geant4SteppingAction.cpp.

◆ ~Geant4SteppingActionSequence()

Geant4SteppingActionSequence::~Geant4SteppingActionSequence ( )
virtual

Default destructor.

Definition at line 89 of file Geant4SteppingAction.cpp.

Member Function Documentation

◆ adopt()

void Geant4SteppingActionSequence::adopt ( Geant4SteppingAction action)

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

Definition at line 119 of file Geant4SteppingAction.cpp.

◆ call()

template<typename Q , typename T >
void dd4hep::sim::Geant4SteppingActionSequence::call ( Q *  p,
void(T::*)(const G4Step *, G4SteppingManager *)  f 
)
inline

Register stepping action callback. Types Q and T must be polymorph!

Definition at line 127 of file Geant4SteppingAction.h.

◆ configureFiber()

void Geant4SteppingActionSequence::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 97 of file Geant4SteppingAction.cpp.

◆ DDG4_DEFINE_ACTION_CONSTRUCTORS()

dd4hep::sim::Geant4SteppingActionSequence::DDG4_DEFINE_ACTION_CONSTRUCTORS ( Geant4SteppingActionSequence  )
protected

Define standard assignments and constructors.

◆ get()

Geant4SteppingAction * Geant4SteppingActionSequence::get ( const std::string &  name) const

Get an action by name.

Definition at line 108 of file Geant4SteppingAction.cpp.

◆ operator()()

void Geant4SteppingActionSequence::operator() ( const G4Step *  step,
G4SteppingManager *  mgr 
)
virtual

User stepping callback.

Pre-track action callback.

Definition at line 113 of file Geant4SteppingAction.cpp.

◆ updateContext()

void Geant4SteppingActionSequence::updateContext ( Geant4Context ctxt)
overridevirtual

Set or update client context.

Reimplemented from dd4hep::sim::Geant4Action.

Definition at line 102 of file Geant4SteppingAction.cpp.

Member Data Documentation

◆ m_actors

Actors<Geant4SteppingAction> dd4hep::sim::Geant4SteppingActionSequence::m_actors
protected

The list of action objects to be called.

Definition at line 109 of file Geant4SteppingAction.h.

◆ m_calls

CallbackSequence dd4hep::sim::Geant4SteppingActionSequence::m_calls
protected

Callback sequence for user stepping action calls.

Definition at line 107 of file Geant4SteppingAction.h.


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