Import Geant4 10.7.0 source tree
This commit is contained in:
@@ -23,263 +23,215 @@
|
||||
// * acceptance of all terms of the Geant4 Software license. *
|
||||
// ********************************************************************
|
||||
//
|
||||
// G4ParticleChange
|
||||
//
|
||||
// Class description:
|
||||
//
|
||||
//
|
||||
// ------------------------------------------------------------
|
||||
// GEANT 4 class header file
|
||||
// Concrete class for ParticleChange containing the results after
|
||||
// invocation of a physics process.
|
||||
// This includes final states of parent particle (momentum, energy,
|
||||
// etc) and secondary particles generated by the interaction.
|
||||
// The tracking assumes that all the values of energy and momentum
|
||||
// are in global reference system, therefore all the needed Lorentz
|
||||
// transformations must have been already computed when filling the
|
||||
// data-members of this class.
|
||||
//
|
||||
//
|
||||
// ------------------------------------------------------------
|
||||
// Implemented for the new scheme 23 Mar. 1998 H.Kurahige
|
||||
//
|
||||
// Class Description
|
||||
// This class is a concrete class for ParticleChange which
|
||||
// has all functionality in old scheme.
|
||||
//-
|
||||
// This class contains the results after invocation of a physics process.
|
||||
// This includes final states of parent particle (momentum, energy,
|
||||
// etc) and secondary particles generated by the interaction.
|
||||
// The tracking assumes that all the values of energy and
|
||||
// momentum are in global reference system, therefore all the
|
||||
// needed Lorentz transformations must have been already Done
|
||||
// when filling the data-members of this class.
|
||||
//-
|
||||
// ---------------------------------------------------------------
|
||||
// IMPORTANT NOTE: Although the name of the class and methods are
|
||||
// "Change", what it stores (and returns in get) are the "FINAL"
|
||||
// values of the Position, Momentum, etc.
|
||||
//
|
||||
// ------------------------------------------------------------
|
||||
// modify AddSecondary methods for "GoodForTracking" flag
|
||||
// 8 June 1998 H.Kurashige
|
||||
// Add Track weight 12 Nov. 1998 H.Kurashige
|
||||
// Add Get/SetMomentumDirectionChange 6 Feb. 1999 H.Kurashige
|
||||
// Add Get/SetDynamicMass 5 Oct. 1999 H.Kurashige
|
||||
// Add Get/SetDynamicCharge 5 Oct. 1999 H.Kurashige
|
||||
// Rename SetXXX methods to ProposeXXX DynamicCharge Oct. 2005 H.Kurashige
|
||||
// Add get/ProposeMagneticMoment Mar 2007 H.Kurashige
|
||||
// Fix treatment of weight Mar 2007 H.Kurashige
|
||||
// Add Get/ProposeVelocity Apr 2011 H.Kurashige
|
||||
// -------------------------------------------------------------
|
||||
|
||||
#ifndef G4ParticleChange_h
|
||||
#define G4ParticleChange_h 1
|
||||
// IMPORTANT NOTE: Despite the name, what this class stores/returns
|
||||
// through its methods, are the "FINAL" values of the Position,
|
||||
// Momentum, etc.
|
||||
|
||||
// Author: Hisaya Kurashige, 23 March 1998
|
||||
// --------------------------------------------------------------------
|
||||
#ifndef G4ParticleChange_hh
|
||||
#define G4ParticleChange_hh 1
|
||||
|
||||
#include "globals.hh"
|
||||
#include "G4ios.hh"
|
||||
#include "G4ThreeVector.hh"
|
||||
#include "G4ThreeVector.hh"
|
||||
class G4DynamicParticle;
|
||||
#include "G4VParticleChange.hh"
|
||||
|
||||
class G4ParticleChange: public G4VParticleChange
|
||||
{
|
||||
class G4DynamicParticle;
|
||||
|
||||
class G4ParticleChange : public G4VParticleChange
|
||||
{
|
||||
public:
|
||||
// default constructor
|
||||
|
||||
G4ParticleChange();
|
||||
// G4ParticleChange(G4bool useEB);
|
||||
// Default constructor
|
||||
|
||||
// destructor
|
||||
virtual ~G4ParticleChange();
|
||||
// Destructor
|
||||
|
||||
protected:
|
||||
// hide copy constructor and assignment operaor as protected
|
||||
G4ParticleChange(const G4ParticleChange &right);
|
||||
G4ParticleChange & operator=(const G4ParticleChange &right);
|
||||
G4bool operator==(const G4ParticleChange& right) const;
|
||||
G4bool operator!=(const G4ParticleChange& right) const;
|
||||
// Equality operators
|
||||
|
||||
public:
|
||||
// equal/unequal operator
|
||||
G4bool operator==(const G4ParticleChange &right) const;
|
||||
G4bool operator!=(const G4ParticleChange &right) const;
|
||||
// --- the following methods are for updating G4Step -----
|
||||
// Return the pointer to G4Step after updating the Step information
|
||||
// by using final state of the track given by a physics process
|
||||
|
||||
public: // with description
|
||||
// ----------------------------------------------------
|
||||
// --- the following methods are for updating G4Step -----
|
||||
// Return the pointer to the G4Step after updating the Step information
|
||||
// by using final state information of the track given by a physics
|
||||
// process
|
||||
virtual G4Step* UpdateStepForAlongStep(G4Step* Step);
|
||||
// A physics process gives the final state of the particle
|
||||
// relative to the initial state at the beginning of the Step,
|
||||
// i.e., based on information of G4Track (or equivalently
|
||||
// the PreStepPoint)
|
||||
// In this method, the differences (delta) between these two states
|
||||
// are calculated, and are accumulated in PostStepPoint.
|
||||
// Take note that the return type of GetMomentumChange is a
|
||||
// pointer to G4ParticleMometum. Also it is a normalized
|
||||
// momentum vector.
|
||||
// A physics process gives the final state of the particle
|
||||
// relative to the initial state at the beginning of the Step,
|
||||
// i.e., based on information of G4Track (or equivalently
|
||||
// the PreStepPoint).
|
||||
// In this method, the differences (delta) between these two states
|
||||
// are calculated, and are accumulated in PostStepPoint.
|
||||
// Take note that the return type of GetMomentumChange() is a
|
||||
// pointer to G4ParticleMomentum. Also it is a normalized
|
||||
// momentum vector
|
||||
|
||||
virtual G4Step* UpdateStepForAtRest(G4Step* Step);
|
||||
virtual G4Step* UpdateStepForPostStep(G4Step* Step);
|
||||
// A physics process gives the final state of the particle
|
||||
// based on information of G4Track (or equivalently the PreStepPoint)
|
||||
|
||||
// A physics process gives the final state of the particle
|
||||
// based on information of G4Track (or equivalently the PreStepPoint)
|
||||
|
||||
virtual void Initialize(const G4Track&);
|
||||
// Initialize all propoerties by using G4Track information
|
||||
// Initialize all propoerties by using G4Track information
|
||||
|
||||
protected: // with description
|
||||
G4Step* UpdateStepInfo(G4Step* Step);
|
||||
// Update the G4Step specific attributes
|
||||
// (i.e. SteppingControl, LocalEnergyDeposit, and TrueStepLength)
|
||||
|
||||
public: // with description
|
||||
|
||||
// ----------------------------------------------------
|
||||
//--- methods to keep information of the final state--
|
||||
// IMPORTANT NOTE:
|
||||
// These ProposeXXX methods stores (and returns in GetXXX methods)
|
||||
// the "FINAL" values of the Position, Momentum, etc.
|
||||
// --- methods to keep information of the final state ---
|
||||
//
|
||||
// The ProposeXXX methods store (and return in GetXXX methods)
|
||||
// the "FINAL" values of the Position, Momentum, etc.
|
||||
|
||||
const G4ThreeVector* GetMomentumDirection() const;
|
||||
void ProposeMomentumDirection(G4double Px, G4double Py, G4double Pz);
|
||||
void ProposeMomentumDirection(const G4ThreeVector& Pfinal);
|
||||
// Get/Propose the MomentumDirection vector: it is the final momentum direction.
|
||||
// Get/Propose the MomentumDirection vector: it is the final momentum
|
||||
// direction
|
||||
|
||||
const G4ThreeVector* GetPolarization() const;
|
||||
void ProposePolarization(G4double Px, G4double Py, G4double Pz);
|
||||
void ProposePolarization(const G4ThreeVector& finalPoralization);
|
||||
// Get/Propose the final Polarization vector.
|
||||
void ProposePolarization(G4double Px, G4double Py, G4double Pz);
|
||||
void ProposePolarization(const G4ThreeVector& finalPoralization);
|
||||
// Get/Propose the final Polarization vector
|
||||
|
||||
G4double GetEnergy() const;
|
||||
void ProposeEnergy(G4double finalEnergy);
|
||||
// Get/Propose the final kinetic energy of the current particle.
|
||||
// Get/Propose the final kinetic energy of the current particle
|
||||
|
||||
G4double GetVelocity() const;
|
||||
void ProposeVelocity(G4double finalVelocity);
|
||||
// Get/Propose the final velocity of the current particle.
|
||||
// Get/Propose the final velocity of the current particle
|
||||
|
||||
G4double GetProperTime() const;
|
||||
void ProposeProperTime(G4double finalProperTime);
|
||||
// Get/Propose th final ProperTime
|
||||
// Get/Propose the final ProperTime
|
||||
|
||||
const G4ThreeVector* GetPosition() const;
|
||||
void ProposePosition(G4double x, G4double y, G4double z);
|
||||
void ProposePosition(const G4ThreeVector& finalPosition);
|
||||
// Get/Propose the final position of the current particle.
|
||||
// Get/Propose the final position of the current particle
|
||||
|
||||
void ProposeGlobalTime(G4double t);
|
||||
void ProposeLocalTime(G4double t);
|
||||
// Get/Propose the final global/local Time
|
||||
// NOTE: DO NOT INVOKE both methods in a step
|
||||
// Each method affects both local and global time
|
||||
void ProposeGlobalTime(G4double t);
|
||||
void ProposeLocalTime(G4double t);
|
||||
// Get/Propose the final global/local Time.
|
||||
// NOTE: DO NOT INVOKE both methods in a step
|
||||
// Each method affects both local and global time
|
||||
|
||||
G4double GetGlobalTime(G4double timeDelay = 0.0) const;
|
||||
G4double GetLocalTime(G4double timeDelay = 0.0) const;
|
||||
// Convert the time delay to the glocbal/local time.
|
||||
// Can get the final global/local time without argument
|
||||
|
||||
G4double GetGlobalTime(G4double timeDelay=0.0) const;
|
||||
G4double GetLocalTime(G4double timeDelay=0.0) const;
|
||||
// Convert the time delay to the glocbal/local time.
|
||||
// Can get the final global/local Time without argument
|
||||
|
||||
G4double GetMass() const;
|
||||
void ProposeMass(G4double finalMass);
|
||||
// Get/Propose the final dynamical Mass in G4DynamicParticle
|
||||
// Get/Propose the final dynamical mass in G4DynamicParticle
|
||||
|
||||
G4double GetCharge() const;
|
||||
void ProposeCharge(G4double finalCharge);
|
||||
// Get/Propose the final dynamical Charge in G4DynamicParticle
|
||||
// Get/Propose the final dynamical charge in G4DynamicParticle
|
||||
|
||||
G4double GetMagneticMoment() const;
|
||||
void ProposeMagneticMoment(G4double finalMagneticMoment);
|
||||
// Get/Propose the final MagneticMoment in G4DynamicParticle
|
||||
|
||||
// Get/Propose the final MagneticMoment in G4DynamicParticle
|
||||
|
||||
G4ThreeVector GetGlobalPosition(const G4ThreeVector& displacement) const;
|
||||
// Convert the position displacement to the global position.
|
||||
// Convert the position displacement to the global position
|
||||
|
||||
G4ThreeVector CalcMomentum(G4double energy,
|
||||
G4ThreeVector direction,
|
||||
G4double mass ) const;
|
||||
// Calculate momentum by using Energy, Momentum Direction, and Mass
|
||||
G4ThreeVector CalcMomentum(G4double energy, G4ThreeVector direction,
|
||||
G4double mass) const;
|
||||
// Calculate momentum by using Energy, Momentum Direction, and Mass
|
||||
|
||||
// --- methods for adding secondaries ---
|
||||
|
||||
|
||||
// ----------------------------------------------------
|
||||
// --- methods for adding secondaries
|
||||
void AddSecondary(G4Track* aSecondary);
|
||||
// Add a secondary particle to theListOfSecondaries.
|
||||
// Add a secondary particle to theListOfSecondaries
|
||||
|
||||
void AddSecondary(G4DynamicParticle* aSecondary,
|
||||
G4bool IsGoodForTracking = false );
|
||||
// Add a secondary particle to theListOfSecondaries.
|
||||
// position and time are same as thePositionChange and theTimeChange
|
||||
G4bool IsGoodForTracking = false);
|
||||
// Add a secondary particle to theListOfSecondaries.
|
||||
// Position and time are same as thePositionChange and theTimeChange
|
||||
|
||||
void AddSecondary(G4DynamicParticle* aSecondary,
|
||||
G4ThreeVector position,
|
||||
G4bool IsGoodForTracking = false );
|
||||
// Add a secondary particle to theListOfSecondaries.
|
||||
// global time are same as theTimeChange and theTimeChange
|
||||
void AddSecondary(G4DynamicParticle* aSecondary, G4ThreeVector position,
|
||||
G4bool IsGoodForTracking = false);
|
||||
// Add a secondary particle to theListOfSecondaries.
|
||||
// Global time are same as theTimeChange and theTimeChange
|
||||
|
||||
void AddSecondary(G4DynamicParticle* aSecondary,
|
||||
G4double time,
|
||||
G4bool IsGoodForTracking = false );
|
||||
// Add a secondary particle to theListOfSecondaries.
|
||||
// position and are same as thePositionChange
|
||||
// ----------------------------------------------------
|
||||
void AddSecondary(G4DynamicParticle* aSecondary, G4double time,
|
||||
G4bool IsGoodForTracking = false);
|
||||
// Add a secondary particle to theListOfSecondaries.
|
||||
// Position and are same as thePositionChange
|
||||
|
||||
// --- Dump and debug methods ---
|
||||
|
||||
public:
|
||||
virtual void DumpInfo() const;
|
||||
|
||||
virtual G4bool CheckIt(const G4Track&);
|
||||
|
||||
protected:
|
||||
|
||||
G4ParticleChange(const G4ParticleChange& right);
|
||||
G4ParticleChange& operator=(const G4ParticleChange& right);
|
||||
// Hidden copy constructor and assignment operator
|
||||
|
||||
G4Step* UpdateStepInfo(G4Step* Step);
|
||||
// Update the G4Step specific attributes
|
||||
// (i.e. SteppingControl, LocalEnergyDeposit, and TrueStepLength)
|
||||
|
||||
G4ThreeVector theMomentumDirectionChange;
|
||||
// It is the vector containing the final momentum direction
|
||||
// after the invoked process. The application of the change
|
||||
// of the momentum direction of the particle is not Done here.
|
||||
// The responsibility to apply the change is up the entity
|
||||
// which invoked the process.
|
||||
// It is the vector containing the final momentum direction
|
||||
// after the invoked process. The application of the change
|
||||
// of the momentum direction of the particle is not done here.
|
||||
// The responsibility to apply the change is up to the entity
|
||||
// which invoked the process
|
||||
|
||||
G4ThreeVector thePolarizationChange;
|
||||
// The changed (final) polarization of a given track
|
||||
|
||||
G4double theEnergyChange;
|
||||
// The final kinetic energy of the current track
|
||||
|
||||
G4double theVelocityChange;
|
||||
G4bool isVelocityChanged;
|
||||
// The final velocity of the current track
|
||||
// The changed (final) polarization of a given track
|
||||
|
||||
G4ThreeVector thePositionChange;
|
||||
// The changed (final) position of a given track
|
||||
|
||||
G4double theGlobalTime0;
|
||||
// The global time at Initial.
|
||||
G4double theLocalTime0;
|
||||
// The local time at Initial.
|
||||
G4double theEnergyChange = 0.0;
|
||||
// The final kinetic energy of the current track
|
||||
|
||||
G4double theTimeChange;
|
||||
// The change of local time of a given particle.
|
||||
|
||||
G4double theProperTimeChange;
|
||||
// The changed (final) proper time of a given track
|
||||
|
||||
G4double theMassChange;
|
||||
// The Changed (final) mass of a given track
|
||||
G4double theVelocityChange = 0.0;
|
||||
G4bool isVelocityChanged = false;
|
||||
// The final velocity of the current track
|
||||
|
||||
G4double theChargeChange;
|
||||
// The Changed (final) charge of a given track
|
||||
|
||||
G4double theMagneticMomentChange;
|
||||
// The Changed (final) MagneticMoment of a given track
|
||||
|
||||
const G4Track* theCurrentTrack;
|
||||
|
||||
public:
|
||||
// for Debug
|
||||
virtual G4bool CheckIt(const G4Track&);
|
||||
G4ThreeVector thePositionChange;
|
||||
// The changed (final) position of a given track
|
||||
|
||||
G4double theGlobalTime0 = 0.0;
|
||||
// The global time at Initial
|
||||
G4double theLocalTime0 = 0.0;
|
||||
// The local time at Initial
|
||||
|
||||
G4double theTimeChange = 0.0;
|
||||
// The change of local time of a given particle
|
||||
|
||||
G4double theProperTimeChange = 0.0;
|
||||
// The changed (final) proper time of a given track
|
||||
|
||||
G4double theMassChange = 0.0;
|
||||
// The Changed (final) mass of a given track
|
||||
|
||||
G4double theChargeChange = 0.0;
|
||||
// The Changed (final) charge of a given track
|
||||
|
||||
G4double theMagneticMomentChange = 0.0;
|
||||
// The Changed (final) MagneticMoment of a given track
|
||||
|
||||
const G4Track* theCurrentTrack = nullptr;
|
||||
};
|
||||
|
||||
#include "G4ParticleChange.icc"
|
||||
|
||||
#endif
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user