#include <G4PenelopeAnnihilationModel.hh>

Inheritance diagram for G4PenelopeAnnihilationModel:

Collaboration diagram for G4PenelopeAnnihilationModel:

Public Member Functions
	G4PenelopeAnnihilationModel (const G4ParticleDefinition *p=0, const G4String &processName="PenAnnih")

virtual	~G4PenelopeAnnihilationModel ()

virtual void	Initialise (const G4ParticleDefinition *, const G4DataVector &)

virtual void	InitialiseLocal (const G4ParticleDefinition , G4VEmModel )

virtual G4double	ComputeCrossSectionPerAtom (const G4ParticleDefinition *, G4double kinEnergy, G4double Z, G4double A=0, G4double cut=0, G4double emax=DBL_MAX)

virtual void	SampleSecondaries (std::vector< G4DynamicParticle > , const G4MaterialCutsCouple , const G4DynamicParticle , G4double tmin, G4double maxEnergy)

void	SetVerbosityLevel (G4int lev)

G4int	GetVerbosityLevel ()

Public Member Functions inherited from G4VEmModel
	G4VEmModel (const G4String &nam)

virtual	~G4VEmModel ()

virtual void	InitialiseForMaterial (const G4ParticleDefinition , const G4Material )

virtual void	InitialiseForElement (const G4ParticleDefinition *, G4int Z)

virtual G4double	ComputeDEDXPerVolume (const G4Material , const G4ParticleDefinition , G4double kineticEnergy, G4double cutEnergy=DBL_MAX)

virtual G4double	CrossSectionPerVolume (const G4Material , const G4ParticleDefinition , G4double kineticEnergy, G4double cutEnergy=0.0, G4double maxEnergy=DBL_MAX)

virtual G4double	GetPartialCrossSection (const G4Material , G4int, const G4ParticleDefinition , G4double)

virtual G4double	ComputeCrossSectionPerShell (const G4ParticleDefinition *, G4int Z, G4int shellIdx, G4double kinEnergy, G4double cutEnergy=0.0, G4double maxEnergy=DBL_MAX)

virtual G4double	ChargeSquareRatio (const G4Track &)

virtual G4double	GetChargeSquareRatio (const G4ParticleDefinition , const G4Material , G4double kineticEnergy)

virtual G4double	GetParticleCharge (const G4ParticleDefinition , const G4Material , G4double kineticEnergy)

virtual void	StartTracking (G4Track *)

virtual void	CorrectionsAlongStep (const G4MaterialCutsCouple , const G4DynamicParticle , G4double &eloss, G4double &niel, G4double length)

virtual G4double	Value (const G4MaterialCutsCouple , const G4ParticleDefinition , G4double kineticEnergy)

virtual G4double	MinPrimaryEnergy (const G4Material , const G4ParticleDefinition , G4double cut=0.0)

virtual G4double	MinEnergyCut (const G4ParticleDefinition , const G4MaterialCutsCouple )

virtual void	SetupForMaterial (const G4ParticleDefinition , const G4Material , G4double kineticEnergy)

virtual void	DefineForRegion (const G4Region *)

virtual void	ModelDescription (std::ostream &outFile) const

void	InitialiseElementSelectors (const G4ParticleDefinition *, const G4DataVector &)

std::vector< G4EmElementSelector * > *	GetElementSelectors ()

void	SetElementSelectors (std::vector< G4EmElementSelector > )

G4double	ComputeDEDX (const G4MaterialCutsCouple , const G4ParticleDefinition , G4double kineticEnergy, G4double cutEnergy=DBL_MAX)

G4double	CrossSection (const G4MaterialCutsCouple , const G4ParticleDefinition , G4double kineticEnergy, G4double cutEnergy=0.0, G4double maxEnergy=DBL_MAX)

G4double	ComputeMeanFreePath (const G4ParticleDefinition , G4double kineticEnergy, const G4Material , G4double cutEnergy=0.0, G4double maxEnergy=DBL_MAX)

G4double	ComputeCrossSectionPerAtom (const G4ParticleDefinition , const G4Element , G4double kinEnergy, G4double cutEnergy=0.0, G4double maxEnergy=DBL_MAX)

G4int	SelectIsotopeNumber (const G4Element *)

const G4Element *	SelectRandomAtom (const G4MaterialCutsCouple , const G4ParticleDefinition , G4double kineticEnergy, G4double cutEnergy=0.0, G4double maxEnergy=DBL_MAX)

const G4Element *	SelectRandomAtom (const G4Material , const G4ParticleDefinition , G4double kineticEnergy, G4double cutEnergy=0.0, G4double maxEnergy=DBL_MAX)

G4int	SelectRandomAtomNumber (const G4Material *)

void	SetParticleChange (G4VParticleChange , G4VEmFluctuationModel f=0)

void	SetCrossSectionTable (G4PhysicsTable *, G4bool isLocal)

G4ElementData *	GetElementData ()

G4PhysicsTable *	GetCrossSectionTable ()

G4VEmFluctuationModel *	GetModelOfFluctuations ()

G4VEmAngularDistribution *	GetAngularDistribution ()

void	SetAngularDistribution (G4VEmAngularDistribution *)

G4double	HighEnergyLimit () const

G4double	LowEnergyLimit () const

G4double	HighEnergyActivationLimit () const

G4double	LowEnergyActivationLimit () const

G4double	PolarAngleLimit () const

G4double	SecondaryThreshold () const

G4bool	LPMFlag () const

G4bool	DeexcitationFlag () const

G4bool	ForceBuildTableFlag () const

G4bool	UseAngularGeneratorFlag () const

void	SetAngularGeneratorFlag (G4bool)

void	SetHighEnergyLimit (G4double)

void	SetLowEnergyLimit (G4double)

void	SetActivationHighEnergyLimit (G4double)

void	SetActivationLowEnergyLimit (G4double)

G4bool	IsActive (G4double kinEnergy)

void	SetPolarAngleLimit (G4double)

void	SetSecondaryThreshold (G4double)

void	SetLPMFlag (G4bool val)

void	SetDeexcitationFlag (G4bool val)

void	SetForceBuildTable (G4bool val)

void	SetMasterThread (G4bool val)

G4bool	IsMaster () const

G4double	MaxSecondaryKinEnergy (const G4DynamicParticle *dynParticle)

const G4String &	GetName () const

void	SetCurrentCouple (const G4MaterialCutsCouple *)

const G4Element *	GetCurrentElement () const

const G4Isotope *	GetCurrentIsotope () const

G4bool	IsLocked () const

void	SetLocked (G4bool)

Protected Attributes
G4ParticleChangeForGamma *	fParticleChange

const G4ParticleDefinition *	fParticle

Protected Attributes inherited from G4VEmModel
G4ElementData *	fElementData

G4VParticleChange *	pParticleChange

G4PhysicsTable *	xSectionTable

const std::vector< G4double > *	theDensityFactor

const std::vector< G4int > *	theDensityIdx

size_t	idxTable

Private Member Functions
G4double	ComputeCrossSectionPerElectron (G4double energy)

G4PenelopeAnnihilationModel &	operator= (const G4PenelopeAnnihilationModel &right)

	G4PenelopeAnnihilationModel (const G4PenelopeAnnihilationModel &)

void	SetParticle (const G4ParticleDefinition *)

Private Attributes
G4int	verboseLevel

G4bool	isInitialised

G4double	fIntrinsicLowEnergyLimit

G4double	fIntrinsicHighEnergyLimit

Static Private Attributes
static G4double	fPielr2 = 0

Additional Inherited Members
Protected Member Functions inherited from G4VEmModel
G4ParticleChangeForLoss *	GetParticleChangeForLoss ()

G4ParticleChangeForGamma *	GetParticleChangeForGamma ()

virtual G4double	MaxSecondaryEnergy (const G4ParticleDefinition *, G4double kineticEnergy)

const G4MaterialCutsCouple *	CurrentCouple () const

void	SetCurrentElement (const G4Element *)

Static Protected Attributes inherited from G4VEmModel
static const G4double	inveplus = 1.0/CLHEP::eplus

Detailed Description

Definition at line 56 of file G4PenelopeAnnihilationModel.hh.

Constructor & Destructor Documentation

◆ G4PenelopeAnnihilationModel() [1/2]

G4PenelopeAnnihilationModel::G4PenelopeAnnihilationModel	(	const G4ParticleDefinition *	p = `0`,
		const G4String &	processName = `"PenAnnih"`
	)

Definition at line 53 of file G4PenelopeAnnihilationModel.cc.

   :G4VEmModel(nam),fParticleChange(0),fParticle(0),isInitialised(false)
 {
   fIntrinsicLowEnergyLimit = 0.0;
   fIntrinsicHighEnergyLimit = 100.0*GeV;
   //  SetLowEnergyLimit(fIntrinsicLowEnergyLimit);
   SetHighEnergyLimit(fIntrinsicHighEnergyLimit);
 
   if (part)
     SetParticle(part);
 
   //Calculate variable that will be used later on
   fPielr2 = pi*classic_electr_radius*classic_electr_radius;
 
   verboseLevel= 0;
   // Verbosity scale:
   // 0 = nothing 
   // 1 = warning for energy non-conservation 
   // 2 = details of energy budget
   // 3 = calculation of cross sections, file openings, sampling of atoms
   // 4 = entering in methods
 
 }

Here is the call graph for this function:

◆ ~G4PenelopeAnnihilationModel()

G4PenelopeAnnihilationModel::~G4PenelopeAnnihilationModel ( )

virtual

Definition at line 80 of file G4PenelopeAnnihilationModel.cc.

81 {;}

◆ G4PenelopeAnnihilationModel() [2/2]

G4PenelopeAnnihilationModel::G4PenelopeAnnihilationModel ( const G4PenelopeAnnihilationModel & )

private

Member Function Documentation

◆ ComputeCrossSectionPerAtom()

G4double G4PenelopeAnnihilationModel::ComputeCrossSectionPerAtom	(	const G4ParticleDefinition *	,
		G4double	kinEnergy,
		G4double	Z,
		G4double	A = `0`,
		G4double	cut = `0`,
		G4double	emax = `DBL_MAX`
	)

virtual

Reimplemented from G4VEmModel.

Definition at line 133 of file G4PenelopeAnnihilationModel.cc.

 {
   if (verboseLevel > 3)
     G4cout << "Calling ComputeCrossSectionPerAtom() of G4PenelopeAnnihilationModel" << 
       G4endl;
 
   G4double cs = Z*ComputeCrossSectionPerElectron(energy);
   
   if (verboseLevel > 2)
     G4cout << "Annihilation cross Section at " << energy/keV << " keV for Z=" << Z << 
       " = " << cs/barn << " barn" << G4endl;
   return cs;
 }

Here is the call graph for this function:

◆ ComputeCrossSectionPerElectron()

G4double G4PenelopeAnnihilationModel::ComputeCrossSectionPerElectron ( G4double energy )

private

Definition at line 280 of file G4PenelopeAnnihilationModel.cc.

 {
   //
   // Penelope model to calculate cross section for positron annihilation.
   // The annihilation cross section per electron is calculated according 
   // to the Heitler formula
   //  W. Heitler, The quantum theory of radiation, Oxford University Press (1954)
   // in the assumptions of electrons free and at rest.
   //
   G4double gamma = 1.0+std::max(energy,1.0*eV)/electron_mass_c2;
   G4double gamma2 = gamma*gamma;
   G4double f2 = gamma2-1.0;
   G4double f1 = std::sqrt(f2);
   G4double crossSection = fPielr2*((gamma2+4.0*gamma+1.0)*std::log(gamma+f1)/f2
              - (gamma+3.0)/f1)/(gamma+1.0);
   return crossSection;
 }

Here is the caller graph for this function:

◆ GetVerbosityLevel()

G4int G4PenelopeAnnihilationModel::GetVerbosityLevel ( )

inline

Definition at line 83 of file G4PenelopeAnnihilationModel.hh.

83 {return verboseLevel;};

G4PenelopeAnnihilationModel::verboseLevel

G4int verboseLevel

Definition: G4PenelopeAnnihilationModel.hh:97

◆ Initialise()

void G4PenelopeAnnihilationModel::Initialise	(	const G4ParticleDefinition *	part,
		const G4DataVector &
	)

virtual

Implements G4VEmModel.

Definition at line 85 of file G4PenelopeAnnihilationModel.cc.

 {
   if (verboseLevel > 3)
     G4cout << "Calling G4PenelopeAnnihilationModel::Initialise()" << G4endl;
   SetParticle(part);
 
   if (IsMaster() && part == fParticle)
     {
 
       if(verboseLevel > 0) {
     G4cout << "Penelope Annihilation model is initialized " << G4endl
            << "Energy range: "
            << LowEnergyLimit() / keV << " keV - "
            << HighEnergyLimit() / GeV << " GeV"
            << G4endl;
       }
     }
 
   if(isInitialised) return;
   fParticleChange = GetParticleChangeForGamma();
   isInitialised = true; 
 }

Here is the call graph for this function:

◆ InitialiseLocal()

void G4PenelopeAnnihilationModel::InitialiseLocal	(	const G4ParticleDefinition *	part,
		G4VEmModel *	masterModel
	)

virtual

Reimplemented from G4VEmModel.

Definition at line 110 of file G4PenelopeAnnihilationModel.cc.

 {
   if (verboseLevel > 3)
     G4cout << "Calling G4PenelopeAnnihilationModel::InitialiseLocal()" << G4endl;
 
   //
   //Check that particle matches: one might have multiple master models (e.g. 
   //for e+ and e-).
   //
   if (part == fParticle)
     {
       //Get the const table pointers from the master to the workers
       const G4PenelopeAnnihilationModel* theModel = 
         static_cast<G4PenelopeAnnihilationModel*> (masterModel);
  
       //Same verbosity for all workers, as the master
       verboseLevel = theModel->verboseLevel;
     }
 }

◆ operator=()

G4PenelopeAnnihilationModel& G4PenelopeAnnihilationModel::operator= ( const G4PenelopeAnnihilationModel & right )

private

◆ SampleSecondaries()

void G4PenelopeAnnihilationModel::SampleSecondaries	(	std::vector< G4DynamicParticle >	fvect,
		const G4MaterialCutsCouple *	,
		const G4DynamicParticle *	aDynamicPositron,
		G4double	tmin,
		G4double	maxEnergy
	)

virtual

Implements G4VEmModel.

Definition at line 153 of file G4PenelopeAnnihilationModel.cc.

 {
   //
   // Penelope model to sample final state for positron annihilation. 
   // Target eletrons are assumed to be free and at rest. Binding effects enabling 
   // one-photon annihilation are neglected.
   // For annihilation at rest, two back-to-back photons are emitted, having energy of 511 keV 
   // and isotropic angular distribution.
   // For annihilation in flight, it is used the theory from 
   //  W. Heitler, The quantum theory of radiation, Oxford University Press (1954)
   // The two photons can have different energy. The efficiency of the sampling algorithm 
   // of the photon energy from the dSigma/dE distribution is practically 100% for 
   // positrons of kinetic energy < 10 keV. It reaches a minimum (about 80%) at energy 
   // of about 10 MeV.
   // The angle theta is kinematically linked to the photon energy, to ensure momentum 
   // conservation. The angle phi is sampled isotropically for the first gamma.
   //
   if (verboseLevel > 3)
     G4cout << "Calling SamplingSecondaries() of G4PenelopeAnnihilationModel" << G4endl;
 
   G4double kineticEnergy = aDynamicPositron->GetKineticEnergy();
 
   // kill primary
   fParticleChange->SetProposedKineticEnergy(0.);
   fParticleChange->ProposeTrackStatus(fStopAndKill);
   
   if (kineticEnergy == 0.0)
     {
       //Old AtRestDoIt
       G4double cosTheta = -1.0+2.0*G4UniformRand();
       G4double sinTheta = std::sqrt(1.0-cosTheta*cosTheta);
       G4double phi = twopi*G4UniformRand();
       G4ThreeVector direction (sinTheta*std::cos(phi),sinTheta*std::sin(phi),cosTheta);
       G4DynamicParticle* firstGamma = new G4DynamicParticle (G4Gamma::Gamma(),
                                  direction, electron_mass_c2);
       G4DynamicParticle* secondGamma = new G4DynamicParticle (G4Gamma::Gamma(),
                                   -direction, electron_mass_c2);
   
       fvect->push_back(firstGamma);
       fvect->push_back(secondGamma);
       return;
     }
 
   //This is the "PostStep" case (annihilation in flight)
   G4ParticleMomentum positronDirection = 
     aDynamicPositron->GetMomentumDirection();
   G4double gamma = 1.0 + std::max(kineticEnergy,1.0*eV)/electron_mass_c2;
   G4double gamma21 = std::sqrt(gamma*gamma-1);
   G4double ani = 1.0+gamma;
   G4double chimin = 1.0/(ani+gamma21);
   G4double rchi = (1.0-chimin)/chimin;
   G4double gt0 = ani*ani-2.0;
   G4double test=0.0;
   G4double epsilon = 0;
   do{
     epsilon = chimin*std::pow(rchi,G4UniformRand());
     G4double reject = ani*ani*(1.0-epsilon)+2.0*gamma-(1.0/epsilon);
     test = G4UniformRand()*gt0-reject;
   }while(test>0);
    
   G4double totalAvailableEnergy = kineticEnergy + 2.0*electron_mass_c2;
   G4double photon1Energy = epsilon*totalAvailableEnergy;
   G4double photon2Energy = (1.0-epsilon)*totalAvailableEnergy;
   G4double cosTheta1 = (ani-1.0/epsilon)/gamma21;
   G4double cosTheta2 = (ani-1.0/(1.0-epsilon))/gamma21;
   
   //G4double localEnergyDeposit = 0.; 
 
   G4double sinTheta1 = std::sqrt(1.-cosTheta1*cosTheta1);
   G4double phi1  = twopi * G4UniformRand();
   G4double dirx1 = sinTheta1 * std::cos(phi1);
   G4double diry1 = sinTheta1 * std::sin(phi1);
   G4double dirz1 = cosTheta1;
   
   G4double sinTheta2 = std::sqrt(1.-cosTheta2*cosTheta2);
   G4double phi2  = phi1+pi;
   G4double dirx2 = sinTheta2 * std::cos(phi2);
   G4double diry2 = sinTheta2 * std::sin(phi2);
   G4double dirz2 = cosTheta2;
   
   G4ThreeVector photon1Direction (dirx1,diry1,dirz1);
   photon1Direction.rotateUz(positronDirection);   
   // create G4DynamicParticle object for the particle1  
   G4DynamicParticle* aParticle1= new G4DynamicParticle (G4Gamma::Gamma(),
                                photon1Direction, 
                                photon1Energy);
   fvect->push_back(aParticle1);
  
   G4ThreeVector photon2Direction(dirx2,diry2,dirz2);
   photon2Direction.rotateUz(positronDirection); 
      // create G4DynamicParticle object for the particle2 
   G4DynamicParticle* aParticle2= new G4DynamicParticle (G4Gamma::Gamma(),
                                photon2Direction,
                                photon2Energy);
   fvect->push_back(aParticle2);
 
   if (verboseLevel > 1)
     {
       G4cout << "-----------------------------------------------------------" << G4endl;
       G4cout << "Energy balance from G4PenelopeAnnihilation" << G4endl;
       G4cout << "Kinetic positron energy: " << kineticEnergy/keV << " keV" << G4endl;
       G4cout << "Total available energy: " << totalAvailableEnergy/keV << " keV " << G4endl;
       G4cout << "-----------------------------------------------------------" << G4endl;
       G4cout << "Photon energy 1: " << photon1Energy/keV << " keV" << G4endl;
       G4cout << "Photon energy 2: " << photon2Energy/keV << " keV" << G4endl;
       G4cout << "Total final state: " << (photon1Energy+photon2Energy)/keV << 
     " keV" << G4endl;
       G4cout << "-----------------------------------------------------------" << G4endl;
     }
   if (verboseLevel > 0)
     {      
       G4double energyDiff = std::fabs(totalAvailableEnergy-photon1Energy-photon2Energy);
       if (energyDiff > 0.05*keV)
     G4cout << "Warning from G4PenelopeAnnihilation: problem with energy conservation: " << 
       (photon1Energy+photon2Energy)/keV << 
       " keV (final) vs. " << 
       totalAvailableEnergy/keV << " keV (initial)" << G4endl;
     }
   return;
 }

Here is the call graph for this function:

◆ SetParticle()

void G4PenelopeAnnihilationModel::SetParticle ( const G4ParticleDefinition * p )

private

Definition at line 300 of file G4PenelopeAnnihilationModel.cc.

 {
   if(!fParticle) {
     fParticle = p;  
   }
 }

Here is the caller graph for this function:

◆ SetVerbosityLevel()

void G4PenelopeAnnihilationModel::SetVerbosityLevel ( G4int lev )

inline

Definition at line 82 of file G4PenelopeAnnihilationModel.hh.

82 {verboseLevel = lev;};

G4PenelopeAnnihilationModel::verboseLevel

G4int verboseLevel

Definition: G4PenelopeAnnihilationModel.hh:97

Member Data Documentation

◆ fIntrinsicHighEnergyLimit

G4double G4PenelopeAnnihilationModel::fIntrinsicHighEnergyLimit

private

Definition at line 101 of file G4PenelopeAnnihilationModel.hh.

◆ fIntrinsicLowEnergyLimit

G4double G4PenelopeAnnihilationModel::fIntrinsicLowEnergyLimit

private

Definition at line 100 of file G4PenelopeAnnihilationModel.hh.

◆ fParticle

const G4ParticleDefinition* G4PenelopeAnnihilationModel::fParticle

protected

Definition at line 87 of file G4PenelopeAnnihilationModel.hh.

◆ fParticleChange

G4ParticleChangeForGamma* G4PenelopeAnnihilationModel::fParticleChange

protected

Definition at line 83 of file G4PenelopeAnnihilationModel.hh.

◆ fPielr2

G4double G4PenelopeAnnihilationModel::fPielr2 = 0

staticprivate

Definition at line 104 of file G4PenelopeAnnihilationModel.hh.

◆ isInitialised

G4bool G4PenelopeAnnihilationModel::isInitialised

private

Definition at line 98 of file G4PenelopeAnnihilationModel.hh.

◆ verboseLevel

G4int G4PenelopeAnnihilationModel::verboseLevel

private

Definition at line 97 of file G4PenelopeAnnihilationModel.hh.

The documentation for this class was generated from the following files:

Public Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Static Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ G4PenelopeAnnihilationModel() [1/2]

◆ ~G4PenelopeAnnihilationModel()

◆ G4PenelopeAnnihilationModel() [2/2]

Member Function Documentation

◆ ComputeCrossSectionPerAtom()

◆ ComputeCrossSectionPerElectron()

◆ GetVerbosityLevel()

◆ Initialise()

◆ InitialiseLocal()

◆ operator=()

◆ SampleSecondaries()

◆ SetParticle()

◆ SetVerbosityLevel()

Member Data Documentation

◆ fIntrinsicHighEnergyLimit

◆ fIntrinsicLowEnergyLimit

◆ fParticle

◆ fParticleChange

◆ fPielr2

◆ isInitialised

◆ verboseLevel