dqm::EcalSPTrackCompare Class Reference

Compare the primary electron at the ECal scoring plane with ECAL tracks reconstructed by ACTS CKF. More...

#include <EcalSPTrackCompare.h>

Public Member Functions
	EcalSPTrackCompare (const std::string &name, framework::Process &process)
void	configure (framework::config::Parameters &ps) override
	Callback for the EventProcessor to configure itself from the given set of parameters.
void	analyze (const framework::Event &event) override
	Process the event and make histograms or summaries.
Public Member Functions inherited from framework::Analyzer
	Analyzer (const std::string &name, Process &process)
	Class constructor.
virtual void	process (Event &event) final
	Processing an event for an Analyzer is calling analyze.
virtual void	beforeNewRun (ldmx::RunHeader &run_header) final
	Don't allow Analyzers to add parameters to the run header.
Public Member Functions inherited from framework::EventProcessor
	DECLARE_FACTORY (EventProcessor, EventProcessor *, const std::string &, Process &)
	declare that we have a factory for this class
	EventProcessor (const std::string &name, Process &process)
	Class constructor.
virtual	~EventProcessor ()=default
	Class destructor.
virtual void	onNewRun (const ldmx::RunHeader &run_header)
	Callback for the EventProcessor to take any necessary action when the run being processed changes.
virtual void	onFileOpen (EventFile &event_file)
	Callback for the EventProcessor to take any necessary action when a new event input ROOT file is opened.
virtual void	onFileClose (EventFile &event_file)
	Callback for the EventProcessor to take any necessary action when a event input ROOT file is closed.
virtual void	onProcessStart ()
	Callback for the EventProcessor to take any necessary action when the processing of events starts, such as creating histograms.
virtual void	onProcessEnd ()
	Callback for the EventProcessor to take any necessary action when the processing of events finishes, such as calculating job-summary quantities.
template<class T >
const T &	getCondition (const std::string &condition_name)
	Access a conditions object for the current event.
TDirectory *	getHistoDirectory ()
	Access/create a directory in the histogram file for this event processor to create histograms and analysis tuples.
void	setStorageHint (framework::StorageControl::Hint hint)
	Mark the current event as having the given storage control hint from this module_.
void	setStorageHint (framework::StorageControl::Hint hint, const std::string &purposeString)
	Mark the current event as having the given storage control hint from this module and the given purpose string.
int	getLogFrequency () const
	Get the current logging frequency from the process.
int	getRunNumber () const
	Get the run number from the process.
std::string	getName () const
	Get the processor name.
void	createHistograms (const std::vector< framework::config::Parameters > &histos)
	Internal function which is used to create histograms passed from the python configuration @parma histos vector of Parameters that configure histograms to create.

Private Attributes
std::string	ecal_sp_coll_name_ {"EcalScoringPlaneHits"}
std::string	ecal_sp_pass_name_ {""}
std::string	track_collection_ {"EcalTracks"}
std::string	track_pass_name_ {""}

Additional Inherited Members
Protected Member Functions inherited from framework::EventProcessor
void	abortEvent ()
	Abort the event immediately.
Protected Attributes inherited from framework::EventProcessor
HistogramPool	histograms_
	helper object for making and filling histograms
NtupleManager &	ntuple_ {NtupleManager::getInstance()}
	Manager for any ntuples.
logging::logger	the_log_
	The logger for this EventProcessor.

Detailed Description

Compare the primary electron at the ECal scoring plane with ECAL tracks reconstructed by ACTS CKF.

Finds the primary beam electron (track ID 1, PDG 11) at scoring plane 31 (ECal front face), then compares its position and direction with each reconstructed EcalTrack. Fills residual histograms for the closest matching track.

Definition at line 21 of file EcalSPTrackCompare.h.

Constructor & Destructor Documentation

EcalSPTrackCompare()

dqm::EcalSPTrackCompare::EcalSPTrackCompare ( const std::string & name, framework::Process & process )

inline

Definition at line 23 of file EcalSPTrackCompare.h.

      : Analyzer(name, process) {}

Member Function Documentation

analyze()

void dqm::EcalSPTrackCompare::analyze ( const framework::Event & event )

overridevirtual

Process the event and make histograms or summaries.

Parameters

event

The Event to analyze

Implements framework::Analyzer.

Definition at line 18 of file EcalSPTrackCompare.cxx.

                                                            {
  // --- Find the primary electron at ECal scoring plane (plane 31) ---
  if (!event.exists(ecal_sp_coll_name_, ecal_sp_pass_name_)) {
    ldmx_log(debug) << "SP collection " << ecal_sp_coll_name_ << " not found";
    return;
  }
 
  const auto& sp_hits = event.getCollection<ldmx::SimTrackerHit>(
      ecal_sp_coll_name_, ecal_sp_pass_name_);
 
  ldmx_log(debug) << "SP hits: " << sp_hits.size();
 
  // Find the highest-momentum forward-going electron at plane 31.
  // In dark brem events the recoil electron has trackID != 1.
  const ldmx::SimTrackerHit* sp_electron = nullptr;
  double best_pz = 0;
  for (const auto& hit : sp_hits) {
    ldmx::SimSpecialID hit_id(hit.getID());
    if (hit_id.plane() != 31) continue;
    if (hit.getPdgID() != 11) continue;
    const auto p = hit.getMomentum();
    if (p[2] <= 0) continue;
    if (p[2] > best_pz) {
      best_pz = p[2];
      sp_electron = &hit;
    }
  }
 
  if (!sp_electron) {
    ldmx_log(debug) << "No forward electron found at ECal SP";
    return;
  }
 
  // Extract SP electron kinematics
  const auto sp_pos = sp_electron->getPosition();
  const auto sp_mom = sp_electron->getMomentum();
  double sp_x = sp_pos[0];
  double sp_y = sp_pos[1];
 
  ldmx_log(debug) << "SP electron: trackID=" << sp_electron->getTrackID()
                  << " pos=(" << sp_x << ", " << sp_y << ") pz=" << best_pz;
  double sp_px = sp_mom[0];
  double sp_py = sp_mom[1];
  double sp_pz = sp_mom[2];
  double sp_p = std::sqrt(sp_px * sp_px + sp_py * sp_py + sp_pz * sp_pz);
  double sp_pt = std::sqrt(sp_px * sp_px + sp_py * sp_py);
  double sp_theta = std::atan2(sp_pt, sp_pz);
  double sp_phi = std::atan2(sp_py, sp_px);
  if (sp_phi < 0) sp_phi += 2.0 * M_PI;  // Shift to [0, 2π]
 
  histograms_.fill("sp_x", sp_x);
  histograms_.fill("sp_y", sp_y);
  histograms_.fill("sp_p", sp_p);
  histograms_.fill("sp_pt", sp_pt);
  histograms_.fill("sp_theta", sp_theta);
  histograms_.fill("sp_phi", sp_phi);
 
  // --- Get reconstructed tracks ---
  if (!event.exists(track_collection_, track_pass_name_)) {
    histograms_.fill("n_tracks", 0);
    histograms_.fill("has_match", 0);
    return;
  }
 
  const auto& tracks =
      event.getCollection<ldmx::Track>(track_collection_, track_pass_name_);
 
  int n_tracks = tracks.size();
  histograms_.fill("n_tracks", n_tracks);
 
  if (n_tracks == 0) {
    histograms_.fill("has_match", 0);
    return;
  }
 
  // --- Find closest track to SP electron ---
  int best_idx = -1;
  double best_dr = 1e9;
 
  for (int i = 0; i < n_tracks; ++i) {
    const auto& track = tracks[i];
    double trk_theta = track.getTheta();
    double trk_phi = track.getPhi();
 
    // Angular distance
    double dtheta = trk_theta - sp_theta;
    double dphi = trk_phi - sp_phi;
    // Wrap dphi to [-pi, pi]
    while (dphi > M_PI) dphi -= 2.0 * M_PI;
    while (dphi < -M_PI) dphi += 2.0 * M_PI;
 
    double dr = std::sqrt(dtheta * dtheta + dphi * dphi);
    if (dr < best_dr) {
      best_dr = dr;
      best_idx = i;
    }
  }
 
  histograms_.fill("has_match", 1);
 
  // --- Fill residuals for the closest track ---
  const auto& best = tracks[best_idx];
 
  // Get track parameters at perigee
  double trk_d0 = best.getD0();
  double trk_phi = best.getPhi();
  double trk_theta = best.getTheta();
  double trk_qop = best.getQoP();
  double trk_p = (std::abs(trk_qop) > 1e-9) ? 1.0 / std::abs(trk_qop) : 0.0;
 
  // Track position at perigee (reference point is at ECAL front face z)
  auto perigee = best.getPerigeeLocation();
  double trk_x = perigee[0] + (-trk_d0 * std::sin(trk_phi));
  double trk_y = perigee[1] + (trk_d0 * std::cos(trk_phi));
 
  ldmx_log(debug) << "Track perigee: (" << perigee[0] << ", " << perigee[1]
                  << ", " << perigee[2] << ")  d0=" << trk_d0;
  ldmx_log(debug) << "Track pos: (" << trk_x << ", " << trk_y
                  << ")  p=" << trk_p << " theta=" << trk_theta
                  << " phi=" << trk_phi;
 
  // Derived track quantities
  double trk_pt = trk_p * std::sin(trk_theta);
 
  // Residuals
  double dx = trk_x - sp_x;
  double dy = trk_y - sp_y;
  double dtheta = trk_theta - sp_theta;
  double dphi = trk_phi - sp_phi;
  while (dphi > M_PI) dphi -= 2.0 * M_PI;
  while (dphi < -M_PI) dphi += 2.0 * M_PI;
  double dp = trk_p - sp_p;
  double dpt = trk_pt - sp_pt;
  double dp_frac = (sp_p > 1.0) ? dp / sp_p : 0.0;
 
  // Track properties
  histograms_.fill("trk_x", trk_x);
  histograms_.fill("trk_y", trk_y);
  histograms_.fill("trk_p", trk_p);
  histograms_.fill("trk_pt", trk_pt);
  histograms_.fill("trk_theta", trk_theta);
  histograms_.fill("trk_phi", trk_phi);
 
  // Residuals
  histograms_.fill("delta_x", dx);
  histograms_.fill("delta_y", dy);
  histograms_.fill("delta_theta", dtheta);
  histograms_.fill("delta_phi", dphi);
  histograms_.fill("delta_p", dp);
  histograms_.fill("delta_pt", dpt);
  histograms_.fill("delta_p_frac", dp_frac);
  histograms_.fill("delta_r", std::sqrt(dx * dx + dy * dy));
  histograms_.fill("delta_angle", best_dr);
 
  // 2D correlations
  histograms_.fill("sp_x_vs_trk_x", sp_x, trk_x);
  histograms_.fill("sp_y_vs_trk_y", sp_y, trk_y);
  histograms_.fill("sp_p_vs_trk_p", sp_p, trk_p);
  histograms_.fill("sp_theta_vs_trk_theta", sp_theta, trk_theta);
}

References framework::Event::exists(), framework::HistogramPool::fill(), ldmx::SimTrackerHit::getMomentum(), ldmx::SimTrackerHit::getPosition(), ldmx::SimTrackerHit::getTrackID(), framework::EventProcessor::histograms_, and ldmx::SimSpecialID::plane().

configure()

void dqm::EcalSPTrackCompare::configure ( framework::config::Parameters & parameters )

overridevirtual

Callback for the EventProcessor to configure itself from the given set of parameters.

The parameters a processor has access to are the member variables of the python class in the sequence that has class_name equal to the EventProcessor class name.

For an example, look at MyProcessor.

Parameters

parameters

Parameters for configuration.

Reimplemented from framework::EventProcessor.

Definition at line 11 of file EcalSPTrackCompare.cxx.

                                                                {
  ecal_sp_coll_name_ = ps.get<std::string>("ecal_sp_coll_name");
  ecal_sp_pass_name_ = ps.get<std::string>("ecal_sp_pass_name");
  track_collection_ = ps.get<std::string>("track_collection");
  track_pass_name_ = ps.get<std::string>("track_pass_name");
}

References framework::config::Parameters::get().

Member Data Documentation

ecal_sp_coll_name_

std::string dqm::EcalSPTrackCompare::ecal_sp_coll_name_ {"EcalScoringPlaneHits"}

private

Definition at line 31 of file EcalSPTrackCompare.h.

{"EcalScoringPlaneHits"};

ecal_sp_pass_name_

std::string dqm::EcalSPTrackCompare::ecal_sp_pass_name_ {""}

private

Definition at line 32 of file EcalSPTrackCompare.h.

{""};

track_collection_

std::string dqm::EcalSPTrackCompare::track_collection_ {"EcalTracks"}

private

Definition at line 33 of file EcalSPTrackCompare.h.

{"EcalTracks"};

track_pass_name_

std::string dqm::EcalSPTrackCompare::track_pass_name_ {""}

private

Definition at line 34 of file EcalSPTrackCompare.h.

{""};

---

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

• DQM/include/DQM/EcalSPTrackCompare.h
• DQM/src/DQM/EcalSPTrackCompare.cxx