| Geant4 Cross Reference |
1 // 1 //
2 // ******************************************* 2 // ********************************************************************
3 // * License and Disclaimer 3 // * License and Disclaimer *
4 // * 4 // * *
5 // * The Geant4 software is copyright of th 5 // * The Geant4 software is copyright of the Copyright Holders of *
6 // * the Geant4 Collaboration. It is provided 6 // * the Geant4 Collaboration. It is provided under the terms and *
7 // * conditions of the Geant4 Software License 7 // * conditions of the Geant4 Software License, included in the file *
8 // * LICENSE and available at http://cern.ch/ 8 // * LICENSE and available at http://cern.ch/geant4/license . These *
9 // * include a list of copyright holders. 9 // * include a list of copyright holders. *
10 // * 10 // * *
11 // * Neither the authors of this software syst 11 // * Neither the authors of this software system, nor their employing *
12 // * institutes,nor the agencies providing fin 12 // * institutes,nor the agencies providing financial support for this *
13 // * work make any representation or warran 13 // * work make any representation or warranty, express or implied, *
14 // * regarding this software system or assum 14 // * regarding this software system or assume any liability for its *
15 // * use. Please see the license in the file 15 // * use. Please see the license in the file LICENSE and URL above *
16 // * for the full disclaimer and the limitatio 16 // * for the full disclaimer and the limitation of liability. *
17 // * 17 // * *
18 // * This code implementation is the result 18 // * This code implementation is the result of the scientific and *
19 // * technical work of the GEANT4 collaboratio 19 // * technical work of the GEANT4 collaboration. *
20 // * By using, copying, modifying or distri 20 // * By using, copying, modifying or distributing the software (or *
21 // * any work based on the software) you ag 21 // * any work based on the software) you agree to acknowledge its *
22 // * use in resulting scientific publicati 22 // * use in resulting scientific publications, and indicate your *
23 // * acceptance of all terms of the Geant4 Sof 23 // * acceptance of all terms of the Geant4 Software license. *
24 // ******************************************* 24 // ********************************************************************
25 // 25 //
26 // 26 //
27 // Author: Jonathan Madsen (May 28st 2020) 27 // Author: Jonathan Madsen (May 28st 2020)
28 // 28 //
29 // class description: 29 // class description:
30 // 30 //
31 // This class is used for multi-threaded 31 // This class is used for multi-threaded Geant4.
32 // The object of this class can be set to 32 // The object of this class can be set to G4MTRunManager, but not to
33 // G4RunManager. G4UserTaskInitialization 33 // G4RunManager. G4UserTaskInitialization class has five virtual methods as
34 // the user hooks which are invoked at se 34 // the user hooks which are invoked at several occasions of the life cycle
35 // of each thread. 35 // of each thread.
36 // 36 //
37 // - virtual void WorkerInitialize() cons 37 // - virtual void WorkerInitialize() const
38 // This method is called after the tread 38 // This method is called after the tread is created but before the
39 // G4WorkerTaskRunManager is instantiate 39 // G4WorkerTaskRunManager is instantiated.
40 // - virtual void WorkerStart() const 40 // - virtual void WorkerStart() const
41 // This method is called once at the beg 41 // This method is called once at the beginning of simulation job when
42 // kernel classes and user action classe 42 // kernel classes and user action classes have already instantiated but
43 // geometry and physics have not been ye 43 // geometry and physics have not been yet initialized. This situation is
44 // identical to "PreInit" state in the s 44 // identical to "PreInit" state in the sequential mode.
45 // - virtual void WorkerRunStart() const 45 // - virtual void WorkerRunStart() const
46 // This method is called before an event 46 // This method is called before an event loop. Geometry and physics have
47 // already been set up for the thread. A 47 // already been set up for the thread. All threads are synchronized and
48 // ready to start the local event loop. 48 // ready to start the local event loop. This situation is identical to
49 // "Idle" state in the sequential mode. 49 // "Idle" state in the sequential mode.
50 // - virtual void WorkerRunEnd() const 50 // - virtual void WorkerRunEnd() const
51 // This method is called for each thread 51 // This method is called for each thread when the local event loop is
52 // done, but before the synchronization 52 // done, but before the synchronization over threads.
53 // - virtual void WorkerStop() const 53 // - virtual void WorkerStop() const
54 // This method is called once at the end 54 // This method is called once at the end of simulation job.
55 // 55 //
56 // Note: This object should be instantiat 56 // Note: This object should be instantiated only once and set to
57 // G4MTRunManager, 57 // G4MTRunManager,
58 // while these five methods are invoked 58 // while these five methods are invoked for each worker thread. Thus, to
59 // store thread-local objects, use G4Thr 59 // store thread-local objects, use G4ThreadLocal keyword.
60 // 60 //
61 61
62 #ifndef G4UserTaskInitialization_hh 62 #ifndef G4UserTaskInitialization_hh
63 #define G4UserTaskInitialization_hh 63 #define G4UserTaskInitialization_hh
64 64
65 #include "G4UserWorkerInitialization.hh" 65 #include "G4UserWorkerInitialization.hh"
66 66
67 class G4UserTaskInitialization : public G4User 67 class G4UserTaskInitialization : public G4UserWorkerInitialization
68 { 68 {
69 public: // with description << 69 public: // with description
70 G4UserTaskInitialization() = default; << 70 G4UserTaskInitialization();
71 ~G4UserTaskInitialization() override = def << 71 virtual ~G4UserTaskInitialization();
72 72
73 // This method is called after the tread i << 73 virtual void WorkerInitialize() const;
74 // G4WorkerTaskRunManager is instantiated. << 74 // This method is called after the tread is created but before the
75 void WorkerInitialize() const override {} << 75 // G4WorkerTaskRunManager is instantiated.
76 76
77 // This method is called once at the begin << 77 virtual void WorkerStart() const;
78 // when kernel classes and user action cla << 78 // This method is called once at the beginning of simulation job
79 // but geometry and physics have not been << 79 // when kernel classes and user action classes have already instantiated
80 // is identical to "PreInit" state in the << 80 // but geometry and physics have not been yet initialized. This situation
81 void WorkerStart() const override {} << 81 // is identical to "PreInit" state in the sequential mode.
82 82
83 // This method is called before an event l << 83 virtual void WorkerRunStart() const;
84 // already been set up for the thread. All << 84 // This method is called before an event loop. Geometry and physics have
85 // ready to start the local event loop. Th << 85 // already been set up for the thread. All threads are synchronized and
86 // "Idle" state in the sequential mode. << 86 // ready to start the local event loop. This situation is identical to
87 void WorkerRunStart() const override {} << 87 // "Idle" state in the sequential mode.
88 88
89 // This method is called for each thread, << 89 virtual void WorkerRunEnd() const;
90 // finished but before the synchronization << 90 // This method is called for each thread, when the local event loop has
91 void WorkerRunEnd() const override {} << 91 // finished but before the synchronization over threads.
92 92
93 // This method is called once at the end o << 93 virtual void WorkerStop() const;
94 // Implement here a clean up action. << 94 // This method is called once at the end of simulation job.
95 void WorkerStop() const override {} << 95 // Implement here a clean up action.
96 }; 96 };
97 97
98 #endif // G4UserTaskInitialization_hh 98 #endif // G4UserTaskInitialization_hh
99 99