G4SafetyHelper Class Reference

#include <G4SafetyHelper.hh>

Public Member Functions
	G4SafetyHelper ()
	~G4SafetyHelper ()
G4double	CheckNextStep (const G4ThreeVector &position, const G4ThreeVector &direction, const G4double currentMaxStep, G4double &newSafety)
G4double	ComputeSafety (const G4ThreeVector &pGlobalPoint, G4double maxRadius=DBL_MAX)
void	Locate (const G4ThreeVector &pGlobalPoint, const G4ThreeVector &direction)
void	ReLocateWithinVolume (const G4ThreeVector &pGlobalPoint)
void	EnableParallelNavigation (G4bool parallel)
void	InitialiseNavigator ()
G4int	SetVerboseLevel (G4int lev)
G4VPhysicalVolume *	GetWorldVolume ()
void	SetCurrentSafety (G4double val, const G4ThreeVector &pos)
void	InitialiseHelper ()

Detailed Description

Definition at line 53 of file G4SafetyHelper.hh.

Constructor & Destructor Documentation

G4SafetyHelper()

G4SafetyHelper::G4SafetyHelper

(

)

Definition at line 42 of file G4SafetyHelper.cc.

 : fUseParallelGeometries(false),     // By default, one geometry only
   fFirstCall(true),
   fVerbose(0), 
   fLastSafetyPosition(0.0,0.0,0.0),
   fLastSafety(0.0),
   fRecomputeFactor(0.0)
{
  fpPathFinder= 0; //  Cannot initialise this yet - a loop results
 
  // Initialization of the Navigator pointer is postponed, and must
  // be undertaken by another class calling InitialiseHelper()
  //
  fpMassNavigator= 0;  
  fMassNavigatorId= -1; 
}

~G4SafetyHelper()

G4SafetyHelper::~G4SafetyHelper

(

)

Definition at line 89 of file G4SafetyHelper.cc.

{
}

Member Function Documentation

CheckNextStep()

G4double G4SafetyHelper::CheckNextStep	(	const G4ThreeVector &	position,
		const G4ThreeVector &	direction,
		const G4double	currentMaxStep,
		G4double &	newSafety
	)

Definition at line 94 of file G4SafetyHelper.cc.

{  
  // Distance in the Mass geometry
  //
  G4double linstep = fpMassNavigator->CheckNextStep( position,
                                                     direction,
                                                     currentMaxStep,
                                                     newSafety);
  fLastSafetyPosition = position;
  fLastSafety         = newSafety;
 
  // TO-DO: Can replace this with a call to PathFinder 
  //        giving id of Mass Geometry --> this avoid doing the work twice
 
  return linstep;
}

Referenced by G4VMscModel::ComputeGeomLimit().

ComputeSafety()

G4double G4SafetyHelper::ComputeSafety	(	const G4ThreeVector &	pGlobalPoint,
		G4double	maxRadius = DBL_MAX
	)

Definition at line 114 of file G4SafetyHelper.cc.

{
  G4double newSafety;
 
  // Only recompute (calling Navigator/PathFinder) if 'position'
  // is  *not* the safety location and has moved 'significantly'
  //
  G4double moveLengthSq = (position-fLastSafetyPosition).mag2();
  G4double safeDistance = fRecomputeFactor*fLastSafety; 
  if(   (moveLengthSq > 0.0 )
     && (moveLengthSq >= safeDistance*safeDistance))    
  {
    fLastSafetyPosition = position;
 
    if( !fUseParallelGeometries )
    {
      // Safety for mass geometry
      fLastSafety = fpMassNavigator->ComputeSafety(position, maxLength, true);
    }
    else
    {
      // Safety for all geometries
      fLastSafety = fpPathFinder->ComputeSafety(position); 
    } 
    newSafety = fLastSafety;
  }
  else
  {
    // return last value if position is not significantly changed
    //
    G4double moveLength = 0;
    if( moveLengthSq > 0.0 )
    {
      moveLength= std::sqrt(moveLengthSq); 
    }
    newSafety = fLastSafety-moveLength;
  } 
  return newSafety;
}

Referenced by G4VEnergyLossProcess::AlongStepDoIt(), and G4VMscModel::ComputeSafety().

EnableParallelNavigation()

void G4SafetyHelper::EnableParallelNavigation ( G4bool  parallel )

inline

Definition at line 130 of file G4SafetyHelper.hh.

{
  fUseParallelGeometries = parallel;
} 

Referenced by G4PathFinder::EnableParallelNavigation().

GetWorldVolume()

G4VPhysicalVolume * G4SafetyHelper::GetWorldVolume ( )

inline

Definition at line 136 of file G4SafetyHelper.hh.

{
  return fpMassNavigator->GetWorldVolume();
}

Referenced by G4VMscModel::ComputeGeomLimit().

InitialiseHelper()

void G4SafetyHelper::InitialiseHelper

(

)

Definition at line 81 of file G4SafetyHelper.cc.

{
  fLastSafetyPosition = G4ThreeVector(0.0,0.0,0.0);
  fLastSafety         = 0.0;
  if (fFirstCall) { InitialiseNavigator(); }
  fFirstCall = false;
}

Referenced by G4VEnergyLossProcess::BuildPhysicsTable(), G4VMscModel::GetParticleChangeForMSC(), G4PathFinder::PrepareNewTrack(), and G4VMultipleScattering::PreparePhysicsTable().

InitialiseNavigator()

void G4SafetyHelper::InitialiseNavigator

(

)

Definition at line 59 of file G4SafetyHelper.cc.

{
  fpPathFinder= G4PathFinder::GetInstance();
 
  G4TransportationManager* pTransportMgr= 
    G4TransportationManager::GetTransportationManager();
 
  fpMassNavigator = pTransportMgr->GetNavigatorForTracking(); 
 
  // Check
  //
  G4VPhysicalVolume* worldPV = fpMassNavigator->GetWorldVolume(); 
  if( worldPV == 0 )
  { 
    G4Exception("G4SafetyHelper::InitialiseNavigator",
                "InvalidNavigatorWorld", FatalException, 
                "Found that existing tracking Navigator has NULL world"); 
  }
 
  fMassNavigatorId = pTransportMgr->ActivateNavigator( fpMassNavigator ); 
}

Referenced by InitialiseHelper().

Locate()

void G4SafetyHelper::Locate	(	const G4ThreeVector &	pGlobalPoint,
		const G4ThreeVector &	direction
	)

Definition at line 184 of file G4SafetyHelper.cc.

{
  if( !fUseParallelGeometries)
  {
    fpMassNavigator->LocateGlobalPointAndSetup(newPosition, &newDirection,
                                               true, false); 
  }
  else
  {
    fpPathFinder->Locate( newPosition, newDirection ); 
  }
}

ReLocateWithinVolume()

void G4SafetyHelper::ReLocateWithinVolume

(

const G4ThreeVector &

pGlobalPoint

)

Definition at line 154 of file G4SafetyHelper.cc.

{
#ifdef G4VERBOSE
  if( fVerbose > 0 ) { 
    // There is an opportunity - and need - to check whether the proposed move is safe
    G4ThreeVector moveVec= newPosition - fLastSafetyPosition;
    if( moveVec.mag2() > sqr(fLastSafety) )
    {
      // A problem exists - we are proposing to move outside 'Safety Sphere'
      G4ExceptionDescription ed;
      ed << " Safety Sphere:  Radius = " << fLastSafety;
      ed << " Center   = " << fLastSafetyPosition << G4endl;
      ed << " New Location :  Move   = " << moveVec.mag2();
      ed << " Position = " << newPosition << G4endl;
      G4Exception("G4SafetyHelper::ReLocateWithinVolume", "GeomNav999", JustWarning,
                 "Unsafe Move> Asked to relocate beyond 'Safety sphere'.");
    }
  }
#endif
   
  if( !fUseParallelGeometries )
  {
    fpMassNavigator->LocateGlobalPointWithinVolume( newPosition ); 
  }
  else
  {
    fpPathFinder->ReLocate( newPosition ); 
  }
}

Referenced by G4VMultipleScattering::PostStepDoIt().

SetCurrentSafety()

void G4SafetyHelper::SetCurrentSafety ( G4double  val, const G4ThreeVector &  pos  )

inline

Definition at line 142 of file G4SafetyHelper.hh.

{
  fLastSafety = val;
  fLastSafetyPosition = pos;
}

Referenced by G4CoupledTransportation::AlongStepGetPhysicalInteractionLength(), G4Transportation::AlongStepGetPhysicalInteractionLength(), and G4ITTransportation::AlongStepGetPhysicalInteractionLength().

SetVerboseLevel()

G4int G4SafetyHelper::SetVerboseLevel ( G4int  lev )

inline

Definition at line 96 of file G4SafetyHelper.hh.

{ G4int oldlv= fVerbose; fVerbose= lev; return oldlv; } 

---

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

• G4SafetyHelper.hh
• G4SafetyHelper.cc