A registry of physical volume info instances that can be searched. More...

#include <BDSPhysicalVolumeInfoRegistry.hh>

Collaboration diagram for BDSPhysicalVolumeInfoRegistry:

Public Member Functions
	~BDSPhysicalVolumeInfoRegistry ()

void	RegisterInfo (G4VPhysicalVolume physicalVolume, BDSPhysicalVolumeInfo info, G4bool isReadOutVolume=false, G4bool isTunnel=false)

void	RegisterInfo (const std::set< G4VPhysicalVolume * > &physicalVolumes, BDSPhysicalVolumeInfo *info, G4bool isReadOutVolume=false, G4bool isTunnel=false)
	Loop version of the same function above but for a set of pvs. More...

BDSPhysicalVolumeInfo *	GetInfo (G4VPhysicalVolume *logicalVolume, G4bool isTunnel=false)

void	RegisterExcludedPV (G4VPhysicalVolume *physicalVolume)

Static Public Member Functions
static BDSPhysicalVolumeInfoRegistry *	Instance ()
	Singleton accessor. More...

Private Member Functions
	BDSPhysicalVolumeInfoRegistry ()
	Default constructor is private as singleton. More...

G4bool	IsRegistered (G4VPhysicalVolume *physicalVolume)
	Check whether a physical volume is registered at all. More...

G4bool	IsRegisteredToReadOutRegister (G4VPhysicalVolume *physicalVolume)
	Check whether a physical volume is registered to the read out registry. More...

G4bool	IsRegisteredToBackupRegister (G4VPhysicalVolume *physicalVolume)
	Check whether a physical volume is registered ot the general backup registry. More...

G4bool	IsRegisteredToTunnelRegister (G4VPhysicalVolume *physicalVolume)

Private Attributes
std::map< G4VPhysicalVolume , BDSPhysicalVolumeInfo >	readOutRegister
	Registry is a map - note 'register' is a protected keyword. More...

std::map< G4VPhysicalVolume , BDSPhysicalVolumeInfo >	backupRegister

std::map< G4VPhysicalVolume , BDSPhysicalVolumeInfo >	tunnelRegister

std::set< G4VPhysicalVolume * >	excludedVolumes

std::set< BDSPhysicalVolumeInfo * >	pvInfosForDeletion


BDSPVInfoIterator	readOutSearch
	Search iterator. More...

BDSPVInfoIterator	backupSearch
	Search iterator. More...

BDSPVInfoIterator	tunnelSearch
	Search iterator. More...

Static Private Attributes
static BDSPhysicalVolumeInfoRegistry *	instance = nullptr
	The singleton instance. More...

Friends
std::ostream &	operator<< (std::ostream &out, BDSPhysicalVolumeInfoRegistry const &r)
	output stream More...

Detailed Description

A registry of physical volume info instances that can be searched.

This actually contains two registries - one for read out geometry and one for general geometry. The reason for this is that the physical volumes of the general geometry are much more numerous and would increase the search time of whole registry

important as it'll be used for every single energy deposition track. However, if the read out geometry is used for an element, then we need only register that as all hits will occur inside the read out geometry and that can be used for info lookup. This means only one registration per beamline element. It is not a formal requirement that each component have a read out geometry (yet) so this look up should work without it. Adding all the physical volumes of a component will lead to polluting the main register with many more volumes. This can be revisited and simplified if we force / require that every element has a read out volume.

Author: Laurie Nevay

Definition at line 55 of file BDSPhysicalVolumeInfoRegistry.hh.

Constructor & Destructor Documentation

◆ ~BDSPhysicalVolumeInfoRegistry()

BDSPhysicalVolumeInfoRegistry::~BDSPhysicalVolumeInfoRegistry ( )

Destructor resets instance to 0 so that the class can be reinstantiated if necessary

Definition at line 44 of file BDSPhysicalVolumeInfoRegistry.cc.

References instance.

◆ BDSPhysicalVolumeInfoRegistry()

BDSPhysicalVolumeInfoRegistry::BDSPhysicalVolumeInfoRegistry ( )

private

Default constructor is private as singleton.

Definition at line 38 of file BDSPhysicalVolumeInfoRegistry.cc.

References backupSearch, readOutRegister, and readOutSearch.

Referenced by Instance().

Here is the caller graph for this function:

Member Function Documentation

◆ GetInfo()

BDSPhysicalVolumeInfo * BDSPhysicalVolumeInfoRegistry::GetInfo	(	G4VPhysicalVolume *	logicalVolume,
		G4bool	isTunnel = `false`
	)

Get the logical volume info for a particular logical volume (by address). Note, returns null pointer if none found. If isTunnel, gets only from tunnelRegistry.

Definition at line 94 of file BDSPhysicalVolumeInfoRegistry.cc.

References backupSearch, IsRegisteredToBackupRegister(), IsRegisteredToReadOutRegister(), readOutSearch, and tunnelSearch.

Referenced by BDSTrajectoryPoint::BDSTrajectoryPoint(), BDSOutputROOTEventTrajectory::FillIndividualTrajectory(), BDSSDApertureImpacts::ProcessHits(), BDSSDEnergyDeposition::ProcessHits(), BDSSDCollimator::ProcessHitsOrdered(), and BDSSDEnergyDeposition::ProcessHitsTrack().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ Instance()

BDSPhysicalVolumeInfoRegistry * BDSPhysicalVolumeInfoRegistry::Instance ( )

static

Singleton accessor.

Definition at line 31 of file BDSPhysicalVolumeInfoRegistry.cc.

References BDSPhysicalVolumeInfoRegistry(), and instance.

Referenced by BDSAcceleratorModel::BDSAcceleratorModel(), BDSTrajectoryPoint::BDSTrajectoryPoint(), BDSDetectorConstruction::BuildWorld(), BDSOutputROOTEventTrajectory::FillIndividualTrajectory(), BDSDetectorConstruction::PlaceBeamlineInWorld(), BDSSDApertureImpacts::ProcessHits(), BDSSDEnergyDeposition::ProcessHits(), BDSSDCollimator::ProcessHitsOrdered(), and BDSSDEnergyDeposition::ProcessHitsTrack().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ IsRegistered()

G4bool BDSPhysicalVolumeInfoRegistry::IsRegistered ( G4VPhysicalVolume * physicalVolume )

private

Check whether a physical volume is registered at all.

Definition at line 130 of file BDSPhysicalVolumeInfoRegistry.cc.

References IsRegisteredToBackupRegister(), and IsRegisteredToReadOutRegister().

Referenced by RegisterInfo().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ IsRegisteredToBackupRegister()

G4bool BDSPhysicalVolumeInfoRegistry::IsRegisteredToBackupRegister ( G4VPhysicalVolume * physicalVolume )

private

Check whether a physical volume is registered ot the general backup registry.

Definition at line 144 of file BDSPhysicalVolumeInfoRegistry.cc.

References backupSearch.

Referenced by GetInfo(), and IsRegistered().

Here is the caller graph for this function:

◆ IsRegisteredToReadOutRegister()

G4bool BDSPhysicalVolumeInfoRegistry::IsRegisteredToReadOutRegister ( G4VPhysicalVolume * physicalVolume )

private

Check whether a physical volume is registered to the read out registry.

Definition at line 135 of file BDSPhysicalVolumeInfoRegistry.cc.

References readOutRegister, and readOutSearch.

Referenced by GetInfo(), and IsRegistered().

Here is the caller graph for this function:

◆ IsRegisteredToTunnelRegister()

G4bool BDSPhysicalVolumeInfoRegistry::IsRegisteredToTunnelRegister ( G4VPhysicalVolume * physicalVolume )

private

Definition at line 153 of file BDSPhysicalVolumeInfoRegistry.cc.

◆ RegisterExcludedPV()

void BDSPhysicalVolumeInfoRegistry::RegisterExcludedPV ( G4VPhysicalVolume * physicalVolume )

Register a pointer to exclude from the search. If the registry is queried with one of these pointers, it immediately returns a nullptr without complaint. This registers the pointer to (hopefully small) member vector that is queried before the main search each time.

Definition at line 125 of file BDSPhysicalVolumeInfoRegistry.cc.

Referenced by BDSDetectorConstruction::BuildWorld().

Here is the caller graph for this function:

◆ RegisterInfo() [1/2]

void BDSPhysicalVolumeInfoRegistry::RegisterInfo	(	const std::set< G4VPhysicalVolume * > &	physicalVolumes,
		BDSPhysicalVolumeInfo *	info,
		G4bool	isReadOutVolume = `false`,
		G4bool	isTunnel = `false`
	)

Loop version of the same function above but for a set of pvs.

Definition at line 85 of file BDSPhysicalVolumeInfoRegistry.cc.

References RegisterInfo().

Here is the call graph for this function:

◆ RegisterInfo() [2/2]

void BDSPhysicalVolumeInfoRegistry::RegisterInfo	(	G4VPhysicalVolume *	physicalVolume,
		BDSPhysicalVolumeInfo *	info,
		G4bool	isReadOutVolume = `false`,
		G4bool	isTunnel = `false`
	)

Register an instance of logical volume info with the address of the logical volume, which is used as the key to access it. Optional isReadOutVolume flag means volume info will be stored in a separate register that will be searched first to minimise search time. If not found there, the main register will be searched. Optional flag isTunnel controls whether the info is stored to a separate registry just for tunnel segments (not so many so quicker look up, and / or doesn't pollute main registry -> slower).

Definition at line 51 of file BDSPhysicalVolumeInfoRegistry.cc.

References BDSPhysicalVolumeInfo::GetName(), IsRegistered(), and readOutRegister.

Referenced by BDSDetectorConstruction::PlaceBeamlineInWorld(), and RegisterInfo().

Here is the call graph for this function: