Geant4  10.02.p01
G4ITDecay.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 //
27 // //
28 // File: G4ITDecay.cc //
29 // Author: D.H. Wright (SLAC) //
30 // Date: 14 November 2014 //
31 // //
33 
34 #include "G4ITDecay.hh"
35 #include "G4IonTable.hh"
36 #include "G4ThreeVector.hh"
37 #include "G4LorentzVector.hh"
38 #include "G4DynamicParticle.hh"
39 #include "G4DecayProducts.hh"
40 #include "G4PhotonEvaporation.hh"
41 #include "G4VAtomDeexcitation.hh"
42 #include "G4AtomicShells.hh"
43 #include "G4Electron.hh"
44 #include "G4LossTableManager.hh"
45 #include "G4Fragment.hh"
46 #include "G4SystemOfUnits.hh"
47 #include "G4PhysicalConstants.hh"
48 
49 
51  const G4double& branch, const G4double& Qvalue,
52  const G4double& excitationE)
53  : G4NuclearDecay("IT decay", IT, excitationE), transitionQ(Qvalue),
54  applyARM(true)
55 {
56  SetParent(theParentNucleus); // Store name of parent nucleus, delete G4MT_parent
57  SetBR(branch);
58 
59  parentZ = theParentNucleus->GetAtomicNumber();
60  parentA = theParentNucleus->GetAtomicMass();
61 
63  G4IonTable* theIonTable =
65  SetDaughter(0, theIonTable->GetIon(parentZ, parentA, excitationE) );
66 }
67 
68 
70 {}
71 
72 
74 {
75  // Fill G4MT_parent with theParentNucleus (stored by SetParent in ctor)
76  if (G4MT_parent == 0) FillParent();
77 
78  // Set up final state
79  // parentParticle is set at rest here because boost with correct momentum
80  // is done later
82  G4ThreeVector(0.,0.,0.) );
83  G4DynamicParticle parentParticle(G4MT_parent, atRest);
84  G4DecayProducts* products = new G4DecayProducts(parentParticle);
85 
86  // Let G4PhotonEvaporation do the decay
88  photoEvap->RDMForced(true);
89  photoEvap->SetICM(true);
90 
91  G4Fragment* nucleus = new G4Fragment(parentA, parentZ, atRest);
92  G4Fragment* eOrGamma = photoEvap->EmittedFragment(nucleus);
93 
94  // Daughter nuclide is returned in nucleus pointer
95  G4double finalDaughterExcitation = nucleus->GetExcitationEnergy();
96  if (finalDaughterExcitation < 1*keV) finalDaughterExcitation = 0.0;
97  G4LorentzVector daughterMomentum = nucleus->GetMomentum();
98  G4IonTable* theIonTable =
100  G4ParticleDefinition* daughterIon =
101  theIonTable->GetIon(parentZ, parentA, finalDaughterExcitation);
102  G4DynamicParticle* dynDaughter = new G4DynamicParticle(daughterIon,
103  daughterMomentum);
104  delete nucleus;
105 
106  if (eOrGamma) {
107  G4DynamicParticle* eOrGammaDyn =
109  eOrGamma->GetMomentum() );
110  eOrGammaDyn->SetProperTime(eOrGamma->GetCreationTime() );
111  products->PushProducts(eOrGammaDyn);
112  delete eOrGamma;
113 
114  // Now do atomic relaxation
115  if (applyARM) {
116  G4int shellIndex = photoEvap->GetVacantShellNumber();
117  if (shellIndex > -1) {
118  G4VAtomDeexcitation* atomDeex =
120  if (atomDeex->IsFluoActive() && parentZ > 5 && parentZ < 100) {
122  if (shellIndex >= nShells) shellIndex = nShells;
124  const G4AtomicShell* shell = atomDeex->GetAtomicShell(parentZ, as);
125  std::vector<G4DynamicParticle*> armProducts;
126 
127  // VI, SI
128  // Allows fixing of Bugzilla 1727
129  //const G4double deexLimit = 0.1*keV;
130  G4double deexLimit = 0.1*keV;
131  if (G4EmParameters::Instance()->DeexcitationIgnoreCut()) deexLimit =0.;
132  //
133 
134  atomDeex->GenerateParticles(&armProducts, shell, parentZ, deexLimit,
135  deexLimit);
136  G4double productEnergy = 0.;
137  for (G4int i = 0; i < G4int(armProducts.size()); i++)
138  productEnergy += armProducts[i]->GetKineticEnergy();
139 
140  G4double deficit = shell->BindingEnergy() - productEnergy;
141  if (deficit > 0.0) {
142  // Add a dummy electron to make up extra energy
143  G4double cosTh = 1.-2.*G4UniformRand();
144  G4double sinTh = std::sqrt(1.- cosTh*cosTh);
145  G4double phi = twopi*G4UniformRand();
146 
147  G4ThreeVector electronDirection(sinTh*std::sin(phi),
148  sinTh*std::cos(phi), cosTh);
149  G4DynamicParticle* extra =
150  new G4DynamicParticle(G4Electron::Electron(), electronDirection,
151  deficit);
152  armProducts.push_back(extra);
153  }
154 
155  G4int nArm = armProducts.size();
156  if (nArm > 0) {
157  G4ThreeVector bst = dynDaughter->Get4Momentum().boostVector();
158  for (G4int i = 0; i < nArm; ++i) {
159  G4DynamicParticle* dp = armProducts[i];
160  G4LorentzVector lv = dp->Get4Momentum().boost(bst);
161  dp->Set4Momentum(lv);
162  products->PushProducts(dp);
163  }
164  }
165  }
166  }
167  } // if ARM on
168  } // eOrGamma
169 
170  products->PushProducts(dynDaughter);
171 
172  // Energy conservation check
173  /*
174  G4int newSize = products->entries();
175  G4DynamicParticle* temp = 0;
176  G4double KEsum = 0.0;
177  for (G4int i = 0; i < newSize; i++) {
178  temp = products->operator[](i);
179  KEsum += temp->GetKineticEnergy();
180  }
181  G4double eCons = G4MT_parent->GetPDGMass() - dynDaughter->GetMass() - KEsum;
182  G4cout << " IT check: Ediff (keV) = " << eCons/keV << G4endl;
183  */
184  delete photoEvap;
185 
186  return products;
187 }
188 
189 
191 {
192  G4cout << " G4ITDecay for parent nucleus " << GetParentName() << G4endl;
193  G4cout << " decays to " << GetDaughterName(0)
194  << " + gammas (or electrons), with branching ratio " << GetBR()
195  << "% and Q value " << transitionQ << G4endl;
196 }
197 
virtual void SetICM(G4bool)
G4double GetBR() const
void SetBR(G4double value)
static G4LossTableManager * Instance()
G4int parentA
Definition: G4ITDecay.hh:64
G4bool IsFluoActive() const
CLHEP::Hep3Vector G4ThreeVector
G4ITDecay(const G4ParticleDefinition *theParentNucleus, const G4double &theBR, const G4double &Qvalue, const G4double &excitation)
Definition: G4ITDecay.cc:50
virtual void RDMForced(G4bool)
const G4String & GetParentName() const
G4int PushProducts(G4DynamicParticle *aParticle)
G4ParticleDefinition * G4MT_parent
G4ParticleDefinition * GetIon(G4int Z, G4int A, G4int lvl=0)
Definition: G4IonTable.cc:491
const G4ParticleDefinition * GetParticleDefinition() const
Definition: G4Fragment.hh:395
virtual G4DecayProducts * DecayIt(G4double)
Definition: G4ITDecay.cc:73
virtual void DumpNuclearInfo()
Definition: G4ITDecay.cc:190
G4double BindingEnergy() const
int G4int
Definition: G4Types.hh:78
G4int GetAtomicNumber() const
virtual const G4AtomicShell * GetAtomicShell(G4int Z, G4AtomicShellEnumerator shell)=0
const G4double transitionQ
Definition: G4ITDecay.hh:62
G4IonTable * GetIonTable() const
#define G4UniformRand()
Definition: Randomize.hh:97
G4GLOB_DLL std::ostream G4cout
G4double GetCreationTime() const
Definition: G4Fragment.hh:405
void SetNumberOfDaughters(G4int value)
const G4LorentzVector & GetMomentum() const
Definition: G4Fragment.hh:284
static const double twopi
Definition: G4SIunits.hh:75
virtual ~G4ITDecay()
Definition: G4ITDecay.cc:69
G4bool applyARM
Definition: G4ITDecay.hh:65
G4int GetAtomicMass() const
G4LorentzVector Get4Momentum() const
const G4String & GetDaughterName(G4int anIndex) const
G4int GetVacantShellNumber() const
void Set4Momentum(const G4LorentzVector &momentum)
G4double GetPDGMass() const
static G4ParticleTable * GetParticleTable()
void SetParent(const G4ParticleDefinition *particle_type)
static G4EmParameters * Instance()
void SetDaughter(G4int anIndex, const G4ParticleDefinition *particle_type)
static G4Electron * Electron()
Definition: G4Electron.cc:94
#define G4endl
Definition: G4ios.hh:61
virtual G4Fragment * EmittedFragment(G4Fragment *theNucleus)
G4VAtomDeexcitation * AtomDeexcitation()
static const double keV
Definition: G4SIunits.hh:213
double G4double
Definition: G4Types.hh:76
void GenerateParticles(std::vector< G4DynamicParticle * > *secVect, const G4AtomicShell *, G4int Z, G4int coupleIndex)
void SetProperTime(G4double)
G4AtomicShellEnumerator
G4double GetExcitationEnergy() const
Definition: G4Fragment.hh:268
G4int parentZ
Definition: G4ITDecay.hh:63
CLHEP::HepLorentzVector G4LorentzVector
static G4int GetNumberOfShells(G4int Z)