| Geant4 Cross Reference |
1 // 1
2 // *******************************************
3 // * License and Disclaimer
4 // *
5 // * The Geant4 software is copyright of th
6 // * the Geant4 Collaboration. It is provided
7 // * conditions of the Geant4 Software License
8 // * LICENSE and available at http://cern.ch/
9 // * include a list of copyright holders.
10 // *
11 // * Neither the authors of this software syst
12 // * institutes,nor the agencies providing fin
13 // * work make any representation or warran
14 // * regarding this software system or assum
15 // * use. Please see the license in the file
16 // * for the full disclaimer and the limitatio
17 // *
18 // * This code implementation is the result
19 // * technical work of the GEANT4 collaboratio
20 // * By using, copying, modifying or distri
21 // * any work based on the software) you ag
22 // * use in resulting scientific publicati
23 // * acceptance of all terms of the Geant4 Sof
24 // *******************************************
25
26 //--------------------------------------------
27 //
28 // ClassName: G4Element
29 //
30 // Description: Contains element properties
31 //
32 // Class description:
33 //
34 // An element is a chemical element either dir
35 // its characteristics: its name, symbol,
36 // Z (effective atomic nu
37 // N (effective number of
38 // A (effective mass of a
39 // or in terms of a collection of constituent
40 // relative abundance (i.e. fraction of nb of
41 //
42 // Quantities, with physical meaning or not, w
43 // element are computed and stored here as Der
44 //
45 // The class contains as a private static memb
46 // elements (an ordered vector of elements).
47 //
48 // Elements can be assembled singly or in mixt
49 // in volume definitions via the G4Material cl
50 //
51 // It is strongly recommended do not delete G4
52 // user code. All G4Elements will be automatic
53 // of Geant4 session
54
55 // 09-07-96, new data members added by L.Urban
56 // 17-01-97, aesthetic rearrangement, M.Maire
57 // 20-01-97, Tsai formula for the rad length,
58 // 21-01-97, remove mixture flag, M.Maire
59 // 24-01-97, new data member: fTaul
60 // new method: ComputeIonisationPara
61 // 20-03-97, corrected initialization of point
62 // 27-06-97, new function GetIsotope(int), M.M
63 // 24-02-98, fWeightVector becomes fRelativeAb
64 // 27-04-98, atomic shell stuff, V. Grichine
65 // 09-07-98, Ionisation parameters removed fro
66 // 04-08-98, new method GetElement(elementName
67 // 16-11-98, Subshell -> Shell, mma
68 // 30-03-01, suppression of the warning messag
69 // 17-07-01, migration to STL, M. Verderi
70 // 13-09-01, stl migration. Suppression of the
71 // 14-09-01, fCountUse: nb of materials which
72 // 26-02-02, fIndexInTable renewed
73 // 01-04-05, new data member fIndexZ to count
74 // 17-10-06: Add Get/Set fNaturalAbundance (V.
75 // 17.09.09, add fNbOfShellElectrons and metho
76
77 #ifndef G4ELEMENT_HH
78 #define G4ELEMENT_HH 1
79
80 #include "G4ElementTable.hh"
81 #include "G4ElementVector.hh"
82 #include "G4IonisParamElm.hh"
83 #include "G4Isotope.hh"
84 #include "G4IsotopeVector.hh"
85 #include "G4ios.hh"
86 #include "globals.hh"
87
88 #include <vector>
89
90 class G4Element
91 {
92 public: // with description
93 // Constructor to Build an element directly;
94 G4Element(const G4String& name, // its name
95 const G4String& symbol, // its symbol
96 G4double Zeff, // atomic number
97 G4double Aeff); // mass of mole
98
99 // Constructor to Build an element from isot
100 G4Element(const G4String& name, // its name
101 const G4String& symbol, // its symbol
102 G4int nbIsotopes); // nb of isotopes
103
104 virtual ~G4Element();
105
106 G4Element(G4Element&) = delete;
107 const G4Element& operator=(const G4Element&)
108
109 // Add an isotope to the element
110 void AddIsotope(G4Isotope* isotope, // isot
111 G4double RelativeAbundance); // fraction
112 // atomes pe
113
114 // Retrieval methods
115 inline const G4String& GetName() const { ret
116 inline const G4String& GetSymbol() const { r
117
118 // Atomic number
119 inline G4double GetZ() const { return fZeff;
120 inline G4int GetZasInt() const { return fZ;
121
122 // Atomic weight in atomic units
123 inline G4double GetN() const { return fNeff;
124 inline G4double GetAtomicMassAmu() const { r
125
126 // Mass of a mole in Geant4 units for atoms
127 inline G4double GetA() const { return fAeff;
128
129 inline G4bool GetNaturalAbundanceFlag() cons
130
131 inline void SetNaturalAbundanceFlag(G4bool);
132
133 // the number of atomic shells in this eleme
134 inline G4int GetNbOfAtomicShells() const { r
135
136 // the binding energy of the shell, ground s
137 G4double GetAtomicShell(G4int index) const;
138
139 // the number of electrons at the shell, gro
140 G4int GetNbOfShellElectrons(G4int index) con
141
142 // number of isotopes constituing this eleme
143 inline std::size_t GetNumberOfIsotopes() con
144
145 // vector of pointers to isotopes constituin
146 inline G4IsotopeVector* GetIsotopeVector() c
147
148 // vector of relative abundance of each isot
149 inline G4double* GetRelativeAbundanceVector(
150
151 inline const G4Isotope* GetIsotope(G4int iso
152
153 // the (static) Table of Elements:
154 static const G4ElementTable* GetElementTable
155
156 static std::size_t GetNumberOfElements();
157
158 // the index of this element in the Table:
159 inline std::size_t GetIndex() const { return
160
161 // return pointer to an element, given its n
162 static G4Element* GetElement(const G4String&
163
164 // Coulomb correction factor:
165 inline G4double GetfCoulomb() const { return
166
167 // Tsai formula for the radiation length:
168 inline G4double GetfRadTsai() const { return
169
170 // pointer to ionisation parameters:
171 inline G4IonisParamElm* GetIonisation() cons
172
173 // printing methods
174 friend std::ostream& operator<<(std::ostream
175 friend std::ostream& operator<<(std::ostream
176 friend std::ostream& operator<<(std::ostream
177 friend std::ostream& operator<<(std::ostream
178
179 inline void SetName(const G4String& name) {
180
181 G4bool operator==(const G4Element&) const =
182 G4bool operator!=(const G4Element&) const =
183
184 private:
185 void InitializePointers();
186 void ComputeDerivedQuantities();
187 void ComputeCoulombFactor();
188 void ComputeLradTsaiFactor();
189 void AddNaturalIsotopes();
190
191 // Mutable access to the element table.
192 static G4ElementTable& GetElementTableRef();
193
194 // Basic data members (which define an Eleme
195
196 G4String fName; // name
197 G4String fSymbol; // symbol
198 G4double fZeff; // Effective atomic number
199 G4double fNeff; // Effective number of nucl
200 G4double fAeff; // Effective mass of a mole
201 G4int fZ;
202
203 G4int fNbOfAtomicShells; // number of atom
204 G4double* fAtomicShells; // Pointer to atom
205 G4int* fNbOfShellElectrons; // Pointer to t
206
207 G4int fNumberOfIsotopes; // Number of isoto
208 G4IsotopeVector* theIsotopeVector; // vecto
209 G4double* fRelativeAbundanceVector; // Frac
210 // for
211
212 // Set up the static Table of Elements
213 std::size_t fIndexInTable;
214 G4bool fNaturalAbundance;
215
216 // Derived data members (computed from the b
217
218 G4double fCoulomb; // Coulomb correction fa
219 G4double fRadTsai; // Tsai formula for the
220 G4IonisParamElm* fIonisation; // Pointer to
221 };
222
223 inline G4bool G4Element::GetNaturalAbundanceFl
224
225 inline void G4Element::SetNaturalAbundanceFlag
226
227 #endif
228