Gabriele Cosmo
356 lines
14 KiB
C++
356 lines
14 KiB
C++
//
|
|
// ********************************************************************
|
|
// * License and Disclaimer *
|
|
// * *
|
|
// * The Geant4 software is copyright of the Copyright Holders of *
|
|
// * the Geant4 Collaboration. It is provided under the terms and *
|
|
// * conditions of the Geant4 Software License, included in the file *
|
|
// * LICENSE and available at http://cern.ch/geant4/license . These *
|
|
// * include a list of copyright holders. *
|
|
// * *
|
|
// * Neither the authors of this software system, nor their employing *
|
|
// * institutes,nor the agencies providing financial support for this *
|
|
// * work make any representation or warranty, express or implied, *
|
|
// * regarding this software system or assume any liability for its *
|
|
// * use. Please see the license in the file LICENSE and URL above *
|
|
// * for the full disclaimer and the limitation of liability. *
|
|
// * *
|
|
// * This code implementation is the result of the scientific and *
|
|
// * technical work of the GEANT4 collaboration. *
|
|
// * By using, copying, modifying or distributing the software (or *
|
|
// * any work based on the software) you agree to acknowledge its *
|
|
// * use in resulting scientific publications, and indicate your *
|
|
// * acceptance of all terms of the Geant4 Software license. *
|
|
// ********************************************************************
|
|
//
|
|
//
|
|
// ------------------------------------------------------------
|
|
// GEANT 4 class header file
|
|
//
|
|
// 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
|
|
// ************************************************************
|
|
|
|
// ************************************************************
|
|
// 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
|
|
// 23 May 2000 MG Pia Clean up for QAO model
|
|
// 25 July 2000 V.Ivanchenko New design iteration
|
|
// 09 August 2000 V.Ivanchenko Add GetContinuousStepLimit
|
|
// 17 August 2000 V.Ivanchenko Add IonFluctuationModel
|
|
// 23 Oct 2000 V.Ivanchenko Renew comments
|
|
// 30 Oct 2001 V.Ivanchenko Add minGammaEnergy and minElectronEnergy
|
|
// 07 Dec 2001 V.Ivanchenko Add SetFluorescence method
|
|
// 26 Feb 2002 V.Ivanchenko Add initialMass for GenericIons
|
|
// 21 Jan 2003 V.Ivanchenko Cut per region
|
|
// ------------------------------------------------------------
|
|
|
|
// Class Description:
|
|
// Ionisation process of charged hadrons and ions, including low energy
|
|
// extensions
|
|
// The physics model is described in CERN-OPEN-99-121 and CERN-OPEN-99-300.
|
|
// The user may select parametrisation tables for electronic
|
|
// stopping powers and nuclear stopping powers
|
|
// The list of available tables:
|
|
// Electronic stopping powers: "ICRU_49p" (default), "ICRU_49He",
|
|
// "Ziegler1977p", "Ziegler1985p",
|
|
// "Ziegler1977He"
|
|
// Nuclear stopping powers: "ICRU_49" (default), "Ziegler1977",
|
|
// "Ziegler1985"
|
|
// Further documentation available from http://www.ge.infn.it/geant4/lowE
|
|
// and in the Physics Reference Manual
|
|
|
|
// ------------------------------------------------------------
|
|
|
|
#ifndef G4hLowEnergyIonisation_h
|
|
#define G4hLowEnergyIonisation_h 1
|
|
|
|
#include "globals.hh"
|
|
#include "G4hLowEnergyLoss.hh"
|
|
#include "G4VLowEnergyModel.hh"
|
|
#include "G4Track.hh"
|
|
#include "G4Step.hh"
|
|
#include "G4Electron.hh"
|
|
#include "G4PhysicsLogVector.hh"
|
|
#include "G4PhysicsLinearVector.hh"
|
|
#include "G4hNuclearStoppingModel.hh"
|
|
#include "G4hBetheBlochModel.hh"
|
|
#include "G4hParametrisedLossModel.hh"
|
|
#include "G4QAOLowEnergyLoss.hh"
|
|
#include "G4hIonEffChargeSquare.hh"
|
|
#include "G4IonChuFluctuationModel.hh"
|
|
#include "G4IonYangFluctuationModel.hh"
|
|
#include "G4AtomicDeexcitation.hh"
|
|
#include "G4MaterialCutsCouple.hh"
|
|
#include <map>
|
|
|
|
class G4VEMDataSet;
|
|
class G4ShellVacancy;
|
|
class G4VhShellCrossSection;
|
|
|
|
class G4hLowEnergyIonisation : public G4hLowEnergyLoss
|
|
{
|
|
public: // With description
|
|
|
|
G4hLowEnergyIonisation(const G4String& processName = "hLowEIoni");
|
|
// The ionisation process for hadrons/ions to be include in the
|
|
// UserPhysicsList
|
|
|
|
~G4hLowEnergyIonisation();
|
|
// Destructor
|
|
|
|
G4bool IsApplicable(const G4ParticleDefinition&);
|
|
// True for all charged hadrons/ions
|
|
|
|
void BuildPhysicsTable(const G4ParticleDefinition& aParticleType) ;
|
|
// Build physics table during initialisation
|
|
|
|
G4double GetMeanFreePath(const G4Track& track,
|
|
G4double previousStepSize,
|
|
enum G4ForceCondition* condition );
|
|
// Return MeanFreePath until delta-electron production
|
|
|
|
void PrintInfoDefinition() const;
|
|
// Print out of the class parameters
|
|
|
|
void SetHighEnergyForProtonParametrisation(G4double energy)
|
|
{protonHighEnergy = energy;} ;
|
|
// Definition of the boundary proton energy. For higher energies
|
|
// Bethe-Bloch formula is used, for lower energies a parametrisation
|
|
// of the energy losses is performed. Default is 2 MeV.
|
|
|
|
void SetLowEnergyForProtonParametrisation(G4double energy)
|
|
{protonLowEnergy = energy;} ;
|
|
// Set of the boundary proton energy. For lower energies
|
|
// the Free Electron Gas model is used for the energy losses.
|
|
// Default is 1 keV.
|
|
|
|
void SetHighEnergyForAntiProtonParametrisation(G4double energy)
|
|
{antiProtonHighEnergy = energy;} ;
|
|
// Set of the boundary antiproton energy. For higher energies
|
|
// Bethe-Bloch formula is used, for lower energies parametrisation
|
|
// of the energy losses is performed. Default is 2 MeV.
|
|
|
|
void SetLowEnergyForAntiProtonParametrisation(G4double energy)
|
|
{antiProtonLowEnergy = energy;} ;
|
|
// Set of the boundary antiproton energy. For lower energies
|
|
// the Free Electron Gas model is used for the energy losses.
|
|
// Default is 1 keV.
|
|
|
|
G4double GetContinuousStepLimit(const G4Track& track,
|
|
G4double previousStepSize,
|
|
G4double currentMinimumStep,
|
|
G4double& currentSafety);
|
|
// Calculation of the step limit due to ionisation losses
|
|
|
|
void SetElectronicStoppingPowerModel(const G4ParticleDefinition* aParticle,
|
|
const G4String& dedxTable);
|
|
// This method defines the electron ionisation parametrisation method
|
|
// via the name of the table. Default is "ICRU_49p".
|
|
|
|
void SetNuclearStoppingPowerModel(const G4String& dedxTable)
|
|
{theNuclearTable = dedxTable; SetNuclearStoppingOn();};
|
|
// This method defines the nuclear ionisation parametrisation method
|
|
// via the name of the table. Default is "ICRU_49".
|
|
|
|
void SetNuclearStoppingOn() {nStopping = true;};
|
|
// This method switch on calculation of the nuclear stopping power.
|
|
|
|
void SetNuclearStoppingOff() {nStopping = false;};
|
|
// This method switch off calculation of the nuclear stopping power.
|
|
|
|
void SetBarkasOn() {theBarkas = true;};
|
|
// This method switch on calculation of the Barkas and Bloch effects.
|
|
|
|
void SetBarkasOff() {theBarkas = false;};
|
|
// This method switch off calculation of the Barkas and Bloch effects.
|
|
|
|
void SetFluorescence(const G4bool val) {theFluo = val;};
|
|
// This method switch on/off simulation of the fluorescence of the media.
|
|
|
|
G4VParticleChange* AlongStepDoIt(const G4Track& trackData ,
|
|
const G4Step& stepData ) ;
|
|
// Function to determine total energy deposition on the step
|
|
|
|
G4VParticleChange* PostStepDoIt(const G4Track& track,
|
|
const G4Step& Step ) ;
|
|
// Simulation of delta rays production.
|
|
|
|
G4double ComputeDEDX(const G4ParticleDefinition* aParticle,
|
|
const G4MaterialCutsCouple* couple,
|
|
G4double kineticEnergy);
|
|
// This method returns electronic dE/dx for protons or antiproton.
|
|
|
|
void SetCutForSecondaryPhotons(G4double cut);
|
|
// Set threshold energy for fluorescence
|
|
|
|
void SetCutForAugerElectrons(G4double cut);
|
|
// Set threshold energy for Auger electron production
|
|
|
|
void ActivateAugerElectronProduction(G4bool val);
|
|
// Set Auger electron production flag on/off
|
|
|
|
|
|
protected:
|
|
|
|
private:
|
|
|
|
void InitializeMe();
|
|
|
|
void InitializeParametrisation();
|
|
|
|
void BuildLossTable(const G4ParticleDefinition& aParticleType);
|
|
|
|
void BuildDataForFluorescence(const G4ParticleDefinition& aParticleType);
|
|
|
|
void BuildLambdaTable(const G4ParticleDefinition& aParticleType);
|
|
|
|
void SetProtonElectronicStoppingPowerModel(const G4String& dedxTable)
|
|
{theProtonTable = dedxTable ;};
|
|
// This method defines the ionisation parametrisation method via its name
|
|
|
|
void SetAntiProtonElectronicStoppingPowerModel(const G4String& dedxTable)
|
|
{theAntiProtonTable = dedxTable ;};
|
|
|
|
G4double ComputeMicroscopicCrossSection(
|
|
const G4ParticleDefinition& aParticleType,
|
|
G4double kineticEnergy,
|
|
G4double atomicNumber,
|
|
G4double deltaCutInEnergy) const;
|
|
|
|
G4double GetConstraints(const G4DynamicParticle* particle,
|
|
const G4MaterialCutsCouple* couple);
|
|
// Function to determine StepLimit
|
|
|
|
G4double ProtonParametrisedDEDX(const G4MaterialCutsCouple* couple,
|
|
G4double kineticEnergy) const;
|
|
|
|
G4double AntiProtonParametrisedDEDX(const G4MaterialCutsCouple* couple,
|
|
G4double kineticEnergy) const;
|
|
|
|
G4double DeltaRaysEnergy(const G4MaterialCutsCouple* couple,
|
|
G4double kineticEnergy,
|
|
G4double particleMass) const;
|
|
// This method returns average energy loss due to delta-rays emission with
|
|
// energy higher than the cut energy for given material.
|
|
|
|
G4double BarkasTerm(const G4Material* material,
|
|
G4double kineticEnergy) const;
|
|
// Function to compute the Barkas term for protons
|
|
|
|
G4double BlochTerm(const G4Material* material,
|
|
G4double kineticEnergy,
|
|
G4double cSquare) const;
|
|
// Function to compute the Bloch term for protons
|
|
|
|
G4double ElectronicLossFluctuation(const G4DynamicParticle* particle,
|
|
const G4MaterialCutsCouple* material,
|
|
G4double meanLoss,
|
|
G4double step) const;
|
|
// Function to sample electronic losses
|
|
|
|
std::vector<G4DynamicParticle*>* DeexciteAtom(const G4MaterialCutsCouple* couple,
|
|
G4double incidentEnergy,
|
|
G4double hMass,
|
|
G4double eLoss);
|
|
|
|
G4int SelectRandomAtom(const G4MaterialCutsCouple* couple,
|
|
G4double kineticEnergy) const;
|
|
|
|
// hide assignment operator
|
|
G4hLowEnergyIonisation & operator=(const G4hLowEnergyIonisation &right);
|
|
G4hLowEnergyIonisation(const G4hLowEnergyIonisation&);
|
|
|
|
private:
|
|
// private data members ...............................
|
|
G4VLowEnergyModel* theBetheBlochModel;
|
|
G4VLowEnergyModel* theProtonModel;
|
|
G4VLowEnergyModel* theAntiProtonModel;
|
|
G4VLowEnergyModel* theIonEffChargeModel;
|
|
G4VLowEnergyModel* theNuclearStoppingModel;
|
|
G4VLowEnergyModel* theIonChuFluctuationModel;
|
|
G4VLowEnergyModel* theIonYangFluctuationModel;
|
|
std::map<G4int,G4double,std::less<G4int> > totalCrossSectionMap;
|
|
|
|
// name of parametrisation table of electron stopping power
|
|
G4String theProtonTable;
|
|
G4String theAntiProtonTable;
|
|
G4String theNuclearTable;
|
|
|
|
// interval of parametrisation of electron stopping power
|
|
G4double protonLowEnergy;
|
|
G4double protonHighEnergy;
|
|
G4double antiProtonLowEnergy;
|
|
G4double antiProtonHighEnergy;
|
|
|
|
// flag of parametrisation of nucleus stopping power
|
|
G4bool nStopping;
|
|
G4bool theBarkas;
|
|
|
|
G4DataVector cutForDelta;
|
|
G4DataVector cutForGamma;
|
|
G4double minGammaEnergy;
|
|
G4double minElectronEnergy;
|
|
G4PhysicsTable* theMeanFreePathTable;
|
|
|
|
const G4double paramStepLimit; // parameter limits the step at low energy
|
|
|
|
G4double fdEdx; // computed in GetContraints
|
|
G4double fRangeNow ; //
|
|
G4double charge; //
|
|
G4double chargeSquare; //
|
|
G4double initialMass; // mass to calculate Lambda tables
|
|
G4double fBarkas;
|
|
|
|
G4AtomicDeexcitation deexcitationManager;
|
|
G4ShellVacancy* shellVacancy;
|
|
G4VhShellCrossSection* shellCS;
|
|
std::vector<G4VEMDataSet*> zFluoDataVector;
|
|
G4bool theFluo;
|
|
G4bool expFlag;
|
|
};
|
|
|
|
//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
|
|
|
|
inline G4double G4hLowEnergyIonisation::GetContinuousStepLimit(
|
|
const G4Track& track,
|
|
G4double,
|
|
G4double currentMinimumStep,
|
|
G4double&)
|
|
{
|
|
G4double Step =
|
|
GetConstraints(track.GetDynamicParticle(),track.GetMaterialCutsCouple()) ;
|
|
|
|
if((Step>0.0)&&(Step<currentMinimumStep))
|
|
currentMinimumStep = Step ;
|
|
|
|
return Step ;
|
|
}
|
|
|
|
//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
|
|
|
|
inline G4bool G4hLowEnergyIonisation::IsApplicable(
|
|
const G4ParticleDefinition& particle)
|
|
{
|
|
return(particle.GetPDGCharge() != 0.0
|
|
&& particle.GetPDGMass() > proton_mass_c2*0.1);
|
|
}
|
|
|
|
//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|