G4Region Class Reference

#include <G4Region.hh>

Public Member Functions
	G4Region (const G4String &name)
virtual	~G4Region ()
G4bool	operator== (const G4Region &rg) const
void	AddRootLogicalVolume (G4LogicalVolume *lv)
void	RemoveRootLogicalVolume (G4LogicalVolume *lv, G4bool scan=true)
void	SetName (const G4String &name)
const G4String &	GetName () const
void	RegionModified (G4bool flag)
G4bool	IsModified () const
void	SetProductionCuts (G4ProductionCuts *cut)
G4ProductionCuts *	GetProductionCuts () const
std::vector< G4LogicalVolume * >::iterator	GetRootLogicalVolumeIterator ()
std::vector< G4Material * >::const_iterator	GetMaterialIterator () const
size_t	GetNumberOfMaterials () const
size_t	GetNumberOfRootVolumes () const
void	UpdateMaterialList ()
void	ClearMaterialList ()
void	ScanVolumeTree (G4LogicalVolume *lv, G4bool region)
void	SetUserInformation (G4VUserRegionInformation *ui)
G4VUserRegionInformation *	GetUserInformation () const
void	SetUserLimits (G4UserLimits *ul)
G4UserLimits *	GetUserLimits () const
void	ClearMap ()
void	RegisterMaterialCouplePair (G4Material *mat, G4MaterialCutsCouple *couple)
G4MaterialCutsCouple *	FindCouple (G4Material *mat)
void	SetFastSimulationManager (G4FastSimulationManager *fsm)
G4FastSimulationManager *	GetFastSimulationManager () const
void	ClearFastSimulationManager ()
void	SetFieldManager (G4FieldManager *fm)
G4FieldManager *	GetFieldManager () const
G4VPhysicalVolume *	GetWorldPhysical () const
void	SetWorld (G4VPhysicalVolume *wp)
G4bool	BelongsTo (G4VPhysicalVolume *thePhys) const
G4Region *	GetParentRegion (G4bool &unique) const
void	SetRegionalSteppingAction (G4UserSteppingAction *rusa)
G4UserSteppingAction *	GetRegionalSteppingAction () const
	G4Region (__void__ &)
void	UsedInMassGeometry (G4bool val=true)
void	UsedInParallelGeometry (G4bool val=true)
G4bool	IsInMassGeometry () const
G4bool	IsInParallelGeometry () const

Detailed Description

Definition at line 61 of file G4Region.hh.

Constructor & Destructor Documentation

G4Region() [1/2]

G4Region::G4Region

(

const G4String &

name

)

Definition at line 48 of file G4Region.cc.

  : fName(pName), fRegionMod(true), fCut(0), fUserInfo(0), fUserLimits(0),
    fFieldManager(0), fFastSimulationManager(0), fWorldPhys(0),
    fRegionalSteppingAction(0),
    fInMassGeometry(false), fInParallelGeometry(false)
{
  G4RegionStore* rStore = G4RegionStore::GetInstance();
  if (rStore->GetRegion(pName,false))
  {
    std::ostringstream message;
    message << "The region has NOT been registered !" << G4endl
            << "          Region " << pName << " already existing in store !"
            << G4endl;
    G4Exception("G4Region::G4Region()", "GeomMgt1001",
                JustWarning, message);
  }
  else
  {
    rStore->Register(this);
  }
}

~G4Region()

G4Region::~G4Region ( )

virtual

Definition at line 91 of file G4Region.cc.

{
  G4RegionStore::GetInstance()->DeRegister(this);
  if(fUserInfo) delete fUserInfo;
}

G4Region() [2/2]

G4Region::G4Region

(

__void__ &

)

Definition at line 75 of file G4Region.cc.

  : fName(""), fRegionMod(true), fCut(0), fUserInfo(0), fUserLimits(0),
    fFieldManager(0), fFastSimulationManager(0), fWorldPhys(0),
    fRegionalSteppingAction(0),
    fInMassGeometry(false), fInParallelGeometry(false)
{
  // Register to store
  //
  G4RegionStore::GetInstance()->Register(this);
}

Member Function Documentation

AddRootLogicalVolume()

void G4Region::AddRootLogicalVolume

(

G4LogicalVolume *

lv

)

Definition at line 227 of file G4Region.cc.

{
  // Check the logical volume is not already in the list
  //
  G4RootLVList::iterator pos;
  pos = std::find(fRootVolumes.begin(),fRootVolumes.end(),lv);
  if (pos == fRootVolumes.end())
  {
    // Insert the root volume in the list and set it as root region
    //
    fRootVolumes.push_back(lv);
    lv->SetRegionRootFlag(true);
  }
 
  // Scan recursively the tree of daugther volumes and set regions
  //
  ScanVolumeTree(lv, true);
 
  // Set region as modified
  //
  fRegionMod = true;
}

Referenced by G4RunManagerKernel::DefineWorldVolume().

BelongsTo()

G4bool G4Region::BelongsTo

(

G4VPhysicalVolume *

thePhys

)

const

Definition at line 335 of file G4Region.cc.

{
  G4LogicalVolume* currLog = thePhys->GetLogicalVolume();
  if (currLog->GetRegion()==this) {return true;}
 
  G4int nDaughters = currLog->GetNoDaughters();
  while (nDaughters--)
  {
    if (BelongsTo(currLog->GetDaughter(nDaughters))) {return true;}
  }
 
  return false;
}

Referenced by BelongsTo(), and SetWorld().

ClearFastSimulationManager()

void G4Region::ClearFastSimulationManager

(

)

Definition at line 355 of file G4Region.cc.

{
  G4bool isUnique;
  G4Region* parent = GetParentRegion(isUnique);
  if(parent)
  {
    if (isUnique)
    {
      fFastSimulationManager = parent->GetFastSimulationManager();
    }
    else
    {
      std::ostringstream message;
      message << "Region <" << fName << "> belongs to more than"
              << " one parent region !" << G4endl
              << "A region cannot belong to more than one direct parent region,"
              << G4endl
              << "to have fast-simulation assigned.";
      G4Exception("G4Region::ClearFastSimulationManager()",
                  "GeomMgt1002", JustWarning, message);
      fFastSimulationManager = 0;
    }
  }
  else
  {
    fFastSimulationManager = 0;
  }
}

Referenced by G4FastSimulationManager::~G4FastSimulationManager().

ClearMap()

void G4Region::ClearMap ( )

inline

ClearMaterialList()

void G4Region::ClearMaterialList

(

)

Definition at line 286 of file G4Region.cc.

{
  fMaterials.clear();
}

Referenced by UpdateMaterialList().

FindCouple()

G4MaterialCutsCouple * G4Region::FindCouple ( G4Material *  mat )

inline

GetFastSimulationManager()

G4FastSimulationManager * G4Region::GetFastSimulationManager ( ) const

inline

Referenced by ClearFastSimulationManager(), G4RunManagerKernel::DumpRegion(), G4VFastSimulationModel::G4VFastSimulationModel(), and G4FastSimulationManager::~G4FastSimulationManager().

GetFieldManager()

G4FieldManager * G4Region::GetFieldManager ( ) const

inline

Referenced by G4PropagatorInField::FindAndSetFieldManager().

GetMaterialIterator()

std::vector< G4Material * >::const_iterator G4Region::GetMaterialIterator ( ) const

inline

Referenced by G4RunManagerKernel::DumpRegion(), and G4PAIPhotonModel::Initialise().

GetName()

const G4String & G4Region::GetName ( ) const

inline

Referenced by G4PhysicalVolumeModel::CreateCurrentAttValues(), G4RunManagerKernel::DefineWorldVolume(), G4EmModelManager::DumpModelList(), G4RunManagerKernel::DumpRegion(), G4EmBiasingManager::Initialise(), G4EmModelManager::Initialise(), G4FastSimulationManager::ListTitle(), G4VEnergyLossProcess::PreparePhysicsTable(), and G4GlobalFastSimulationManager::ShowSetup().

GetNumberOfMaterials()

size_t G4Region::GetNumberOfMaterials ( ) const

inline

Referenced by G4RunManagerKernel::DumpRegion(), and G4PAIPhotonModel::Initialise().

GetNumberOfRootVolumes()

size_t G4Region::GetNumberOfRootVolumes ( ) const

inline

Referenced by G4RunManagerKernel::DefineWorldVolume(), and G4RunManagerKernel::DumpRegion().

GetParentRegion()

G4Region * G4Region::GetParentRegion

(

G4bool &

unique

)

const

Definition at line 390 of file G4Region.cc.

{
  G4Region* parent = 0; unique = true;
  G4LogicalVolumeStore* lvStore = G4LogicalVolumeStore::GetInstance();
  G4LogicalVolumeStore::iterator lvItr;
 
  // Loop over all logical volumes in the store
  //
  for(lvItr=lvStore->begin(); lvItr!=lvStore->end(); lvItr++)
  {
    G4int nD = (*lvItr)->GetNoDaughters();
    G4Region* aR = (*lvItr)->GetRegion();
 
    // Loop over all daughters of each logical volume
    //
    for(G4int iD=0; iD<nD; iD++)
    {
      if((*lvItr)->GetDaughter(iD)->GetLogicalVolume()->GetRegion()==this)
      { 
        if(parent)
        {
          if(parent!=aR) { unique = false; }
        }
        else  // Cache LV parent region which includes a daughter volume
              // with the same associated region as the current one
        {
          parent = aR;
        }
      }
    }
  }
  return parent;
}

Referenced by ClearFastSimulationManager().

GetProductionCuts()

G4ProductionCuts * G4Region::GetProductionCuts ( ) const

inline

Referenced by G4RunManagerKernel::DumpRegion(), G4EmCalculator::FindCouple(), G4VUserPhysicsList::GetCutValue(), G4PAIModel::Initialise(), G4PAIPhotonModel::Initialise(), G4VAtomDeexcitation::InitialiseAtomicDeexcitation(), and G4VUserPhysicsList::SetParticleCuts().

GetRegionalSteppingAction()

G4UserSteppingAction * G4Region::GetRegionalSteppingAction ( ) const

inline

Referenced by G4RunManagerKernel::DumpRegion(), and G4SteppingManager::Stepping().

GetRootLogicalVolumeIterator()

std::vector< G4LogicalVolume * >::iterator G4Region::GetRootLogicalVolumeIterator ( )

inline

Referenced by G4RunManagerKernel::DefineWorldVolume(), and G4RunManagerKernel::DumpRegion().

GetUserInformation()

G4VUserRegionInformation * G4Region::GetUserInformation ( ) const

inline

Referenced by G4RunManagerKernel::DumpRegion().

GetUserLimits()

G4UserLimits * G4Region::GetUserLimits ( ) const

inline

Referenced by G4RunManagerKernel::DumpRegion().

GetWorldPhysical()

G4VPhysicalVolume * G4Region::GetWorldPhysical ( ) const

inline

Referenced by G4RunManagerKernel::DumpRegion(), and G4FastSimulationManager::ListTitle().

IsInMassGeometry()

G4bool G4Region::IsInMassGeometry ( ) const

inline

Referenced by G4RunManagerKernel::DumpRegion().

IsInParallelGeometry()

G4bool G4Region::IsInParallelGeometry ( ) const

inline

Referenced by G4RunManagerKernel::DumpRegion().

IsModified()

G4bool G4Region::IsModified ( ) const

inline

operator==()

G4bool G4Region::operator== ( const G4Region &  rg ) const

inline

RegionModified()

void G4Region::RegionModified ( G4bool  flag )

inline

RegisterMaterialCouplePair()

void G4Region::RegisterMaterialCouplePair ( G4Material *  mat, G4MaterialCutsCouple *  couple  )

inline

RemoveRootLogicalVolume()

void G4Region::RemoveRootLogicalVolume	(	G4LogicalVolume *	lv,
		G4bool	scan = true
	)

Definition at line 256 of file G4Region.cc.

{
  // Find and remove logical volume from the list
  //
  G4RootLVList::iterator pos;
  pos = std::find(fRootVolumes.begin(),fRootVolumes.end(),lv);
  if (pos != fRootVolumes.end())
  {
    if (fRootVolumes.size() != 1)  // Avoid resetting flag for world since
    {                              // volume may be already deleted !
      lv->SetRegionRootFlag(false);
    }
    fRootVolumes.erase(pos);
  }
 
  if (scan)  // Update the materials list
  {
    UpdateMaterialList();
  }
 
  // Set region as modified
  //
  fRegionMod = true;
}

Referenced by G4RunManagerKernel::DefineWorldVolume(), and G4LogicalVolume::~G4LogicalVolume().

ScanVolumeTree()

void G4Region::ScanVolumeTree	(	G4LogicalVolume *	lv,
		G4bool	region
	)

Definition at line 106 of file G4Region.cc.

{
  // If logical volume is going to become a region, add 
  // its material to the list if not already present
  //
  G4Region* currentRegion = 0;
  size_t noDaughters = lv->GetNoDaughters();
  G4Material* volMat = lv->GetMaterial();
  if(!volMat && fInMassGeometry)
  {
    std::ostringstream message;
    message << "Logical volume <" << lv->GetName() << ">" << G4endl
            << "does not have a valid material pointer." << G4endl
            << "A logical volume belonging to the (tracking) world volume "
            << "must have a valid material.";
    G4Exception("G4Region::ScanVolumeTree()", "GeomMgt0002",
                FatalException, message, "Check your geometry construction.");
  }
  if (region)
  {
    currentRegion = this;
    if (volMat)
    { 
      AddMaterial(volMat); 
      G4Material* baseMat = const_cast<G4Material*>(volMat->GetBaseMaterial());
      if (baseMat) { AddMaterial(baseMat); }
    }
  }
 
  // Set the LV region to be either the current region or NULL,
  // according to the boolean selector
  //
  lv->SetRegion(currentRegion);
 
  // Stop recursion here if no further daughters are involved
  //
  if(noDaughters==0) return;
 
  G4VPhysicalVolume* daughterPVol = lv->GetDaughter(0);
  if (daughterPVol->IsParameterised())
  {
    // Adopt special treatment in case of parameterised volumes,
    // where parameterisation involves a new material scan
    //
    G4VPVParameterisation* pParam = daughterPVol->GetParameterisation();
 
    if (pParam->GetMaterialScanner())
    {
      size_t matNo = pParam->GetMaterialScanner()->GetNumberOfMaterials();
      for (register size_t mat=0; mat<matNo; mat++)
      {
        volMat = pParam->GetMaterialScanner()->GetMaterial(mat);
        if(!volMat && fInMassGeometry)
        {
          std::ostringstream message;
          message << "The parameterisation for the physical volume <"
                  << daughterPVol->GetName() << ">" << G4endl
                  << "does not return a valid material pointer." << G4endl
                  << "A volume belonging to the (tracking) world volume must "
                  << "have a valid material.";
          G4Exception("G4Region::ScanVolumeTree()", "GeomMgt0002",
                      FatalException, message, "Check your parameterisation.");
        }
        if (volMat)
        { 
          AddMaterial(volMat); 
          G4Material* baseMat = const_cast<G4Material*>(volMat->GetBaseMaterial());
          if (baseMat) { AddMaterial(baseMat); }
        }
      }
    }
    else
    {
      size_t repNo = daughterPVol->GetMultiplicity();
      for (register size_t rep=0; rep<repNo; rep++)
      {
        volMat = pParam->ComputeMaterial(rep, daughterPVol);
        if(!volMat && fInMassGeometry)
        {
          std::ostringstream message;
          message << "The parameterisation for the physical volume <"
                  << daughterPVol->GetName() << ">" << G4endl
                  << "does not return a valid material pointer." << G4endl
                  << "A volume belonging to the (tracking) world volume must "
                  << "have a valid material.";
          G4Exception("G4Region::ScanVolumeTree()", "GeomMgt0002",
                      FatalException, message, "Check your parameterisation.");
        }
        if(volMat)
        { 
          AddMaterial(volMat);
          G4Material* baseMat = const_cast<G4Material*>(volMat->GetBaseMaterial());
          if (baseMat) { AddMaterial(baseMat); }
        }
      }
    }
    G4LogicalVolume* daughterLVol = daughterPVol->GetLogicalVolume();
    ScanVolumeTree(daughterLVol, region);
  }
  else
  {
    for (register size_t i=0; i<noDaughters; i++)
    {
      G4LogicalVolume* daughterLVol = lv->GetDaughter(i)->GetLogicalVolume();
      if (!daughterLVol->IsRootRegion())
      {
        // Set daughter's LV to be a region and store materials in
        // the materials list, if the LV is not already a root region
        //
        ScanVolumeTree(daughterLVol, region);
      }
    }
  }
}

Referenced by AddRootLogicalVolume(), ScanVolumeTree(), and UpdateMaterialList().

SetFastSimulationManager()

void G4Region::SetFastSimulationManager ( G4FastSimulationManager *  fsm )

inline

Referenced by G4FastSimulationManager::G4FastSimulationManager().

SetFieldManager()

void G4Region::SetFieldManager ( G4FieldManager *  fm )

inline

SetName()

void G4Region::SetName ( const G4String &  name )

inline

SetProductionCuts()

void G4Region::SetProductionCuts ( G4ProductionCuts *  cut )

inline

Referenced by G4RunManagerKernel::DumpRegion(), and G4RunManagerKernel::G4RunManagerKernel().

SetRegionalSteppingAction()

void G4Region::SetRegionalSteppingAction ( G4UserSteppingAction *  rusa )

inline

SetUserInformation()

void G4Region::SetUserInformation ( G4VUserRegionInformation *  ui )

inline

SetUserLimits()

void G4Region::SetUserLimits ( G4UserLimits *  ul )

inline

SetWorld()

void G4Region::SetWorld

(

G4VPhysicalVolume *

wp

)

Definition at line 319 of file G4Region.cc.

{
  if(!wp)
  { fWorldPhys = 0; }
  else
  { if(BelongsTo(wp)) fWorldPhys = wp; }
 
  return;
}

UpdateMaterialList()

void G4Region::UpdateMaterialList

(

)

Definition at line 297 of file G4Region.cc.

{
  // Reset the materials list
  //
  ClearMaterialList();
 
  // Loop over the root logical volumes and rebuild the list
  // of materials from scratch
  //
  G4RootLVList::iterator pLV;
  for (pLV=fRootVolumes.begin(); pLV!=fRootVolumes.end(); pLV++)
  {
    ScanVolumeTree(*pLV, true);
  }
}

Referenced by RemoveRootLogicalVolume().

UsedInMassGeometry()

void G4Region::UsedInMassGeometry ( G4bool  val = true )

inline

UsedInParallelGeometry()

void G4Region::UsedInParallelGeometry ( G4bool  val = true )

inline

---

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

• G4Region.hh
• G4Region.cc