#include <G4HadronStoppingProcess.hh>

Inheritance diagram for G4HadronStoppingProcess:

Public Member Functions
	G4HadronStoppingProcess (const G4String &name="hadronCaptureAtRest")

virtual	~G4HadronStoppingProcess ()

virtual G4bool	IsApplicable (const G4ParticleDefinition &)

virtual void	PreparePhysicsTable (const G4ParticleDefinition &)

virtual void	BuildPhysicsTable (const G4ParticleDefinition &)

virtual G4double	AtRestGetPhysicalInteractionLength (const G4Track &track, G4ForceCondition *condition)

virtual G4double	PostStepGetPhysicalInteractionLength (const G4Track &track, G4double previousStepSize, G4ForceCondition *condition)

virtual G4VParticleChange *	AtRestDoIt (const G4Track &, const G4Step &)

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

void	SetElementSelector (G4ElementSelector *ptr)

void	SetEmCascade (G4HadronicInteraction *ptr)

void	SetBoundDecay (G4HadronicInteraction *ptr)

Public Member Functions inherited from G4HadronicProcess
	G4HadronicProcess (const G4String &processName="Hadronic", G4ProcessType procType=fHadronic)

	G4HadronicProcess (const G4String &processName, G4HadronicProcessType subType)

	~G4HadronicProcess () override

void	RegisterMe (G4HadronicInteraction *a)

G4double	GetElementCrossSection (const G4DynamicParticle part, const G4Element elm, const G4Material *mat=nullptr)

G4double	GetMicroscopicCrossSection (const G4DynamicParticle part, const G4Element elm, const G4Material *mat=nullptr)

G4VParticleChange *	PostStepDoIt (const G4Track &aTrack, const G4Step &aStep) override

void	PreparePhysicsTable (const G4ParticleDefinition &) override

void	BuildPhysicsTable (const G4ParticleDefinition &) override

void	DumpPhysicsTable (const G4ParticleDefinition &p)

void	AddDataSet (G4VCrossSectionDataSet *aDataSet)

std::vector< G4HadronicInteraction * > &	GetHadronicInteractionList ()

G4HadronicInteraction *	GetHadronicModel (const G4String &)

G4double	GetMeanFreePath (const G4Track &aTrack, G4double, G4ForceCondition *) override

const G4Nucleus *	GetTargetNucleus () const

const G4Isotope *	GetTargetIsotope ()

void	ProcessDescription (std::ostream &outFile) const override

void	BiasCrossSectionByFactor (G4double aScale)

void	MultiplyCrossSectionBy (G4double factor)

G4double	CrossSectionFactor () const

void	SetIntegral (G4bool val)

void	SetEpReportLevel (G4int level)

void	SetEnergyMomentumCheckLevels (G4double relativeLevel, G4double absoluteLevel)

std::pair< G4double, G4double >	GetEnergyMomentumCheckLevels () const

G4CrossSectionDataStore *	GetCrossSectionDataStore ()

Public Member Functions inherited from G4VDiscreteProcess
	G4VDiscreteProcess (const G4String &aName, G4ProcessType aType=fNotDefined)

	G4VDiscreteProcess (G4VDiscreteProcess &)

virtual	~G4VDiscreteProcess ()

G4VDiscreteProcess &	operator= (const G4VDiscreteProcess &)=delete

virtual G4double	PostStepGetPhysicalInteractionLength (const G4Track &track, G4double previousStepSize, G4ForceCondition *condition)

virtual G4VParticleChange *	PostStepDoIt (const G4Track &, const G4Step &)

virtual G4double	AlongStepGetPhysicalInteractionLength (const G4Track &, G4double, G4double, G4double &, G4GPILSelection *)

virtual G4double	AtRestGetPhysicalInteractionLength (const G4Track &, G4ForceCondition *)

virtual G4VParticleChange *	AtRestDoIt (const G4Track &, const G4Step &)

virtual G4VParticleChange *	AlongStepDoIt (const G4Track &, const G4Step &)

Public Member Functions inherited from G4VProcess
	G4VProcess (const G4String &aName="NoName", G4ProcessType aType=fNotDefined)

	G4VProcess (const G4VProcess &right)

virtual	~G4VProcess ()

G4VProcess &	operator= (const G4VProcess &)=delete

G4bool	operator== (const G4VProcess &right) const

G4bool	operator!= (const G4VProcess &right) const

virtual G4VParticleChange *	PostStepDoIt (const G4Track &track, const G4Step &stepData)=0

virtual G4VParticleChange *	AlongStepDoIt (const G4Track &track, const G4Step &stepData)=0

virtual G4VParticleChange *	AtRestDoIt (const G4Track &track, const G4Step &stepData)=0

virtual G4double	AlongStepGetPhysicalInteractionLength (const G4Track &track, G4double previousStepSize, G4double currentMinimumStep, G4double &proposedSafety, G4GPILSelection *selection)=0

virtual G4double	AtRestGetPhysicalInteractionLength (const G4Track &track, G4ForceCondition *condition)=0

virtual G4double	PostStepGetPhysicalInteractionLength (const G4Track &track, G4double previousStepSize, G4ForceCondition *condition)=0

G4double	GetCurrentInteractionLength () const

void	SetPILfactor (G4double value)

G4double	GetPILfactor () const

G4double	AlongStepGPIL (const G4Track &track, G4double previousStepSize, G4double currentMinimumStep, G4double &proposedSafety, G4GPILSelection *selection)

G4double	AtRestGPIL (const G4Track &track, G4ForceCondition *condition)

G4double	PostStepGPIL (const G4Track &track, G4double previousStepSize, G4ForceCondition *condition)

virtual G4bool	IsApplicable (const G4ParticleDefinition &)

virtual void	BuildPhysicsTable (const G4ParticleDefinition &)

virtual void	PreparePhysicsTable (const G4ParticleDefinition &)

virtual G4bool	StorePhysicsTable (const G4ParticleDefinition *, const G4String &, G4bool)

virtual G4bool	RetrievePhysicsTable (const G4ParticleDefinition *, const G4String &, G4bool)

const G4String &	GetPhysicsTableFileName (const G4ParticleDefinition *, const G4String &directory, const G4String &tableName, G4bool ascii=false)

const G4String &	GetProcessName () const

G4ProcessType	GetProcessType () const

void	SetProcessType (G4ProcessType)

G4int	GetProcessSubType () const

void	SetProcessSubType (G4int)

virtual void	StartTracking (G4Track *)

virtual void	EndTracking ()

virtual void	SetProcessManager (const G4ProcessManager *)

virtual const G4ProcessManager *	GetProcessManager ()

virtual void	ResetNumberOfInteractionLengthLeft ()

G4double	GetNumberOfInteractionLengthLeft () const

G4double	GetTotalNumberOfInteractionLengthTraversed () const

G4bool	isAtRestDoItIsEnabled () const

G4bool	isAlongStepDoItIsEnabled () const

G4bool	isPostStepDoItIsEnabled () const

virtual void	DumpInfo () const

virtual void	ProcessDescription (std::ostream &outfile) const

void	SetVerboseLevel (G4int value)

G4int	GetVerboseLevel () const

virtual void	SetMasterProcess (G4VProcess *masterP)

const G4VProcess *	GetMasterProcess () const

virtual void	BuildWorkerPhysicsTable (const G4ParticleDefinition &part)

virtual void	PrepareWorkerPhysicsTable (const G4ParticleDefinition &)

Protected Member Functions
G4double	GetMeanLifeTime (const G4Track &, G4ForceCondition *)

Protected Member Functions inherited from G4HadronicProcess
G4HadronicInteraction *	ChooseHadronicInteraction (const G4HadProjectile &aHadProjectile, G4Nucleus &aTargetNucleus, const G4Material aMaterial, const G4Element anElement)

G4Nucleus *	GetTargetNucleusPointer ()

void	DumpState (const G4Track &, const G4String &, G4ExceptionDescription &)

G4HadronicInteraction *	GetHadronicInteraction () const

G4double	GetLastCrossSection ()

void	FillResult (G4HadFinalState *aR, const G4Track &aT)

G4HadFinalState *	CheckResult (const G4HadProjectile &thePro, const G4Nucleus &targetNucleus, G4HadFinalState *result)

void	CheckEnergyMomentumConservation (const G4Track &, const G4Nucleus &)

virtual G4double	GetMeanFreePath (const G4Track &aTrack, G4double previousStepSize, G4ForceCondition *condition)=0

Protected Member Functions inherited from G4VProcess
void	SubtractNumberOfInteractionLengthLeft (G4double prevStepSize)

void	ClearNumberOfInteractionLengthLeft ()

Additional Inherited Members
Static Public Member Functions inherited from G4VProcess
static const G4String &	GetProcessTypeName (G4ProcessType)

Protected Attributes inherited from G4HadronicProcess
G4HadProjectile	thePro

G4ParticleChange *	theTotalResult

G4double	fWeight

G4int	epReportLevel

Protected Attributes inherited from G4VProcess
const G4ProcessManager *	aProcessManager = nullptr

G4VParticleChange *	pParticleChange = nullptr

G4ParticleChange	aParticleChange

G4double	theNumberOfInteractionLengthLeft = -1.0

G4double	currentInteractionLength = -1.0

G4double	theInitialNumberOfInteractionLength = -1.0

G4String	theProcessName

G4String	thePhysicsTableFileName

G4ProcessType	theProcessType = fNotDefined

G4int	theProcessSubType = -1

G4double	thePILfactor = 1.0

G4int	verboseLevel = 0

G4bool	enableAtRestDoIt = true

G4bool	enableAlongStepDoIt = true

G4bool	enablePostStepDoIt = true

Detailed Description

Definition at line 62 of file G4HadronStoppingProcess.hh.

Constructor & Destructor Documentation

◆ G4HadronStoppingProcess()

G4HadronStoppingProcess::G4HadronStoppingProcess ( const G4String & name = "hadronCaptureAtRest" )

explicit

Definition at line 63 of file G4HadronStoppingProcess.cc.

    : G4HadronicProcess(name, fHadronAtRest),
      fElementSelector(new G4ElementSelector()),
      fEmCascade(new G4EmCaptureCascade()),  // Owned by InteractionRegistry
      fBoundDecay(0),
      emcID(-1),
      ncID(-1),
      dioID(-1)
{
  // Modify G4VProcess flags to emulate G4VRest instead of G4VDiscrete
  enableAtRestDoIt = true;
  enablePostStepDoIt = false;
 
  G4HadronicProcessStore::Instance()->RegisterExtraProcess(this);
}

◆ ~G4HadronStoppingProcess()

G4HadronStoppingProcess::~G4HadronStoppingProcess ( )

virtual

Definition at line 81 of file G4HadronStoppingProcess.cc.

{
  //G4HadronicProcessStore::Instance()->DeRegisterExtraProcess(this);
  delete fElementSelector;
  // NOTE: fEmCascade and fEmBoundDecay owned by registry, not locally
}

Member Function Documentation

◆ AtRestDoIt()

G4VParticleChange * G4HadronStoppingProcess::AtRestDoIt	(	const G4Track &	track,
		const G4Step &
	)

virtual

Reimplemented from G4VDiscreteProcess.

Definition at line 133 of file G4HadronStoppingProcess.cc.

{
  // if primary is not Alive then do nothing
  theTotalResult->Initialize(track);
 
  G4Nucleus* nucleus = GetTargetNucleusPointer();
  G4Element* elm = fElementSelector->SelectZandA(track, nucleus);
 
  G4HadFinalState* result = 0;
  thePro.Initialise(track);
 
  // save track time an dstart capture from zero time
  thePro.SetGlobalTime(0.0);
  G4double time0 = track.GetGlobalTime();
 
  G4bool nuclearCapture = true;
 
  // Do the electromagnetic cascade in the nuclear field.
  // EM cascade should keep G4HadFinalState object,
  // because it will not be deleted at the end of this method
  //
  result = fEmCascade->ApplyYourself(thePro, *nucleus);
  G4double ebound = result->GetLocalEnergyDeposit(); 
  G4double edep = 0.0; 
  G4int nSecondaries = result->GetNumberOfSecondaries();
  G4int nEmCascadeSec = nSecondaries;
 
  // Try decay from bound level 
  // For mu- the time of projectile should be changed.
  // Decay should keep G4HadFinalState object,
  // because it will not be deleted at the end of this method.
  //
  thePro.SetBoundEnergy(ebound);
  if(fBoundDecay) {
    G4HadFinalState* resultDecay = 
      fBoundDecay->ApplyYourself(thePro, *nucleus);
    G4int n = resultDecay->GetNumberOfSecondaries();
    if(0 < n) {
      nSecondaries += n;
      result->AddSecondaries(resultDecay);
    } 
    if(resultDecay->GetStatusChange() == stopAndKill) {
      nuclearCapture = false; 
    }
    resultDecay->Clear();
  }
 
  if(nuclearCapture) {
 
    // delay of capture
    G4double capTime = thePro.GetGlobalTime();
    thePro.SetGlobalTime(0.0);
 
    // select model
    G4HadronicInteraction* model = 0;
    try {
      model = ChooseHadronicInteraction(thePro, *nucleus, 
                    track.GetMaterial(), elm);
    }
    catch(G4HadronicException & aE) {
      G4ExceptionDescription ed;
      ed << "Target element "<<elm->GetName()<<"  Z= " 
     << nucleus->GetZ_asInt() << "  A= " 
     << nucleus->GetA_asInt() << G4endl;
      DumpState(track,"ChooseHadronicInteraction",ed);
      ed << " No HadronicInteraction found out" << G4endl;
      G4Exception("G4HadronStoppingProcess::AtRestDoIt", "had005", 
          FatalException, ed);
    }
 
    G4HadFinalState* resultNuc = 0;
    G4int reentryCount = 0;
    do {
      // sample final state
      // nuclear interaction should keep G4HadFinalState object
      // model should define time of each secondary particle
      try {
    resultNuc = model->ApplyYourself(thePro, *nucleus);
    ++reentryCount;
      }
      catch(G4HadronicException & aR) {
    G4ExceptionDescription ed;
    ed << "Call for " << model->GetModelName() << G4endl;
    ed << "Target element "<<elm->GetName()<<"  Z= " 
       << nucleus->GetZ_asInt() 
       << "  A= " << nucleus->GetA_asInt() << G4endl;
    DumpState(track,"ApplyYourself",ed);
    ed << " ApplyYourself failed" << G4endl;
    G4Exception("G4HadronStoppingProcess::AtRestDoIt", "had006", 
            FatalException, ed);
      }
 
      // Check the result for catastrophic energy non-conservation
      resultNuc = CheckResult(thePro, *nucleus, resultNuc);
 
      if(reentryCount>100) {
    G4ExceptionDescription ed;
    ed << "Call for " << model->GetModelName() << G4endl;
    ed << "Target element "<<elm->GetName()<<"  Z= " 
       << nucleus->GetZ_asInt() 
       << "  A= " << nucleus->GetA_asInt() << G4endl;
    DumpState(track,"ApplyYourself",ed);
    ed << " ApplyYourself does not completed after 100 attempts" << G4endl;
    G4Exception("G4HadronStoppingProcess::AtRestDoIt", "had006", 
            FatalException, ed);  
      }
      // Loop checking, 06-Aug-2015, Vladimir Ivanchenko
    } while(!resultNuc);
 
    edep = resultNuc->GetLocalEnergyDeposit();
    size_t nnuc = resultNuc->GetNumberOfSecondaries();
 
    // add delay time of capture
    for(size_t i=0; i<nnuc; ++i) { 
      G4HadSecondary* sec = resultNuc->GetSecondary(i);
      sec->SetTime(capTime + sec->GetTime());
    }
 
    nSecondaries += nnuc;
    result->AddSecondaries(resultNuc); 
    resultNuc->Clear();
  }
 
  // Fill results
  //
  theTotalResult->ProposeTrackStatus(fStopAndKill);
  theTotalResult->ProposeLocalEnergyDeposit(edep);  
  theTotalResult->SetNumberOfSecondaries(nSecondaries);
  G4double w  = track.GetWeight();
  theTotalResult->ProposeWeight(w);
  for(G4int i=0; i<nSecondaries; ++i) {
    G4HadSecondary* sec = result->GetSecondary(i);
 
    // add track global time to the reaction time
    G4double time = sec->GetTime();
    if(time < 0.0) { time = 0.0; }
    time += time0;
 
    // create secondary track
    G4Track* t = new G4Track(sec->GetParticle(),
                 time, 
                 track.GetPosition());
    t->SetWeight(w*sec->GetWeight());
 
    // use SetCreatorModelIndex to "label" the track
    if (i<nEmCascadeSec) {
      t->SetCreatorModelIndex(emcID);
    } else if (nuclearCapture) {
      t->SetCreatorModelIndex(ncID);
    } else {
      t->SetCreatorModelIndex(dioID);
    }
 
    t->SetTouchableHandle(track.GetTouchableHandle());
    theTotalResult->AddSecondary(t);
  }
  result->Clear();
 
  if (epReportLevel != 0) { 
    CheckEnergyMomentumConservation(track, *nucleus);
  }
  return theTotalResult;
}

◆ AtRestGetPhysicalInteractionLength()

G4double G4HadronStoppingProcess::AtRestGetPhysicalInteractionLength	(	const G4Track &	track,
		G4ForceCondition *	condition
	)

virtual

Reimplemented from G4VDiscreteProcess.

Definition at line 115 of file G4HadronStoppingProcess.cc.

{
  *condition = NotForced;
  return 0.0;
}

◆ BuildPhysicsTable()

void G4HadronStoppingProcess::BuildPhysicsTable ( const G4ParticleDefinition & p )

virtual

Reimplemented from G4HadronicProcess.

Definition at line 108 of file G4HadronStoppingProcess.cc.

{
  G4HadronicProcessStore::Instance()->PrintInfo(&p);
}

◆ GetMeanLifeTime()

G4double G4HadronStoppingProcess::GetMeanLifeTime	(	const G4Track &	,
		G4ForceCondition *
	)

inlineprotected

Definition at line 98 of file G4HadronStoppingProcess.hh.

99 { return -1.0; }

◆ IsApplicable()

G4bool G4HadronStoppingProcess::IsApplicable ( const G4ParticleDefinition & p )

virtual

Reimplemented from G4VProcess.

Reimplemented in G4HadronicAbsorptionBertini, G4HadronicAbsorptionFritiof, G4HadronicAbsorptionFritiofWithBinaryCascade, and G4MuonMinusCapture.

Definition at line 90 of file G4HadronStoppingProcess.cc.

{
  return (p.GetPDGCharge() < 0.0);
}

Referenced by G4HadronicAbsorptionBertini::IsApplicable().

◆ PostStepGetPhysicalInteractionLength()

G4double G4HadronStoppingProcess::PostStepGetPhysicalInteractionLength	(	const G4Track &	track,
		G4double	previousStepSize,
		G4ForceCondition *	condition
	)

virtual

Reimplemented from G4VDiscreteProcess.

Definition at line 124 of file G4HadronStoppingProcess.cc.

{
  *condition = NotForced;
  return DBL_MAX;
}

◆ PreparePhysicsTable()

void G4HadronStoppingProcess::PreparePhysicsTable ( const G4ParticleDefinition & p )

virtual

Reimplemented from G4HadronicProcess.

Definition at line 98 of file G4HadronStoppingProcess.cc.

{
  G4HadronicProcessStore::Instance()->RegisterParticleForExtraProcess(this,&p);
  emcID = G4PhysicsModelCatalog::Register(G4String((GetProcessName() + "_EMCascade")));
  ncID  = G4PhysicsModelCatalog::Register(G4String((GetProcessName() + "_NuclearCapture")));
  dioID = G4PhysicsModelCatalog::Register(G4String((GetProcessName() + "_DIO")));
}

◆ ProcessDescription()

void G4HadronStoppingProcess::ProcessDescription ( std::ostream & outFile ) const

virtual

Reimplemented from G4HadronicProcess.

Reimplemented in G4HadronicAbsorptionBertini, G4HadronicAbsorptionFritiof, G4HadronicAbsorptionFritiofWithBinaryCascade, and G4MuonMinusCapture.

Definition at line 300 of file G4HadronStoppingProcess.cc.

{
  outFile << "Base process for negatively charged particle capture at rest.\n";
}

◆ SetBoundDecay()

void G4HadronStoppingProcess::SetBoundDecay ( G4HadronicInteraction * ptr )

inline

Definition at line 137 of file G4HadronStoppingProcess.hh.

{
  fBoundDecay = ptr;
}

Referenced by G4MuonMinusCapture::G4MuonMinusCapture().

◆ SetElementSelector()

void G4HadronStoppingProcess::SetElementSelector ( G4ElementSelector * ptr )

inline

Definition at line 122 of file G4HadronStoppingProcess.hh.

{
  if(fElementSelector != ptr) {
    delete fElementSelector;
    fElementSelector = ptr;
  }
}

◆ SetEmCascade()

void G4HadronStoppingProcess::SetEmCascade ( G4HadronicInteraction * ptr )

inline

Definition at line 131 of file G4HadronStoppingProcess.hh.

{
  fEmCascade = ptr;
}

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

Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ G4HadronStoppingProcess()

◆ ~G4HadronStoppingProcess()

Member Function Documentation

◆ AtRestDoIt()

◆ AtRestGetPhysicalInteractionLength()

◆ BuildPhysicsTable()

◆ GetMeanLifeTime()

◆ IsApplicable()

◆ PostStepGetPhysicalInteractionLength()

◆ PreparePhysicsTable()

◆ ProcessDescription()

◆ SetBoundDecay()

◆ SetElementSelector()

◆ SetEmCascade()