G4PhysicalVolumeStore Class Reference

G4PhysicalVolumeStore is a singleton class, acting as container for all physical volumes, with functionality derived from std::vector<T>. All physical volumes should be registered with G4PhysicalVolumeStore, and removed on their destruction. The underlying container initially has a capacity of 100. A map indexed by volume names is also recorded for fast search; pointers to volumes with same name are stored in buckets. More...

#include <G4PhysicalVolumeStore.hh>

Inheritance diagram for G4PhysicalVolumeStore:

Public Member Functions
virtual	~G4PhysicalVolumeStore ()
	G4PhysicalVolumeStore (const G4PhysicalVolumeStore &)=delete
G4PhysicalVolumeStore &	operator= (const G4PhysicalVolumeStore &)=delete
G4VPhysicalVolume *	GetVolume (const G4String &name, G4bool verbose=true, G4bool reverseSearch=false) const
G4bool	IsMapValid () const
void	SetMapValid (G4bool val)
const std::map< G4String, std::vector< G4VPhysicalVolume * > > &	GetMap () const
void	UpdateMap ()

Static Public Member Functions
static void	Register (G4VPhysicalVolume *pVolume)
static void	DeRegister (G4VPhysicalVolume *pVolume)
static G4PhysicalVolumeStore *	GetInstance ()
static void	SetNotifier (G4VStoreNotifier *pNotifier)
static void	Clean ()

Protected Member Functions
	G4PhysicalVolumeStore ()

Detailed Description

G4PhysicalVolumeStore is a singleton class, acting as container for all physical volumes, with functionality derived from std::vector<T>. All physical volumes should be registered with G4PhysicalVolumeStore, and removed on their destruction. The underlying container initially has a capacity of 100. A map indexed by volume names is also recorded for fast search; pointers to volumes with same name are stored in buckets.

Definition at line 63 of file G4PhysicalVolumeStore.hh.

Constructor & Destructor Documentation

~G4PhysicalVolumeStore()

G4PhysicalVolumeStore::~G4PhysicalVolumeStore ( )

virtual

Destructor: takes care to delete allocated physical volumes.

Definition at line 66 of file G4PhysicalVolumeStore.cc.

{
  Clean();  // Delete all volumes in the store
  G4VPhysicalVolume::Clean();  // Delete allocated sub-instance data
}

G4PhysicalVolumeStore() [1/2]

G4PhysicalVolumeStore::G4PhysicalVolumeStore ( const G4PhysicalVolumeStore & )

delete

Copy constructor and assignment operator not allowed.

Referenced by Clean(), DeRegister(), G4PhysicalVolumeStore(), GetInstance(), GetVolume(), operator=(), and Register().

G4PhysicalVolumeStore() [2/2]

G4PhysicalVolumeStore::G4PhysicalVolumeStore ( )

protected

Protected constructor.

Definition at line 56 of file G4PhysicalVolumeStore.cc.

{
  reserve(100);
}

Member Function Documentation

Clean()

void G4PhysicalVolumeStore::Clean ( )

static

Deletes all physical volumes from the store. Mother logical volumes are automatically notified and have their daughters de-registered.

Definition at line 76 of file G4PhysicalVolumeStore.cc.

{
  // Do nothing if geometry is closed
  //
  if (G4GeometryManager::GetInstance()->IsGeometryClosed())
  {
    G4cout << "WARNING - Attempt to delete the physical volume store"
           << " while geometry closed !" << G4endl;
    return;
  }
 
  // Locks store for deletion of volumes. De-registration will be
  // performed at this stage. G4VPhysicalVolumes will not de-register
  // themselves.
  //
  locked = true;
 
  G4PhysicalVolumeStore* store = GetInstance();
 
  for(const auto & pos : *store)
  {
    if (fgNotifier != nullptr) { fgNotifier->NotifyDeRegistration(); }
    delete pos;
  }
 
  store->bmap.clear(); store->mvalid = false;
  locked = false;
  store->clear();
}

Referenced by G4RunManager::ReinitializeGeometry(), and ~G4PhysicalVolumeStore().

DeRegister()

void G4PhysicalVolumeStore::DeRegister ( G4VPhysicalVolume * pVolume )

static

Removes the logical volume 'pVolume' from the collection.

Definition at line 171 of file G4PhysicalVolumeStore.cc.

{
  G4PhysicalVolumeStore* store = GetInstance();
  if (!locked)    // Do not de-register if locked !
  {
    if (fgNotifier != nullptr) { fgNotifier->NotifyDeRegistration(); }
    G4LogicalVolume* motherLogical = pVolume->GetMotherLogical();
    if (motherLogical != nullptr) { motherLogical->RemoveDaughter(pVolume); }
    for (auto i=store->cbegin(); i!=store->cend(); ++i)
    {
      if (**i==*pVolume)
      {
        store->erase(i);
        break;
      }
    }
    const G4String& vol_name = pVolume->GetName();
    auto it = store->bmap.find(vol_name);
    if (it != store->bmap.cend())
    {
      if (it->second.size() > 1)
      {
        for (auto i=it->second.cbegin(); i!=it->second.cend(); ++i)
        {
          if (**i==*pVolume)
          {
            it->second.erase(i);
            break;
          }
        }
      }
      else
      {
        store->bmap.erase(it);
      }
    }
  }
}

Referenced by G4VPhysicalVolume::~G4VPhysicalVolume().

GetInstance()

G4PhysicalVolumeStore * G4PhysicalVolumeStore::GetInstance ( )

static

Returns a pointer to the unique instance of G4PhysicalVolumeStore, creating it if necessary.

Definition at line 254 of file G4PhysicalVolumeStore.cc.

{
  static G4PhysicalVolumeStore worldStore;
  if (fgInstance == nullptr)
  {
    fgInstance = &worldStore;
  }
  return fgInstance;
}

Referenced by G4AdjointCrossSurfChecker::AddanExtSurfaceOfAvolume(), G4AdjointCrossSurfChecker::AddaSphericalSurfaceWithCenterAtTheCenterOfAVolume(), Clean(), G4SPSPosDistribution::ConfineSourceToVolume(), G4AdjointPosOnPhysVolGenerator::DefinePhysicalVolume(), DeRegister(), G4GeometryWorkspace::DestroyWorkspace(), G4GDMLReadStructure::GetPhysvol(), G4tgbGeometryDumper::GetTopPhysVol(), GetVolume(), G4GeometryWorkspace::InitialisePhysicalVolumes(), Register(), G4RunManager::ReinitializeGeometry(), G4VPhysicalVolume::SetName(), SetNotifier(), G4VViewer::SetTouchable(), G4ScoringRealWorld::SetupGeometry(), G4RegionStore::SetWorldVolume(), G4GDMLRead::StripNames(), UpdateMap(), and G4PhysicalVolumeModel::Validate().

GetMap()

const std::map< G4String, std::vector< G4VPhysicalVolume * > > & G4PhysicalVolumeStore::GetMap ( ) const

inline

Return the internal map.

Definition at line 127 of file G4PhysicalVolumeStore.hh.

{ return bmap; }

GetVolume()

G4VPhysicalVolume * G4PhysicalVolumeStore::GetVolume	(	const G4String &	name,
		G4bool	verbose = true,
		G4bool	reverseSearch = false ) const

Returns a pointer to the first or last volume in the collection having that 'name'. Uses the internal map for fast search and warns if a volume in the collection is not unique or not found.

Parameters

[in]	name	The name of the volume to search.
[in]	verbose	Flag for enabling verbosity (default true).
[in]	reverseSearch	Flag to enable inverse search (default false).

Definition at line 215 of file G4PhysicalVolumeStore.cc.

{
  G4PhysicalVolumeStore* store = GetInstance();
  if (!store->mvalid)  { store->UpdateMap(); }
  auto pos = store->bmap.find(name);
  if(pos != store->bmap.cend())
  {
    if ((verbose) && (pos->second.size()>1))
    {
      std::ostringstream message;
      message << "There exists more than ONE physical volume in store named: "
              << name << "!" << G4endl
              << "Returning the first found.";
      G4Exception("G4PhysicalVolumeStore::GetVolume()",
                  "GeomMgt1001", JustWarning, message);
    }
    if(reverseSearch)
    {
      return pos->second[pos->second.size()-1];
    }
    return pos->second[0];
  }
  if (verbose)
  {
     std::ostringstream message;
     message << "Volume NOT found in store !" << G4endl
            << "        Volume " << name << " NOT found in store !" << G4endl
            << "        Returning NULL pointer.";
     G4Exception("G4PhysicalVolumeStore::GetVolume()",
                 "GeomMgt1001", JustWarning, message);
  }
  return nullptr;
}

Referenced by G4AdjointCrossSurfChecker::AddanExtSurfaceOfAvolume(), G4AdjointCrossSurfChecker::AddaSphericalSurfaceWithCenterAtTheCenterOfAVolume(), G4SPSPosDistribution::ConfineSourceToVolume(), and G4GDMLReadStructure::GetPhysvol().

IsMapValid()

G4bool G4PhysicalVolumeStore::IsMapValid ( ) const

inline

Accessor and modifier to assess validity of the internal map.

Definition at line 120 of file G4PhysicalVolumeStore.hh.

{ return mvalid; }

operator=()

G4PhysicalVolumeStore & G4PhysicalVolumeStore::operator= ( const G4PhysicalVolumeStore & )

delete

Register()

void G4PhysicalVolumeStore::Register ( G4VPhysicalVolume * pVolume )

static

Adds the logical volume 'pVolume' to the collection.

Definition at line 147 of file G4PhysicalVolumeStore.cc.

{
  G4PhysicalVolumeStore* store = GetInstance();
  store->push_back(pVolume);
  const G4String& vol_name = pVolume->GetName();
  auto it = store->bmap.find(vol_name);
  if (it != store->bmap.cend())
  {
    it->second.push_back(pVolume);
  }
  else
  {
    std::vector<G4VPhysicalVolume*> vol_vec { pVolume };
    store->bmap.insert(std::make_pair(vol_name, vol_vec));
  }
  if (fgNotifier != nullptr) { fgNotifier->NotifyRegistration(); }
  store->mvalid = true;
}

Referenced by G4VPhysicalVolume::G4VPhysicalVolume(), and G4VPhysicalVolume::G4VPhysicalVolume().

SetMapValid()

void G4PhysicalVolumeStore::SetMapValid ( G4bool val )

inline

Definition at line 121 of file G4PhysicalVolumeStore.hh.

{ mvalid = val; }

Referenced by G4VPhysicalVolume::SetName().

SetNotifier()

void G4PhysicalVolumeStore::SetNotifier ( G4VStoreNotifier * pNotifier )

static

Assigns a notifier for allocation/deallocation of the physical volumes.

Definition at line 110 of file G4PhysicalVolumeStore.cc.

{
  GetInstance();
  fgNotifier = pNotifier;
}

UpdateMap()

void G4PhysicalVolumeStore::UpdateMap

(

)

Brings contents of the internal map up to date and resets validity flag.

Definition at line 120 of file G4PhysicalVolumeStore.cc.

{
  G4AutoLock l(&mapMutex);  // to avoid thread contention at initialisation
  if (mvalid) { return; }
  bmap.clear();
  for(const auto & pos : *GetInstance())
  {
    const G4String& vol_name = pos->GetName();
    auto it = bmap.find(vol_name);
    if (it != bmap.cend())
    {
      it->second.push_back(pos);
    }
    else
    {
      std::vector<G4VPhysicalVolume*> vol_vec { pos };
      bmap.insert(std::make_pair(vol_name, vol_vec));
    }
  }
  mvalid = true;
  l.unlock();
}

Referenced by GetVolume(), and G4GDMLRead::StripNames().

---

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

• G4PhysicalVolumeStore.hh
• G4PhysicalVolumeStore.cc