Files
geant4/source/processes/electromagnetic/lowenergy/include/G4hLowEnergyIonisation.hh
T
2016-06-08 15:28:20 +02:00

268 lines
10 KiB
C++

// This code implementation is the intellectual property of
// the GEANT4 collaboration.
//
// By copying, distributing or modifying the Program (or any work
// based on the Program) you indicate your acceptance of this statement,
// and all its terms.
//
// ------------------------------------------------------------
// GEANT 4 class header file
//
// For information related to this code contact:
// CERN, IT Division, ASD group
// History: based on object model of
// 2nd December 1995, G.Cosmo
// ---------- G4hLowEnergyIonisation physics process -----
// by Vladimir Ivanchenko, 14 July 1999
// was made on the base of G4hIonisation class
// developed by Laszlo Urban
// ************************************************************
// Class Description:
// G4hLowEnergyIonisation class is the extention of the ionisation
// process for the slow charged hadrons. The physics model is
// described in CERN-OPEN-99-121. User have a possibility to define
// a parametrisation table via its name.
// Class Description - End
// ************************************************************
// 28 July 1999 V.Ivanchenko cleen up
// 17 August 1999 G.Mancinelli implemented ICRU parametrization (protons)
// 20 August 1999 G.Mancinelli implemented ICRU parametrization (alpha)
// 31 August 1999 V.Ivanchenko update and cleen up
// ------------------------------------------------------------
#ifndef G4hLowEnergyIonisation_h
#define G4hLowEnergyIonisation_h 1
#include "G4ios.hh"
#include "Randomize.hh"
#include "G4hEnergyLoss.hh"
#include "globals.hh"
#include "G4Track.hh"
#include "G4Step.hh"
#include "G4Electron.hh"
#include "G4PhysicsLogVector.hh"
#include "G4PhysicsLinearVector.hh"
class G4hLowEnergyIonisation : public G4hEnergyLoss
{
public: // Without description
G4hLowEnergyIonisation(const G4String& processName = "hLowEIoni");
~G4hLowEnergyIonisation();
G4bool IsApplicable(const G4ParticleDefinition&);
void SetPhysicsTableBining(G4double lowE, G4double highE, G4int nBins);
void BuildPhysicsTable(const G4ParticleDefinition& aParticleType);
void BuildLambdaTable(const G4ParticleDefinition& aParticleType);
G4double GetMeanFreePath(
const G4Track& track,
G4double previousStepSize,
G4ForceCondition* condition ) ;
G4VParticleChange *PostStepDoIt(const G4Track& track,
const G4Step& Step ) ;
void BuildLossTable(const G4ParticleDefinition& aParticleType);
void PrintInfoDefinition();
protected:
virtual G4double ComputeMicroscopicCrossSection(
const G4ParticleDefinition& aParticleType,
G4double KineticEnergy,
G4double AtomicNumber);
//--------------------------------------------------------start
virtual G4double ComputeBarkasTerm(
const G4Material* material,
const G4double KinEnergy,
const G4double PartMass);
//Function to compute the Barkas term
//---------------------------------------------------------end
public: // With description
void SetStoppingPowerTableName(const G4String& dedxTable);
// This method defines the ionisation parametrisation method via its name
void SetNuclearStoppingOn();
// This method switch on calculation of the nuclear stopping power.
void SetNuclearStoppingOff();
// This method switch off calculation of the nuclear stopping power.
void SetAntiProtonStoppingOn();
// This method switch on calculation of the loss table for antiproton
// using antiproron formulation (down to 100 keV).
void SetAntiProtonStoppingOff();
// This method switch off calculation of the loss table for antiproton
// using antiproron formulation (down to 100 keV).
G4double GetParametrisedLoss(const G4Material* material,
const G4double KinEnergy,
const G4double DeltaRayCutNow,
const G4double PartMass,
const G4double PartCharge);
// This method returns parametrised energy loss.
// NEW**** modified totake account of the Barkas correction
G4double GetBetheBlochLoss(const G4Material* material, const G4double KinEnergy,
const G4double DeltaRayCutNow);
// This method returns energy loss calculated via Bethe-Bloch formula.
G4double GetFreeElectronGasLoss(G4double paramA, G4double KinEnergy);
// This method returns energy loss parametrised in the free electron gas model.
G4double GetUrbanModel(const G4Element* element, G4double KinEnergy);
// This method returns energy loss parametrised as in the hIonisation class.
G4double GetDeltaRaysEnergy(const G4Material* material, const G4double KinEnergy,
const G4double DeltaRayCutNow);
// This method returns average energy loss due to delta-rays emission with
// energy higher than the cut energy for given material.
G4int MolecIsInICRU_R49p(const G4Material* material);
// This method returns index of the material in the table of protons energy
// loss in ICRU Report N49. If material is not in the table the method returns -1.
G4int MolecIsInICRU_R49PowersHe(const G4Material* material);
// This method returns index of the material in the table of He energy loss
// in ICRU Report N49. If material is not in the table the method returns -1.
G4double MolecIsInZiegler1988(const G4Material* material);
// This method returns index of the material in the table of energy loss from
// NIM B35 (1988) 215-228. If material is not in the table the method returns -1.
G4double GetMolecICRU_R49Loss(const G4Material* material, const G4double KinEnergy,
const G4double DeltaRayCutNow, const G4int molecIndex);
// This method returns energy loss of protons in material from the table of ICRU
// Report N49.
G4double GetChemicalFactor(const G4double ExpStopPower125, const G4double KinEnergy,
const G4double BraggStopPower125);
// This method returns the value of "chemical factor" which allows to correct
// energy losses calculated according to the Bragg's rule (NIM B35 (1988) 215-228).
G4double GetStoppingPower1977H(G4int iz, G4double E);
// This method returns protons electronic stopping power parametrised according to
// H.H.Andersen & J.F.Ziegler, Hydrogen Stopping Powers and
// Ranges in All Elements, Vol.3, Pergamon Press, 1977
G4double GetStoppingPowerICRU_R49p(G4int iz, G4double E, G4String type);
// This method returns protons electronic stopping power parametrised according to
// ICRU Report N49, 1993.
G4double GetStoppingPower1977He(G4int iz, G4double E);
// This method returns He electronic stopping power parametrised according to
// J.F.Ziegler, Helium Stopping Powers and
// Ranges in All Elemental Matter, Vol.4, Pergamon Press, 1977
G4double GetStoppingPowerICRU_R49He(G4int iz, G4double E);
// This method returns He electronic stopping power parametrised according to
// ICRU Report N49, 1993. J.F. Ziegler model.
G4double GetStoppingPowerICRU_R49PowersHe(G4int iz, G4double E);
// This method returns He electronic stopping power parametrised according to
// J.F.Ziegler, Helium Stopping Powers and
// Ranges in All Elemental Matter, Vol.4, Pergamon Press, 1977
G4double GetStoppingPower1977n(G4double Z1, G4double Z2,
G4double M1, G4double M2, G4double E);
// This method returns nuclear stopping power parametrised according to
// J.F.Ziegler, Helium Stopping Powers and
// Ranges in All Elemental Matter, Vol.4, Pergamon Press, 1977
G4double GetStoppingPower1985n(G4double Z1, G4double Z2,
G4double M1, G4double M2, G4double E);
// This method returns nuclear stopping power parametrised according to
// J.F.Ziegler, J.P. Biersack, U. Littmark
// The Stopping and Range of Ions in Matter,
// Vol.1, Pergamon Press, 1985
G4double GetStoppingPowerMoliere(G4double Z1, G4double Z2,
G4double M1, G4double M2, G4double E);
// This method returns nuclear stopping power parametrised according to
// ICRU Report N49, 1993. Moliere model.
G4double GetHeEffChargeSquare(const G4int iz, const G4double HeKinEnergy);
// This method returns He effective charge square parametrised according to
// J.F.Ziegler, J.P. Biersack, U. Littmark
// The Stopping and Range of Ions in Matter,
// Vol.1, Pergamon Press, 1985
G4double GetIonEffChargeSquare(const G4Material* material, const G4double KinEnergy,
const G4double IonCharge);
// This method returns ion effective charge square parametrised according to
// J.F.Ziegler, J.P. Biersack, U. Littmark
// The Stopping and Range of Ions in Matter,
// Vol.1, Pergamon Press, 1985
private:
// hide assignment operator
G4hLowEnergyIonisation & operator=(const G4hLowEnergyIonisation &right);
G4hLowEnergyIonisation(const G4hLowEnergyIonisation&);
private:
// private data members ...............................
protected:
// protected data members ...............................
G4PhysicsTable* theMeanFreePathTable;
// interval of parametrisation of electron stopping power
G4double ParamLowEnergy;
G4double ParamHighEnergy;
// name of parametrisation table of electron stopping power
G4String DEDXtable;
// flag of parametrisation of nucleus stopping power
G4bool nStopping;
G4bool pbarStop;
// constants needed for the energy loss calculation
const G4double twoln10;
const G4double Factor;
const G4double bg2lim;
const G4double taulim; // energy to start to switch off shell corrections
G4double RateMass;
G4double MassRatio;
// particles , cuts in kinetic energy ........
const G4Electron* theElectron;
const G4Proton* theProton;
const G4AntiProton* theAntiProton;
const G4double* DeltaCutInKineticEnergy ;
G4double DeltaCutInKineticEnergyNow ;
G4double ProtonMassAMU;
G4double HeMassAMU;
G4double ZieglerFactor; // Factor to convert the Stopping Power
// unit [ev/(10^15 atoms/cm^2]
// into the Geant4 dE/dx unit
};
#include "G4hLowEnergyIonisation.icc"
#endif