Gabriele Cosmo
402 lines
14 KiB
C++
402 lines
14 KiB
C++
//
|
|
// ********************************************************************
|
|
// * DISCLAIMER *
|
|
// * *
|
|
// * The following disclaimer summarizes all the specific disclaimers *
|
|
// * of contributors to this software. The specific disclaimers,which *
|
|
// * govern, are listed with their locations in: *
|
|
// * http://cern.ch/geant4/license *
|
|
// * *
|
|
// * 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. *
|
|
// * *
|
|
// * 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. *
|
|
// ********************************************************************
|
|
//
|
|
//
|
|
// $Id: G4VUserPhysicsList.hh,v 1.14 2001/10/16 08:35:50 kurasige Exp $
|
|
// GEANT4 tag $Name: geant4-04-01 $
|
|
//
|
|
//
|
|
// ------------------------------------------------------------
|
|
// GEANT 4 class header file
|
|
// Class Description:
|
|
// This class is an abstruct class for
|
|
// constructing particles and processes.
|
|
// User must implement following four virtual methods
|
|
// in his own concrete class derived from this class.
|
|
// G4VUserPhysicsList::ConstructParticle()
|
|
// Construct particles
|
|
// G4VUserPhysicsList::constructPhysics()
|
|
// Construct procesess and register them to particles
|
|
// G4VUserPhysicsList::SetCuts()
|
|
// set cut values in range to all particles
|
|
// (and rebuilding physics table will be invoked )
|
|
//
|
|
// -------------------------------------------
|
|
// History
|
|
// first version 09 Jan. 1998 by H.Kurashige
|
|
// modified 24 Jan. 1998 by H.Kurashige
|
|
// rename DumpCutValues/DumpCutValuesTable
|
|
// change SetCuts method
|
|
// add SetCutsWithDefault method
|
|
// modified 06 June 1998 by H.Kurashige
|
|
// add AddProcessManager
|
|
// add BuildPhysicsTable
|
|
// modified 29 June 1998 by H.Kurashige
|
|
// add AddProcessManager
|
|
// modified 05 Dec. 1998 by H.Kurashige
|
|
// add ConstructAllParticles()
|
|
// modified 14, Apr 1999 by H.Kurashige
|
|
// change BuildPhysicsTable as public
|
|
// removed ConstructAllParticles() and related methods
|
|
// changed SetCuts method argument
|
|
// modified 08, Nov 2000 by H.Kurashige
|
|
// added Retrieve/StorePhysicsTable and related methods
|
|
// modified 08, Mar 2001 by H.Kurashige
|
|
// added binary mode for Retrieve/StorePhysicsTable
|
|
// added RetrieveCutValues and related
|
|
// added Set/ResetStoredInAscii() to switch on ascii mode
|
|
// for Retrieve/StorePhysicsTable
|
|
// ------------------------------------------------------------
|
|
#ifndef G4VUserPhysicsList_h
|
|
#define G4VUserPhysicsList_h 1
|
|
#include "globals.hh"
|
|
#include "G4ios.hh"
|
|
|
|
#include "G4ParticleTable.hh"
|
|
#include "G4ParticleDefinition.hh"
|
|
|
|
class G4UserPhysicsListMessenger;
|
|
class G4VProcess;
|
|
|
|
class G4VUserPhysicsList
|
|
{
|
|
public:
|
|
G4VUserPhysicsList();
|
|
virtual ~G4VUserPhysicsList();
|
|
|
|
public: // with description
|
|
// By calling the "Construct" method,
|
|
// particles and processes are created
|
|
void Construct();
|
|
|
|
|
|
protected: // with description
|
|
// These two methods of ConstructParticle() and ConstructProcess()
|
|
// will be invoked in the Construct() method.
|
|
|
|
// each particle type will be instantiated
|
|
virtual void ConstructParticle() = 0;
|
|
|
|
// each physics process will be instantiated and
|
|
// registered to the process manager of each particle type
|
|
virtual void ConstructProcess() = 0;
|
|
|
|
protected: // with description
|
|
// User must invoke this method in his ConstructProcess()
|
|
// implementation in order to insures particle transportation.
|
|
// !! Caution: this class must not be overriden !!
|
|
void AddTransportation();
|
|
|
|
/////////////////////////////////////////////////////////////////
|
|
public: // with description
|
|
// "SetCuts" method sets a cut value for all particle types
|
|
// in the particle table
|
|
virtual void SetCuts() = 0;
|
|
|
|
public: // with description
|
|
// set/get the default cut value
|
|
// Calling SetDefaultCutValue causes re-calcuration of cut values
|
|
// and physics tables just before the next event loop
|
|
void SetDefaultCutValue(G4double newCutValue);
|
|
G4double GetDefaultCutValue() const;
|
|
|
|
/////////////////////////////////////////////////////////////////////
|
|
public: // with description
|
|
// Invoke BuildPhysicsTable for all processes for specified particle
|
|
// In case of "Retrieve" flag is ON, PhysicsTable will be
|
|
// retrieved from files
|
|
void BuildPhysicsTable(G4ParticleDefinition* );
|
|
|
|
|
|
// Store PhysicsTable together with both material and cut value
|
|
// information in files under the specified directory.
|
|
// (return true if files are sucessfully created)
|
|
G4bool StorePhysicsTable(const G4String& directory = ".");
|
|
|
|
// Return true if "Retrieve" flag is ON.
|
|
// (i.e. PhysicsTable will be retrieved from files)
|
|
G4bool IsPhysicsTableRetrieved() const;
|
|
G4bool IsStoredInAscii() const;
|
|
|
|
// Get directory path for physics table files.
|
|
const G4String& GetPhysicsTableDirectory() const;
|
|
|
|
// Set "Retrieve" flag
|
|
// Directory path can be set together.
|
|
// Null string (default) means directory is not changed
|
|
// from the current value
|
|
void SetPhysicsTableRetrieved(const G4String& directory = "");
|
|
void SetStoredInAscii();
|
|
|
|
// Reset "Retrieve" flag
|
|
void ResetPhysicsTableRetrieved();
|
|
void ResetStoredInAscii();
|
|
|
|
///////////////////////////////////////////////////////////////////////
|
|
public: // with description
|
|
// Print out the List of registered particles types
|
|
void DumpList() const;
|
|
|
|
public: // with description
|
|
// Print out information of cut values
|
|
void DumpCutValuesTable() const;
|
|
void DumpCutValues(const G4String &particle_name = "ALL") const;
|
|
void DumpCutValues(G4ParticleDefinition* ) const;
|
|
|
|
public: // with description
|
|
void SetVerboseLevel(G4int value);
|
|
G4int GetVerboseLevel() const;
|
|
// set/get controle flag for output message
|
|
// 0: Silent
|
|
// 1: Warning message
|
|
// 2: More
|
|
|
|
///////////////////////////////////////////////////////////////////////////
|
|
protected: // with description
|
|
// "SetCutsWithDefault" method sets a cut value with the default
|
|
// cut values for all particle types in the particle table
|
|
void SetCutsWithDefault();
|
|
|
|
|
|
// Following are utility methods for SetCuts/reCalcCuts
|
|
|
|
// Reset cut values in energy for all particle types
|
|
// By calling this methods, the run manager will invoke
|
|
// SetCuts() just before event loop
|
|
void ResetCuts();
|
|
|
|
// SetCutValue sets a cut value for a particle type
|
|
void SetCutValue(G4double aCut, const G4String& name);
|
|
void ReCalcCutValue(const G4String& name);
|
|
|
|
// "setCutsForOthers" method sets a cut value to all particle types
|
|
// which have not be called SetCuts() methods yet.
|
|
// (i.e. particles which have no definit cut values)
|
|
void SetCutValueForOthers(G4double cutValue);
|
|
|
|
// "setCutsForOtherThan" sets a cut value to all particle types
|
|
// other than particle types specified in arguments
|
|
void SetCutValueForOtherThan(G4double cutValue,
|
|
G4ParticleDefinition* first,
|
|
G4ParticleDefinition* second = 0,
|
|
G4ParticleDefinition* third = 0,
|
|
G4ParticleDefinition* fourth = 0,
|
|
G4ParticleDefinition* fifth = 0,
|
|
G4ParticleDefinition* sixth = 0,
|
|
G4ParticleDefinition* seventh = 0,
|
|
G4ParticleDefinition* eighth = 0,
|
|
G4ParticleDefinition* nineth = 0,
|
|
G4ParticleDefinition* tenth = 0 );
|
|
|
|
// "reCalcCutsForOthers" method re-calculates a cut value
|
|
// to all particle types which have not be called SetCuts() methods yet.
|
|
void ReCalcCutValueForOthers();
|
|
|
|
// Invoke SetCuts for specified particle
|
|
// In case of "Retrieve" flag is ON,
|
|
// Cut values will be retrieved from files
|
|
void SetParticleCuts( G4double cut, G4ParticleDefinition* );
|
|
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
public:
|
|
// Get/SetApplyCuts gets/sets the flag for ApplyCuts
|
|
void SetApplyCuts(G4bool value, const G4String& name);
|
|
G4bool GetApplyCuts(const G4String& name) const;
|
|
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
protected:
|
|
// do BuildPhysicsTable for make the integral schema
|
|
void BuildIntegralPhysicsTable(G4VProcess* ,G4ParticleDefinition* );
|
|
|
|
protected:
|
|
// Retrieve PhysicsTable from files for proccess belongng the particle.
|
|
// Normal BuildPhysics procedure of processes will be invoked,
|
|
// if it fails (in case of Process's RetrievePhysicsTable returns false)
|
|
virtual void RetrievePhysicsTable(G4ParticleDefinition* ,
|
|
const G4String& directory,
|
|
G4bool ascii = false);
|
|
|
|
// Store material information in files under the specified directory.
|
|
virtual G4bool StoreMaterialInfo(const G4String& directory,
|
|
G4bool ascii = false);
|
|
// Store cut values information in files under the specified directory.
|
|
virtual G4bool StoreCutValues(const G4String& directory,
|
|
G4bool ascii = false);
|
|
|
|
// Retrieve cut values information in files under the specified directory.
|
|
virtual G4bool RetrieveCutValues(const G4String& directory,
|
|
G4bool ascii = false);
|
|
|
|
|
|
// check stored material and cut values
|
|
virtual G4bool CheckForRetrievePhysicsTable(const G4String& directory,
|
|
G4bool ascii = false);
|
|
// check stored material is consistent with the current detector setup.
|
|
virtual G4bool CheckMaterialInfo(const G4String& directory,
|
|
G4bool ascii = false);
|
|
/////////////////////////////////////////////////////////////////
|
|
protected:
|
|
// adds new ProcessManager to all particles in the Particle Table
|
|
// this routine is used in Construct()
|
|
void InitializeProcessManager();
|
|
|
|
public: // with description
|
|
// remove and delete ProcessManagers for all particles in tha Particle Table
|
|
// this routine is invoked from RunManager
|
|
void RemoveProcessManager();
|
|
|
|
public: // with description
|
|
// add process manager for particles created on-the-fly
|
|
void AddProcessManager(G4ParticleDefinition* newParticle,
|
|
G4ProcessManager* newManager = 0 );
|
|
|
|
|
|
////////////////////////////////////////////////////////////////////////
|
|
protected:
|
|
// the particle table has the complete List of existing particle types
|
|
G4ParticleTable* theParticleTable;
|
|
G4ParticleTable::G4PTblDicIterator* theParticleIterator;
|
|
|
|
protected:
|
|
// pointer to G4UserPhysicsListMessenger
|
|
G4UserPhysicsListMessenger* theMessenger;
|
|
|
|
protected:
|
|
G4int verboseLevel;
|
|
|
|
protected:
|
|
// this is the default cut value for all particles
|
|
G4double defaultCutValue;
|
|
|
|
protected:
|
|
// flag to determine physics table will be build from file or not
|
|
G4bool fRetrievePhysicsTable;
|
|
G4bool fStoredInAscii;
|
|
|
|
G4bool fIsCheckedForRetrievePhysicsTable;
|
|
G4bool fIsRestoredCutValues;
|
|
|
|
// directory name for physics table files
|
|
G4String directoryPhysicsTable;
|
|
|
|
// number of materials in G4MaterialTable
|
|
// (this member is used by store/restore physics table)
|
|
G4int numberOfMaterial;
|
|
|
|
private:
|
|
enum { FixedStringLengthForStore = 32 };
|
|
|
|
////////////////////////////////////////////////////////////////////
|
|
protected:
|
|
enum { NumberOfParticlesForStoreCuts = 9};
|
|
static const G4String particleForStoreCuts[NumberOfParticlesForStoreCuts];
|
|
G4bool isBuildPhysicsTable[NumberOfParticlesForStoreCuts];
|
|
G4int isParticleForStoreCuts(const G4ParticleDefinition*) const;
|
|
};
|
|
|
|
|
|
inline void G4VUserPhysicsList::Construct()
|
|
{
|
|
#ifdef G4VERBOSE
|
|
if (verboseLevel >1) G4cout << "G4VUserPhysicsList::Construct()" << G4endl;
|
|
|
|
if (verboseLevel >1) G4cout << "Construct particles " << G4endl;
|
|
#endif
|
|
ConstructParticle();
|
|
|
|
InitializeProcessManager();
|
|
|
|
#ifdef G4VERBOSE
|
|
if (verboseLevel >1) G4cout << "Construct processes " << G4endl;
|
|
#endif
|
|
ConstructProcess();
|
|
}
|
|
|
|
inline G4double G4VUserPhysicsList::GetDefaultCutValue() const
|
|
{
|
|
return defaultCutValue;
|
|
}
|
|
|
|
inline void G4VUserPhysicsList::SetVerboseLevel(G4int value)
|
|
{
|
|
verboseLevel = value;
|
|
#ifdef G4VERBOSE
|
|
if (verboseLevel >1){
|
|
G4cout << "G4VUserPhysicsList::SetVerboseLevel :";
|
|
G4cout << " Verbose level is set to " << verboseLevel << G4endl;
|
|
}
|
|
#endif
|
|
}
|
|
|
|
inline G4int G4VUserPhysicsList::GetVerboseLevel() const
|
|
{
|
|
return verboseLevel;
|
|
}
|
|
|
|
inline
|
|
G4bool G4VUserPhysicsList::IsPhysicsTableRetrieved() const
|
|
{
|
|
return fRetrievePhysicsTable;
|
|
}
|
|
|
|
inline
|
|
G4bool G4VUserPhysicsList::IsStoredInAscii() const
|
|
{
|
|
return fStoredInAscii;
|
|
}
|
|
|
|
inline
|
|
const G4String& G4VUserPhysicsList::GetPhysicsTableDirectory() const
|
|
{
|
|
return directoryPhysicsTable;
|
|
}
|
|
|
|
inline
|
|
void G4VUserPhysicsList::SetStoredInAscii()
|
|
{
|
|
fStoredInAscii = true;
|
|
}
|
|
|
|
|
|
inline
|
|
void G4VUserPhysicsList::ResetPhysicsTableRetrieved()
|
|
{
|
|
fRetrievePhysicsTable = false;
|
|
fIsRestoredCutValues = false;
|
|
fIsCheckedForRetrievePhysicsTable=false;
|
|
}
|
|
|
|
|
|
inline
|
|
void G4VUserPhysicsList::ResetStoredInAscii()
|
|
{
|
|
fStoredInAscii = false;
|
|
}
|
|
#endif
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|