Geant4 Cross Reference

Cross-Referencing   Geant4
Geant4/materials/include/G4NistMaterialBuilder.hh

Version: [ ReleaseNotes ] [ 1.0 ] [ 1.1 ] [ 2.0 ] [ 3.0 ] [ 3.1 ] [ 3.2 ] [ 4.0 ] [ 4.0.p1 ] [ 4.0.p2 ] [ 4.1 ] [ 4.1.p1 ] [ 5.0 ] [ 5.0.p1 ] [ 5.1 ] [ 5.1.p1 ] [ 5.2 ] [ 5.2.p1 ] [ 5.2.p2 ] [ 6.0 ] [ 6.0.p1 ] [ 6.1 ] [ 6.2 ] [ 6.2.p1 ] [ 6.2.p2 ] [ 7.0 ] [ 7.0.p1 ] [ 7.1 ] [ 7.1.p1 ] [ 8.0 ] [ 8.0.p1 ] [ 8.1 ] [ 8.1.p1 ] [ 8.1.p2 ] [ 8.2 ] [ 8.2.p1 ] [ 8.3 ] [ 8.3.p1 ] [ 8.3.p2 ] [ 9.0 ] [ 9.0.p1 ] [ 9.0.p2 ] [ 9.1 ] [ 9.1.p1 ] [ 9.1.p2 ] [ 9.1.p3 ] [ 9.2 ] [ 9.2.p1 ] [ 9.2.p2 ] [ 9.2.p3 ] [ 9.2.p4 ] [ 9.3 ] [ 9.3.p1 ] [ 9.3.p2 ] [ 9.4 ] [ 9.4.p1 ] [ 9.4.p2 ] [ 9.4.p3 ] [ 9.4.p4 ] [ 9.5 ] [ 9.5.p1 ] [ 9.5.p2 ] [ 9.6 ] [ 9.6.p1 ] [ 9.6.p2 ] [ 9.6.p3 ] [ 9.6.p4 ] [ 10.0 ] [ 10.0.p1 ] [ 10.0.p2 ] [ 10.0.p3 ] [ 10.0.p4 ] [ 10.1 ] [ 10.1.p1 ] [ 10.1.p2 ] [ 10.1.p3 ] [ 10.2 ] [ 10.2.p1 ] [ 10.2.p2 ] [ 10.2.p3 ] [ 10.3 ] [ 10.3.p1 ] [ 10.3.p2 ] [ 10.3.p3 ] [ 10.4 ] [ 10.4.p1 ] [ 10.4.p2 ] [ 10.4.p3 ] [ 10.5 ] [ 10.5.p1 ] [ 10.6 ] [ 10.6.p1 ] [ 10.6.p2 ] [ 10.6.p3 ] [ 10.7 ] [ 10.7.p1 ] [ 10.7.p2 ] [ 10.7.p3 ] [ 10.7.p4 ] [ 11.0 ] [ 11.0.p1 ] [ 11.0.p2 ] [ 11.0.p3, ] [ 11.0.p4 ] [ 11.1 ] [ 11.1.1 ] [ 11.1.2 ] [ 11.1.3 ] [ 11.2 ] [ 11.2.1 ] [ 11.2.2 ] [ 11.3.0 ]

Diff markup

Differences between /materials/include/G4NistMaterialBuilder.hh (Version 11.3.0) and /materials/include/G4NistMaterialBuilder.hh (Version 10.2.p3)


  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 // $Id: G4NistMaterialBuilder.hh 95428 2016-02-10 15:00:35Z gcosmo $
 26                                                    27 
 27 #ifndef G4NistMaterialBuilder_h                    28 #ifndef G4NistMaterialBuilder_h
 28 #define G4NistMaterialBuilder_h 1                  29 #define G4NistMaterialBuilder_h 1
 29                                                    30 
 30 //--------------------------------------------     31 //---------------------------------------------------------------------------
 31 //                                                 32 //
 32 // ClassName:   G4NistMaterialBuilder              33 // ClassName:   G4NistMaterialBuilder
 33 //                                                 34 //
 34 // Description: Utility class to hold and mani     35 // Description: Utility class to hold and manipulate G4Materials
 35 //                                                 36 //
 36 // Author:      V.Ivanchenko 21.11.2004            37 // Author:      V.Ivanchenko 21.11.2004
 37 //                                                 38 //
 38 // Modifications:                                  39 // Modifications:
 39 // 31.10.05 Add chemical effect and gas proper     40 // 31.10.05 Add chemical effect and gas properties (V.Ivanchenko)
 40 // 27.02.06 V.Ivanchneko add ConstructNewGasMa     41 // 27.02.06 V.Ivanchneko add ConstructNewGasMaterial
 41 // 11.05.06 V.Ivanchneko add warning flag to F     42 // 11.05.06 V.Ivanchneko add warning flag to FindOrBuildMaterial method
 42 // 27.07.06 V.Ivanchneko set defaul warning=tr     43 // 27.07.06 V.Ivanchneko set defaul warning=true for FindOrBuildMaterial
 43 // 27.07.07 V.Ivanchneko add matIndex vector t     44 // 27.07.07 V.Ivanchneko add matIndex vector to control built materials
 44 // 28.07.07 V.Ivanchneko add BuildMaterial met     45 // 28.07.07 V.Ivanchneko add BuildMaterial method using Nist index
 45 // 29.04.10 V.Ivanchneko add GetMeanIonisation     46 // 29.04.10 V.Ivanchneko add GetMeanIonisationEnergy method using Nist index
 46 // 09.02.12 P.Gumplinger add ConstructNewIdeal     47 // 09.02.12 P.Gumplinger add ConstructNewIdealGasMaterial
 47 //                                                 48 //
 48 //--------------------------------------------     49 //----------------------------------------------------------------------------
 49 //                                                 50 //
 50 // Class Description:                              51 // Class Description:
 51 //                                                 52 //
 52 // Element data from the NIST DB on Atomic Wei     53 // Element data from the NIST DB on Atomic Weights and Isotope Compositions
 53 // http://physics.nist.gov/PhysRefData/Composi     54 // http://physics.nist.gov/PhysRefData/Compositions/index.html
 54 //                                                 55 //
 55                                                    56 
 56 #include "G4Material.hh"                       <<  57 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo......
 57 #include "globals.hh"                          << 
 58                                                    58 
                                                   >>  59 #include <vector>
 59 #include <CLHEP/Units/PhysicalConstants.h>         60 #include <CLHEP/Units/PhysicalConstants.h>
 60                                                    61 
 61 #include <vector>                              <<  62 #include "globals.hh"
                                                   >>  63 #include "G4Material.hh"
                                                   >>  64 #include "G4Threading.hh"
                                                   >>  65 
                                                   >>  66 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo......
 62                                                    67 
 63 class G4NistElementBuilder;                        68 class G4NistElementBuilder;
 64                                                    69 
 65 class G4NistMaterialBuilder                        70 class G4NistMaterialBuilder
 66 {                                                  71 {
 67  public:                                       <<  72 public:
 68   G4NistMaterialBuilder(G4NistElementBuilder*, << 
 69                                                << 
 70   ~G4NistMaterialBuilder() = default;          << 
 71                                                    73 
                                                   >>  74   G4NistMaterialBuilder(G4NistElementBuilder*, G4int verb=0);
                                                   >>  75       
                                                   >>  76   ~G4NistMaterialBuilder();
                                                   >>  77  
 72   // Find or build a G4Material by name, from      78   // Find or build a G4Material by name, from dataBase
 73   inline G4Material* FindMaterial(const G4Stri <<  79   //
 74   G4Material* FindOrBuildMaterial(const G4Stri <<  80   G4Material* FindOrBuildMaterial (const G4String& name, 
                                                   >>  81            G4bool isotopes=true,
                                                   >>  82            G4bool warning =true);
                                                   >>  83               
 75                                                    84 
 76   // Find or build a simple material via atomi     85   // Find or build a simple material via atomic number
 77   inline G4Material* FindSimpleMaterial(G4int  <<  86   //
 78   G4Material* FindOrBuildSimpleMaterial(G4int      87   G4Material* FindOrBuildSimpleMaterial(G4int Z, G4bool warning);
 79                                                    88 
 80   // construct a G4Material from scratch by at     89   // construct a G4Material from scratch by atome count
 81   G4Material* ConstructNewMaterial(const G4Str <<  90   // 
 82     const std::vector<G4int>& nbAtoms, G4doubl <<  91   G4Material* ConstructNewMaterial (const G4String& name,
 83     G4double temp = NTP_Temperature, G4double  <<  92             const std::vector<G4String>& elm,
                                                   >>  93             const std::vector<G4int>& nbAtoms,
                                                   >>  94             G4double  dens, 
                                                   >>  95             G4bool    isotopes = true,
                                                   >>  96             G4State   state    = kStateSolid,     
                                                   >>  97             G4double  temp     = NTP_Temperature,  
                                                   >>  98             G4double  pressure = CLHEP::STP_Pressure);
 84                                                    99 
 85   // construct a G4Material from scratch by fr    100   // construct a G4Material from scratch by fraction mass
 86   G4Material* ConstructNewMaterial(const G4Str << 101   //
 87     const std::vector<G4double>& weight, G4dou << 102   G4Material* ConstructNewMaterial (const G4String& name,
 88     G4double temp = NTP_Temperature, G4double  << 103             const std::vector<G4String>& elm,
                                                   >> 104             const std::vector<G4double>& weight,
                                                   >> 105             G4double  dens, 
                                                   >> 106             G4bool    isotopes = true,
                                                   >> 107             G4State   state    = kStateSolid,     
                                                   >> 108             G4double  temp     = NTP_Temperature,  
                                                   >> 109             G4double  pressure = CLHEP::STP_Pressure); 
                                                   >> 110 
 89                                                   111 
 90   // construct a gas G4Material from scratch b    112   // construct a gas G4Material from scratch by atome count
 91   G4Material* ConstructNewGasMaterial(         << 113   // 
 92     const G4String& name, const G4String& name << 114   G4Material* ConstructNewGasMaterial(const G4String& name, 
                                                   >> 115               const G4String& nameDB,
                                                   >> 116               G4double temp, G4double pres, 
                                                   >> 117               G4bool isotopes = true);
 93                                                   118 
 94   // Construct an ideal gas G4Material from sc    119   // Construct an ideal gas G4Material from scratch by atom count
 95   G4Material* ConstructNewIdealGasMaterial(con << 120   //
 96     const std::vector<G4int>& nbAtoms, G4doubl << 121   G4Material* ConstructNewIdealGasMaterial(const G4String& name,
 97     G4double pressure = CLHEP::STP_Pressure);  << 122                                            const std::vector<G4String>& elm,
 98                                                << 123                                            const std::vector<G4int>& nbAtoms,
                                                   >> 124                                            G4bool    isotopes = true,
                                                   >> 125                                            G4double  temp     = NTP_Temperature,
                                                   >> 126                                            G4double  pressure = CLHEP::STP_Pressure); 
                                                   >> 127               
 99   // verbosity level defined by G4NistManager     128   // verbosity level defined by G4NistManager
                                                   >> 129   //
100   void SetVerbose(G4int val);                     130   void SetVerbose(G4int val);
101                                                   131 
102   // cout predefined materials:                   132   // cout predefined materials:
103   // "simple" - only pure materials in basic s    133   // "simple" - only pure materials in basic state (Z = 1, ..., 98)
104   // "compound" - NIST compounds                  134   // "compound" - NIST compounds
105   // "hep" - HEP materials and compounds          135   // "hep" - HEP materials and compounds
106   // "biochemical" - bio-chemical materials    << 136   // "biochemical" - bio-chemical materials 
107   // "all" - all                                  137   // "all" - all
                                                   >> 138   //
108   void ListMaterials(const G4String&) const;      139   void ListMaterials(const G4String&) const;
109                                                   140 
110   // cout lists of predefined materials           141   // cout lists of predefined materials
                                                   >> 142   //
111   void ListNistSimpleMaterials() const;           143   void ListNistSimpleMaterials() const;
112   void ListNistCompoundMaterials() const;         144   void ListNistCompoundMaterials() const;
113   void ListHepMaterials() const;                  145   void ListHepMaterials() const;
114   void ListSpaceMaterials() const;                146   void ListSpaceMaterials() const;
115   void ListBioChemicalMaterials() const;          147   void ListBioChemicalMaterials() const;
116                                                   148 
117   // access to the list of names of Geant4 pre    149   // access to the list of names of Geant4 predefined materials
                                                   >> 150   //
118   const std::vector<G4String>& GetMaterialName    151   const std::vector<G4String>& GetMaterialNames() const;
119                                                   152 
120   // access to the NIST mean ionisation potent    153   // access to the NIST mean ionisation potentials and nominal densities
                                                   >> 154   //
121   inline G4double GetMeanIonisationEnergy(G4in    155   inline G4double GetMeanIonisationEnergy(G4int index) const;
122   inline G4double GetNominalDensity(G4int inde    156   inline G4double GetNominalDensity(G4int index) const;
123                                                   157 
124   G4bool operator==(const G4NistMaterialBuilde << 158 private:
125   G4bool operator!=(const G4NistMaterialBuilde << 
126   G4NistMaterialBuilder(const G4NistMaterialBu << 
127   const G4NistMaterialBuilder& operator=(const << 
128                                                   159 
129  private:                                      << 
130   void Initialise();                              160   void Initialise();
131   void NistSimpleMaterials();                     161   void NistSimpleMaterials();
132   void NistCompoundMaterials();                   162   void NistCompoundMaterials();
133   void NistCompoundMaterials2();                  163   void NistCompoundMaterials2();
134   void HepAndNuclearMaterials();                  164   void HepAndNuclearMaterials();
135   void SpaceMaterials();                          165   void SpaceMaterials();
136   void BioChemicalMaterials();                    166   void BioChemicalMaterials();
137                                                   167 
138   // add parameters of material from NIST DB t    168   // add parameters of material from NIST DB to internal vectors
139   // density in g/cm3, mean ionisation potenti    169   // density in g/cm3, mean ionisation potential in eV
140   //                                           << 170   // 
141   void AddMaterial(const G4String& nameMat, G4 << 171   void AddMaterial(const G4String& nameMat, G4double dens, G4int Z=0,
142     G4int ncomp = 1, G4State = kStateSolid, G4 << 172        G4double pot=0.0, G4int ncomp=1,
                                                   >> 173        G4State=kStateSolid, G4bool stp = true);
143                                                   174 
144   void AddGas(const G4String& nameMat, G4doubl << 175   void AddGas(const G4String& nameMat, G4double t=NTP_Temperature,
                                                   >> 176                                        G4double p=CLHEP::STP_Pressure);
145                                                   177 
146   void AddElementByWeightFraction(G4int Z, G4d    178   void AddElementByWeightFraction(G4int Z, G4double);
147   void AddElementByAtomCount(G4int Z, G4int);  << 179   void AddElementByAtomCount     (G4int Z, G4int);
148                                                   180 
149   void AddElementByWeightFraction(const G4Stri    181   void AddElementByWeightFraction(const G4String& name, G4double);
150   void AddElementByAtomCount(const G4String& n << 182   void AddElementByAtomCount     (const G4String& name, G4int);
151                                                   183 
152   // build a G4Material from dataBase             184   // build a G4Material from dataBase
153   G4Material* BuildNistMaterial(const G4String << 
154   G4Material* BuildMaterial(G4int idx);           185   G4Material* BuildMaterial(G4int idx);
155                                                   186 
156   void DumpElm(G4int) const;                      187   void DumpElm(G4int) const;
157   void DumpMix(G4int) const;                      188   void DumpMix(G4int) const;
158                                                   189 
159  private:                                      << 190 private:
160   G4NistElementBuilder* elmBuilder;            << 
161                                                   191 
162   G4int verbose;                               << 192   G4NistElementBuilder*  elmBuilder;
163   G4int nMaterials{0};                         << 
164   G4int nComponents{0};                        << 
165   G4int nCurrent{0};                           << 
166   G4int nElementary;                           << 
167   G4int nNIST;                                 << 
168   G4int nHEP;                                  << 
169   G4int nSpace;                                << 
170                                                << 
171   std::vector<G4String> names;                 << 
172   std::vector<G4String> chFormulas;            << 
173                                                << 
174   std::vector<G4double> densities;             << 
175   std::vector<G4double> ionPotentials;         << 
176   std::vector<G4State> states;                 << 
177   std::vector<G4double> fractions;             << 
178   std::vector<G4bool> atomCount;               << 
179   std::vector<G4int> components;               << 
180   std::vector<G4int> indexes;                  << 
181   std::vector<G4int> elements;                 << 
182   std::vector<G4int> matIndex;                 << 
183   std::vector<G4bool> STP;                     << 
184                                                << 
185   std::vector<G4int> idxGas;                   << 
186   std::vector<G4double> gasTemperature;        << 
187   std::vector<G4double> gasPressure;           << 
188 };                                             << 
189                                                   193 
190 inline const std::vector<G4String>& G4NistMate << 194   G4int                  verbose;
191 {                                              << 195   G4int                  nMaterials;
192   return names;                                << 196   G4int                  nComponents;
193 }                                              << 197   G4int                  nCurrent;
                                                   >> 198   G4int                  nElementary;
                                                   >> 199   G4int                  nNIST;
                                                   >> 200   G4int                  nHEP;
                                                   >> 201   G4int                  nSpace;
                                                   >> 202 
                                                   >> 203   std::vector<G4String>  names;
                                                   >> 204   std::vector<G4String>  chFormulas;
                                                   >> 205 
                                                   >> 206   std::vector<G4double>  densities;
                                                   >> 207   std::vector<G4double>  ionPotentials;
                                                   >> 208   std::vector<G4State>   states;
                                                   >> 209   std::vector<G4double>  fractions;
                                                   >> 210   std::vector<G4bool>    atomCount;
                                                   >> 211   std::vector<G4int>     components;
                                                   >> 212   std::vector<G4int>     indexes;
                                                   >> 213   std::vector<G4int>     elements;
                                                   >> 214   std::vector<G4int>     matIndex;
                                                   >> 215   std::vector<G4bool>    STP;
                                                   >> 216 
                                                   >> 217   std::vector<G4int>     idxGas;
                                                   >> 218   std::vector<G4double>  gasTemperature;
                                                   >> 219   std::vector<G4double>  gasPressure;
                                                   >> 220 
                                                   >> 221   G4bool                 first;
                                                   >> 222 #ifdef G4MULTITHREADED
                                                   >> 223   static G4Mutex nistMaterialMutex;
                                                   >> 224 #endif
194                                                   225 
195 inline G4double G4NistMaterialBuilder::GetMean << 226 };
196 {                                              << 
197   return (index >= 0 && index < nMaterials) ?  << 
198 }                                              << 
199                                                   227 
200 inline G4double G4NistMaterialBuilder::GetNomi << 228 inline const std::vector<G4String>& 
                                                   >> 229        G4NistMaterialBuilder::GetMaterialNames() const
201 {                                                 230 {
202   return (index >= 0 && index < nMaterials) ?  << 231   return names;
203 }                                                 232 }
204                                                   233 
205 inline G4Material* G4NistMaterialBuilder::Find << 234 inline G4double 
                                                   >> 235 G4NistMaterialBuilder::GetMeanIonisationEnergy(G4int index) const
206 {                                                 236 {
207   const G4MaterialTable* theMaterialTable = G4 << 237   G4double res = 10*index;
208   G4Material* ptr = nullptr;                   << 238   if(index >= 0 && index < nMaterials) { res = ionPotentials[index]; }
209   for (auto& mat : *theMaterialTable) {        << 239   return res;
210     if (name == mat->GetName()) {              << 
211       ptr = mat;                               << 
212       break;                                   << 
213     }                                          << 
214   }                                            << 
215   return ptr;                                  << 
216 }                                                 240 }
217                                                   241 
218 inline G4Material* G4NistMaterialBuilder::Find << 242 inline G4double 
                                                   >> 243 G4NistMaterialBuilder::GetNominalDensity(G4int index) const
219 {                                                 244 {
220   return (Z > 0 && Z < nElementary) ? FindMate << 245   G4double res = 0.0;
                                                   >> 246   if(index >= 0 && index < nMaterials) { res = densities[index]; }
                                                   >> 247   return res;
221 }                                                 248 }
222                                                   249 
223 #endif                                            250 #endif
224                                                   251