biasing::utility::StepPrinter Class Reference

User stepping action used to print the details of a step. More...

#include <StepPrinter.h>

Public Member Functions
	StepPrinter (const std::string &name, framework::config::Parameters &parameters)
	Constructor.
virtual	~StepPrinter ()=default
	Destructor.
void	stepping (const G4Step *step) override
	Stepping action called when a step is taken during tracking of a particle.
std::vector< simcore::TYPE >	getTypes () override
	Retrieve the type of actions this class defines.
Public Member Functions inherited from simcore::UserAction
	UserAction (const std::string &name, framework::config::Parameters &parameters)
	Constructor.
virtual	~UserAction ()=default
	Destructor.
virtual void	BeginOfEventAction (const G4Event *)
	Method called at the beginning of every event.
virtual void	EndOfEventAction (const G4Event *)
	Method called at the end of every event.
virtual void	BeginOfRunAction (const G4Run *)
	Method called at the beginning of a run.
virtual void	EndOfRunAction (const G4Run *)
	Method called at the end of a run.
virtual void	PreUserTrackingAction (const G4Track *)
	Method called before the UserTrackingAction.
virtual void	PostUserTrackingAction (const G4Track *)
	Method called after the UserTrackingAction.
virtual G4ClassificationOfNewTrack	ClassifyNewTrack (const G4Track *, const G4ClassificationOfNewTrack &cl)
	Method called when a track is updated.
virtual void	NewStage ()
	Method called at the beginning of a new stage.
virtual void	PrepareNewEvent ()
	Method called at the beginning of a new event.

Private Attributes
int	trackID_ {-9999}
	The track ID to filter on.
std::string	processName_ {"UNDEFINED"}
int	depth_ {0}
std::unordered_map< int, int >	trackParents_ {}

Additional Inherited Members
Public Types inherited from simcore::UserAction
using	Factory = ::simcore::Factory< UserAction, std::shared_ptr< UserAction >, const std::string &, framework::config::Parameters & >
	factory for user actions
Protected Member Functions inherited from simcore::UserAction
UserEventInformation *	getEventInfo () const
	Get a handle to the event information.
const std::map< int, ldmx::SimParticle > &	getCurrentParticleMap () const
	Get the current particle map.
Protected Attributes inherited from simcore::UserAction
std::string	name_ {""}
	Name of the UserAction.
framework::config::Parameters	parameters_
	The set of parameters used to configure this class.

Detailed Description

User stepping action used to print the details of a step.

Definition at line 16 of file StepPrinter.h.

Constructor & Destructor Documentation

StepPrinter()

biasing::utility::StepPrinter::StepPrinter	(	const std::string &	name,
		framework::config::Parameters &	parameters
	)

Constructor.

Parameters

[in]	name	the name of the instance of this UserAction.
[in]	parameters	the parameters used to configure this UserAction.

Definition at line 12 of file StepPrinter.cxx.

    : simcore::UserAction(name, parameters) {
  trackID_ = parameters.getParameter<int>("track_id");
  processName_ = parameters.getParameter<std::string>("process_name");
  depth_ = parameters.getParameter<int>("depth");
}

References framework::config::Parameters::getParameter(), and trackID_.

Member Function Documentation

getTypes()

std::vector< simcore::TYPE > biasing::utility::StepPrinter::getTypes ( )

inlineoverridevirtual

Retrieve the type of actions this class defines.

Implements simcore::UserAction.

Definition at line 40 of file StepPrinter.h.

                                             {
    return {simcore::TYPE::STEPPING};
  }

stepping()

void biasing::utility::StepPrinter::stepping ( const G4Step *  step )

overridevirtual

Stepping action called when a step is taken during tracking of a particle.

Parameters

[in]

step

Geant4 step

Reimplemented from simcore::UserAction.

Definition at line 20 of file StepPrinter.cxx.

                                             {
  // Get the track associated with this step
  auto track{step->GetTrack()};
 
  const auto trackID{track->GetTrackID()};
  const auto parent{track->GetParentID()};
  // Don't bother filling the map if we aren't going to use it
  if (depth_ > 0) {
    trackParents_[trackID] = parent;
  }
 
  auto process{track->GetCreatorProcess()};
  std::string processName{process ? process->GetProcessName() : "Primary"};
  // Unwrap biasing part of process name if present
  if (processName.find("biasWrapper") != std::string::npos) {
    std::size_t pos = processName.find_first_of("(") + 1;
    processName = processName.substr(pos, processName.size() - pos - 1);
  }
 
  // This could be a negated condition, but it is easier to read this way
  //
  auto trackMap{simcore::g4user::TrackingAction::get()->getTrackMap()};
  if (trackID == trackID_ ||  // We are the track of interest
      trackMap.isDescendant(
          trackID, trackID_,
          depth_) ||  // We are a descendent of the track of interest
      processName ==
          processName_  // The parent process was the process of interest
  ) {
    // This is an interesting track -> Carry on processing
  } else {
    return;
  }
  // Get the particle name.
  const auto particleName{track->GetParticleDefinition()->GetParticleName()};
 
  // Get the energy of the particle
  const auto energy{step->GetPostStepPoint()->GetTotalEnergy()};
 
  // Get the volume the particle is in.
  auto volume{track->GetVolume()};
  auto volumeName{volume->GetName()};
 
  // Get the next volume (can fail if current volume is WorldPV and next is
  // outside the world)
  auto nextVolume{track->GetNextVolume() ? track->GetNextVolume()->GetName()
                                         : "undefined"};
 
  // Get the region
  auto regionName{volume->GetLogicalVolume()->GetRegion()->GetName()};
 
  std::cout << " Step " << track->GetCurrentStepNumber() << " ("
            << track->GetParticleDefinition()->GetParticleName() << ") {"
            << " Energy: " << energy << " Track ID: " << track->GetTrackID()
            << " Particle currently in: " << volumeName
            << " Region: " << regionName << " Next volume: " << nextVolume
            << " Weight: " << track->GetWeight() << " Parent: " << parent
            << " (" << processName << ") "
            << " Children:";
  for (auto const& child : *(step->GetSecondaryInCurrentStep())) {
    std::cout << " (" << child->GetTotalEnergy()
              << "): " << child->GetParticleDefinition()->GetPDGEncoding();
  }
 
  std::cout << " }" << std::endl;
}

References simcore::g4user::TrackingAction::get(), simcore::g4user::TrackingAction::getTrackMap(), and trackID_.

Member Data Documentation

depth_

int biasing::utility::StepPrinter::depth_ {0}

private

Definition at line 48 of file StepPrinter.h.

{0};

processName_

std::string biasing::utility::StepPrinter::processName_ {"UNDEFINED"}

private

Definition at line 47 of file StepPrinter.h.

{"UNDEFINED"};

trackID_

int biasing::utility::StepPrinter::trackID_ {-9999}

private

The track ID to filter on.

Definition at line 46 of file StepPrinter.h.

{-9999};

Referenced by stepping(), and StepPrinter().

trackParents_

std::unordered_map<int, int> biasing::utility::StepPrinter::trackParents_ {}

private

Definition at line 49 of file StepPrinter.h.

{};

---

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

• Biasing/include/Biasing/Utility/StepPrinter.h
• Biasing/src/Biasing/Utility/StepPrinter.cxx