Geant4  10.00.p03
G4RNGHelper.hh
Go to the documentation of this file.
1 //
2 // ********************************************************************
3 // * License and Disclaimer *
4 // * *
5 // * The Geant4 software is copyright of the Copyright Holders of *
6 // * the Geant4 Collaboration. It is provided under the terms and *
7 // * conditions of the Geant4 Software License, included in the file *
8 // * LICENSE and available at http://cern.ch/geant4/license . These *
9 // * include a list of copyright holders. *
10 // * *
11 // * Neither the authors of this software system, nor their employing *
12 // * institutes,nor the agencies providing financial support for this *
13 // * work make any representation or warranty, express or implied, *
14 // * regarding this software system or assume any liability for its *
15 // * use. Please see the license in the file LICENSE and URL above *
16 // * for the full disclaimer and the limitation of liability. *
17 // * *
18 // * This code implementation is the result of the scientific and *
19 // * technical work of the GEANT4 collaboration. *
20 // * By using, copying, modifying or distributing the software (or *
21 // * any work based on the software) you agree to acknowledge its *
22 // * use in resulting scientific publications, and indicate your *
23 // * acceptance of all terms of the Geant4 Software license. *
24 // ********************************************************************
25 //
26 //
27 // Helper class for RNG Engine seeds.
28 // Used in MT builds to guarantee reproducibility.
29 // The function of this class is to return a RNG Engine seed
30 // given its index. It is a simple templated container that
31 // Allows to add seeds (AddOneSeed) and retrieve a seed (GetSeed)
32 // by index.
33 //
34 // The normal use is with G4RNGHelper where each element of th econtainer
35 // represents a seed. To enforce strong-reproducibility the variant with
36 // the RNG Engine status file names is avilable
37 
38 #ifndef G4RNGHELPER_HH
39 #define G4RNGHELPER_HH
40 
41 #include "G4Types.hh"
42 #include <vector>
43 #include <queue>
44 #include "globals.hh"
45 
46 template <class T>
48 private:
50 public:
51  // The container is modeled as a (shared) singleton
53  if (!instance)
54  {
55  instance = new G4TemplateRNGHelper();
56  }
57  return instance;
58  }
59  typedef std::vector<T> SeedsQueue;
60  typedef typename SeedsQueue::size_type SeedsQueueSize_type;
61 
62 private:
64  {
65  offset=0;
66  nev_filled=0;
67  nev_total=0;
68  }
69 
70 public:
72  Clear();
73  instance = 0;
74  }
75 
76  //Returns seed given id
77  virtual const T GetSeed(const G4int& sdId ) {
78  G4int seedId = sdId - 2*offset;
79  if ( seedId < static_cast<G4int>(seeds.size()) )
80  {
81  T& seed = seeds[seedId];
82  return seed;
83  }
85  msg << "No seed number "<<seedId<<"("<<seeds.size()<<" available)\n"
86  << " Original seed number "<<sdId<<" filled so far "<<offset;
87  G4Exception("G4RNGHelper::GetSeed","Run0035", FatalException,msg);
88  return T();
89  }
90 
91  //Adds one seed to the collection
92  void AddOneSeed( const T& seed ) { seeds.push_back(seed); }
93 
94  //Fills N primary seed pairs
95  void Fill(double* dbl,int nev,int nev_tot,int nrpe)
96  {
97  seeds.clear();
98  for(int i=0;i<nrpe*nev;i++)
99  { seeds.push_back((long)(100000000L*dbl[i])); }
100  offset = 0;
101  nev_filled = nev;
102  nev_total = nev_tot;
103  nRandParEvent = nrpe;
104  }
105 
106  void Refill(double* dbl, int nev)
107  {
108  if(nev==0) return;
109  seeds.clear();
110  for(int i=0;i<nRandParEvent*nev;i++)
111  { seeds.push_back((long)(100000000L*dbl[i])); }
112  offset += nev_filled;
113  nev_filled = nev;
114  }
115 
116  //Number of available seeds
117  const SeedsQueueSize_type GetNumberSeeds() const { return seeds.size(); }
118 
119  //Empty the seeds container
120  virtual void Clear() { seeds.clear(); }
121 protected:
122  SeedsQueue seeds;
123  // Note: following numbers are number of events.
124  // seeds are generated for nRandParEvent times n_event
125  int offset;
129 };
130 
133 typedef std::queue<long> G4SeedsQueue;
134 
135 #endif
static G4TemplateRNGHelper * GetInstance()
Definition: G4RNGHelper.hh:52
void Fill(double *dbl, int nev, int nev_tot, int nrpe)
Definition: G4RNGHelper.hh:95
std::ostringstream G4ExceptionDescription
Definition: globals.hh:76
std::vector< T > SeedsQueue
Definition: G4RNGHelper.hh:59
void AddOneSeed(const T &seed)
Definition: G4RNGHelper.hh:92
virtual const T GetSeed(const G4int &sdId)
Definition: G4RNGHelper.hh:77
int G4int
Definition: G4Types.hh:78
G4TemplateRNGHelper< long > G4RNGHelper
Definition: G4RNGHelper.hh:131
std::queue< long > G4SeedsQueue
Definition: G4RNGHelper.hh:133
static const G4int L[nN]
void Refill(double *dbl, int nev)
Definition: G4RNGHelper.hh:106
virtual void Clear()
Definition: G4RNGHelper.hh:120
const SeedsQueueSize_type GetNumberSeeds() const
Definition: G4RNGHelper.hh:117
G4TemplateRNGHelper< long > * instance
Definition: G4RNGHelper.cc:31
void G4Exception(const char *originOfException, const char *exceptionCode, G4ExceptionSeverity severity, const char *comments)
Definition: G4Exception.cc:41
static G4TemplateRNGHelper * instance
Definition: G4RNGHelper.hh:49
G4TemplateRNGHelper< G4String > G4StringRNGHelper
Definition: G4RNGHelper.hh:132
SeedsQueue::size_type SeedsQueueSize_type
Definition: G4RNGHelper.hh:60
virtual ~G4TemplateRNGHelper()
Definition: G4RNGHelper.hh:71