User action that allows a user to filter out events that are non-fiducial, i.e. More...

#include <NonFiducialFilter.h>

Public Member Functions
	NonFiducialFilter (const std::string &name, framework::config::Parameters &parameters)
	Constructor.

virtual	~NonFiducialFilter ()=default
	Destructor.

void	stepping (const G4Step *step) override
	Implement the stepping action which performs the target volume biasing.

void	EndOfEventAction (const G4Event *) override
	Method called at the end of every event.

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	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
double	recoil_max_p_ {1500}
	Recoil electron threshold.

bool	abort_fiducial_ {true}
	If turned on, this aborts fiducial events.

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 action that allows a user to filter out events that are non-fiducial, i.e.

the electron is not contained in the ECAL and so can act like the signal

Definition at line 36 of file NonFiducialFilter.h.

Constructor & Destructor Documentation

◆ NonFiducialFilter()

NonFiducialFilter::NonFiducialFilter	(	const std::string &	name,
		framework::config::Parameters &	parameters
	)

Constructor.

Definition at line 22 of file NonFiducialFilter.cxx.

    : simcore::UserAction(name, parameters) {
  recoil_max_p_ = parameters.getParameter<double>("recoil_max_p");
  abort_fiducial_ = parameters.getParameter<bool>("abort_fiducial");
}

References abort_fiducial_, framework::config::Parameters::getParameter(), and recoil_max_p_.

Member Function Documentation

◆ EndOfEventAction()

void NonFiducialFilter::EndOfEventAction ( const G4Event * )

overridevirtual

Method called at the end of every event.

Parameters

event Geant4 event object.

Reimplemented from simcore::UserAction.

Definition at line 101 of file NonFiducialFilter.cxx.

                                                       {
  if (nonFiducial_) {
    ldmx_log(debug) << "  >> This event is non-fiducial in ECAL, keeping it";
  } else {
    ldmx_log(debug) << ">> This event is fiducial, exiting";
  }
}

◆ getTypes()

std::vector< simcore::TYPE > biasing::NonFiducialFilter::getTypes ( )

inlineoverridevirtual

Retrieve the type of actions this class defines.

Implements simcore::UserAction.

Definition at line 58 of file NonFiducialFilter.h.

                                             {
    return {simcore::TYPE::EVENT, simcore::TYPE::STACKING,
            simcore::TYPE::STEPPING};
  }

◆ stepping()

void NonFiducialFilter::stepping ( const G4Step * step )

overridevirtual

Implement the stepping action which performs the target volume biasing.

Parameters

step	The Geant4 step.

Reimplemented from simcore::UserAction.

Definition at line 29 of file NonFiducialFilter.cxx.

                                                   {
  // Get the track associated with this step.
  auto track{step->GetTrack()};
 
  // Get the PDG ID of the track and make sure it's an electron.
  if (auto pdgID{track->GetParticleDefinition()->GetPDGEncoding()};
      pdgID != 11) {
    return;
  }
 
  // Only process the primary electron track
  int parentID{step->GetTrack()->GetParentID()};
  if (parentID != 0) {
    return;
  }
 
  // Check in which volume the electron is currently
  auto volume{track->GetVolume()->GetLogicalVolume()
                  ? track->GetVolume()->GetLogicalVolume()->GetName()
                  : "undefined"};
 
  // Check if the track is tagged.
  auto electronCheck{simcore::UserTrackInformation::get(track)};
  if (electronCheck->isRecoilElectron() == true) {
    if (track->GetMomentum().mag() > recoil_max_p_) {
      // Kill the track if its momemntum is too high
      track->SetTrackStatus(fKillTrackAndSecondaries);
      G4RunManager::GetRunManager()->AbortEvent();
      ldmx_log(debug) << " Recoil track momentum is too high, expected to be "
                         "fiducial, exiting\n";
      return;
    }
    // Check if the track ever enters the ECal. If it does, kill the track and
    // abort the event.
    auto isInEcal{((volume.contains("Si") || volume.contains("W") ||
                    volume.contains("PCB") || volume.contains("strongback") ||
                    volume.contains("Glue") || volume.contains("CFMix") ||
                    volume.contains("Al") || volume.contains("C")) &&
                   volume.contains("volume")) ||
                  (volume.contains("nohole_motherboard"))};
 
    // isInEcal should be taken from
    // simcore::logical_volume_tests::isInEcal(volume) but for now it's under
    // its own namespace so I cannot reach it here see issue
    // https://github.com/LDMX-Software/ldmx-sw/issues/1286
    if (abort_fiducial_ && isInEcal) {
      track->SetTrackStatus(fKillTrackAndSecondaries);
      G4RunManager::GetRunManager()->AbortEvent();
      ldmx_log(debug) << ">> This event is fiducial, exiting";
      nonFiducial_ = false;
      return;
    }
    // I comment the following debug out since it would print per step and it's
    // hard to read but it could be otherwise useful if somebody wants to do a
    // step-by-step debugging ldmx_log(debug) << "  >> In this step this is
    // non-fiducial, keeping it so far";
    nonFiducial_ = true;
    return;
  } else {
    // Check if the particle enters the recoil tracker.
    if (volume.compareTo("recoil") == 0) {
      /* Tag the tracks that:
       1) Have a recoil electron
       2) Enter/Exit the Target */
      auto trackInfo{simcore::UserTrackInformation::get(track)};
      trackInfo->tagRecoilElectron();  // tag the target recoil electron
      ldmx_log(debug) << "  >> This track is the recoil electron, tagging it";
      return;
    }
  }
}

References abort_fiducial_, simcore::UserTrackInformation::get(), recoil_max_p_, and simcore::UserTrackInformation::tagRecoilElectron().

Member Data Documentation

◆ abort_fiducial_

bool biasing::NonFiducialFilter::abort_fiducial_ {true}

private

If turned on, this aborts fiducial events.

Definition at line 67 of file NonFiducialFilter.h.

67{true};

Referenced by NonFiducialFilter(), and stepping().

◆ recoil_max_p_

double biasing::NonFiducialFilter::recoil_max_p_ {1500}

private

Recoil electron threshold.

Definition at line 65 of file NonFiducialFilter.h.

65{1500}; // MeV