larg4::OpBoundaryProcessSimple Class Reference

Discrete process for reflection and diffusion at optical interfaces. More...

#include "OpBoundaryProcessSimple.hh"

Inheritance diagram for larg4::OpBoundaryProcessSimple:

Public Member Functions
	OpBoundaryProcessSimple (const G4String &processName="OpBoundary", G4ProcessType type=fOptical)
	~OpBoundaryProcessSimple ()
G4bool	IsApplicable (const G4ParticleDefinition &aParticleType)
G4double	GetMeanFreePath (const G4Track &, G4double, G4ForceCondition *condition)
G4VParticleChange *	PostStepDoIt (const G4Track &aTrack, const G4Step &aStep)
OpBoundaryProcessSimpleStatus	GetStatus () const

Private Member Functions
G4bool	G4BooleanRand (const G4double prob) const

Private Attributes
OpBoundaryProcessSimpleStatus	fTheStatus
G4double	fCarTolerance
int	fVerbosity

Detailed Description

Discrete process for reflection and diffusion at optical interfaces.

See also

G4VDiscreteProcess

This class invokes a simplified model of optical reflections at boundaries between different materials. The relevant reflectivities are ultimately read from detinfo::LArProperties via larg4::MaterialPropertiesLoader.

The required parameters are total reflectance (detinfo::LArProperties::SurfaceReflectances()) and ratio of diffuse to specular reflectance (detinfo::LArProperties::SurfaceReflectanceDiffuseFractions()). Each photon crossing a boundary with a defined reflectance is randomly either reflected or absorbed and killed according to the supplied probability.

Every reflected photon with a defined diffuse reflection fraction is then randomly either diffusely or specularly reflected according to the supplied probability. All materials with no defined reflectance are assumed to be black and absorb all incident photons.

This physics process is loaded in larg4::OpticalPhysics physics constructor.

This class is based on the G4OpBoundaryProcess class in Geant4 and was adapted for LArSoft by Ben Jones, MIT, March 2010.

Definition at line 108 of file OpBoundaryProcessSimple.hh.

Constructor & Destructor Documentation

larg4::OpBoundaryProcessSimple::OpBoundaryProcessSimple	(	const G4String &	processName = "OpBoundary",
		G4ProcessType	type = fOptical
	)

Definition at line 73 of file OpBoundaryProcessSimple.cxx.

References fCarTolerance, fTheStatus, and larg4::Undefined.

    : G4VDiscreteProcess(processName, type)
  {
    if ( 1 > 0) {
      G4cout << GetProcessName() << " is created " << G4endl;
    }


    SetProcessSubType(fOpBoundary);

    fTheStatus = Undefined;

    fCarTolerance = G4GeometryTolerance::GetInstance()
      ->GetSurfaceTolerance();

  }

larg4::OpBoundaryProcessSimple::~OpBoundaryProcessSimple

(

)

Definition at line 98 of file OpBoundaryProcessSimple.cxx.

  {
  }

Member Function Documentation

G4bool larg4::OpBoundaryProcessSimple::G4BooleanRand ( const G4double  prob ) const

inlineprivate

Definition at line 163 of file OpBoundaryProcessSimple.hh.

Referenced by PostStepDoIt().

  {
    /* Returns a random boolean variable with the specified probability */
    return (G4UniformRand() < prob);
  }

G4double larg4::OpBoundaryProcessSimple::GetMeanFreePath	(	const G4Track &	,
		G4double	,
		G4ForceCondition *	condition
	)

Definition at line 297 of file OpBoundaryProcessSimple.cxx.

  {
    *condition = Forced;

    return DBL_MAX;
  }

OpBoundaryProcessSimpleStatus larg4::OpBoundaryProcessSimple::GetStatus ( ) const

inline

Definition at line 177 of file OpBoundaryProcessSimple.hh.

References fTheStatus.

  {
    return fTheStatus;
  }

G4bool larg4::OpBoundaryProcessSimple::IsApplicable ( const G4ParticleDefinition &  aParticleType )

inline

Definition at line 170 of file OpBoundaryProcessSimple.hh.

  {
    return ( &aParticleType == G4OpticalPhoton::OpticalPhoton() );
  }

G4VParticleChange * larg4::OpBoundaryProcessSimple::PostStepDoIt	(	const G4Track &	aTrack,
		const G4Step &	aStep
	)

Definition at line 109 of file OpBoundaryProcessSimple.cxx.

References fCarTolerance, fTheStatus, fVerbosity, G4BooleanRand(), larg4::NotAtBoundary, sim::LArG4Parameters::OpVerbosity(), larg4::SimpleAbsorbed, larg4::SimpleAbsorbedNoRefl, larg4::SimpleDiffuse, larg4::SimpleSpecular, larg4::StepTooSmall, and larg4::Undefined.

  {

    // Note - these have to be loaded here, since this object
    // is constructed before LArG4, and hence before the
    // LArG4 parameters are read from config

    fTheStatus = Undefined;
    aParticleChange.Initialize(aTrack);


    G4StepPoint* pPreStepPoint  = aStep.GetPreStepPoint();
    G4StepPoint* pPostStepPoint = aStep.GetPostStepPoint();


    if (pPostStepPoint->GetStepStatus() != fGeomBoundary){
      fTheStatus = NotAtBoundary;
      return G4VDiscreteProcess::PostStepDoIt(aTrack, aStep);
    }
    if (aTrack.GetStepLength()<=fCarTolerance/2){
      fTheStatus = StepTooSmall;
      return G4VDiscreteProcess::PostStepDoIt(aTrack, aStep);
    }

    G4Material* Material1 = pPreStepPoint  -> GetMaterial();
    G4Material* Material2 = pPostStepPoint -> GetMaterial();


    if(Material1 != Material2)
      {

  art::ServiceHandle<sim::LArG4Parameters> lgp;

  fVerbosity = lgp->OpVerbosity();



  G4double thePhotonMomentum;

  G4ThreeVector OldMomentum;
  G4ThreeVector OldPolarization;

  G4ThreeVector NewMomentum;
  G4ThreeVector NewPolarization;

  G4ThreeVector theGlobalNormal;
  G4ThreeVector theFacetNormal;

  std::string Material1Name = Material1->GetName();
  std::string Material2Name = Material2->GetName();

  const G4DynamicParticle* aParticle = aTrack.GetDynamicParticle();


  thePhotonMomentum = aParticle->GetTotalMomentum();
  OldMomentum       = aParticle->GetMomentumDirection();
  OldPolarization   = aParticle->GetPolarization();



  if (fVerbosity>9) std::cout<<"OpBoundaryProcessSimple Debug: Photon " <<aTrack.GetTrackID() <<" momentum "<<thePhotonMomentum << " Material1 " << Material1Name.c_str() << " Material 2 " << Material2Name.c_str() << std::endl;

  G4ThreeVector theGlobalPoint = pPostStepPoint->GetPosition();

  G4Navigator* theNavigator =
    G4TransportationManager::GetTransportationManager()->
    GetNavigatorForTracking();

  G4ThreeVector theLocalPoint = theNavigator->
    GetGlobalToLocalTransform().
    TransformPoint(theGlobalPoint);

  G4ThreeVector theLocalNormal;   // Normal points back into volume

  G4bool valid;
  theLocalNormal = theNavigator->GetLocalExitNormal(&valid);

  if (valid) {
    theLocalNormal = -theLocalNormal;
  }
  else {
    G4cerr << " OpBoundaryProcessSimple/PostStepDoIt(): "
     << " The Navigator reports that it returned an invalid normal"
     << G4endl;
  }

  theGlobalNormal = theNavigator->GetLocalToGlobalTransform().
    TransformAxis(theLocalNormal);

  if (OldMomentum * theGlobalNormal > 0.0) {
#ifdef G4DEBUG_OPTICAL
    G4cerr << " OpBoundaryProcessSimple/PostStepDoIt(): "
     << " theGlobalNormal points the wrong direction "
     << G4endl;
#endif
    theGlobalNormal = -theGlobalNormal;
  }

  G4MaterialPropertiesTable* aMaterialPropertiesTable;
  G4MaterialPropertyVector* Reflectance;
  G4MaterialPropertyVector* DiffuseReflectanceFraction;


  aMaterialPropertiesTable = Material1->GetMaterialPropertiesTable();


  if (aMaterialPropertiesTable) {

   std::stringstream PropertyName;
   PropertyName<<"REFLECTANCE_"<<Material2Name.c_str();
   Reflectance =         aMaterialPropertiesTable->GetProperty(PropertyName.str().c_str());

   PropertyName.str("");
   PropertyName<<"DIFFUSE_REFLECTANCE_FRACTION_"<<Material2Name.c_str();
   DiffuseReflectanceFraction=aMaterialPropertiesTable->GetProperty(PropertyName.str().c_str());

    if (Reflectance)
      {
        double theReflectance = Reflectance->Value(thePhotonMomentum);
        if( G4BooleanRand(theReflectance))
    {
      if(DiffuseReflectanceFraction)
        {
          double theDiffuseReflectanceFraction = DiffuseReflectanceFraction->Value(thePhotonMomentum);
          if(G4BooleanRand(theDiffuseReflectanceFraction))
      {
        fTheStatus=SimpleDiffuse;
      }
          else
      {
        fTheStatus=SimpleSpecular;
      }
        }
      else
        {
          fTheStatus=SimpleSpecular;
        }
    }
        else
    {
        fTheStatus=SimpleAbsorbed;
    }

      }
    else
      {
        fTheStatus=SimpleAbsorbedNoRefl;
      }
  }




  // Take action according to track status

  if ( fTheStatus == SimpleDiffuse ) {
    NewMomentum = G4LambertianRand(theGlobalNormal);
    theFacetNormal = (NewMomentum - OldMomentum).unit();
  }

  else if (fTheStatus==SimpleSpecular) {
    theFacetNormal = theGlobalNormal;
    G4double PdotN = OldMomentum * theFacetNormal;
    NewMomentum = OldMomentum - (2.*PdotN)*theFacetNormal;
  }

  else if ((fTheStatus==SimpleAbsorbed) || (fTheStatus==SimpleAbsorbedNoRefl)) {
    aParticleChange.ProposeTrackStatus(fStopAndKill);
  }

  else if ((fTheStatus==NotAtBoundary)||(fTheStatus==StepTooSmall))
    {
      NewMomentum=OldMomentum;
    }
  else aParticleChange.ProposeTrackStatus(fStopAndKill);

  NewMomentum = NewMomentum.unit();
  aParticleChange.ProposeMomentumDirection(NewMomentum);
      }
    return G4VDiscreteProcess::PostStepDoIt(aTrack,aStep);

  }

Member Data Documentation

G4double larg4::OpBoundaryProcessSimple::fCarTolerance

private

Definition at line 153 of file OpBoundaryProcessSimple.hh.

Referenced by OpBoundaryProcessSimple(), and PostStepDoIt().

OpBoundaryProcessSimpleStatus larg4::OpBoundaryProcessSimple::fTheStatus

private

Definition at line 152 of file OpBoundaryProcessSimple.hh.

Referenced by GetStatus(), OpBoundaryProcessSimple(), and PostStepDoIt().

int larg4::OpBoundaryProcessSimple::fVerbosity

private

Definition at line 155 of file OpBoundaryProcessSimple.hh.

Referenced by PostStepDoIt().

---

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

• /cvmfs/larsoft.opensciencegrid.org/products/larsim/v07_09_00/source/larsim/LArG4/OpBoundaryProcessSimple.hh
• /cvmfs/larsoft.opensciencegrid.org/products/larsim/v07_09_00/source/larsim/LArG4/OpBoundaryProcessSimple.cxx