Public Member Functions
	TrackingRecoDQM (const std::string &name, framework::Process &process)

	~TrackingRecoDQM ()=default
	Destructor.

void	analyze (const framework::Event &event) override
	Process the event and make histograms or summaries.

void	trackMonitoring (const std::vector< ldmx::Track > &tracks, const std::vector< ldmx::Measurement > &measurements, const std::string title, const bool &doDetail, const bool &doTruth)

void	efficiencyPlots (const std::vector< ldmx::Track > &tracks, const std::vector< ldmx::Measurement > &measurements, const std::string &title)

void	trackStateMonitoring (const std::vector< ldmx::Track > &tracks, ldmx::TrackStateType ts_type, const std::string &ts_title)
	Monitoring plots for tracks extrapolated to the ECAL Scoring plane.

void	configure (framework::config::Parameters &parameters) override
	Configure the analyzer using the given user specified parameters.

void	onProcessEnd () override
	Callback for the EventProcessor to take any necessary action when the processing of events finishes, such as calculating job-summary quantities.

void	sortTracks (const std::vector< ldmx::Track > &tracks, std::vector< ldmx::Track > &uniqueTracks, std::vector< ldmx::Track > &duplicateTracks, std::vector< ldmx::Track > &fakeTracks)

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.

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	track_collection_

std::string	truth_collection_

std::string	measurement_collection_

std::string	measurement_passname_

std::string	ecal_sp_coll_name_

std::string	ecal_sp_passname_

std::string	target_sp_coll_name_

std::string	target_sp_passname_

std::string	track_collection_events_passname_

std::string	track_passname_

std::string	truth_events_passname_

std::string	truth_passname_

std::string	title_ {"tagger_trk_"}

double	track_prob_cut_ {0.5}

std::string	subdetector_ {"Tagger"}

bool	do_truth_comparison_ {false}

std::vector< std::string >	track_states_

std::shared_ptr< std::vector< ldmx::Track > >	truth_track_collection_ {nullptr}

std::shared_ptr< std::vector< ldmx::SimTrackerHit > >	ecal_scoring_hits_ {nullptr}

std::shared_ptr< std::vector< ldmx::SimTrackerHit > >	target_scoring_hits_

std::vector< ldmx::Track >	unique_tracks_

std::vector< ldmx::Track >	duplicate_tracks_

std::vector< ldmx::Track >	fake_tracks_

std::map< int, int >	pidmap_

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

Definition at line 28 of file TrackingRecoDQM.h.

Constructor & Destructor Documentation

◆ TrackingRecoDQM()

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

inline

Definition at line 30 of file TrackingRecoDQM.h.

31 : framework::Analyzer(name, process){};

framework::Analyzer

Base class for a module which does not produce a data product.

Definition EventProcessor.h:294

framework::Analyzer::process

virtual void process(Event &event) final

Processing an event for an Analyzer is calling analyze.

Definition EventProcessor.h:316

Member Function Documentation

◆ analyze()

void tracking::dqm::TrackingRecoDQM::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 37 of file TrackingRecoDQM.cxx.

                                                         {
  ldmx_log(trace) << "DQM Reading in:" << track_collection_;
 
  if (!event.exists(track_collection_, track_collection_events_passname_)) {
    ldmx_log(error) << "TrackCollection " << track_collection_
                    << " with pass = " << track_collection_events_passname_
                    << " not in event";
    return;
  }
 
  auto tracks{
      event.getCollection<ldmx::Track>(track_collection_, track_passname_)};
 
  if (!event.exists(measurement_collection_, measurement_passname_)) {
    ldmx_log(error) << "Measurement collection " << measurement_collection_
                    << " with pass = " << measurement_passname_
                    << " not in event";
    return;
  }
 
  auto measurements{event.getCollection<ldmx::Measurement>(
      measurement_collection_, measurement_passname_)};
 
  // The truth track collection
  if (event.exists(truth_collection_, truth_events_passname_)) {
    truth_track_collection_ = std::make_shared<std::vector<ldmx::Track>>(
        event.getCollection<ldmx::Track>(truth_collection_, truth_passname_));
    do_truth_comparison_ = true;
  }
 
  // The scoring plane hits_
  if (event.exists(ecal_sp_coll_name_, ecal_sp_passname_)) {
    ecal_scoring_hits_ = std::make_shared<std::vector<ldmx::SimTrackerHit>>(
        event.getCollection<ldmx::SimTrackerHit>(ecal_sp_coll_name_,
                                                 ecal_sp_passname_));
  }
 
  if (event.exists(target_sp_coll_name_, target_sp_passname_)) {
    target_scoring_hits_ = std::make_shared<std::vector<ldmx::SimTrackerHit>>(
        event.getCollection<ldmx::SimTrackerHit>(target_sp_coll_name_,
                                                 target_sp_passname_));
  }
 
  ldmx_log(debug) << "Do truth comparison::" << do_truth_comparison_;
 
  if (do_truth_comparison_) {
    sortTracks(tracks, unique_tracks_, duplicate_tracks_, fake_tracks_);
  } else {
    unique_tracks_ = tracks;
  }
 
  ldmx_log(debug) << "Filling histograms for " << tracks.size() << " tracks";
 
  // General Plots
  histograms_.fill(title_ + "N_tracks", tracks.size());
 
  if (!unique_tracks_.empty()) {
    ldmx_log(debug) << "Track Monitoring on " << unique_tracks_.size()
                    << " Unique Tracks";
    trackMonitoring(unique_tracks_, measurements, title_, true,
                    do_truth_comparison_);
  }
 
  // Fakes and duplicates
  if (!duplicate_tracks_.empty()) {
    ldmx_log(debug) << "Track Monitoring on " << duplicate_tracks_.size()
                    << " duplicates";
    trackMonitoring(duplicate_tracks_, measurements, title_ + "dup_", false,
                    false);
  }
  if (!fake_tracks_.empty()) {
    ldmx_log(debug) << "Track Monitoring on " << fake_tracks_.size()
                    << " fakes";
    trackMonitoring(fake_tracks_, measurements, title_ + "fake_", false, false);
  }
 
  // Track Extrapolation to Ecal Monitoring
  // trackStateMonitoring requires truth_track_collection_ to be available
  ldmx_log(trace) << "Track Extrapolation to Ecal Monitoring";
  if (do_truth_comparison_) {
    if (std::find(track_states_.begin(), track_states_.end(), "target") !=
        track_states_.end()) {
      trackStateMonitoring(tracks, ldmx::AtTarget, "target");
    }
 
    if (std::find(track_states_.begin(), track_states_.end(), "ecal") !=
        track_states_.end()) {
      trackStateMonitoring(tracks, ldmx::AtECAL, "ecal");
    }
 
    if (std::find(track_states_.begin(), track_states_.end(), "beamOrigin") !=
        track_states_.end()) {
      trackStateMonitoring(tracks, ldmx::AtBeamOrigin, "beamOrigin");
    }
  }
 
  // Technical Efficiency plots
  if (do_truth_comparison_) {
    ldmx_log(trace) << "Technical Efficiency plots";
    efficiencyPlots(tracks, measurements, title_);
  }
 
  // Tagger Recoil Matching
 
  // Clear the vectors
  ldmx_log(trace) << "Clear the vectors";
  unique_tracks_.clear();
  duplicate_tracks_.clear();
  fake_tracks_.clear();
}

References framework::Event::exists(), framework::HistogramPool::fill(), framework::EventProcessor::histograms_, and trackStateMonitoring().

◆ configure()

void tracking::dqm::TrackingRecoDQM::configure ( framework::config::Parameters & parameters )

overridevirtual

Configure the analyzer using the given user specified parameters.

Parameters

parameters Set of parameters used to configure this analyzer.

Reimplemented from framework::EventProcessor.

Definition at line 5 of file TrackingRecoDQM.cxx.

                                                                     {
  track_collection_ = parameters.get<std::string>("track_collection");
  truth_collection_ = parameters.get<std::string>("truth_collection");
  measurement_collection_ =
      parameters.get<std::string>("measurement_collection");
  measurement_passname_ = parameters.get<std::string>("measurement_passname");
 
  ecal_sp_coll_name_ = parameters.get<std::string>("ecal_sp_coll_name");
  ecal_sp_passname_ = parameters.get<std::string>("ecal_sp_passname");
  target_sp_coll_name_ = parameters.get<std::string>("target_sp_coll_name");
  target_sp_passname_ = parameters.get<std::string>("target_sp_passname");
  truth_passname_ = parameters.get<std::string>("truth_passname");
  truth_events_passname_ = parameters.get<std::string>("truth_events_passname");
  track_passname_ = parameters.get<std::string>("track_passname");
  track_collection_events_passname_ =
      parameters.get<std::string>("track_collection_events_passname");
 
  title_ = parameters.get<std::string>("title", "tagger_trk_");
  track_prob_cut_ = parameters.get<double>("trackProb_cut", 0.5);
  subdetector_ = parameters.get<std::string>("subdetector", "Tagger");
  track_states_ = parameters.get<std::vector<std::string>>("track_states", {});
 
  pidmap_[-321] = PIDBins::kminus;
  pidmap_[321] = PIDBins::kplus;
  pidmap_[-211] = PIDBins::piminus;
  pidmap_[211] = PIDBins::piplus;
  pidmap_[11] = PIDBins::electron;
  pidmap_[-11] = PIDBins::positron;
  pidmap_[2212] = PIDBins::proton;
  pidmap_[-2212] = PIDBins::antiproton;
}

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

◆ efficiencyPlots()

void tracking::dqm::TrackingRecoDQM::efficiencyPlots	(	const std::vector< ldmx::Track > &	tracks,
		const std::vector< ldmx::Measurement > &	measurements,
		const std::string &	title )

Definition at line 152 of file TrackingRecoDQM.cxx.

                            {
  // Do all truth track plots - denominator
 
  histograms_.fill(title + "truth_N_tracks", truth_track_collection_->size());
  for (auto& truth_trk : *(truth_track_collection_)) {
    auto truth_phi = truth_trk.getPhi();
    auto truth_d0 = truth_trk.getD0();
    auto truth_z0 = truth_trk.getZ0();
    auto truth_theta = truth_trk.getTheta();
    auto truth_qop = truth_trk.getQoP();
    auto truth_p = 1000. / abs(truth_trk.getQoP());  // MeV
    auto truth_n_hits = truth_trk.getNhits();
 
    auto truth_mom = truth_trk.getMomentumAtTarget();
    double truth_pt_beam{0.}, truth_beam_angle{0.};
    if (truth_mom.size() == 3) {
      truth_pt_beam =
          std::sqrt(truth_mom[0] * truth_mom[0] + truth_mom[1] * truth_mom[1]);
      truth_beam_angle = std::atan2(truth_pt_beam, truth_mom[2]);
    }
 
    histograms_.fill(title + "truth_nHits", truth_n_hits);
    histograms_.fill(title + "truth_d0", truth_d0);
    histograms_.fill(title + "truth_z0", truth_z0);
    histograms_.fill(title + "truth_phi", truth_phi);
    histograms_.fill(title + "truth_theta", truth_theta);
    histograms_.fill(title + "truth_qop", truth_qop);
    histograms_.fill(title + "truth_p", truth_p);
    histograms_.fill(title + "truth_beam_angle", truth_beam_angle);
 
    if (pidmap_.count(truth_trk.getPdgID()) != 0) {
      histograms_.fill(title + "truth_PID", pidmap_[truth_trk.getPdgID()]);
 
      // TODO do this properly.
 
      if (pidmap_[truth_trk.getPdgID()] == PIDBins::kminus) {
        histograms_.fill(title + "truth_kminus_p", truth_p);
      }
 
      if (pidmap_[truth_trk.getPdgID()] == PIDBins::kplus) {
        histograms_.fill(title + "truth_kplus_p", truth_p);
      }
 
      if (pidmap_[truth_trk.getPdgID()] == PIDBins::piminus) {
        histograms_.fill(title + "truth_piminus_p", truth_p);
      }
 
      if (pidmap_[truth_trk.getPdgID()] == PIDBins::piplus) {
        histograms_.fill(title + "truth_piplus_p", truth_p);
      }
 
      if (pidmap_[truth_trk.getPdgID()] == PIDBins::electron) {
        histograms_.fill(title + "truth_electron_p", truth_p);
      }
 
      if (pidmap_[truth_trk.getPdgID()] == PIDBins::positron) {
        histograms_.fill(title + "truth_positron_p", truth_p);
      }
 
      if (pidmap_[truth_trk.getPdgID()] == PIDBins::proton) {
        histograms_.fill(title + "truth_proton_p", truth_p);
      }
    }
 
  }  // loop on truth tracks
 
  for (auto& track : tracks) {
    // Match the tracks to truth
    ldmx::Track* truth_trk = nullptr;
 
    auto it = std::find_if(truth_track_collection_->begin(),
                           truth_track_collection_->end(),
                           [&](const ldmx::Track& tt) {
                             return tt.getTrackID() == track.getTrackID();
                           });
 
    double track_truth_prob = track.getTruthProb();
 
    if (it != truth_track_collection_->end() &&
        track_truth_prob >= track_prob_cut_)
      truth_trk = &(*it);
 
    // Match not found
    if (!truth_trk) return;
 
    auto truth_phi = truth_trk->getPhi();
    auto truth_d0 = truth_trk->getD0();
    auto truth_z0 = truth_trk->getZ0();
    auto truth_theta = truth_trk->getTheta();
    auto truth_qop = truth_trk->getQoP();
    auto truth_p = 1000. / abs(truth_trk->getQoP());  // MeV
 
    auto truth_mom = truth_trk->getMomentumAtTarget();
    double truth_pt_beam{0.}, truth_beam_angle{0.};
    if (truth_mom.size() == 3) {
      truth_pt_beam =
          std::sqrt(truth_mom[0] * truth_mom[0] + truth_mom[1] * truth_mom[1]);
      truth_beam_angle = std::atan2(truth_pt_beam, truth_mom[2]);
    }
 
    // Fill reco plots for efficiencies - numerator. The quantities are truth
    histograms_.fill(title + "match_prob", track_truth_prob);
    histograms_.fill(title + "match_d0", truth_d0);
    histograms_.fill(title + "match_z0", truth_z0);
    histograms_.fill(title + "match_phi", truth_phi);
    histograms_.fill(title + "match_theta", truth_theta);
    histograms_.fill(title + "match_p", truth_p);
    histograms_.fill(title + "match_qop", truth_qop);
    histograms_.fill(title + "match_beam_angle", truth_beam_angle);
    histograms_.fill(title + "match_nHits", measurements.size());
    auto dedx_measurements = track.getDedxMeasurements();
    auto measurement_idxs = track.getMeasurementsIdxs();
    for (size_t i = 0; i < measurement_idxs.size(); ++i) {
      histograms_.fill(title + "match_layers_hit",
                       measurements.at(measurement_idxs[i]).getLayer());
      // Add histogram of the measurement dE/dx
      if (i < dedx_measurements.size()) {
        histograms_.fill(title + "match_measurement_dedx",
                         dedx_measurements[i]);
      }
    }
 
    // For some particles
 
    if (pidmap_.count(truth_trk->getPdgID()) != 0) {
      histograms_.fill(title + "match_PID", pidmap_[truth_trk->getPdgID()]);
 
      // TODO do this properly.
 
      if (pidmap_[truth_trk->getPdgID()] == PIDBins::kminus) {
        histograms_.fill(title + "match_kminus_p", truth_p);
      }
 
      if (pidmap_[truth_trk->getPdgID()] == PIDBins::kplus) {
        histograms_.fill(title + "match_kplus_p", truth_p);
      }
 
      if (pidmap_[truth_trk->getPdgID()] == PIDBins::piminus) {
        histograms_.fill(title + "match_piminus_p", truth_p);
      }
 
      if (pidmap_[truth_trk->getPdgID()] == PIDBins::piplus) {
        histograms_.fill(title + "match_piplus_p", truth_p);
      }
 
      if (pidmap_[truth_trk->getPdgID()] == PIDBins::electron) {
        histograms_.fill(title + "match_electron_p", truth_p);
      }
 
      if (pidmap_[truth_trk->getPdgID()] == PIDBins::positron) {
        histograms_.fill(title + "match_positron_p", truth_p);
      }
 
      if (pidmap_[truth_trk->getPdgID()] == PIDBins::proton) {
        histograms_.fill(title + "match_proton_p", truth_p);
      }
    }
  }  // Loop on tracks
 
}  // Efficiency plots

◆ onProcessEnd()

void tracking::dqm::TrackingRecoDQM::onProcessEnd ( )

overridevirtual

Callback for the EventProcessor to take any necessary action when the processing of events finishes, such as calculating job-summary quantities.

Reimplemented from framework::EventProcessor.

Definition at line 148 of file TrackingRecoDQM.cxx.

                                   {
  // Produce the efficiency plots. (TODO::Switch to TEfficiency instead)
}

◆ sortTracks()

void tracking::dqm::TrackingRecoDQM::sortTracks	(	const std::vector< ldmx::Track > &	tracks,
		std::vector< ldmx::Track > &	uniqueTracks,
		std::vector< ldmx::Track > &	duplicateTracks,
		std::vector< ldmx::Track > &	fakeTracks )

Definition at line 643 of file TrackingRecoDQM.cxx.

                                                                   {
  // Create a copy of the const vector so we can sort it
  std::vector<ldmx::Track> sorted_tracks = tracks;
 
  // Sort the vector of Track objects based on their trackID member
  std::sort(sorted_tracks.begin(), sorted_tracks.end(),
            [](ldmx::Track& t1, ldmx::Track& t2) {
              return t1.getTrackID() < t2.getTrackID();
            });
 
  // Loop over the sorted vector of Track objects
  for (size_t i = 0; i < sorted_tracks.size(); i++) {
    if (sorted_tracks[i].getTruthProb() < track_prob_cut_)
      fakeTracks.push_back(sorted_tracks[i]);
    else {  // not a fake track
      // If this is the first Track object with this trackID, add it to the
      // uniqueTracks vector directly
      if (uniqueTracks.size() == 0 ||
          sorted_tracks[i].getTrackID() != sorted_tracks[i - 1].getTrackID()) {
        uniqueTracks.push_back(sorted_tracks[i]);
      }
      // Otherwise, add it to the duplicateTracks vector if its truthProb is
      // lower than the existing Track object Otherwise, if the truthProbability
      // is higher than the track stored in uniqueTracks, put it in uniqueTracks
      // and move the uniqueTracks.back to duplicateTracks.
      else if (sorted_tracks[i].getTruthProb() >
               uniqueTracks.back().getTruthProb()) {
        duplicateTracks.push_back(uniqueTracks.back());
        uniqueTracks.back() = sorted_tracks[i];
      }
      // Otherwise, add it to the duplicateTracks vector
      else {
        duplicateTracks.push_back(sorted_tracks[i]);
      }
    }  // a real track
  }  // loop on sorted tracks
  // The total number of elements in the uniqueTracks and duplicateTracks
  // vectors should be equal to the number of elements in the original tracks
  // vector
  if (uniqueTracks.size() + duplicateTracks.size() + fakeTracks.size() !=
      tracks.size()) {
    std::cerr << "Error: unique and duplicate tracks vectors do not add up to "
                 "original tracks vector";
    return;
  }
 
  // Iterate through the uniqueTracks vector and duplicateTracks vector
  ldmx_log(trace) << "Unique tracks:";
  for (const ldmx::Track& track : uniqueTracks) {
    ldmx_log(trace) << "\tTrack ID: " << track.getTrackID()
                    << ", Truth Prob: " << track.getTruthProb();
  }
  ldmx_log(trace) << "Duplicate tracks:";
  for (const ldmx::Track& track : duplicateTracks) {
    ldmx_log(trace) << "\tTrack ID: " << track.getTrackID()
                    << ", Truth Prob: " << track.getTruthProb();
  }
  ldmx_log(trace) << "Fake tracks:";
  for (const ldmx::Track& track : fakeTracks) {
    ldmx_log(trace) << "\tTrack ID: " << track.getTrackID()
                    << ", Truth Prob: " << track.getTruthProb();
  }
}

◆ trackMonitoring()

void tracking::dqm::TrackingRecoDQM::trackMonitoring	(	const std::vector< ldmx::Track > &	tracks,
		const std::vector< ldmx::Measurement > &	measurements,
		const std::string	title,
		const bool &	doDetail,
		const bool &	doTruth )

Definition at line 316 of file TrackingRecoDQM.cxx.

                                               {
  for (auto& track : tracks) {
    // Perigee track parameters
    auto trk_d0 = track.getD0();
    auto trk_z0 = track.getZ0();
    auto trk_qop = track.getQoP();
    auto trk_theta = track.getTheta();
    auto trk_phi = track.getPhi();
    auto trk_p = 1000. / abs(trk_qop);  // MeV
    auto dedx_measurements = track.getDedxMeasurements();
    auto measurement_idxs = track.getMeasurementsIdxs();
    for (size_t i = 0; i < measurement_idxs.size(); ++i) {
      histograms_.fill(title + "layers_hit",
                       measurements.at(measurement_idxs[i]).getLayer());
      // Add histogram of the measurement dE/dx
      if (i < dedx_measurements.size()) {
        histograms_.fill(title + "measurement_dedx", dedx_measurements[i]);
      }
    }
 
    // Per-layer unbiased U-residuals — only filled for the main unique-track
    // call (title == title_).  Fakes/duplicates use a different title prefix
    // and do not have these histograms declared.
    //
    // Algebraic leave-one-out unbiasing (NIM A 262, 444, 1987):
    //   r_smooth = m - x_smooth
    //   denom    = V - C          (V = cov_uu, C = smoothed cov[loc0,loc0])
    //   r_ubs    = V / denom * r_smooth
    //   pull     = r_smooth / sqrt(denom)
    if (title == title_) {
      const auto& sm_loc0 = track.getSmoothedLoc0();
      const auto& sm_cov = track.getSmoothedCovLoc0();
      for (size_t i = 0; i < measurement_idxs.size(); ++i) {
        if (i >= sm_loc0.size()) break;
        const auto& meas = measurements.at(measurement_idxs[i]);
        int layer = meas.getLayer();
        float meas_u = meas.getLocalPosition()[0];
        float V = meas.getLocalCovariance()[0];  // cov_uu
        float C = sm_cov[i];                     // smoothed cov[loc0, loc0]
        float denom = V - C;
        if (denom <= 0.f) continue;  // degenerate — skip
        float r_smooth = meas_u - sm_loc0[i];
        float res_ubs = r_smooth * V / denom;
        float pull_ubs = r_smooth / std::sqrt(denom);
        histograms_.fill(title_ + "unbiased_res_u_l" + std::to_string(layer),
                         res_ubs);
        histograms_.fill(title_ + "unbiased_pull_u_l" + std::to_string(layer),
                         pull_ubs);
      }
    }
 
    auto trk_mom = track.getMomentumAtTarget();
    // getMomentumAtTarget() returns MeV (LDMX convention)
    double px_ldmx{0.}, py_ldmx{0.}, pz_ldmx{0.};
    double pt_bending{0.}, pt_beam{0.};
    if (trk_mom.size() == 3) {
      px_ldmx = trk_mom[0];  // MeV
      py_ldmx = trk_mom[1];
      pz_ldmx = trk_mom[2];
      // Bending-plane pT: horizontal (x_ldmx) + downstream (z_ldmx)
      pt_bending = std::sqrt(px_ldmx * px_ldmx + pz_ldmx * pz_ldmx);
      // Transverse pT perpendicular to beam: horizontal + vertical
      pt_beam = std::sqrt(px_ldmx * px_ldmx + py_ldmx * py_ldmx);
    }
 
    // Covariance matrix
    Acts::BoundSquareMatrix cov =
        tracking::sim::utils::unpackCov(track.getPerigeeCov());
 
    double sigmad0 = sqrt(
        cov(Acts::BoundIndices::eBoundLoc0, Acts::BoundIndices::eBoundLoc0));
    double sigmaz0 = sqrt(
        cov(Acts::BoundIndices::eBoundLoc1, Acts::BoundIndices::eBoundLoc1));
    double sigmaphi =
        sqrt(cov(Acts::BoundIndices::eBoundPhi, Acts::BoundIndices::eBoundPhi));
    double sigmatheta = sqrt(
        cov(Acts::BoundIndices::eBoundTheta, Acts::BoundIndices::eBoundTheta));
    double sigmaqop = sqrt(cov(Acts::BoundIndices::eBoundQOverP,
                               Acts::BoundIndices::eBoundQOverP));
    double sigmap =
        (1000. / trk_qop) * (1000. / trk_qop) * sigmaqop / 1000.;  // MeV
 
    histograms_.fill(title + "d0", trk_d0);
    histograms_.fill(title + "z0", trk_z0);
    histograms_.fill(title + "qop", trk_qop);
    histograms_.fill(title + "phi", trk_phi);
    histograms_.fill(title + "theta", trk_theta);
    histograms_.fill(title + "p", trk_p);
 
    if (doDetail) {
      histograms_.fill(title + "px", px_ldmx);
      histograms_.fill(title + "py", py_ldmx);
      histograms_.fill(title + "pz", pz_ldmx);
 
      histograms_.fill(title + "pt_bending", pt_bending);
      histograms_.fill(title + "pt_beam", pt_beam);
 
      histograms_.fill(title + "nHits", track.getNhits());
      histograms_.fill(title + "Chi2", track.getChi2());
      histograms_.fill(title + "ndf", track.getNdf());
      histograms_.fill(title + "Chi2_per_ndf",
                       track.getChi2() / track.getNdf());
      histograms_.fill(title + "nShared", track.getNsharedHits());
 
      histograms_.fill(title + "d0_err", sigmad0);
      histograms_.fill(title + "z0_err", sigmaz0);
      histograms_.fill(title + "phi_err", sigmaphi);
      histograms_.fill(title + "theta_err", sigmatheta);
      histograms_.fill(title + "qop_err", sigmaqop);
      histograms_.fill(title + "p_err", sigmap);
 
      // 2D Error plots (p in MeV)
      histograms_.fill(title + "d0_err_vs_p", trk_p, sigmad0);
      histograms_.fill(title + "z0_err_vs_p", trk_p, sigmaz0);
      histograms_.fill(title + "p_err_vs_p", trk_p, sigmap);
 
      if (track.getNhits() == 8)
        histograms_.fill(title + "p_err_vs_p_8hits", trk_p, sigmap);
      else if (track.getNhits() == 9)
        histograms_.fill(title + "p_err_vs_p_9hits", trk_p, sigmap);
      else if (track.getNhits() == 10)
        histograms_.fill(title + "p_err_vs_p_10hits", trk_p, sigmap);
    }
 
    if (doTruth) {
      // Match to the truth track
      ldmx::Track* truth_trk = nullptr;
 
      auto it = std::find_if(truth_track_collection_->begin(),
                             truth_track_collection_->end(),
                             [&](const ldmx::Track& tt) {
                               return tt.getTrackID() == track.getTrackID();
                             });
 
      double track_truth_prob = track.getTruthProb();
 
      if (it != truth_track_collection_->end() &&
          track_truth_prob >= track_prob_cut_)
        truth_trk = &(*it);
 
      // Found matched track
      if (truth_trk) {
        auto truth_d0 = truth_trk->getD0();
        auto truth_z0 = truth_trk->getZ0();
        auto truth_phi = truth_trk->getPhi();
        auto truth_theta = truth_trk->getTheta();
        auto truth_qop = truth_trk->getQoP();
        auto truth_p = 1000. / abs(truth_trk->getQoP());  // MeV
        auto truth_mom = truth_trk->getMomentumAtTarget();
        // getMomentumAtTarget() returns MeV (LDMX convention)
        double truth_pt_beam{0.};
        if (truth_mom.size() == 3) {
          truth_pt_beam = std::sqrt(truth_mom[0] * truth_mom[0] +
                                    truth_mom[1] * truth_mom[1]);
        }
 
        // histograms_.fill(title+"truth_d0",   truth_d0);
        // histograms_.fill(title+"truth_z0",   truth_z0);
        // histograms_.fill(title+"truth_phi",  truth_phi);
        // histograms_.fill(title+"truth_theta",truth_theta);
        // histograms_.fill(title+"truth_qop",  truth_qop);
        // histograms_.fill(title+"truth_p",    truth_p);
 
        double res_d0 = trk_d0 - truth_d0;
        double res_z0 = trk_z0 - truth_z0;
        double res_phi = trk_phi - truth_phi;
        double res_theta = trk_theta - truth_theta;
        double res_qop = trk_qop - truth_qop;
        double res_p = trk_p - truth_p;
        double res_pt_beam = pt_beam - truth_pt_beam;
 
        histograms_.fill(title + "res_d0", res_d0);
        histograms_.fill(title + "res_z0", res_z0);
        histograms_.fill(title + "res_phi", res_phi);
        histograms_.fill(title + "res_theta", res_theta);
        histograms_.fill(title + "res_qop", res_qop);
        histograms_.fill(title + "res_p", res_p);
        histograms_.fill(title + "res_pt_beam", res_pt_beam);
 
        double pull_d0 = res_d0 / sigmad0;
        double pull_z0 = res_z0 / sigmaz0;
        double pull_phi = res_phi / sigmaphi;
        double pull_theta = res_theta / sigmatheta;
        double pull_qop = res_qop / sigmaqop;
        double pull_p = res_p / sigmap;
 
        histograms_.fill(title + "pull_d0", pull_d0);
        histograms_.fill(title + "pull_z0", pull_z0);
        histograms_.fill(title + "pull_phi", pull_phi);
        histograms_.fill(title + "pull_theta", pull_theta);
        histograms_.fill(title + "pull_qop", pull_qop);
        histograms_.fill(title + "pull_p", pull_p);
 
        // Error plots from residuals
 
        histograms_.fill(title + "res_p_vs_p", truth_p, res_p);
 
        histograms_.fill(title + "res_qop_vs_p", truth_p, res_qop);
        histograms_.fill(title + "res_d0_vs_p", truth_p, res_d0);
        histograms_.fill(title + "res_z0_vs_p", truth_p, res_z0);
        histograms_.fill(title + "res_phi_vs_p", truth_p, res_phi);
        histograms_.fill(title + "res_theta_vs_p", truth_p, res_theta);
 
        histograms_.fill(title + "pull_qop_vs_p", truth_p, pull_qop);
        histograms_.fill(title + "pull_d0_vs_p", truth_p, pull_d0);
        histograms_.fill(title + "pull_z0_vs_p", truth_p, pull_z0);
        histograms_.fill(title + "pull_phi_vs_p", truth_p, pull_phi);
        histograms_.fill(title + "pull_theta_vs_p", truth_p, pull_theta);
 
        if (track.getNhits() == 8)
          histograms_.fill(title + "res_p_vs_p_8hits", truth_p, res_p);
        else if (track.getNhits() == 9)
          histograms_.fill(title + "res_p_vs_p_9hits", truth_p, res_p);
        else if (track.getNhits() == 10)
          histograms_.fill(title + "res_p_vs_p_10hits", truth_p, res_p);
 
        histograms_.fill(title + "res_pt_beam_vs_p", truth_pt_beam,
                         res_pt_beam);
 
      }  // found matched track
    }  // do TruthComparison
  }  // loop on tracks
 
}  // Track Monitoring

◆ trackStateMonitoring()

void tracking::dqm::TrackingRecoDQM::trackStateMonitoring	(	const std::vector< ldmx::Track > &	tracks,
		ldmx::TrackStateType	ts_type,
		const std::string &	ts_title )

Monitoring plots for tracks extrapolated to the ECAL Scoring plane.

This aims Tracks will be truth matched first to get the trackID. The hit with the trackID

Definition at line 544 of file TrackingRecoDQM.cxx.

                               {
  for (auto& track : tracks) {
    // Match the tracks to truth
    ldmx::Track* truth_trk = nullptr;
 
    auto it = std::find_if(truth_track_collection_->begin(),
                           truth_track_collection_->end(),
                           [&](const ldmx::Track& tt) {
                             return tt.getTrackID() == track.getTrackID();
                           });
 
    double track_truth_prob = track.getTruthProb();
 
    if (it != truth_track_collection_->end() &&
        track_truth_prob >= track_prob_cut_)
      truth_trk = &(*it);
 
    // Match not found, skip track
    if (!truth_trk) continue;
 
    auto trk_ts = track.getTrackState(ts_type);
    auto truth_ts = truth_trk->getTrackState(ts_type);
 
    if (!trk_ts.has_value()) continue;
    if (!truth_ts.has_value()) continue;
 
    const ldmx::Track::TrackState& target_state = trk_ts.value();
    const ldmx::Track::TrackState& truth_target_state = truth_ts.value();
 
    // Check that the covariance is filled
    if (target_state.pos_mom_cov_.size() < 21) continue;
 
    // Sigma from Cartesian position covariance (LDMX frame):
    // pos_mom_cov_ upper-triangle layout: xx=0, yy=6
    double sigmaloc0 = std::sqrt(target_state.pos_mom_cov_[0]);  // sigma_x
    double sigmaloc1 = std::sqrt(target_state.pos_mom_cov_[6]);  // sigma_y
 
    double trk_qop = track.getQoP();
    double trk_p = 1000. / abs(trk_qop);  // MeV
 
    // loc0/loc1 = x/y position at the surface in LDMX global frame
    double track_state_loc0 = target_state.pos_[0];
    double track_state_loc1 = target_state.pos_[1];
 
    double truth_state_loc0 = truth_target_state.pos_[0];
    double truth_state_loc1 = truth_target_state.pos_[1];
 
    histograms_.fill(title_ + "trk_" + ts_title + "_loc0", track_state_loc0);
    histograms_.fill(title_ + "trk_" + ts_title + "_loc1", track_state_loc1);
    histograms_.fill(title_ + ts_title + "_truth_loc0", truth_state_loc0);
    histograms_.fill(title_ + ts_title + "_truth_loc1", truth_state_loc1);
 
    // TH1F  residuals
    histograms_.fill(
        title_ + "trk_" + ts_title + "_loc0-truth_" + ts_title + "_loc0",
        track_state_loc0 - truth_state_loc0);
    histograms_.fill(
        title_ + "trk_" + ts_title + "_loc1-truth_" + ts_title + "_loc1",
        track_state_loc1 - truth_state_loc1);
 
    // TH1F  The pulls of loc0 and loc1
    histograms_.fill(title_ + ts_title + "_Pulls_of_loc0",
                     (track_state_loc0 - truth_state_loc0) / sigmaloc0);
    histograms_.fill(title_ + ts_title + "_Pulls_of_loc1",
                     (track_state_loc1 - truth_state_loc1) / sigmaloc1);
 
    // TODO:: TH1F The pulls of phi, theta, qop
 
    // TH2F  residual vs Nhits
    histograms_.fill(title_ + ts_title + "_res_loc0-vs-N_hits",
                     track.getNhits(), track_state_loc0 - truth_state_loc0);
    histograms_.fill(title_ + ts_title + "_res_loc1-vs-N_hits",
                     track.getNhits(), track_state_loc1 - truth_state_loc1);
 
    // TH2F  pulls vs Nhits
    histograms_.fill(title_ + ts_title + "_pulls_loc0-vs-N_hits",
                     track.getNhits(),
                     (track_state_loc0 - truth_state_loc0) / sigmaloc0);
    histograms_.fill(title_ + ts_title + "_pulls_loc1-vs-N_hits",
                     track.getNhits(),
                     (track_state_loc1 - truth_state_loc1) / sigmaloc1);
 
    // TH2F  residual vs trk_p
    histograms_.fill(title_ + ts_title + "_res_loc0-vs-trk_p", trk_p,
                     track_state_loc0 - truth_state_loc0);
    histograms_.fill(title_ + ts_title + "_res_loc1-vs-trk_p", trk_p,
                     track_state_loc1 - truth_state_loc1);
 
    // TH2F  pulls vs trk_p
    histograms_.fill(title_ + ts_title + "_pulls_loc0-vs-trk_p", trk_p,
                     (track_state_loc0 - truth_state_loc0) / sigmaloc0);
    histograms_.fill(title_ + ts_title + "_pulls_loc1-vs-trk_p", trk_p,
                     (track_state_loc1 - truth_state_loc1) / sigmaloc1);
 
  }  // loop on tracks
}

References framework::HistogramPool::fill(), and framework::EventProcessor::histograms_.

Referenced by analyze().

Member Data Documentation

◆ do_truth_comparison_

bool tracking::dqm::TrackingRecoDQM::do_truth_comparison_ {false}

private

Definition at line 90 of file TrackingRecoDQM.h.

90{false};

◆ duplicate_tracks_

std::vector<ldmx::Track> tracking::dqm::TrackingRecoDQM::duplicate_tracks_

private

Definition at line 108 of file TrackingRecoDQM.h.

◆ ecal_scoring_hits_

std::shared_ptr<std::vector<ldmx::SimTrackerHit> > tracking::dqm::TrackingRecoDQM::ecal_scoring_hits_ {nullptr}

private

Definition at line 97 of file TrackingRecoDQM.h.

97{nullptr};

◆ ecal_sp_coll_name_

std::string tracking::dqm::TrackingRecoDQM::ecal_sp_coll_name_

private

Definition at line 78 of file TrackingRecoDQM.h.

◆ ecal_sp_passname_

std::string tracking::dqm::TrackingRecoDQM::ecal_sp_passname_

private

Definition at line 79 of file TrackingRecoDQM.h.

◆ fake_tracks_

std::vector<ldmx::Track> tracking::dqm::TrackingRecoDQM::fake_tracks_

private

Definition at line 110 of file TrackingRecoDQM.h.

◆ measurement_collection_

std::string tracking::dqm::TrackingRecoDQM::measurement_collection_

private

Definition at line 75 of file TrackingRecoDQM.h.

◆ measurement_passname_

std::string tracking::dqm::TrackingRecoDQM::measurement_passname_

private

Definition at line 76 of file TrackingRecoDQM.h.

◆ pidmap_

std::map<int, int> tracking::dqm::TrackingRecoDQM::pidmap_

private

Definition at line 113 of file TrackingRecoDQM.h.

◆ subdetector_

std::string tracking::dqm::TrackingRecoDQM::subdetector_ {"Tagger"}

private

Definition at line 89 of file TrackingRecoDQM.h.

89{"Tagger"};

◆ target_scoring_hits_

std::shared_ptr<std::vector<ldmx::SimTrackerHit> > tracking::dqm::TrackingRecoDQM::target_scoring_hits_

private

Initial value:

{

nullptr}

Definition at line 100 of file TrackingRecoDQM.h.

100 {

101 nullptr};

◆ target_sp_coll_name_

std::string tracking::dqm::TrackingRecoDQM::target_sp_coll_name_

private

Definition at line 80 of file TrackingRecoDQM.h.

◆ target_sp_passname_

std::string tracking::dqm::TrackingRecoDQM::target_sp_passname_

private

Definition at line 81 of file TrackingRecoDQM.h.

◆ title_

std::string tracking::dqm::TrackingRecoDQM::title_ {"tagger_trk_"}

private

Definition at line 87 of file TrackingRecoDQM.h.

87{"tagger_trk_"};

◆ track_collection_

std::string tracking::dqm::TrackingRecoDQM::track_collection_

private

Definition at line 73 of file TrackingRecoDQM.h.

◆ track_collection_events_passname_

std::string tracking::dqm::TrackingRecoDQM::track_collection_events_passname_

private

Definition at line 82 of file TrackingRecoDQM.h.

◆ track_passname_

std::string tracking::dqm::TrackingRecoDQM::track_passname_

private

Definition at line 83 of file TrackingRecoDQM.h.

◆ track_prob_cut_

double tracking::dqm::TrackingRecoDQM::track_prob_cut_ {0.5}

private

Definition at line 88 of file TrackingRecoDQM.h.

88{0.5};

◆ track_states_

std::vector<std::string> tracking::dqm::TrackingRecoDQM::track_states_

private

Definition at line 91 of file TrackingRecoDQM.h.

◆ truth_collection_

std::string tracking::dqm::TrackingRecoDQM::truth_collection_

private

Definition at line 74 of file TrackingRecoDQM.h.

◆ truth_events_passname_

std::string tracking::dqm::TrackingRecoDQM::truth_events_passname_

private

Definition at line 84 of file TrackingRecoDQM.h.

◆ truth_passname_

std::string tracking::dqm::TrackingRecoDQM::truth_passname_

private

Definition at line 85 of file TrackingRecoDQM.h.

◆ truth_track_collection_

std::shared_ptr<std::vector<ldmx::Track> > tracking::dqm::TrackingRecoDQM::truth_track_collection_ {nullptr}

private

Definition at line 94 of file TrackingRecoDQM.h.

94{nullptr};

◆ unique_tracks_

std::vector<ldmx::Track> tracking::dqm::TrackingRecoDQM::unique_tracks_

private

Definition at line 106 of file TrackingRecoDQM.h.

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

Tracking/include/Tracking/dqm/TrackingRecoDQM.h
Tracking/src/Tracking/dqm/TrackingRecoDQM.cxx

Public Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ TrackingRecoDQM()

Member Function Documentation

◆ analyze()

◆ configure()

◆ efficiencyPlots()

◆ onProcessEnd()

◆ sortTracks()

◆ trackMonitoring()

◆ trackStateMonitoring()

Member Data Documentation

◆ do_truth_comparison_

◆ duplicate_tracks_

◆ ecal_scoring_hits_

◆ ecal_sp_coll_name_

◆ ecal_sp_passname_

◆ fake_tracks_

◆ measurement_collection_

◆ measurement_passname_

◆ pidmap_

◆ subdetector_

◆ target_scoring_hits_

◆ target_sp_coll_name_

◆ target_sp_passname_

◆ title_

◆ track_collection_

◆ track_collection_events_passname_

◆ track_passname_

◆ track_prob_cut_

◆ track_states_

◆ truth_collection_

◆ truth_events_passname_

◆ truth_passname_

◆ truth_track_collection_

◆ unique_tracks_