Gabriele Cosmo
95 lines
4.7 KiB
C++
95 lines
4.7 KiB
C++
//
|
|
// ********************************************************************
|
|
// * License and Disclaimer *
|
|
// * *
|
|
// * The Geant4 software is copyright of the Copyright Holders of *
|
|
// * the Geant4 Collaboration. It is provided under the terms and *
|
|
// * conditions of the Geant4 Software License, included in the file *
|
|
// * LICENSE and available at http://cern.ch/geant4/license . These *
|
|
// * include a list of copyright holders. *
|
|
// * *
|
|
// * Neither the authors of this software system, nor their employing *
|
|
// * institutes,nor the agencies providing financial support for this *
|
|
// * work make any representation or warranty, express or implied, *
|
|
// * regarding this software system or assume any liability for its *
|
|
// * use. Please see the license in the file LICENSE and URL above *
|
|
// * for the full disclaimer and the limitation of liability. *
|
|
// * *
|
|
// * This code implementation is the result of the scientific and *
|
|
// * technical work of the GEANT4 collaboration. *
|
|
// * By using, copying, modifying or distributing the software (or *
|
|
// * any work based on the software) you agree to acknowledge its *
|
|
// * use in resulting scientific publications, and indicate your *
|
|
// * acceptance of all terms of the Geant4 Software license. *
|
|
// ********************************************************************
|
|
//
|
|
//
|
|
// 25 Feb 2013: Andrea Dotti, first implementation
|
|
//
|
|
// class description:
|
|
//
|
|
// This class is used for multi-threaded Geant4.
|
|
// The object of this class can be set to G4MTRunManager, but not to G4RunManager.
|
|
// G4UserWorkerInitialization class has five virtual methods as the user hooks
|
|
// which are invoked at several occasions of the life cycle of each thread.
|
|
//
|
|
// - virtual void WorkerInitialize() const
|
|
// This method is called after the tread is created but before the G4WorkerRunManager
|
|
// is instantiated.
|
|
// - virtual void WorkerStart() const
|
|
// This method is called once at the beginning of simulation job when kernel
|
|
// classes and user action classes have already instantiated but geometry and
|
|
// physics have not been yet initialized. This situation is identical to
|
|
// "PreInit" state in the sequential mode.
|
|
// - virtual void WorkerRunStart() const
|
|
// This method is called before an event loop. Geometry and physics have already
|
|
// been set up for the thread. All threads are synchronized and ready to start
|
|
// the local event loop. This situation is identical to "Idle" state in the sequential mode.
|
|
// - virtual void WorkerRunEnd() const
|
|
// This method is called for each thread when the local event loop is done, but
|
|
// before the synchronization over threads.
|
|
// - virtual void WorkerStop() const
|
|
// This method is called once at the end of simulation job.
|
|
//
|
|
// Note: This object should be instantiated only once and set to G4MTRunManager,
|
|
// while these five methods are invoked for each worker thread. Thus, to store
|
|
// thread-local objects, use G4ThreadLocal keyword.
|
|
//
|
|
|
|
#ifndef G4UserWorkerInitialization_hh
|
|
#define G4UserWorkerInitialization_hh
|
|
|
|
class G4UserWorkerInitialization {
|
|
public: // with description
|
|
G4UserWorkerInitialization();
|
|
virtual ~G4UserWorkerInitialization();
|
|
|
|
virtual void WorkerInitialize() const;
|
|
// This method is called after the tread is created but before the
|
|
// G4WorkerRunManager is instantiated.
|
|
|
|
virtual void WorkerStart() const;
|
|
// This method is called once at the beginning of simulation job
|
|
// when kernel classes and user action classes have already instantiated
|
|
// but geometry and physics have not been yet initialized. This situation
|
|
// is identical to "PreInit" state in the sequential mode.
|
|
|
|
virtual void WorkerRunStart() const;
|
|
// This method is called before an event loop. Geometry and physics have
|
|
// already been set up for the thread. All threads are synchronized and
|
|
// ready to start the local event loop. This situation is identical to
|
|
// "Idle" state in the sequential mode.
|
|
|
|
virtual void WorkerRunEnd() const;
|
|
// This method is called for each thread, when the local event loop has
|
|
// finished but before the synchronization over threads.
|
|
|
|
virtual void WorkerStop() const;
|
|
// This method is called once at the end of simulation job.
|
|
// Implement here a clean up action.
|
|
|
|
};
|
|
|
|
#endif //G4UserWorkerInitialization_hh
|
|
|