Geant4 Cross Reference

Cross-Referencing   Geant4
Geant4/processes/hadronic/util/include/G4Nucleus.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 /processes/hadronic/util/include/G4Nucleus.hh (Version 11.3.0) and /processes/hadronic/util/include/G4Nucleus.hh (Version 9.4.p2)


  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 // original by H.P. Wellisch                   <<  26 //
 27 // modified by J.L. Chuma, TRIUMF, 19-Nov-1996 <<  27 //
 28 // last modified: 27-Mar-1997                  <<  28  // original by H.P. Wellisch
 29 // Chr. Volcker, 10-Nov-1997: new methods and  <<  29  // modified by J.L. Chuma, TRIUMF, 19-Nov-1996
 30 // M.G. Pia, 2 Oct 1998: modified GetFermiMome <<  30  // last modified: 27-Mar-1997
 31 //                       the source of memory  <<  31  // Chr. Volcker, 10-Nov-1997: new methods and class variables.
 32 // G.Folger, spring 2010:  add integer A/Z int <<  32  // M.G. Pia, 2 Oct 1998: modified GetFermiMomentum (original design was
 33 // A. Ribon, autumn 2021:  extended to hypernu <<  33  //                       the source of memory leaks)
 34                                                <<  34  // G.Folger, spring 2010:  add integer A/Z interface
                                                   >>  35  
 35 #ifndef G4Nucleus_h                                36 #ifndef G4Nucleus_h
 36 #define G4Nucleus_h 1                              37 #define G4Nucleus_h 1
 37 // Class Description                               38 // Class Description
 38 // This class knows how to describe a nucleus;     39 // This class knows how to describe a nucleus; 
 39 // to be used in your physics implementation (     40 // to be used in your physics implementation (not physics list) in case you need this physics.
 40 // Class Description - End                         41 // Class Description - End
 41                                                    42 
 42                                                    43  
 43 #include "globals.hh"                              44 #include "globals.hh"
 44 #include "G4ThreeVector.hh"                        45 #include "G4ThreeVector.hh"
 45 #include "G4ParticleTypes.hh"                      46 #include "G4ParticleTypes.hh"
 46 #include "G4ReactionProduct.hh"                    47 #include "G4ReactionProduct.hh"
 47 #include "G4DynamicParticle.hh"                    48 #include "G4DynamicParticle.hh"
 48 #include "G4ReactionProductVector.hh"              49 #include "G4ReactionProductVector.hh"
 49 #include "Randomize.hh"                            50 #include "Randomize.hh"
 50                                                    51  
 51 class G4Nucleus                                <<  52  class G4Nucleus 
 52 {                                              <<  53  {
 53   public:                                      <<  54  public:
 54                                                    55     
 55     G4Nucleus();                                   56     G4Nucleus();
 56     G4Nucleus(const G4double A, const G4double <<  57     
 57     G4Nucleus(const G4int A, const G4int Z, co <<  58     G4Nucleus( const G4double A, const G4double Z );
 58     G4Nucleus(const G4Material* aMaterial);    <<  59 
                                                   >>  60     G4Nucleus( const G4int A, const G4int Z );
                                                   >>  61 
                                                   >>  62     G4Nucleus( const G4Material *aMaterial );
 59                                                    63     
 60     ~G4Nucleus();                                  64     ~G4Nucleus();
 61                                                    65     
 62     inline G4Nucleus( const G4Nucleus &right )     66     inline G4Nucleus( const G4Nucleus &right )
 63     { *this = right; }                             67     { *this = right; }
 64                                                    68     
 65     inline G4Nucleus& operator = (const G4Nucl <<  69     inline G4Nucleus & operator=( const G4Nucleus &right )
 66     {                                          <<  70      {
 67       if (this != &right) {                    <<  71        if( this != &right )
 68         theA=right.theA;                       <<  72        {
 69         theZ=right.theZ;                       <<  73          theA=right.theA;  
 70         theL=right.theL;                       <<  74          theZ=right.theZ;  
 71         aEff=right.aEff;                       <<  75          aEff=right.aEff;  
 72         zEff=right.zEff;                       <<  76          zEff=right.zEff;  
 73         fIsotope = right.fIsotope;             <<  77          pnBlackTrackEnergy=right.pnBlackTrackEnergy; 
 74         pnBlackTrackEnergy=right.pnBlackTrackE <<  78          dtaBlackTrackEnergy=right.dtaBlackTrackEnergy;
 75         dtaBlackTrackEnergy=right.dtaBlackTrac <<  79          pnBlackTrackEnergyfromAnnihilation =
 76         pnBlackTrackEnergyfromAnnihilation =   <<  80                       right.pnBlackTrackEnergyfromAnnihilation; 
 77                      right.pnBlackTrackEnergyf <<  81          dtaBlackTrackEnergyfromAnnihilation =
 78         dtaBlackTrackEnergyfromAnnihilation =  <<  82                       right.dtaBlackTrackEnergyfromAnnihilation; 
 79                      right.dtaBlackTrackEnergy <<  83          theTemp = right.theTemp;
 80         theTemp = right.theTemp;               <<  84    excitationEnergy = right.excitationEnergy;
 81         excitationEnergy = right.excitationEne <<  85    momentum = right.momentum;
 82         momentum = right.momentum;             <<  86    fermiMomentum = right.fermiMomentum;
 83         fermiMomentum = right.fermiMomentum;   <<  87        }
 84       }                                        <<  88        return *this;
 85       return *this;                            <<  89      }
 86     }                                          << 
 87                                                    90    
 88     inline G4bool operator==( const G4Nucleus      91     inline G4bool operator==( const G4Nucleus &right ) const
 89     { return ( this == (G4Nucleus *) &right );     92     { return ( this == (G4Nucleus *) &right ); }
 90                                                    93     
 91     inline G4bool operator!=( const G4Nucleus      94     inline G4bool operator!=( const G4Nucleus &right ) const
 92     { return ( this != (G4Nucleus *) &right );     95     { return ( this != (G4Nucleus *) &right ); }
 93                                                    96     
 94     void ChooseParameters( const G4Material *a     97     void ChooseParameters( const G4Material *aMaterial );
 95                                                    98 
 96     void SetParameters( const G4double A, cons <<  99     void SetParameters( const G4double A, const G4double Z );
 97     void SetParameters( const G4int A, const G << 100     void SetParameters( const G4int A, const G4int Z );
 98                                                << 101     
                                                   >> 102 //deprecated Jan 2010, GF
                                                   >> 103     inline G4double GetN() const
                                                   >> 104     { return aEff; }
                                                   >> 105     
                                                   >> 106     inline G4double GetZ() const
                                                   >> 107     { return zEff; }
                                                   >> 108 
                                                   >> 109 //to be replaced by new 
 99     inline G4int GetA_asInt() const               110     inline G4int GetA_asInt() const
100     { return theA; }                              111     { return theA; }   
101                                                   112     
102     inline G4int GetN_asInt() const               113     inline G4int GetN_asInt() const
103     { return theA-theZ-theL; }                 << 114     { return theA-theZ; }   
104                                                   115     
105     inline G4int GetZ_asInt() const               116     inline G4int GetZ_asInt() const
106     { return theZ; }                              117     { return theZ; }   
107                                                << 118 //... \GF
108     inline G4int GetL() const  // Number of La << 
109     { return theL; }                           << 
110                                                << 
111     inline const G4Isotope* GetIsotope()       << 
112     { return fIsotope; }                       << 
113                                                << 
114     inline void SetIsotope(const G4Isotope* is << 
115     {                                          << 
116       fIsotope = iso;                          << 
117       if(iso) {                                << 
118   theZ = iso->GetZ();                          << 
119         theA = iso->GetN();                    << 
120   theL = 0;                                    << 
121         aEff = theA;                           << 
122         zEff = theZ;                           << 
123       }                                        << 
124     }                                          << 
125                                                   119 
126     G4DynamicParticle *ReturnTargetParticle()     120     G4DynamicParticle *ReturnTargetParticle() const;
127                                                   121     
128     G4double AtomicMass( const G4double A, con << 122     G4double AtomicMass( const G4double A, const G4double Z ) const;
129     G4double AtomicMass( const G4int A, const  << 123     G4double AtomicMass( const G4int A, const G4int Z ) const;
130                                                << 124     
131     G4double GetThermalPz( const G4double mass    125     G4double GetThermalPz( const G4double mass, const G4double temp ) const;
132                                                   126     
133     G4ReactionProduct GetThermalNucleus(G4doub    127     G4ReactionProduct GetThermalNucleus(G4double aMass, G4double temp=-1) const;
134                                                   128     
135     G4ReactionProduct GetBiasedThermalNucleus(    129     G4ReactionProduct GetBiasedThermalNucleus(G4double aMass, G4ThreeVector aVelocity, G4double temp=-1) const;
136                                                   130 
137     void DoKinematicsOfThermalNucleus(const G4 << 
138                                       G4Reacti << 
139                                                << 
140     G4double Cinema( G4double kineticEnergy );    131     G4double Cinema( G4double kineticEnergy );
141                                                   132     
142     G4double EvaporationEffects( G4double kine    133     G4double EvaporationEffects( G4double kineticEnergy );
143                                                   134 
144     G4double AnnihilationEvaporationEffects(G4    135     G4double AnnihilationEvaporationEffects(G4double kineticEnergy, G4double ekOrg);
145                                                   136     
146     inline G4double GetPNBlackTrackEnergy() co    137     inline G4double GetPNBlackTrackEnergy() const
147     { return pnBlackTrackEnergy; }                138     { return pnBlackTrackEnergy; }
148                                                   139     
149     inline G4double GetDTABlackTrackEnergy() c    140     inline G4double GetDTABlackTrackEnergy() const
150     { return dtaBlackTrackEnergy; }               141     { return dtaBlackTrackEnergy; }
151                                                   142     
152     inline G4double GetAnnihilationPNBlackTrac    143     inline G4double GetAnnihilationPNBlackTrackEnergy() const
153     { return pnBlackTrackEnergyfromAnnihilatio    144     { return pnBlackTrackEnergyfromAnnihilation; }
154                                                   145     
155     inline G4double GetAnnihilationDTABlackTra    146     inline G4double GetAnnihilationDTABlackTrackEnergy() const
156     { return dtaBlackTrackEnergyfromAnnihilati    147     { return dtaBlackTrackEnergyfromAnnihilation; }
157                                                   148     
158 // ******************  methods introduced by C    149 // ******************  methods introduced by ChV ***********************    
159    // return fermi momentum                       150    // return fermi momentum
160      G4ThreeVector GetFermiMomentum();            151      G4ThreeVector GetFermiMomentum();
161                                                   152 
162 /*                                                153 /*
163   // return particle to be absorbed.              154   // return particle to be absorbed. 
164      G4DynamicParticle* ReturnAbsorbingParticl    155      G4DynamicParticle* ReturnAbsorbingParticle(G4double weight);
165 */                                                156 */
166                                                   157 
167   //  final nucleus fragmentation. Return List    158   //  final nucleus fragmentation. Return List of particles
168   // which should be used for further tracking    159   // which should be used for further tracking.
169      G4ReactionProductVector* Fragmentate();      160      G4ReactionProductVector* Fragmentate();
170                                                   161      
171                                                   162 
172   // excitation Energy...                         163   // excitation Energy...
173      void AddExcitationEnergy(G4double anEnerg    164      void AddExcitationEnergy(G4double anEnergy);
174                                                   165   
175                                                   166   
176   // momentum of absorbed Particles ..            167   // momentum of absorbed Particles ..
177      void AddMomentum(const G4ThreeVector aMom    168      void AddMomentum(const G4ThreeVector aMomentum);
178                                                   169      
179   // return excitation Energy                     170   // return excitation Energy
180      G4double GetEnergyDeposit() {return excit    171      G4double GetEnergyDeposit() {return excitationEnergy; }
181                                                   172      
182                                                   173 
183                                                   174 
184 // ****************************** end ChV ****    175 // ****************************** end ChV ******************************
185                                                   176 
186                                                   177 
187  private:                                         178  private:
188                                                   179     
189     G4int    theA;                                180     G4int    theA;
190     G4int    theZ;                                181     G4int    theZ;
191     G4int    theL;  // Number of Lambdas (in t << 
192     G4double aEff;  // effective atomic weight    182     G4double aEff;  // effective atomic weight
193     G4double zEff;  // effective atomic number    183     G4double zEff;  // effective atomic number
194                                                << 
195     const G4Isotope* fIsotope;                 << 
196                                                   184     
197     G4double pnBlackTrackEnergy;  // the kinet    185     G4double pnBlackTrackEnergy;  // the kinetic energy available for
198                                   // proton/ne    186                                   // proton/neutron black track particles
199     G4double dtaBlackTrackEnergy; // the kinet    187     G4double dtaBlackTrackEnergy; // the kinetic energy available for
200                                   // deuteron/    188                                   // deuteron/triton/alpha particles
201     G4double pnBlackTrackEnergyfromAnnihilatio    189     G4double pnBlackTrackEnergyfromAnnihilation;
202                      // kinetic energy availab    190                      // kinetic energy available for proton/neutron black 
203                      // track particles based     191                      // track particles based on baryon annihilation 
204     G4double dtaBlackTrackEnergyfromAnnihilati    192     G4double dtaBlackTrackEnergyfromAnnihilation;
205                      // kinetic energy availab    193                      // kinetic energy available for deuteron/triton/alpha 
206                      // black track particles     194                      // black track particles based on baryon annihilation 
207                                                   195 
208                                                   196 
209 // ************************** member variables    197 // ************************** member variables by ChV *******************
210   // Excitation Energy leading to evaporation     198   // Excitation Energy leading to evaporation or deexcitation.
211      G4double  excitationEnergy;                  199      G4double  excitationEnergy;
212                                                   200      
213   // Momentum, accumulated by absorbing Partic    201   // Momentum, accumulated by absorbing Particles
214      G4ThreeVector momentum;                      202      G4ThreeVector momentum;
215                                                   203      
216   // Fermi Gas model: at present, we assume co    204   // Fermi Gas model: at present, we assume constant nucleon density for all 
217   // nuclei. The radius of a nucleon is taken     205   // nuclei. The radius of a nucleon is taken to be 1 fm.
218   // see for example S.Fl"ugge, Encyclopedia o    206   // see for example S.Fl"ugge, Encyclopedia of Physics, Vol XXXIX, 
219   // Structure of Atomic Nuclei (Berlin-Gottin    207   // Structure of Atomic Nuclei (Berlin-Gottingen-Heidelberg, 1957) page 426.
220                                                   208 
221   // maximum momentum possible from fermi gas     209   // maximum momentum possible from fermi gas model:
222      G4double fermiMomentum;                      210      G4double fermiMomentum; 
223      G4double theTemp; // temperature             211      G4double theTemp; // temperature
224 // ****************************** end ChV ****    212 // ****************************** end ChV ******************************
225                                                   213 
226  };                                               214  };
227                                                   215  
228 #endif                                            216 #endif
229                                                   217  
230                                                   218