Geant4 Cross Reference

Cross-Referencing   Geant4
Geant4/processes/decay/src/G4Decay.cc

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/decay/src/G4Decay.cc (Version 11.3.0) and /processes/decay/src/G4Decay.cc (Version 11.2.1)


  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 //                                                 26 //
 27 //                                                 27 //
 28 //                                                 28 // 
 29 // -------------------------------------------     29 // --------------------------------------------------------------
 30 //      GEANT 4 class implementation file          30 //      GEANT 4 class implementation file
 31 //                                                 31 //
 32 //      History: first implementation, based o     32 //      History: first implementation, based on object model of
 33 //      2nd December 1995, G.Cosmo                 33 //      2nd December 1995, G.Cosmo
 34 //      7 July 1996 H.Kurashige                    34 //      7 July 1996 H.Kurashige
 35 // -------------------------------------------     35 // ------------------------------------------------------------
 36 //   remove  BuildPhysicsTable()  28 Nov. 1997     36 //   remove  BuildPhysicsTable()  28 Nov. 1997  H.Kurashige
 37 //   change  DBL_EPSIRON to DBL_MIN 14 Dec. 19     37 //   change  DBL_EPSIRON to DBL_MIN 14 Dec. 1997  H.Kurashige
 38 //   modified for new ParticleChange 12 Mar. 1     38 //   modified for new ParticleChange 12 Mar. 1998  H.Kurashige
 39 //   modified for "GoodForTrackingFlag" 19 Jun     39 //   modified for "GoodForTrackingFlag" 19 June 1998  H.Kurashige
 40 //   rename thePhysicsTable to aPhyscisTable 2     40 //   rename thePhysicsTable to aPhyscisTable 2 Aug. 1998 H.Kurashige
 41 //   modified IsApplicable in order to protect     41 //   modified IsApplicable in order to protect the decay from registered 
 42 //   to resonances    12 Dec. 1998   H.Kurashi     42 //   to resonances    12 Dec. 1998   H.Kurashige 
 43 //   remove G4ParticleMomentum  6 Feb. 99 H.Ku     43 //   remove G4ParticleMomentum  6 Feb. 99 H.Kurashige
 44 //   modified  IsApplicable to activate G4Deca     44 //   modified  IsApplicable to activate G4Decay for resonances  1 Mar. 00 H.Kurashige 
 45 //   Add External Decayer         23 Feb. 2001     45 //   Add External Decayer         23 Feb. 2001  H.Kurashige
 46 //   change LowestBinValue,HighestBinValue and     46 //   change LowestBinValue,HighestBinValue and TotBin(200) 9 Feb. 2002
 47 //                                                 47 //
 48                                                    48 
 49 #include "G4Decay.hh"                              49 #include "G4Decay.hh"
 50                                                    50 
 51 #include "G4PhysicalConstants.hh"                  51 #include "G4PhysicalConstants.hh"
 52 #include "G4SystemOfUnits.hh"                      52 #include "G4SystemOfUnits.hh"
 53 #include "G4DynamicParticle.hh"                    53 #include "G4DynamicParticle.hh"
 54 #include "G4DecayProducts.hh"                      54 #include "G4DecayProducts.hh"
 55 #include "G4DecayTable.hh"                         55 #include "G4DecayTable.hh"
 56 #include "G4VDecayChannel.hh"                      56 #include "G4VDecayChannel.hh"
 57 #include "G4PhysicsLogVector.hh"                   57 #include "G4PhysicsLogVector.hh"
 58 #include "G4ParticleChangeForDecay.hh"             58 #include "G4ParticleChangeForDecay.hh"
 59 #include "G4VExtDecayer.hh"                        59 #include "G4VExtDecayer.hh"
 60                                                    60 
 61 // constructor                                     61 // constructor
 62 G4Decay::G4Decay(const G4String& processName)      62 G4Decay::G4Decay(const G4String& processName)
 63                                :G4VRestDiscret     63                                :G4VRestDiscreteProcess(processName, fDecay),
 64         verboseLevel(1),                           64         verboseLevel(1),
 65                                 HighestValue(2     65                                 HighestValue(20.0),
 66         fRemainderLifeTime(-1.0),                  66         fRemainderLifeTime(-1.0),
 67                                 pExtDecayer(nu     67                                 pExtDecayer(nullptr)
 68 {                                                  68 {
 69   // set Process Sub Type                          69   // set Process Sub Type
 70   SetProcessSubType(static_cast<int>(DECAY));      70   SetProcessSubType(static_cast<int>(DECAY));
 71                                                    71 
 72 #ifdef G4VERBOSE                                   72 #ifdef G4VERBOSE
 73   if (GetVerboseLevel()>1) {                       73   if (GetVerboseLevel()>1) {
 74     G4cout << "G4Decay  constructor " << "  Na     74     G4cout << "G4Decay  constructor " << "  Name:" << processName << G4endl;
 75   }                                                75   }
 76 #endif                                             76 #endif
 77                                                    77 
 78   pParticleChange = &fParticleChangeForDecay;      78   pParticleChange = &fParticleChangeForDecay;
 79 }                                                  79 }
 80                                                    80 
 81 G4Decay::~G4Decay()                                81 G4Decay::~G4Decay()
 82 {                                                  82 {
 83   if (pExtDecayer != nullptr) {                    83   if (pExtDecayer != nullptr) {
 84     delete pExtDecayer;                            84     delete pExtDecayer;
 85   }                                                85   }
 86 }                                                  86 }
 87                                                    87 
 88 G4bool G4Decay::IsApplicable(const G4ParticleD     88 G4bool G4Decay::IsApplicable(const G4ParticleDefinition& aParticleType)
 89 {                                                  89 {
 90    // check if the particle is stable?             90    // check if the particle is stable?
 91    if (aParticleType.GetPDGLifeTime() <0.0) {      91    if (aParticleType.GetPDGLifeTime() <0.0) {
 92      return false;                                 92      return false;
 93    } else if (aParticleType.GetPDGMass() <= 0.     93    } else if (aParticleType.GetPDGMass() <= 0.0*MeV) {
 94      return false;                                 94      return false;
 95    } else {                                        95    } else {
 96      return true;                                  96      return true; 
 97    }                                               97    }
 98 }                                                  98 }
 99                                                    99 
100 G4double G4Decay::GetMeanLifeTime(const G4Trac    100 G4double G4Decay::GetMeanLifeTime(const G4Track& aTrack  ,
101                                   G4ForceCondi    101                                   G4ForceCondition*)
102 {                                                 102 {
103    // returns the mean free path in GEANT4 int    103    // returns the mean free path in GEANT4 internal units
104    G4double meanlife;                             104    G4double meanlife;
105                                                   105 
106    // get particle                                106    // get particle 
107    const G4DynamicParticle* aParticle = aTrack    107    const G4DynamicParticle* aParticle = aTrack.GetDynamicParticle();
108    const G4ParticleDefinition* aParticleDef =     108    const G4ParticleDefinition* aParticleDef = aParticle->GetDefinition();
109    G4double aLife = aParticleDef->GetPDGLifeTi    109    G4double aLife = aParticleDef->GetPDGLifeTime();
110                                                   110 
111    // check if the particle is stable?            111    // check if the particle is stable?
112    if (aParticleDef->GetPDGStable()) {            112    if (aParticleDef->GetPDGStable()) {
113     //1000000 times the life time of the unive    113     //1000000 times the life time of the universe
114      meanlife = 1e24 * s;                         114      meanlife = 1e24 * s;
115                                                   115     
116    } else {                                       116    } else {
117      meanlife = aLife;                            117      meanlife = aLife;
118    }                                              118    }
119                                                   119 
120 #ifdef G4VERBOSE                                  120 #ifdef G4VERBOSE
121    if (GetVerboseLevel()>1) {                     121    if (GetVerboseLevel()>1) {
122      G4cout << "mean life time: "<< meanlife/n    122      G4cout << "mean life time: "<< meanlife/ns << "[ns]" << G4endl;
123    }                                              123    }
124 #endif                                            124 #endif
125                                                   125 
126    return  meanlife;                              126    return  meanlife;
127 }                                                 127 }
128                                                   128 
129 G4double G4Decay::GetMeanFreePath(const G4Trac    129 G4double G4Decay::GetMeanFreePath(const G4Track& aTrack,G4double, G4ForceCondition*)
130 {                                                 130 {
131    // get particle                                131    // get particle 
132    const G4DynamicParticle* aParticle = aTrack    132    const G4DynamicParticle* aParticle = aTrack.GetDynamicParticle();
133    const G4ParticleDefinition* aParticleDef =     133    const G4ParticleDefinition* aParticleDef = aParticle->GetDefinition();
134    G4double aMass = aParticle->GetMass();         134    G4double aMass = aParticle->GetMass();
135    G4double aLife = aParticleDef->GetPDGLifeTi    135    G4double aLife = aParticleDef->GetPDGLifeTime();
136                                                   136 
137                                                   137 
138     // returns the mean free path in GEANT4 in    138     // returns the mean free path in GEANT4 internal units
139    G4double pathlength;                           139    G4double pathlength;
140    G4double aCtau = c_light * aLife;              140    G4double aCtau = c_light * aLife;
141                                                   141 
142    // check if the particle is stable?            142    // check if the particle is stable?
143    if (aParticleDef->GetPDGStable()) {            143    if (aParticleDef->GetPDGStable()) {
144      pathlength = DBL_MAX;                        144      pathlength = DBL_MAX;
145                                                   145 
146    //check if the particle has very short life    146    //check if the particle has very short life time ?
147    } else if (aCtau < DBL_MIN) {                  147    } else if (aCtau < DBL_MIN) { 
148      pathlength =  DBL_MIN;                       148      pathlength =  DBL_MIN;
149                                                   149  
150    } else {                                       150    } else {
151     //calculate the mean free path                151     //calculate the mean free path 
152     // by using normalized kinetic energy (= E    152     // by using normalized kinetic energy (= Ekin/mass)
153      G4double   rKineticEnergy = aParticle->Ge    153      G4double   rKineticEnergy = aParticle->GetKineticEnergy()/aMass; 
154      if ( rKineticEnergy > HighestValue) {        154      if ( rKineticEnergy > HighestValue) {
155        // gamma >>  1                             155        // gamma >>  1
156        pathlength = ( rKineticEnergy + 1.0)* a    156        pathlength = ( rKineticEnergy + 1.0)* aCtau;
157      } else if ( rKineticEnergy < DBL_MIN ) {     157      } else if ( rKineticEnergy < DBL_MIN ) {
158        // too slow particle                       158        // too slow particle
159 #ifdef G4VERBOSE                                  159 #ifdef G4VERBOSE
160        if (GetVerboseLevel()>1) {                 160        if (GetVerboseLevel()>1) {
161    G4cout << "G4Decay::GetMeanFreePath()   !!p    161    G4cout << "G4Decay::GetMeanFreePath()   !!particle stops!!";
162          G4cout << aParticleDef->GetParticleNa    162          G4cout << aParticleDef->GetParticleName() << G4endl;
163    G4cout << "KineticEnergy:" << aParticle->Ge    163    G4cout << "KineticEnergy:" << aParticle->GetKineticEnergy()/GeV <<"[GeV]";
164        }                                          164        }
165 #endif                                            165 #endif
166        pathlength = DBL_MIN;                      166        pathlength = DBL_MIN;
167      } else {                                     167      } else {
168        // beta <1                                 168        // beta <1 
169        pathlength = (aParticle->GetTotalMoment    169        pathlength = (aParticle->GetTotalMomentum())/aMass*aCtau ;
170      }                                            170      }
171    }                                              171    }
172   return  pathlength;                             172   return  pathlength;
173 }                                                 173 }
174                                                   174 
175 void G4Decay::BuildPhysicsTable(const G4Partic    175 void G4Decay::BuildPhysicsTable(const G4ParticleDefinition&)
176 {                                                 176 {
177   return;                                         177   return;
178 }                                                 178 }
179                                                   179 
180 G4VParticleChange* G4Decay::DecayIt(const G4Tr    180 G4VParticleChange* G4Decay::DecayIt(const G4Track& aTrack, const G4Step& )
181 {                                                 181 {
182   // The DecayIt() method returns by pointer a    182   // The DecayIt() method returns by pointer a particle-change object.
183   // Units are expressed in GEANT4 internal un    183   // Units are expressed in GEANT4 internal units.
184                                                   184 
185   //   Initialize ParticleChange                  185   //   Initialize ParticleChange
186   //     all members of G4VParticleChange are     186   //     all members of G4VParticleChange are set to equal to 
187   //     corresponding member in G4Track          187   //     corresponding member in G4Track
188   fParticleChangeForDecay.Initialize(aTrack);     188   fParticleChangeForDecay.Initialize(aTrack);
189                                                   189 
190   // get particle                                 190   // get particle 
191   const G4DynamicParticle* aParticle = aTrack.    191   const G4DynamicParticle* aParticle = aTrack.GetDynamicParticle();
192   const G4ParticleDefinition* aParticleDef = a    192   const G4ParticleDefinition* aParticleDef = aParticle->GetDefinition();
193                                                   193 
194   // check if  the particle is stable             194   // check if  the particle is stable
195   if (aParticleDef->GetPDGStable()) return &fP    195   if (aParticleDef->GetPDGStable()) return &fParticleChangeForDecay ;
196                                                   196  
197                                                   197 
198   //check if thePreAssignedDecayProducts exist    198   //check if thePreAssignedDecayProducts exists
199   const G4DecayProducts* o_products = (aPartic    199   const G4DecayProducts* o_products = (aParticle->GetPreAssignedDecayProducts());
200   G4bool isPreAssigned = (o_products != nullpt    200   G4bool isPreAssigned = (o_products != nullptr);   
201   G4DecayProducts* products = nullptr;            201   G4DecayProducts* products = nullptr;
202                                                   202 
203   // decay table                                  203   // decay table
204   G4DecayTable   *decaytable = aParticleDef->G    204   G4DecayTable   *decaytable = aParticleDef->GetDecayTable();
205                                                   205  
206   // check if external decayer exists             206   // check if external decayer exists
207   G4bool isExtDecayer = (decaytable == nullptr    207   G4bool isExtDecayer = (decaytable == nullptr) && (pExtDecayer != nullptr);
208                                                   208 
209   // Error due to NO Decay Table                  209   // Error due to NO Decay Table 
210   if ( (decaytable == nullptr) && !isExtDecaye    210   if ( (decaytable == nullptr) && !isExtDecayer && !isPreAssigned ){
211     if (GetVerboseLevel()>0) {                    211     if (GetVerboseLevel()>0) {
212       G4cout <<  "G4Decay::DoIt  : decay table    212       G4cout <<  "G4Decay::DoIt  : decay table not defined  for ";
213       G4cout << aParticle->GetDefinition()->Ge    213       G4cout << aParticle->GetDefinition()->GetParticleName()<< G4endl;
214     }                                             214     }
215     G4ExceptionDescription ed;                    215     G4ExceptionDescription ed;
216     ed << "For " << aParticle->GetDefinition()    216     ed << "For " << aParticle->GetDefinition()->GetParticleName()
217        << " decay probability exist but decay     217        << " decay probability exist but decay table is not defined "
218        << "- the particle will be killed;\n"      218        << "- the particle will be killed;\n"
219        << "    isExtDecayer: " << isExtDecayer    219        << "    isExtDecayer: " << isExtDecayer
220        << "; isPreAssigned: " << isPreAssigned    220        << "; isPreAssigned: " << isPreAssigned;    
221     G4Exception( "G4Decay::DecayIt ",             221     G4Exception( "G4Decay::DecayIt ",
222                  "DECAY101",JustWarning, ed);     222                  "DECAY101",JustWarning, ed);
223                                                   223 
224     fParticleChangeForDecay.SetNumberOfSeconda    224     fParticleChangeForDecay.SetNumberOfSecondaries(0);
225     // Kill the parent particle                   225     // Kill the parent particle
226     fParticleChangeForDecay.ProposeTrackStatus    226     fParticleChangeForDecay.ProposeTrackStatus( fStopAndKill ) ;
227     fParticleChangeForDecay.ProposeLocalEnergy    227     fParticleChangeForDecay.ProposeLocalEnergyDeposit(0.0); 
228                                                   228     
229     ClearNumberOfInteractionLengthLeft();         229     ClearNumberOfInteractionLengthLeft();
230     return &fParticleChangeForDecay ;             230     return &fParticleChangeForDecay ;
231   }                                               231   }
232                                                   232 
233   if (isPreAssigned) {                            233   if (isPreAssigned) {
234     // copy decay products                        234     // copy decay products 
235     products = new G4DecayProducts(*o_products    235     products = new G4DecayProducts(*o_products); 
236   } else if ( isExtDecayer ) {                    236   } else if ( isExtDecayer ) {
237     // decay according to external decayer        237     // decay according to external decayer
238     products = pExtDecayer->ImportDecayProduct    238     products = pExtDecayer->ImportDecayProducts(aTrack);
239   } else {                                        239   } else {
240     // Decay according to decay table.            240     // Decay according to decay table.
241     // Keep trying to choose a candidate decay    241     // Keep trying to choose a candidate decay channel if the dynamic mass
242     // of the decaying particle is below the s    242     // of the decaying particle is below the sum of the PDG masses of the
243     // candidate daughter particles.              243     // candidate daughter particles.
244     // This is needed because the decay table     244     // This is needed because the decay table used in Geant4 is based on
245     // the assumption of nominal PDG masses, b    245     // the assumption of nominal PDG masses, but a wide resonance can have
246     // a dynamic masses well below its nominal    246     // a dynamic masses well below its nominal PDG masses, and therefore
247     // some of its decay channels can be below    247     // some of its decay channels can be below the kinematical threshold. 
248     // Note that, for simplicity, we ignore he    248     // Note that, for simplicity, we ignore here the possibility that
249     // one or more of the candidate daughter p    249     // one or more of the candidate daughter particles can be, in turn,
250     // wide resonance. However, if this is the    250     // wide resonance. However, if this is the case, and the channel is
251     // accepted, then the masses of the resona    251     // accepted, then the masses of the resonance daughter particles will
252     // be sampled by taking into account their    252     // be sampled by taking into account their widths.
253     G4VDecayChannel* decaychannel = nullptr;      253     G4VDecayChannel* decaychannel = nullptr;
254     G4double massParent = aParticle->GetMass()    254     G4double massParent = aParticle->GetMass();
255     decaychannel = decaytable->SelectADecayCha    255     decaychannel = decaytable->SelectADecayChannel(massParent);
256     if ( decaychannel == nullptr) {               256     if ( decaychannel == nullptr) {
257       // decay channel not found                  257       // decay channel not found
258      G4ExceptionDescription ed;                   258      G4ExceptionDescription ed;
259       ed << "Can not determine decay channel f    259       ed << "Can not determine decay channel for " 
260    << aParticleDef->GetParticleName() << G4end    260    << aParticleDef->GetParticleName() << G4endl 
261    << "  mass of dynamic particle: "              261    << "  mass of dynamic particle: " 
262    << massParent/GeV << " (GEV)" << G4endl        262    << massParent/GeV << " (GEV)" << G4endl
263    << "  dacay table has " << decaytable->entr    263    << "  dacay table has " << decaytable->entries() 
264    << " entries" << G4endl;                       264    << " entries" << G4endl;
265       G4double checkedmass=massParent;            265       G4double checkedmass=massParent;
266       if (massParent < 0.) {                      266       if (massParent < 0.) {
267   checkedmass=aParticleDef->GetPDGMass();         267   checkedmass=aParticleDef->GetPDGMass();
268   ed << "Using PDG mass ("<<checkedmass/GeV       268   ed << "Using PDG mass ("<<checkedmass/GeV 
269      << "(GeV)) in IsOKWithParentMass" << G4en    269      << "(GeV)) in IsOKWithParentMass" << G4endl; 
270       }                                           270       }
271       for (G4int ic =0;ic <decaytable->entries    271       for (G4int ic =0;ic <decaytable->entries();++ic) {
272   G4VDecayChannel * dc= decaytable->GetDecayCh    272   G4VDecayChannel * dc= decaytable->GetDecayChannel(ic);
273   ed << ic << ": BR " << dc->GetBR() << ", IsO    273   ed << ic << ": BR " << dc->GetBR() << ", IsOK? " 
274      << dc->IsOKWithParentMass(checkedmass)       274      << dc->IsOKWithParentMass(checkedmass)
275      << ", --> ";                                 275      << ", --> "; 
276   G4int ndaughters=dc->GetNumberOfDaughters();    276   G4int ndaughters=dc->GetNumberOfDaughters();
277   for (G4int id=0;id<ndaughters;++id) {           277   for (G4int id=0;id<ndaughters;++id) {
278     if (id>0) ed << " + ";   // seperator, exc    278     if (id>0) ed << " + ";   // seperator, except for first
279     ed << dc->GetDaughterName(id);                279     ed << dc->GetDaughterName(id);
280   }                                               280   }
281   ed << G4endl;                                   281   ed << G4endl;
282       }                                           282       }
283       G4Exception("G4Decay::DoIt", "DECAY003",    283       G4Exception("G4Decay::DoIt", "DECAY003", FatalException,ed);
284     } else {                                      284     } else {
285       // execute DecayIt()                        285       // execute DecayIt() 
286 #ifdef G4VERBOSE                                  286 #ifdef G4VERBOSE
287       G4int temp = decaychannel->GetVerboseLev    287       G4int temp = decaychannel->GetVerboseLevel();
288       if (GetVerboseLevel()>1) {                  288       if (GetVerboseLevel()>1) {
289   G4cout << "G4Decay::DoIt  : selected decay c    289   G4cout << "G4Decay::DoIt  : selected decay channel  addr:" 
290          << decaychannel <<G4endl;                290          << decaychannel <<G4endl;
291   decaychannel->SetVerboseLevel(GetVerboseLeve    291   decaychannel->SetVerboseLevel(GetVerboseLevel());
292       }                                           292       }
293 #endif                                            293 #endif
294       products = decaychannel->DecayIt(aPartic    294       products = decaychannel->DecayIt(aParticle->GetMass());
295 #ifdef G4VERBOSE                                  295 #ifdef G4VERBOSE
296       if (GetVerboseLevel()>1) {                  296       if (GetVerboseLevel()>1) {
297   decaychannel->SetVerboseLevel(temp);            297   decaychannel->SetVerboseLevel(temp);
298       }                                           298       }
299 #endif                                            299 #endif
300 #ifdef G4VERBOSE                                  300 #ifdef G4VERBOSE
301       if (GetVerboseLevel()>2) {                  301       if (GetVerboseLevel()>2) {
302   if (! products->IsChecked() ) products->Dump    302   if (! products->IsChecked() ) products->DumpInfo();
303       }                                           303       }
304 #endif                                            304 #endif
305     }                                             305     }
306   }                                               306   }
307                                                   307   
308   // get parent particle information .........    308   // get parent particle information ...................................
309   G4double   ParentEnergy  = aParticle->GetTot    309   G4double   ParentEnergy  = aParticle->GetTotalEnergy();
310   G4double   ParentMass    = aParticle->GetMas    310   G4double   ParentMass    = aParticle->GetMass();
311   if (ParentEnergy < ParentMass) {                311   if (ParentEnergy < ParentMass) {
312     G4ExceptionDescription ed;                    312     G4ExceptionDescription ed;
313     ed << "Total Energy is less than its mass     313     ed << "Total Energy is less than its mass - increased the energy"
314        << "\n Particle: " << aParticle->GetDef    314        << "\n Particle: " << aParticle->GetDefinition()->GetParticleName()
315        << "\n Energy:"    << ParentEnergy/MeV     315        << "\n Energy:"    << ParentEnergy/MeV << "[MeV]"
316        << "\n Mass:"      << ParentMass/MeV <<    316        << "\n Mass:"      << ParentMass/MeV << "[MeV]";
317     G4Exception( "G4Decay::DecayIt ",             317     G4Exception( "G4Decay::DecayIt ",
318                  "DECAY102",JustWarning, ed);     318                  "DECAY102",JustWarning, ed);
319     ParentEnergy = ParentMass;                    319     ParentEnergy = ParentMass;
320   }                                               320   }
321                                                   321 
322   G4ThreeVector ParentDirection(aParticle->Get    322   G4ThreeVector ParentDirection(aParticle->GetMomentumDirection());
323                                                   323 
324   //boost all decay products to laboratory fra    324   //boost all decay products to laboratory frame
325   G4double energyDeposit = 0.0;                   325   G4double energyDeposit = 0.0;
326   G4double finalGlobalTime = aTrack.GetGlobalT    326   G4double finalGlobalTime = aTrack.GetGlobalTime();
327   G4double finalLocalTime = aTrack.GetLocalTim    327   G4double finalLocalTime = aTrack.GetLocalTime();
328   if (aTrack.GetTrackStatus() == fStopButAlive    328   if (aTrack.GetTrackStatus() == fStopButAlive ){
329     // AtRest case                                329     // AtRest case
330     finalGlobalTime += fRemainderLifeTime;        330     finalGlobalTime += fRemainderLifeTime;
331     finalLocalTime += fRemainderLifeTime;         331     finalLocalTime += fRemainderLifeTime;
332     energyDeposit += aParticle->GetKineticEner    332     energyDeposit += aParticle->GetKineticEnergy();
333     if (isPreAssigned) products->Boost( Parent    333     if (isPreAssigned) products->Boost( ParentEnergy, ParentDirection);
334   } else {                                        334   } else {
335     // PostStep case                              335     // PostStep case
336     if (!isExtDecayer) products->Boost( Parent    336     if (!isExtDecayer) products->Boost( ParentEnergy, ParentDirection);
337   }                                               337   }
338    // set polarization for daughter particles     338    // set polarization for daughter particles
339    DaughterPolarization(aTrack, products);        339    DaughterPolarization(aTrack, products);
340                                                   340 
341                                                   341 
342   //add products in fParticleChangeForDecay       342   //add products in fParticleChangeForDecay
343   G4int numberOfSecondaries = products->entrie    343   G4int numberOfSecondaries = products->entries();
344   fParticleChangeForDecay.SetNumberOfSecondari    344   fParticleChangeForDecay.SetNumberOfSecondaries(numberOfSecondaries);
345 #ifdef G4VERBOSE                                  345 #ifdef G4VERBOSE
346   if (GetVerboseLevel()>1) {                      346   if (GetVerboseLevel()>1) {
347     G4cout << "G4Decay::DoIt  : Decay vertex :    347     G4cout << "G4Decay::DoIt  : Decay vertex :";
348     G4cout << " Time: " << finalGlobalTime/ns     348     G4cout << " Time: " << finalGlobalTime/ns << "[ns]";
349     G4cout << " X:" << (aTrack.GetPosition()).    349     G4cout << " X:" << (aTrack.GetPosition()).x() /cm << "[cm]";
350     G4cout << " Y:" << (aTrack.GetPosition()).    350     G4cout << " Y:" << (aTrack.GetPosition()).y() /cm << "[cm]";
351     G4cout << " Z:" << (aTrack.GetPosition()).    351     G4cout << " Z:" << (aTrack.GetPosition()).z() /cm << "[cm]";
352     G4cout << G4endl;                             352     G4cout << G4endl;
353     G4cout << "G4Decay::DoIt  : decay products    353     G4cout << "G4Decay::DoIt  : decay products in Lab. Frame" << G4endl;
354     products->DumpInfo();                         354     products->DumpInfo();
355   }                                               355   }
356 #endif                                            356 #endif
357   G4int index;                                    357   G4int index;
358   G4ThreeVector currentPosition;                  358   G4ThreeVector currentPosition;
359   const G4TouchableHandle thand = aTrack.GetTo    359   const G4TouchableHandle thand = aTrack.GetTouchableHandle();
360   for (index=0; index < numberOfSecondaries; i    360   for (index=0; index < numberOfSecondaries; index++){
361     // get current position of the track          361     // get current position of the track
362     currentPosition = aTrack.GetPosition();       362     currentPosition = aTrack.GetPosition();
363     // create a new track object                  363     // create a new track object
364     G4Track* secondary = new G4Track( products    364     G4Track* secondary = new G4Track( products->PopProducts(),
365               finalGlobalTime ,                   365               finalGlobalTime ,
366               currentPosition );                  366               currentPosition );
367     // switch on good for tracking flag           367     // switch on good for tracking flag
368     secondary->SetGoodForTrackingFlag();          368     secondary->SetGoodForTrackingFlag();
369     secondary->SetTouchableHandle(thand);         369     secondary->SetTouchableHandle(thand);
370     // add the secondary track in the List        370     // add the secondary track in the List
371     fParticleChangeForDecay.AddSecondary(secon    371     fParticleChangeForDecay.AddSecondary(secondary);
372   }                                               372   }
373   delete products;                                373   delete products;
374                                                   374   
375   // Kill the parent particle                     375   // Kill the parent particle
376   fParticleChangeForDecay.ProposeTrackStatus(     376   fParticleChangeForDecay.ProposeTrackStatus( fStopAndKill ) ;
377   fParticleChangeForDecay.ProposeLocalEnergyDe    377   fParticleChangeForDecay.ProposeLocalEnergyDeposit(energyDeposit); 
378   fParticleChangeForDecay.ProposeLocalTime( fi    378   fParticleChangeForDecay.ProposeLocalTime( finalLocalTime );
379                                                   379   
380   // Clear NumberOfInteractionLengthLeft          380   // Clear NumberOfInteractionLengthLeft
381   ClearNumberOfInteractionLengthLeft();           381   ClearNumberOfInteractionLengthLeft();
382                                                   382   
383   return &fParticleChangeForDecay ;               383   return &fParticleChangeForDecay ;
384 }                                                 384 } 
385                                                   385 
386 void G4Decay::DaughterPolarization(const G4Tra    386 void G4Decay::DaughterPolarization(const G4Track& , G4DecayProducts* )
387 {                                                 387 {
388   // empty implementation                         388   // empty implementation
389 }                                                 389 }
390                                                   390 
391                                                   391 
392                                                   392 
393 void G4Decay::StartTracking(G4Track*)             393 void G4Decay::StartTracking(G4Track*)
394 {                                                 394 {
395   currentInteractionLength = -1.0;                395   currentInteractionLength = -1.0;
396   ResetNumberOfInteractionLengthLeft();           396   ResetNumberOfInteractionLengthLeft();
397                                                   397  
398   fRemainderLifeTime = -1.0;                      398   fRemainderLifeTime = -1.0;
399 }                                                 399 }
400                                                   400 
401 void G4Decay::EndTracking()                       401 void G4Decay::EndTracking()
402 {                                                 402 {
403   // Clear NumberOfInteractionLengthLeft          403   // Clear NumberOfInteractionLengthLeft
404   ClearNumberOfInteractionLengthLeft();           404   ClearNumberOfInteractionLengthLeft();
405                                                   405 
406   currentInteractionLength = -1.0;                406   currentInteractionLength = -1.0;
407 }                                                 407 }
408                                                   408 
409                                                   409 
410 G4double G4Decay::PostStepGetPhysicalInteracti    410 G4double G4Decay::PostStepGetPhysicalInteractionLength(
411                              const G4Track& tr    411                              const G4Track& track,
412                              G4double   previo    412                              G4double   previousStepSize,
413                              G4ForceCondition*    413                              G4ForceCondition* condition
414                             )                     414                             )
415 {                                                 415 {
416    // condition is set to "Not Forced"            416    // condition is set to "Not Forced"
417   *condition = NotForced;                         417   *condition = NotForced;
418                                                   418 
419    // pre-assigned Decay time                     419    // pre-assigned Decay time
420   G4double pTime = track.GetDynamicParticle()-    420   G4double pTime = track.GetDynamicParticle()->GetPreAssignedDecayProperTime();
421   G4double aLife = track.GetDynamicParticle()-    421   G4double aLife = track.GetDynamicParticle()->GetDefinition()->GetPDGLifeTime();
422                                                   422 
423   if (pTime < 0.) {                               423   if (pTime < 0.) {
424     // normal case                                424     // normal case 
425     if ( previousStepSize > 0.0){                 425     if ( previousStepSize > 0.0){
426       // subtract NumberOfInteractionLengthLef    426       // subtract NumberOfInteractionLengthLeft 
427       SubtractNumberOfInteractionLengthLeft(pr    427       SubtractNumberOfInteractionLengthLeft(previousStepSize);
428       if(theNumberOfInteractionLengthLeft<0.){    428       if(theNumberOfInteractionLengthLeft<0.){
429   theNumberOfInteractionLengthLeft=perMillion;    429   theNumberOfInteractionLengthLeft=perMillion;
430       }                                           430       }
431       fRemainderLifeTime = theNumberOfInteract    431       fRemainderLifeTime = theNumberOfInteractionLengthLeft*aLife;
432     }                                             432     }
433     // get mean free path                         433     // get mean free path
434     currentInteractionLength = GetMeanFreePath    434     currentInteractionLength = GetMeanFreePath(track, previousStepSize, condition);
435                                                   435     
436 #ifdef G4VERBOSE                                  436 #ifdef G4VERBOSE
437     if ((currentInteractionLength <=0.0) || (v    437     if ((currentInteractionLength <=0.0) || (verboseLevel>2)){
438       G4cout << "G4Decay::PostStepGetPhysicalI    438       G4cout << "G4Decay::PostStepGetPhysicalInteractionLength " << G4endl;
439       track.GetDynamicParticle()->DumpInfo();     439       track.GetDynamicParticle()->DumpInfo();
440       G4cout << " in Material  " << track.GetM    440       G4cout << " in Material  " << track.GetMaterial()->GetName() <<G4endl;
441       G4cout << "MeanFreePath = " << currentIn    441       G4cout << "MeanFreePath = " << currentInteractionLength/cm << "[cm]" <<G4endl;
442     }                                             442     }
443 #endif                                            443 #endif
444                                                   444 
445     G4double value;                               445     G4double value;
446     if (currentInteractionLength <DBL_MAX) {      446     if (currentInteractionLength <DBL_MAX) {
447       value = theNumberOfInteractionLengthLeft    447       value = theNumberOfInteractionLengthLeft * currentInteractionLength;
448       //fRemainderLifeTime = theNumberOfIntera    448       //fRemainderLifeTime = theNumberOfInteractionLengthLeft*aLife;
449     } else {                                      449     } else {
450       value = DBL_MAX;                            450       value = DBL_MAX;
451     }                                             451     }
452                                                   452 
453     return value;                                 453     return value;
454                                                   454 
455   } else {                                        455   } else {
456     //pre-assigned Decay time case                456     //pre-assigned Decay time case
457     // reminder proper time                       457     // reminder proper time
458     fRemainderLifeTime = pTime - track.GetProp    458     fRemainderLifeTime = pTime - track.GetProperTime();
459     if (fRemainderLifeTime <= 0.0) fRemainderL    459     if (fRemainderLifeTime <= 0.0) fRemainderLifeTime = 0.0;
460                                                   460     
461     G4double  rvalue=0.0;                         461     G4double  rvalue=0.0; 
462     // use pre-assigned Decay time to determin    462     // use pre-assigned Decay time to determine PIL
463     if (aLife>0.0) {                              463     if (aLife>0.0) {
464       // ordinary particle                        464       // ordinary particle
465       rvalue = (fRemainderLifeTime/aLife)*GetM    465       rvalue = (fRemainderLifeTime/aLife)*GetMeanFreePath(track, previousStepSize, condition);
466     } else {                                      466     } else {
467      // shortlived particle                       467      // shortlived particle
468       rvalue = c_light * fRemainderLifeTime;      468       rvalue = c_light * fRemainderLifeTime;
469      // by using normalized kinetic energy (=     469      // by using normalized kinetic energy (= Ekin/mass)
470      G4double   aMass =  track.GetDynamicParti    470      G4double   aMass =  track.GetDynamicParticle()->GetMass();
471      rvalue *= track.GetDynamicParticle()->Get    471      rvalue *= track.GetDynamicParticle()->GetTotalMomentum()/aMass;
472     }                                             472     }
473     return rvalue;                                473     return rvalue;
474   }                                               474   }
475 }                                                 475 }
476                                                   476 
477 G4double G4Decay::AtRestGetPhysicalInteraction    477 G4double G4Decay::AtRestGetPhysicalInteractionLength(
478                              const G4Track& tr    478                              const G4Track& track,
479                              G4ForceCondition*    479                              G4ForceCondition* condition
480                             )                     480                             )
481 {                                                 481 {
482      // condition is set to "Not Forced"          482      // condition is set to "Not Forced"
483   *condition = NotForced;                         483   *condition = NotForced;
484                                                   484 
485   G4double pTime = track.GetDynamicParticle()-    485   G4double pTime = track.GetDynamicParticle()->GetPreAssignedDecayProperTime();
486   if (pTime >= 0.) {                              486   if (pTime >= 0.) {
487     fRemainderLifeTime = pTime - track.GetProp    487     fRemainderLifeTime = pTime - track.GetProperTime();
488     if (fRemainderLifeTime <= 0.0) fRemainderL    488     if (fRemainderLifeTime <= 0.0) fRemainderLifeTime = DBL_MIN;
489   } else {                                        489   } else {
490     fRemainderLifeTime =                          490     fRemainderLifeTime = 
491       theNumberOfInteractionLengthLeft * GetMe    491       theNumberOfInteractionLengthLeft * GetMeanLifeTime(track, condition);
492   }                                               492   }
493   return fRemainderLifeTime;                      493   return fRemainderLifeTime;
494 }                                                 494 }
495                                                   495 
496                                                   496 
497 void G4Decay::SetExtDecayer(G4VExtDecayer* val    497 void G4Decay::SetExtDecayer(G4VExtDecayer* val)
498 {                                                 498 {
499   pExtDecayer = val;                              499   pExtDecayer = val;
500                                                   500 
501   // set Process Sub Type                         501   // set Process Sub Type
502   if ( pExtDecayer !=0 ) {                        502   if ( pExtDecayer !=0 ) {
503     SetProcessSubType(static_cast<int>(DECAY_E    503     SetProcessSubType(static_cast<int>(DECAY_External));
504   }                                               504   }
505 }                                                 505 }
506                                                   506 
507 G4VParticleChange* G4Decay::PostStepDoIt(         507 G4VParticleChange* G4Decay::PostStepDoIt(
508            const G4Track& aTrack,                 508            const G4Track& aTrack,
509            const G4Step&  aStep                   509            const G4Step&  aStep
510           )                                       510           )
511 {                                                 511 {
512   if ( (aTrack.GetTrackStatus() == fStopButAli    512   if ( (aTrack.GetTrackStatus() == fStopButAlive ) ||
513        (aTrack.GetTrackStatus() == fStopAndKil    513        (aTrack.GetTrackStatus() == fStopAndKill )   ){
514     fParticleChangeForDecay.Initialize(aTrack)    514     fParticleChangeForDecay.Initialize(aTrack);
515     return &fParticleChangeForDecay;              515     return &fParticleChangeForDecay;
516   } else {                                        516   } else {
517     return DecayIt(aTrack, aStep);                517     return DecayIt(aTrack, aStep);
518   }                                               518   }
519 }                                                 519 }
520                                                   520 
521 void G4Decay::ProcessDescription(std::ostream&    521 void G4Decay::ProcessDescription(std::ostream& outFile) const
522 {                                                 522 {
523   outFile << GetProcessName() << ": Decay of p    523   outFile << GetProcessName() << ": Decay of particles. \n"
524     << "kinematics of daughters are dertermine    524     << "kinematics of daughters are dertermined by DecayChannels " 
525           << " or by PreAssignedDecayProducts\    525           << " or by PreAssignedDecayProducts\n";
526 }                                                 526 }
527                                                   527