Geant4  10.00.p03
G4Decay.cc
Go to the documentation of this file.
1 //
2 // ********************************************************************
3 // * License and Disclaimer *
4 // * *
5 // * The Geant4 software is copyright of the Copyright Holders of *
6 // * the Geant4 Collaboration. It is provided under the terms and *
7 // * conditions of the Geant4 Software License, included in the file *
8 // * LICENSE and available at http://cern.ch/geant4/license . These *
9 // * include a list of copyright holders. *
10 // * *
11 // * Neither the authors of this software system, nor their employing *
12 // * institutes,nor the agencies providing financial support for this *
13 // * work make any representation or warranty, express or implied, *
14 // * regarding this software system or assume any liability for its *
15 // * use. Please see the license in the file LICENSE and URL above *
16 // * for the full disclaimer and the limitation of liability. *
17 // * *
18 // * This code implementation is the result of the scientific and *
19 // * technical work of the GEANT4 collaboration. *
20 // * By using, copying, modifying or distributing the software (or *
21 // * any work based on the software) you agree to acknowledge its *
22 // * use in resulting scientific publications, and indicate your *
23 // * acceptance of all terms of the Geant4 Software license. *
24 // ********************************************************************
25 //
26 //
27 // $Id: G4Decay.cc 79331 2014-02-24 09:38:19Z gcosmo $
28 //
29 //
30 // --------------------------------------------------------------
31 // GEANT 4 class implementation file
32 //
33 // History: first implementation, based on object model of
34 // 2nd December 1995, G.Cosmo
35 // 7 July 1996 H.Kurashige
36 // ------------------------------------------------------------
37 // remove BuildPhysicsTable() 28 Nov. 1997 H.Kurashige
38 // change DBL_EPSIRON to DBL_MIN 14 Dec. 1997 H.Kurashige
39 // modified for new ParticleChange 12 Mar. 1998 H.Kurashige
40 // modified for "GoodForTrackingFlag" 19 June 1998 H.Kurashige
41 // rename thePhysicsTable to aPhyscisTable 2 Aug. 1998 H.Kurashige
42 // modified IsApplicable in order to protect the decay from registered
43 // to resonances 12 Dec. 1998 H.Kurashige
44 // remove G4ParticleMomentum 6 Feb. 99 H.Kurashige
45 // modified IsApplicable to activate G4Decay for resonances 1 Mar. 00 H.Kurashige
46 // Add External Decayer 23 Feb. 2001 H.Kurashige
47 // change LowestBinValue,HighestBinValue and TotBin(200) 9 Feb. 2002
48 //
49 
50 #include "G4Decay.hh"
51 
52 #include "G4PhysicalConstants.hh"
53 #include "G4SystemOfUnits.hh"
54 #include "G4DynamicParticle.hh"
55 #include "G4DecayProducts.hh"
56 #include "G4DecayTable.hh"
57 #include "G4VDecayChannel.hh"
58 #include "G4PhysicsLogVector.hh"
60 #include "G4VExtDecayer.hh"
61 
62 // constructor
63 G4Decay::G4Decay(const G4String& processName)
64  :G4VRestDiscreteProcess(processName, fDecay),
65  verboseLevel(1),
66  HighestValue(20.0),
67  fRemainderLifeTime(-1.0),
68  pExtDecayer(0)
69 {
70  // set Process Sub Type
71  SetProcessSubType(static_cast<int>(DECAY));
72 
73 #ifdef G4VERBOSE
74  if (GetVerboseLevel()>1) {
75  G4cout << "G4Decay constructor " << " Name:" << processName << G4endl;
76  }
77 #endif
78 
80 }
81 
83 {
84  if (pExtDecayer) {
85  delete pExtDecayer;
86  }
87 }
88 
90 {
91  // check if the particle is stable?
92  if (aParticleType.GetPDGLifeTime() <0.0) {
93  return false;
94  } else if (aParticleType.GetPDGMass() <= 0.0*MeV) {
95  return false;
96  } else {
97  return true;
98  }
99 }
100 
103 {
104  // returns the mean free path in GEANT4 internal units
105  G4double meanlife;
106 
107  // get particle
108  const G4DynamicParticle* aParticle = aTrack.GetDynamicParticle();
109  const G4ParticleDefinition* aParticleDef = aParticle->GetDefinition();
110  G4double aLife = aParticleDef->GetPDGLifeTime();
111 
112  // check if the particle is stable?
113  if (aParticleDef->GetPDGStable()) {
114  //1000000 times the life time of the universe
115  meanlife = 1e24 * s;
116 
117  } else {
118  meanlife = aLife;
119  }
120 
121 #ifdef G4VERBOSE
122  if (GetVerboseLevel()>1) {
123  G4cout << "mean life time: "<< meanlife/ns << "[ns]" << G4endl;
124  }
125 #endif
126 
127  return meanlife;
128 }
129 
131 {
132  // get particle
133  const G4DynamicParticle* aParticle = aTrack.GetDynamicParticle();
134  const G4ParticleDefinition* aParticleDef = aParticle->GetDefinition();
135  G4double aMass = aParticle->GetMass();
136  G4double aLife = aParticleDef->GetPDGLifeTime();
137 
138 
139  // returns the mean free path in GEANT4 internal units
140  G4double pathlength;
141  G4double aCtau = c_light * aLife;
142 
143  // check if the particle is stable?
144  if (aParticleDef->GetPDGStable()) {
145  pathlength = DBL_MAX;
146 
147  //check if the particle has very short life time ?
148  } else if (aCtau < DBL_MIN) {
149  pathlength = DBL_MIN;
150 
151  } else {
152  //calculate the mean free path
153  // by using normalized kinetic energy (= Ekin/mass)
154  G4double rKineticEnergy = aParticle->GetKineticEnergy()/aMass;
155  if ( rKineticEnergy > HighestValue) {
156  // gamma >> 1
157  pathlength = ( rKineticEnergy + 1.0)* aCtau;
158  } else if ( rKineticEnergy < DBL_MIN ) {
159  // too slow particle
160 #ifdef G4VERBOSE
161  if (GetVerboseLevel()>1) {
162  G4cout << "G4Decay::GetMeanFreePath() !!particle stops!!";
163  G4cout << aParticleDef->GetParticleName() << G4endl;
164  G4cout << "KineticEnergy:" << aParticle->GetKineticEnergy()/GeV <<"[GeV]";
165  }
166 #endif
167  pathlength = DBL_MIN;
168  } else {
169  // beta <1
170  pathlength = (aParticle->GetTotalMomentum())/aMass*aCtau ;
171  }
172  }
173  return pathlength;
174 }
175 
177 {
178  return;
179 }
180 
182 {
183  // The DecayIt() method returns by pointer a particle-change object.
184  // Units are expressed in GEANT4 internal units.
185 
186  // Initialize ParticleChange
187  // all members of G4VParticleChange are set to equal to
188  // corresponding member in G4Track
190 
191  // get particle
192  const G4DynamicParticle* aParticle = aTrack.GetDynamicParticle();
193  const G4ParticleDefinition* aParticleDef = aParticle->GetDefinition();
194 
195  // check if the particle is stable
196  if (aParticleDef->GetPDGStable()) return &fParticleChangeForDecay ;
197 
198 
199  //check if thePreAssignedDecayProducts exists
200  const G4DecayProducts* o_products = (aParticle->GetPreAssignedDecayProducts());
201  G4bool isPreAssigned = (o_products != 0);
202  G4DecayProducts* products = 0;
203 
204  // decay table
205  G4DecayTable *decaytable = aParticleDef->GetDecayTable();
206 
207  // check if external decayer exists
208  G4bool isExtDecayer = (decaytable == 0) && (pExtDecayer !=0);
209 
210  // Error due to NO Decay Table
211  if ( (decaytable == 0) && !isExtDecayer &&!isPreAssigned ){
212  if (GetVerboseLevel()>0) {
213  G4cout << "G4Decay::DoIt : decay table not defined for ";
214  G4cout << aParticle->GetDefinition()->GetParticleName()<< G4endl;
215  }
216  G4Exception( "G4Decay::DecayIt ",
217  "DECAY101",JustWarning,
218  "Decay table is not defined");
219 
221  // Kill the parent particle
224 
226  return &fParticleChangeForDecay ;
227  }
228 
229  if (isPreAssigned) {
230  // copy decay products
231  products = new G4DecayProducts(*o_products);
232  } else if ( isExtDecayer ) {
233  // decay according to external decayer
234  products = pExtDecayer->ImportDecayProducts(aTrack);
235  } else {
236  // decay acoording to decay table
237  // choose a decay channel
238  G4VDecayChannel *decaychannel = decaytable->SelectADecayChannel();
239  if (decaychannel == 0 ){
240  // decay channel not found
241  G4Exception("G4Decay::DoIt", "DECAY003", FatalException,
242  " can not determine decay channel ");
243  } else {
244  // execute DecayIt()
245 #ifdef G4VERBOSE
246  G4int temp = decaychannel->GetVerboseLevel();
247  if (GetVerboseLevel()>1) {
248  G4cout << "G4Decay::DoIt : selected decay channel addr:" << decaychannel <<G4endl;
249  decaychannel->SetVerboseLevel(GetVerboseLevel());
250  }
251 #endif
252  products = decaychannel->DecayIt(aParticle->GetMass());
253 #ifdef G4VERBOSE
254  if (GetVerboseLevel()>1) {
255  decaychannel->SetVerboseLevel(temp);
256  }
257 #endif
258 #ifdef G4VERBOSE
259  if (GetVerboseLevel()>2) {
260  if (! products->IsChecked() ) products->DumpInfo();
261  }
262 #endif
263  }
264  }
265 
266  // get parent particle information ...................................
267  G4double ParentEnergy = aParticle->GetTotalEnergy();
268  G4double ParentMass = aParticle->GetMass();
269  if (ParentEnergy < ParentMass) {
270  if (GetVerboseLevel()>0) {
271  G4cout << "G4Decay::DoIt : Total Energy is less than its mass" << G4endl;
272  G4cout << " Particle: " << aParticle->GetDefinition()->GetParticleName();
273  G4cout << " Energy:" << ParentEnergy/MeV << "[MeV]";
274  G4cout << " Mass:" << ParentMass/MeV << "[MeV]";
275  G4cout << G4endl;
276  }
277  G4Exception( "G4Decay::DecayIt ",
278  "DECAY102",JustWarning,
279  "Total Energy is less than its mass");
280  ParentEnergy = ParentMass;
281  }
282 
283  G4ThreeVector ParentDirection(aParticle->GetMomentumDirection());
284 
285  //boost all decay products to laboratory frame
286  G4double energyDeposit = 0.0;
287  G4double finalGlobalTime = aTrack.GetGlobalTime();
288  G4double finalLocalTime = aTrack.GetLocalTime();
289  if (aTrack.GetTrackStatus() == fStopButAlive ){
290  // AtRest case
291  finalGlobalTime += fRemainderLifeTime;
292  finalLocalTime += fRemainderLifeTime;
293  energyDeposit += aParticle->GetKineticEnergy();
294  if (isPreAssigned) products->Boost( ParentEnergy, ParentDirection);
295  } else {
296  // PostStep case
297  if (!isExtDecayer) products->Boost( ParentEnergy, ParentDirection);
298  }
299  // set polarization for daughter particles
300  DaughterPolarization(aTrack, products);
301 
302 
303  //add products in fParticleChangeForDecay
304  G4int numberOfSecondaries = products->entries();
305  fParticleChangeForDecay.SetNumberOfSecondaries(numberOfSecondaries);
306 #ifdef G4VERBOSE
307  if (GetVerboseLevel()>1) {
308  G4cout << "G4Decay::DoIt : Decay vertex :";
309  G4cout << " Time: " << finalGlobalTime/ns << "[ns]";
310  G4cout << " X:" << (aTrack.GetPosition()).x() /cm << "[cm]";
311  G4cout << " Y:" << (aTrack.GetPosition()).y() /cm << "[cm]";
312  G4cout << " Z:" << (aTrack.GetPosition()).z() /cm << "[cm]";
313  G4cout << G4endl;
314  G4cout << "G4Decay::DoIt : decay products in Lab. Frame" << G4endl;
315  products->DumpInfo();
316  }
317 #endif
318  G4int index;
320  const G4TouchableHandle thand = aTrack.GetTouchableHandle();
321  for (index=0; index < numberOfSecondaries; index++)
322  {
323  // get current position of the track
324  currentPosition = aTrack.GetPosition();
325  // create a new track object
326  G4Track* secondary = new G4Track( products->PopProducts(),
327  finalGlobalTime ,
328  currentPosition );
329  // switch on good for tracking flag
330  secondary->SetGoodForTrackingFlag();
331  secondary->SetTouchableHandle(thand);
332  // add the secondary track in the List
334  }
335  delete products;
336 
337  // Kill the parent particle
340  fParticleChangeForDecay.ProposeLocalTime( finalLocalTime );
341 
342  // Clear NumberOfInteractionLengthLeft
344 
345  return &fParticleChangeForDecay ;
346 }
347 
349 {
350 }
351 
352 
353 
355 {
358 
359  fRemainderLifeTime = -1.0;
360 }
361 
363 {
364  // Clear NumberOfInteractionLengthLeft
366 
368 }
369 
370 
372  const G4Track& track,
373  G4double previousStepSize,
375  )
376 {
377  // condition is set to "Not Forced"
378  *condition = NotForced;
379 
380  // pre-assigned Decay time
383 
384  if (pTime < 0.) {
385  // normal case
386  if ( previousStepSize > 0.0){
387  // subtract NumberOfInteractionLengthLeft
388  SubtractNumberOfInteractionLengthLeft(previousStepSize);
391  }
393  }
394  // get mean free path
395  currentInteractionLength = GetMeanFreePath(track, previousStepSize, condition);
396 
397 #ifdef G4VERBOSE
398  if ((currentInteractionLength <=0.0) || (verboseLevel>2)){
399  G4cout << "G4Decay::PostStepGetPhysicalInteractionLength " << G4endl;
400  track.GetDynamicParticle()->DumpInfo();
401  G4cout << " in Material " << track.GetMaterial()->GetName() <<G4endl;
402  G4cout << "MeanFreePath = " << currentInteractionLength/cm << "[cm]" <<G4endl;
403  }
404 #endif
405 
406  G4double value;
409  //fRemainderLifeTime = theNumberOfInteractionLengthLeft*aLife;
410  } else {
411  value = DBL_MAX;
412  }
413 
414  return value;
415 
416  } else {
417  //pre-assigned Decay time case
418  // reminder proper time
419  fRemainderLifeTime = pTime - track.GetProperTime();
421 
422  G4double rvalue=0.0;
423  // use pre-assigned Decay time to determine PIL
424  if (aLife>0.0) {
425  // ordinary particle
426  rvalue = (fRemainderLifeTime/aLife)*GetMeanFreePath(track, previousStepSize, condition);
427  } else {
428  // shortlived particle
429  rvalue = c_light * fRemainderLifeTime;
430  // by using normalized kinetic energy (= Ekin/mass)
431  G4double aMass = track.GetDynamicParticle()->GetMass();
432  rvalue *= track.GetDynamicParticle()->GetTotalMomentum()/aMass;
433  }
434  return rvalue;
435  }
436 }
437 
439  const G4Track& track,
441  )
442 {
443  // condition is set to "Not Forced"
444  *condition = NotForced;
445 
447  if (pTime >= 0.) {
448  fRemainderLifeTime = pTime - track.GetProperTime();
450  } else {
453  }
454  return fRemainderLifeTime;
455 }
456 
457 
459 {
460  pExtDecayer = val;
461 
462  // set Process Sub Type
463  if ( pExtDecayer !=0 ) {
464  SetProcessSubType(static_cast<int>(DECAY_External));
465  }
466 }
467 
469  const G4Track& aTrack,
470  const G4Step& aStep
471  )
472 {
473  if ( (aTrack.GetTrackStatus() == fStopButAlive ) ||
474  (aTrack.GetTrackStatus() == fStopAndKill ) ){
476  return &fParticleChangeForDecay;
477  } else {
478  return DecayIt(aTrack, aStep);
479  }
480 }
481 
static const double cm
Definition: G4SIunits.hh:106
G4double condition(const G4ErrorSymMatrix &m)
virtual G4double GetMeanLifeTime(const G4Track &aTrack, G4ForceCondition *condition)
Definition: G4Decay.cc:101
static const double MeV
Definition: G4SIunits.hh:193
virtual G4double GetMeanFreePath(const G4Track &aTrack, G4double previousStepSize, G4ForceCondition *condition)
Definition: G4Decay.cc:130
G4double GetLocalTime() const
virtual ~G4Decay()
Definition: G4Decay.cc:82
G4double GetProperTime() const
G4double GetKineticEnergy() const
CLHEP::Hep3Vector G4ThreeVector
G4double GetTotalEnergy() const
const G4DynamicParticle * GetDynamicParticle() const
const G4double HighestValue
Definition: G4Decay.hh:172
virtual G4bool IsApplicable(const G4ParticleDefinition &)
Definition: G4Decay.cc:89
G4double z
Definition: TRTMaterials.hh:39
virtual G4DecayProducts * ImportDecayProducts(const G4Track &aTrack)=0
G4bool GetPDGStable() const
const G4String & GetName() const
Definition: G4Material.hh:176
const G4ThreeVector & GetPosition() const
G4TrackStatus GetTrackStatus() const
void DumpInfo(G4int mode=0) const
const G4DecayProducts * GetPreAssignedDecayProducts() const
G4double theNumberOfInteractionLengthLeft
Definition: G4VProcess.hh:293
void SetTouchableHandle(const G4TouchableHandle &apValue)
G4ParticleDefinition * GetDefinition() const
virtual G4VParticleChange * PostStepDoIt(const G4Track &aTrack, const G4Step &aStep)
Definition: G4Decay.cc:468
G4VExtDecayer * pExtDecayer
Definition: G4Decay.hh:181
void Boost(G4double totalEnergy, const G4ThreeVector &momentumDirection)
virtual void ResetNumberOfInteractionLengthLeft()
Definition: G4VProcess.cc:95
virtual void StartTracking(G4Track *)
Definition: G4Decay.cc:354
void ClearNumberOfInteractionLengthLeft()
Definition: G4VProcess.hh:447
int G4int
Definition: G4Types.hh:78
const G4String & GetParticleName() const
virtual G4VParticleChange * DecayIt(const G4Track &aTrack, const G4Step &aStep)
Definition: G4Decay.cc:181
void ProposeLocalEnergyDeposit(G4double anEnergyPart)
G4double fRemainderLifeTime
Definition: G4Decay.hh:175
G4double GetTotalMomentum() const
G4int verboseLevel
Definition: G4Decay.hh:164
static const double s
Definition: G4SIunits.hh:150
G4DecayTable * GetDecayTable() const
virtual G4double PostStepGetPhysicalInteractionLength(const G4Track &track, G4double previousStepSize, G4ForceCondition *condition)
Definition: G4Decay.cc:371
virtual void Initialize(const G4Track &)
G4GLOB_DLL std::ostream G4cout
void SetVerboseLevel(G4int value)
static char * currentPosition
G4double GetMass() const
bool G4bool
Definition: G4Types.hh:79
void DumpInfo() const
const G4ThreeVector & GetMomentumDirection() const
virtual G4double AtRestGetPhysicalInteractionLength(const G4Track &track, G4ForceCondition *condition)
Definition: G4Decay.cc:438
G4double currentInteractionLength
Definition: G4VProcess.hh:297
void SetProcessSubType(G4int)
Definition: G4VProcess.hh:432
static const double GeV
Definition: G4SIunits.hh:196
Definition: G4Step.hh:76
G4Decay(const G4String &processName="Decay")
Definition: G4Decay.cc:63
G4double GetGlobalTime() const
void AddSecondary(G4Track *aSecondary)
const G4TouchableHandle & GetTouchableHandle() const
G4Material * GetMaterial() const
G4VDecayChannel * SelectADecayChannel()
Definition: G4DecayTable.cc:81
void G4Exception(const char *originOfException, const char *exceptionCode, G4ExceptionSeverity severity, const char *comments)
Definition: G4Exception.cc:41
static const double perMillion
Definition: G4SIunits.hh:298
G4int GetVerboseLevel() const
G4double GetPDGMass() const
void SetNumberOfSecondaries(G4int totSecondaries)
G4DynamicParticle * PopProducts()
G4VParticleChange * pParticleChange
Definition: G4VProcess.hh:283
#define DBL_MIN
Definition: templates.hh:75
virtual void BuildPhysicsTable(const G4ParticleDefinition &)
Definition: G4Decay.cc:176
virtual void DaughterPolarization(const G4Track &aTrack, G4DecayProducts *products)
Definition: G4Decay.cc:348
G4double GetPDGLifeTime() const
#define G4endl
Definition: G4ios.hh:61
G4bool IsChecked() const
G4int entries() const
virtual G4DecayProducts * DecayIt(G4double parentMass=-1.0)=0
void SubtractNumberOfInteractionLengthLeft(G4double previousStepSize)
Definition: G4VProcess.hh:544
void SetExtDecayer(G4VExtDecayer *)
Definition: G4Decay.cc:458
double G4double
Definition: G4Types.hh:76
void ProposeTrackStatus(G4TrackStatus status)
G4ForceCondition
G4double GetPreAssignedDecayProperTime() const
virtual void EndTracking()
Definition: G4Decay.cc:362
#define DBL_MAX
Definition: templates.hh:83
#define ns
Definition: xmlparse.cc:597
void SetGoodForTrackingFlag(G4bool value=true)
G4ParticleChangeForDecay fParticleChangeForDecay
Definition: G4Decay.hh:178
G4int GetVerboseLevel() const
Definition: G4Decay.hh:188