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

#include <Geant4StackingAction.h>

Inheritance diagram for dd4hep::sim::Geant4StackingActionSequence:

Public Member Functions
	Geant4StackingActionSequence (Geant4Context *ctxt, const std::string &name)
	Standard constructor. More...

virtual	~Geant4StackingActionSequence ()
	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...

Geant4StackingAction *	get (const std::string &name) const
	Get an action by name. More...

template<typename T >
void	callAtNewStage (T p, void(T::f)(G4StackManager *))
	Register begin-of-event callback. Types Q and T must be polymorph! More...

template<typename T >
void	callAtPrepare (T p, void(T::f)(G4StackManager *))
	Register end-of-event callback. Types Q and T must be polymorph! More...

void	adopt (Geant4StackingAction *action)
	Add an actor responding to all callbacks. Sequence takes ownership. More...

virtual void	newStage (G4StackManager *stackManager)
	New-stage callback. More...

virtual void	prepare (G4StackManager *stackManager)
	Preparation callback. More...

virtual TrackClassification	classifyNewTrack (G4StackManager stackManager, const G4Track track)
	Classify new track: The first call in the sequence returning non-null pointer wins! 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...

Geant4Context *	context () 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...

PropertyManager &	properties ()
	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...

Geant4UIMessenger *	control () const
	Access to the UI messenger. More...

virtual void	enableUI ()
	Enable and install UI messenger. More...

template<typename T >
Geant4Action &	declareProperty (const std::string &nam, T &val)
	Declare property. More...

template<typename T >
Geant4Action &	declareProperty (const char *nam, T &val)
	Declare property. More...

bool	hasProperty (const std::string &name) const
	Check property for existence. More...

Property &	property (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...

Geant4RunActionSequence &	runAction () const
	Access to the main run action sequence from the kernel object. More...

Geant4EventActionSequence &	eventAction () const
	Access to the main event action sequence from the kernel object. More...

Geant4SteppingActionSequence &	steppingAction () const
	Access to the main stepping action sequence from the kernel object. More...

Geant4TrackingActionSequence &	trackingAction () const
	Access to the main tracking action sequence from the kernel object. More...

Geant4StackingActionSequence &	stackingAction () const
	Access to the main stacking action sequence from the kernel object. More...

Geant4GeneratorActionSequence &	generatorAction () const
	Access to the main generator action sequence from the kernel object. More...

Protected Member Functions
	DDG4_DEFINE_ACTION_CONSTRUCTORS (Geant4StackingActionSequence)
	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_newStage
	Callback sequence for the newStage call. More...

CallbackSequence	m_prepare

Actors< Geant4StackingAction >	m_actors
	The list of action objects to be called. More...

Protected Attributes inherited from dd4hep::sim::Geant4Action
Geant4Context *	m_context { nullptr }
	Reference to the Geant4 context. More...

Geant4UIMessenger *	m_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 stacking action sequence.

The sequence dispatches the callbacks for each stepping action to all registered Geant4StackingAction 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 128 of file Geant4StackingAction.h.

Constructor & Destructor Documentation

◆ Geant4StackingActionSequence()

Geant4StackingActionSequence::Geant4StackingActionSequence	(	Geant4Context *	ctxt,
		const std::string &	name
	)

Standard constructor.

Definition at line 107 of file Geant4StackingAction.cpp.

◆ ~Geant4StackingActionSequence()

Geant4StackingActionSequence::~Geant4StackingActionSequence ( )

virtual

Default destructor.

Definition at line 114 of file Geant4StackingAction.cpp.

Member Function Documentation

◆ adopt()

void Geant4StackingActionSequence::adopt ( Geant4StackingAction * action )

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

Definition at line 123 of file Geant4StackingAction.cpp.

◆ callAtNewStage()

template<typename T >

void dd4hep::sim::Geant4StackingActionSequence::callAtNewStage	(	T *	p,
		void(T::)(G4StackManager )	f
	)

inline

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

Definition at line 151 of file Geant4StackingAction.h.

◆ callAtPrepare()

template<typename T >

void dd4hep::sim::Geant4StackingActionSequence::callAtPrepare	(	T *	p,
		void(T::)(G4StackManager )	f
	)

inline

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

Definition at line 155 of file Geant4StackingAction.h.

◆ classifyNewTrack()

TrackClassification Geant4StackingActionSequence::classifyNewTrack	(	G4StackManager *	stackManager,
		const G4Track *	track
	)

virtual

Classify new track: The first call in the sequence returning non-null pointer wins!

Definition at line 162 of file Geant4StackingAction.cpp.

◆ configureFiber()

void Geant4StackingActionSequence::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 139 of file Geant4StackingAction.cpp.

◆ DDG4_DEFINE_ACTION_CONSTRUCTORS()

dd4hep::sim::Geant4StackingActionSequence::DDG4_DEFINE_ACTION_CONSTRUCTORS ( Geant4StackingActionSequence )

protected

Define standard assignments and constructors.

◆ get()

Geant4StackingAction * Geant4StackingActionSequence::get ( const std::string & name ) const

Get an action by name.

Definition at line 144 of file Geant4StackingAction.cpp.

◆ newStage()

void Geant4StackingActionSequence::newStage ( G4StackManager * stackManager )

virtual

New-stage callback.

Pre-track action callback.

Definition at line 149 of file Geant4StackingAction.cpp.

◆ prepare()

void Geant4StackingActionSequence::prepare ( G4StackManager * stackManager )

virtual

Preparation callback.

Post-track action callback.

Definition at line 155 of file Geant4StackingAction.cpp.

◆ updateContext()

void Geant4StackingActionSequence::updateContext ( Geant4Context * ctxt )

overridevirtual

Set or update client context.

Reimplemented from dd4hep::sim::Geant4Action.

Definition at line 133 of file Geant4StackingAction.cpp.

Member Data Documentation

◆ m_actors

Actors<Geant4StackingAction> dd4hep::sim::Geant4StackingActionSequence::m_actors

protected

The list of action objects to be called.

Definition at line 135 of file Geant4StackingAction.h.

◆ m_newStage

CallbackSequence dd4hep::sim::Geant4StackingActionSequence::m_newStage

protected

Callback sequence for the newStage call.

Definition at line 131 of file Geant4StackingAction.h.

◆ m_prepare

CallbackSequence dd4hep::sim::Geant4StackingActionSequence::m_prepare

protected

Definition at line 133 of file Geant4StackingAction.h.

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

DDG4/include/DDG4/Geant4StackingAction.h
DDG4/src/Geant4StackingAction.cpp

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ Geant4StackingActionSequence()

◆ ~Geant4StackingActionSequence()

Member Function Documentation

◆ adopt()

◆ callAtNewStage()

◆ callAtPrepare()

◆ classifyNewTrack()

◆ configureFiber()

◆ DDG4_DEFINE_ACTION_CONSTRUCTORS()

◆ get()

◆ newStage()

◆ prepare()

◆ updateContext()

Member Data Documentation

◆ m_actors

◆ m_newStage

◆ m_prepare