G4TaskRunManagerKernel Class Reference

#include <G4TaskRunManagerKernel.hh>

Inheritance diagram for G4TaskRunManagerKernel:

Public Member Functions
	G4TaskRunManagerKernel ()
	~G4TaskRunManagerKernel () override=default
void	SetUpDecayChannels ()
void	BroadcastAbortRun (G4bool softAbort)
Public Member Functions inherited from G4RunManagerKernel
	G4RunManagerKernel ()
virtual	~G4RunManagerKernel ()
void	DefineWorldVolume (G4VPhysicalVolume *worldVol, G4bool topologyIsChanged=true)
void	WorkerDefineWorldVolume (G4VPhysicalVolume *worldVol, G4bool topologyIsChanged=true)
void	SetPhysics (G4VUserPhysicsList *uPhys)
void	InitializePhysics ()
G4bool	RunInitialization (G4bool fakeRun=false)
void	RunTermination ()
void	UpdateRegion ()
void	DumpRegion (const G4String &rname) const
void	DumpRegion (G4Region *region=nullptr) const
void	WorkerUpdateWorldVolume ()
void	GeometryHasBeenModified ()
void	PhysicsHasBeenModified ()
G4EventManager *	GetEventManager () const
G4StackManager *	GetStackManager () const
G4TrackingManager *	GetTrackingManager () const
void	SetPrimaryTransformer (G4PrimaryTransformer *pt)
G4PrimaryTransformer *	GetPrimaryTransformer () const
const G4String &	GetVersionString () const
void	SetVerboseLevel (G4int vl)
void	SetGeometryToBeOptimized (G4bool vl)
void	ResetNavigatorAtInitialization (G4bool val=true)
G4int	GetNumberOfParallelWorld () const
void	SetNumberOfParallelWorld (G4int i)
G4VUserPhysicsList *	GetPhysicsList () const
G4VPhysicalVolume *	GetCurrentWorld () const
G4int	GetNumberOfStaticAllocators () const

Static Public Member Functions
static G4WorkerThread *	GetWorkerThread ()
static void	InitializeWorker ()
static void	ExecuteWorkerInit ()
static void	ExecuteWorkerTask ()
static void	TerminateWorkerRunEventLoop ()
static void	TerminateWorker ()
static void	TerminateWorkerRunEventLoop (G4WorkerTaskRunManager *)
static std::vector< G4String > &	InitCommandStack ()
Static Public Member Functions inherited from G4RunManagerKernel
static G4RunManagerKernel *	GetRunManagerKernel ()

Protected Member Functions
void	SetupShadowProcess () const override
Protected Member Functions inherited from G4RunManagerKernel
	G4RunManagerKernel (RMKType rmkType)
void	SetupDefaultRegion ()
void	SetupPhysics ()
void	ResetNavigator ()
void	BuildPhysicsTables (G4bool fakeRun)
void	CheckRegions ()
void	PropagateGenericIonID ()

Static Protected Attributes
static G4RUN_DLL std::vector< G4String >	initCmdStack = {}

Additional Inherited Members
Public Types inherited from G4RunManagerKernel
enum	RMKType { sequentialRMK , masterRMK , workerRMK }
Protected Attributes inherited from G4RunManagerKernel
RMKType	runManagerKernelType
G4Region *	defaultRegion = nullptr
G4Region *	defaultRegionForParallelWorld = nullptr
G4bool	geometryNeedsToBeClosed = true

Detailed Description

Definition at line 67 of file G4TaskRunManagerKernel.hh.

Constructor & Destructor Documentation

G4TaskRunManagerKernel()

G4TaskRunManagerKernel::G4TaskRunManagerKernel

(

)

Definition at line 69 of file G4TaskRunManagerKernel.cc.

                                               : G4RunManagerKernel(masterRMK)
{
  // This version of the constructor should never be called in sequential mode!
#ifndef G4MULTITHREADED
  G4ExceptionDescription msg;
  msg << "Geant4 code is compiled without multi-threading support "
         "(-DG4MULTITHREADED "
         "is set to off).";
  msg << " This type of RunManager can only be used in mult-threaded "
         "applications.";
  G4Exception("G4RunManagerKernel::G4RunManagerKernel()", "Run0109", FatalException, msg);
#endif
  // Set flag that a MT-type kernel has been instantiated
  G4Threading::SetMultithreadedApplication(true);
}

~G4TaskRunManagerKernel()

G4TaskRunManagerKernel::~G4TaskRunManagerKernel ( )

overridedefault

Member Function Documentation

BroadcastAbortRun()

void G4TaskRunManagerKernel::BroadcastAbortRun

(

G4bool

softAbort

)

Definition at line 319 of file G4TaskRunManagerKernel.cc.

{
  G4ConsumeParameters(softAbort);
}

ExecuteWorkerInit()

void G4TaskRunManagerKernel::ExecuteWorkerInit ( )

static

Definition at line 219 of file G4TaskRunManagerKernel.cc.

{
  // because of TBB
  if (G4MTRunManager::GetMasterThreadId() == G4ThisThread::get_id()) {
    G4TaskManager* taskManager = G4TaskRunManager::GetMasterRunManager()->GetTaskManager();
    auto _fut = taskManager->async(ExecuteWorkerInit);
    return _fut->get();
  }
 
  // this check is for TBB as there is not a way to run an initialization
  // routine on each thread
  if (!workerRM()) InitializeWorker();
 
  auto& wrm = workerRM();
  assert(wrm.get() != nullptr);
  wrm->DoCleanup();
}

Referenced by G4SubEvtRunManager::CreateAndStartWorkers(), G4TaskRunManager::CreateAndStartWorkers(), and ExecuteWorkerInit().

ExecuteWorkerTask()

void G4TaskRunManagerKernel::ExecuteWorkerTask ( )

static

Definition at line 239 of file G4TaskRunManagerKernel.cc.

{
  // because of TBB
  if (G4MTRunManager::GetMasterThreadId() == G4ThisThread::get_id()) {
    G4TaskManager* taskManager = G4TaskRunManager::GetMasterRunManager()->GetTaskManager();
    auto _fut = taskManager->async(ExecuteWorkerTask);
    return _fut->get();
  }
 
  // this check is for TBB as there is not a way to run an initialization
  // routine on each thread
  if (!workerRM()) InitializeWorker();
 
  auto& wrm = workerRM();
  assert(wrm.get() != nullptr);
  wrm->DoWork();
}

Referenced by G4SubEvtRunManager::AddEventTask(), G4TaskRunManager::AddEventTask(), and ExecuteWorkerTask().

GetWorkerThread()

G4WorkerThread * G4TaskRunManagerKernel::GetWorkerThread ( )

static

Definition at line 117 of file G4TaskRunManagerKernel.cc.

{
  return context().get();
}

InitCommandStack()

std::vector< G4String > & G4TaskRunManagerKernel::InitCommandStack ( )

static

Definition at line 295 of file G4TaskRunManagerKernel.cc.

{
  return initCmdStack;
}

Referenced by G4SubEvtRunManager::CreateAndStartWorkers(), and G4TaskRunManager::CreateAndStartWorkers().

InitializeWorker()

void G4TaskRunManagerKernel::InitializeWorker ( )

static

!!!!!!!!!!!!!!!!!!!!!!!!! !!!!! IMPORTANT !!!!!!!!! !!!!!!!!!!!!!!!!!!!!!!!!!

!!!!!!!!!!!!!!!!!!!!!!!!!

Definition at line 124 of file G4TaskRunManagerKernel.cc.

{
  if (context() && workerRM()) return;
 
  G4TaskRunManager* mrm = G4TaskRunManager::GetMasterRunManager();
  if (G4MTRunManager::GetMasterThreadId() == G4ThisThread::get_id()) {
    G4TaskManager* taskManager = mrm->GetTaskManager();
    auto _fut = taskManager->async(InitializeWorker);
    _fut->wait();
    return;
  }
 
  //!!!!!!!!!!!!!!!!!!!!!!!!!!
  //!!!!!! IMPORTANT !!!!!!!!!
  //!!!!!!!!!!!!!!!!!!!!!!!!!!
  // Here is not sequential anymore and G4UserWorkerThreadInitialization is
  // a shared user initialization class
  // This means this method cannot use data memebers of G4RunManagerKernel
  // unless they are invariant ("read-only") and can be safely shared.
  //  All the rest that is not invariant should be incapsualted into
  //  the context (or, as for wThreadContext be G4ThreadLocal)
  //!!!!!!!!!!!!!!!!!!!!!!!!!!
 
  G4Threading::WorkerThreadJoinsPool();
  context() = std::make_unique<G4WorkerThread>();
 
  //============================
  // Step-0: Thread ID
  //============================
  // Initliazie per-thread stream-output
  // The following line is needed before we actually do IO initialization
  // becasue the constructor of UI manager resets the IO destination.
  context()->SetNumberThreads((G4int)mrm->GetThreadPool()->size());
  context()->SetThreadId(G4int(G4ThreadPool::get_this_thread_id() - 1));
  G4int thisID = context()->GetThreadId();
  G4Threading::G4SetThreadId(thisID);
  G4UImanager::GetUIpointer()->SetUpForAThread(thisID);
 
  //============================
  // Optimization: optional
  //============================
  // Enforce thread affinity if requested
  context()->SetPinAffinity(mrm->GetPinAffinity());
 
  //============================
  // Step-1: Random number engine
  //============================
  // RNG Engine needs to be initialized by "cloning" the master one.
  const CLHEP::HepRandomEngine* masterEngine = mrm->getMasterRandomEngine();
  mrm->GetUserWorkerThreadInitialization()->SetupRNGEngine(masterEngine);
 
  //============================
  // Step-2: Initialize worker thread
  //============================
  if (mrm->GetUserWorkerInitialization() != nullptr)
    mrm->GetUserWorkerInitialization()->WorkerInitialize();
 
  if (mrm->GetUserActionInitialization() != nullptr) {
    G4VSteppingVerbose* sv = mrm->GetUserActionInitialization()->InitializeSteppingVerbose();
    if (sv != nullptr) G4VSteppingVerbose::SetInstance(sv);
  }
  // Now initialize worker part of shared objects (geometry/physics)
  G4WorkerThread::BuildGeometryAndPhysicsVector();
  workerRM().reset(static_cast<G4WorkerTaskRunManager*>(
    mrm->GetUserWorkerThreadInitialization()->CreateWorkerRunManager()));
  auto& wrm = workerRM();
  wrm->SetWorkerThread(context().get());
 
  //================================
  // Step-3: Setup worker run manager
  //================================
  // Set the detector and physics list to the worker thread. Share with master
  const G4VUserDetectorConstruction* detector = mrm->GetUserDetectorConstruction();
  wrm->G4RunManager::SetUserInitialization(const_cast<G4VUserDetectorConstruction*>(detector));
  const G4VUserPhysicsList* physicslist = mrm->GetUserPhysicsList();
  wrm->SetUserInitialization(const_cast<G4VUserPhysicsList*>(physicslist));
 
  //================================
  // Step-4: Initialize worker run manager
  //================================
  if (mrm->GetUserActionInitialization() != nullptr)
    mrm->GetNonConstUserActionInitialization()->Build();
  if (mrm->GetUserWorkerInitialization() != nullptr)
    mrm->GetUserWorkerInitialization()->WorkerStart();
 
  workerRM()->Initialize();
 
  for (auto& itr : initCmdStack)
    G4UImanager::GetUIpointer()->ApplyCommand(itr);
 
  wrm->ProcessUI();
}

Referenced by G4SubEvtRunManager::CreateAndStartWorkers(), G4TaskRunManager::CreateAndStartWorkers(), ExecuteWorkerInit(), ExecuteWorkerTask(), and InitializeWorker().

SetUpDecayChannels()

void G4TaskRunManagerKernel::SetUpDecayChannels

(

)

Definition at line 302 of file G4TaskRunManagerKernel.cc.

{
  G4ParticleTable::G4PTblDicIterator* pItr = G4ParticleTable::GetParticleTable()->GetIterator();
  pItr->reset();
  while ((*pItr)()) {
    G4DecayTable* dt = pItr->value()->GetDecayTable();
    if (dt != nullptr) {
      G4int nCh = dt->entries();
      for (G4int i = 0; i < nCh; i++) {
        dt->GetDecayChannel(i)->GetDaughter(0);
      }
    }
  }
}

SetupShadowProcess()

void G4TaskRunManagerKernel::SetupShadowProcess ( ) const

overrideprotectedvirtual

Reimplemented from G4RunManagerKernel.

Definition at line 87 of file G4TaskRunManagerKernel.cc.

{
  // Behavior is the same as base class (sequential mode)
  // ShadowProcess pointer == process poitner
  G4RunManagerKernel::SetupShadowProcess();
}

TerminateWorker()

void G4TaskRunManagerKernel::TerminateWorker ( )

static

Definition at line 266 of file G4TaskRunManagerKernel.cc.

{
  //===============================
  // Step-6: Terminate worker thread
  //===============================
  G4TaskRunManager* mrm = G4TaskRunManager::GetMasterRunManager();
  if ((mrm != nullptr) && (mrm->GetUserWorkerInitialization() != nullptr))
    mrm->GetUserWorkerInitialization()->WorkerStop();
 
  workerRM().reset();
  context().reset();
 
  G4WorkerThread::DestroyGeometryAndPhysicsVector();
 
  G4Threading::WorkerThreadLeavesPool();
}

Referenced by G4SubEvtRunManager::TerminateWorkers(), and G4TaskRunManager::TerminateWorkers().

TerminateWorkerRunEventLoop() [1/2]

void G4TaskRunManagerKernel::TerminateWorkerRunEventLoop ( )

static

Definition at line 259 of file G4TaskRunManagerKernel.cc.

{
  if (workerRM()) TerminateWorkerRunEventLoop(workerRM().get());
}

Referenced by TerminateWorkerRunEventLoop(), G4SubEvtRunManager::WaitForEndEventLoopWorkers(), and G4TaskRunManager::WaitForEndEventLoopWorkers().

TerminateWorkerRunEventLoop() [2/2]

void G4TaskRunManagerKernel::TerminateWorkerRunEventLoop ( G4WorkerTaskRunManager * wrm )

static

Definition at line 285 of file G4TaskRunManagerKernel.cc.

{
  if (wrm == nullptr) return;
 
  wrm->TerminateEventLoop();
  wrm->RunTermination();
}

Member Data Documentation

initCmdStack

std::vector< G4String > G4TaskRunManagerKernel::initCmdStack = {}

staticprotected

Definition at line 65 of file G4TaskRunManagerKernel.hh.

Referenced by InitCommandStack(), InitializeWorker(), and ~G4TaskRunManagerKernel().

---

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

• G4TaskRunManagerKernel.hh
• G4TaskRunManagerKernel.cc