Base class to initialize a multi-threaded or single threaded Geant4 application. More...

#include <Geant4PythonDetectorConstruction.h>

Inheritance diagram for dd4hep::sim::Geant4PythonDetectorConstruction:

Public Member Functions
	Geant4PythonDetectorConstruction (Geant4Context *c, const std::string &nam)
	Standard constructor. More...

virtual	~Geant4PythonDetectorConstruction ()
	Default destructor. More...

void	setConstructGeo (PyObject callable, PyObject args)
	Set the Detector initialization command. More...

void	setConstructField (PyObject callable, PyObject args)
	Set the field initialization command. More...

void	setConstructSensitives (PyObject callable, PyObject args)
	Set the sensitive detector initialization command. More...

virtual void	constructGeo (Geant4DetectorConstructionContext *ctxt) override
	Geometry construction callback. Called at "Construct()". More...

virtual void	constructField (Geant4DetectorConstructionContext *ctxt) override
	Electromagnetic field construction callback. Called at "ConstructSDandField()". More...

virtual void	constructSensitives (Geant4DetectorConstructionContext *ctxt) override
	Sensitive detector construction callback. Called at "ConstructSDandField()". More...

Public Member Functions inherited from dd4hep::sim::Geant4DetectorConstruction
	Geant4DetectorConstruction (Geant4Context *context, const std::string &nam)
	Standard Constructor. More...

virtual	~Geant4DetectorConstruction ()
	Default destructor. More...

virtual G4VSensitiveDetector *	createSensitiveDetector (const std::string &type, const std::string &name)
	Create Geant4 sensitive detector object using the factory mechanism. 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...

virtual void	updateContext (Geant4Context *ctxt)
	Set or update client context. More...

virtual void	configureFiber (Geant4Context *thread_context)
	Set or update client for the use in a new thread fiber. 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
void	exec (const std::string &desc, const Geant4PythonCall &cmd) const
	Execute command in the python interpreter. 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
Geant4PythonCall	m_constructSD
	Sensitive detector initialization command. Default: empty. More...

Geant4PythonCall	m_constructFLD
	Field initialization command. Default: empty. More...

Geant4PythonCall	m_constructGEO
	Geometry initialization command. Default: empty. 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

Base class to initialize a multi-threaded or single threaded Geant4 application.

Geant4PythonDetectorConstruction is the corresponding python action to populate the detector construction sequencer. and supports three ccallbacks:

// Set the Detector initialization command
void setConstructGeo(PyObject* callable, PyObject* args);
// Set the field initialization command
void setConstructField(PyObject* callable, PyObject* args);
// Set the sensitive detector initialization command
void setConstructSensitives(PyObject* callable, PyObject* args);

to be used in python as call sequence within the master thread:

init_seq = self.master().detectorConstruction(True) init_action = DetectorConstruction(self.master(),name_type) init_action.setConstructGeo(geometry_setup_call, < geometry_args > ) init_action.setConstructField(field_setup_call, < field_args > ) init_action.setConstructSensitives(sensitives_setup_call, < sensitives_args >) init_seq.adopt(init_action)

If any of the three callback is not set, the corresponding actiion is not executed. Hereby are geometry_setup_call, field_setup_call and sensitives_setup_call the callable objects to configure the geometry, the tracking field and the sensitive detectors. < geometry_args >, < field_args > and < sensitives_args > are the corresponding callable arguments in the form of a python tuple object.

All python callbacks are supposed to return the integer '1' on success. Any other return code is assumed to be failure.