| Geant4 Cross Reference |
1 // -*- C++ -*- 1
2 //
3 // -------------------------------------------
4 // HEP Random
5 // --- RandGauss ---
6 // class header file
7 // -------------------------------------------
8 // This file is part of Geant4 (simulation too
9
10 // Class defining methods for shooting gaussia
11 // given a mean (default=0) or specifying also
12 // Gaussian random numbers are generated two a
13 // other time shoot is called the number retur
14 // time before.
15 // Default values are used for operator()().
16
17 // ===========================================
18 // Gabriele Cosmo - Created: 5th September 199
19 // - Minor corrections: 31st Oc
20 // - Added methods to shoot arr
21 // J.Marraffino - Added default arguments as
22 // operator() with arguments.
23 // for computation in fire():
24 // Gabriele Cosmo - Relocated static data from
25 // M Fischler - put and get to/from stream
26 // ===========================================
27
28 #ifndef RandGauss_h
29 #define RandGauss_h 1
30
31 #include "CLHEP/Random/Random.h"
32 #include "CLHEP/Utility/memory.h"
33 #include "CLHEP/Utility/thread_local.h"
34
35 namespace CLHEP {
36
37 /**
38 * @author
39 * @ingroup random
40 */
41 class RandGauss : public HepRandom {
42
43 public:
44
45 inline RandGauss ( HepRandomEngine& anEngine
46
47 inline RandGauss ( HepRandomEngine* anEngine
48
49 // These constructors should be used to inst
50 // distribution object defining a local engi
51 // The static generator will be skipped usin
52 // defined below.
53 // If the engine is passed by pointer the co
54 // will be deleted by the RandGauss destruct
55 // If the engine is passed by reference the
56 // will not be deleted by the RandGauss dest
57
58 virtual ~RandGauss();
59 // Destructor
60
61 // Static methods to shoot random values usi
62
63 static double shoot();
64
65 static inline double shoot( double mean, do
66
67 static void shootArray ( const int size, do
68 double mean=0.0, d
69
70 // Static methods to shoot random values us
71 // by-passing the static generator.
72
73 static double shoot( HepRandomEngine* anEng
74
75 static inline double shoot( HepRandomEngine
76 double mean,
77
78 static void shootArray ( HepRandomEngine* a
79 double* vect, doub
80 double stdDev=1.0
81
82 // Methods using the localEngine to shoot r
83 // the static generator.
84
85 double fire();
86
87 inline double fire( double mean, double stdD
88
89 void fireArray ( const int size, double* vec
90 void fireArray ( const int size, double* vec
91 double mean, double stdDev
92
93 virtual double operator()();
94 virtual double operator()( double mean, doub
95
96 std::string name() const;
97 HepRandomEngine & engine();
98
99 static std::string distributionName() {retur
100 // Provides the name of this distribution cl
101
102 // Save and restore to/from streams
103
104 std::ostream & put ( std::ostream & os ) con
105 std::istream & get ( std::istream & is );
106
107 // Methods setFlag(false) and setF(false) i
108 // code before shoot/fire will force genera
109 // values.
110
111 static bool getFlag();
112
113 static void setFlag( bool val );
114
115 bool getF() const {return set;}
116
117 void setF( bool val ) {set = val;}
118
119 // Methods overriding the base class static
120 // by adding extra data so that save in one
121 // will produce the identical sequence to re
122 // generating gaussian randoms there
123
124 static void saveEngineStatus( const char fil
125 // Saves to file the current status of the c
126
127 static void restoreEngineStatus( const char
128 // Restores a saved status (if any) for the
129
130 static std::ostream& saveFullState ( std::os
131 // Saves to stream the state of the engine a
132
133 static std::istream& restoreFullState ( std:
134 // Restores from stream the state of the eng
135
136 static std::ostream& saveDistState ( std::os
137 // Saves to stream the state of the cached d
138
139 static std::istream& restoreDistState ( std:
140 // Restores from stream the state of the cac
141
142
143 protected:
144
145 static double getVal();
146
147 static void setVal( double nextVal );
148
149 double normal();
150
151 double defaultMean;
152 double defaultStdDev;
153
154 std::shared_ptr<HepRandomEngine> localEngine
155
156 private:
157
158 bool set;
159 double nextGauss;
160
161 // static data
162 static CLHEP_THREAD_LOCAL bool set_st;
163 static CLHEP_THREAD_LOCAL double nextGauss_s
164
165 };
166
167 } // namespace CLHEP
168
169 #include "CLHEP/Random/RandGauss.icc"
170
171 #endif
172