MuonR4::MlMsTrackSeeder Class Reference

ITrackSeedingTool implementation which constructs seeds directly from sufficiently large ML-nominated segment components. More...

#include <MlMsTrackSeeder.h>

Inheritance diagram for MuonR4::MlMsTrackSeeder:

Collaboration diagram for MuonR4::MlMsTrackSeeder:

Public Member Functions
StatusCode	initialize () override final
StatusCode	findTrackSeeds (const EventContext &ctx, std::vector< MsTrackSeed > &outSeeds) const override final
	Retrieves the segment container from StoreGate and constructs TrackSeeds from them.
Acts::Result< Acts::BoundTrackParameters >	estimateStartParameters (const EventContext &ctx, const MsTrackSeed &seed) const override final
	Estimate the start track parameters for a given track seed.

Private Attributes
ToolHandle< ITrackSeedingTool >	m_seedParameterEstimator
SG::ReadHandleKey< xAOD::MuonSegmentContainer >	m_segmentKey
Gaudi::Property< std::string >	m_candidateDecoration
SG::ReadDecorHandleKey< xAOD::MuonSegmentContainer >	m_candidateDecorKey
Gaudi::Property< unsigned int >	m_minSegmentsPerCandidate

Detailed Description

ITrackSeedingTool implementation which constructs seeds directly from sufficiently large ML-nominated segment components.

The wrapped conventional tool is used only for initial-parameter estimation; it never constructs seeds for this tool. Consequently MsTrackFindingAlg sees only the standard ITrackSeedingTool interface and selects this implementation entirely through job configuration.

Definition at line 26 of file MlMsTrackSeeder.h.

Member Function Documentation

estimateStartParameters()

Acts::Result< Acts::BoundTrackParameters > MuonR4::MlMsTrackSeeder::estimateStartParameters ( const EventContext & ctx, const MsTrackSeed & seed ) const

finaloverride

Estimate the start track parameters for a given track seed.

Parameters

ctx	EventContext
seed	The track seed for which to estimate start parameters

Returns

The estimated start parameters or an error

Definition at line 94 of file MlMsTrackSeeder.cxx.

                                   {
  return m_seedParameterEstimator->estimateStartParameters(ctx, seed);
}

findTrackSeeds()

StatusCode MuonR4::MlMsTrackSeeder::findTrackSeeds ( const EventContext & ctx, std::vector< MsTrackSeed > & outSeeds ) const

finaloverride

Retrieves the segment container from StoreGate and constructs TrackSeeds from them.

The seed canddiates are pushed to the output seed container

Parameters

ctx	EventContext to access the xAOD::MuonSegmentContainer from store gate and additional conditions data if needed to construct the seed
outSeeds	Mutable reference to the container to whichh the seeds are pushed to.

Definition at line 34 of file MlMsTrackSeeder.cxx.

                                            {
  const xAOD::MuonSegmentContainer* segments{nullptr};
  ATH_CHECK(SG::get(segments, m_segmentKey, ctx));
 
  // The decoration payload is [componentId, isSeedAnchor].
  SG::ReadDecorHandle<xAOD::MuonSegmentContainer, std::vector<unsigned int>>
      componentAcc{m_candidateDecorKey, ctx};
  if (!componentAcc.isAvailable()) {
    ATH_MSG_DEBUG("No ML candidate decoration found");
    return StatusCode::SUCCESS;
  }
 
  std::map<unsigned int, MlComponent> components;
 
  for (const xAOD::MuonSegment* segment : *segments) {
    if (!segment) continue;
    const std::vector<unsigned int>& payload = componentAcc(*segment);
    if (payload.size() != 2 || payload[0] == 0) continue;
    MlComponent& component = components[payload[0]];
    component.segments.push_back(segment);
    if (payload[1] != 0) component.anchors.push_back(segment);
  }
 
  std::size_t acceptedComponents = 0;
  std::size_t constructedSeeds = 0;
  for (const auto& [componentId, component] : components) {
    if (component.segments.size() < m_minSegmentsPerCandidate.value() ||
        component.anchors.empty()) {
      continue;
    }
    ++acceptedComponents;
 
    for (const xAOD::MuonSegment* anchor : component.anchors) {
      const MsTrackSeed::Location location =
          Muon::MuonStationIndex::isBarrel(anchor->chamberIndex())
              ? MsTrackSeed::Location::Barrel
              : MsTrackSeed::Location::Endcap;
      MsTrackSeed seed{location, ExpandedSector{anchor->position().phi()}};
      for (const xAOD::MuonSegment* segment : component.segments) {
        seed.addSegment(segment);
      }
      seed.setPosition(anchor->position());
      outSeeds.push_back(std::move(seed));
      ++constructedSeeds;
    }
    ATH_MSG_VERBOSE("Constructed " << component.anchors.size()
                    << " seed(s) from ML component " << componentId
                    << " with " << component.segments.size()
                    << " segments");
  }
 
  ATH_MSG_DEBUG("Constructed " << constructedSeeds << " seed(s) from "
                << acceptedComponents << "/" << components.size()
                << " decorated ML component(s)");
  return StatusCode::SUCCESS;
}

initialize()

StatusCode MuonR4::MlMsTrackSeeder::initialize ( )

finaloverride

Definition at line 27 of file MlMsTrackSeeder.cxx.

                                       {
  ATH_CHECK(m_seedParameterEstimator.retrieve());
  ATH_CHECK(m_segmentKey.initialize());
  ATH_CHECK(m_candidateDecorKey.initialize());
  return StatusCode::SUCCESS;
}

Member Data Documentation

m_candidateDecoration

Gaudi::Property<std::string> MuonR4::MlMsTrackSeeder::m_candidateDecoration

private

Initial value:

{
      this, "CandidateDecoration", "trackCandidateIds",
      "Segment [componentId, isSeedAnchor] decoration"}

Definition at line 48 of file MlMsTrackSeeder.h.

                                                {
      this, "CandidateDecoration", "trackCandidateIds",
      "Segment [componentId, isSeedAnchor] decoration"};

m_candidateDecorKey

SG::ReadDecorHandleKey<xAOD::MuonSegmentContainer> MuonR4::MlMsTrackSeeder::m_candidateDecorKey

private

Initial value:

{
      this, "CandidateDecoration", m_segmentKey, "trackCandidateIds",
      "Scheduler dependency on the ML candidate decoration"}

Definition at line 51 of file MlMsTrackSeeder.h.

                                                                    {
      this, "CandidateDecoration", m_segmentKey, "trackCandidateIds",
      "Scheduler dependency on the ML candidate decoration"};

m_minSegmentsPerCandidate

Gaudi::Property<unsigned int> MuonR4::MlMsTrackSeeder::m_minSegmentsPerCandidate

private

Initial value:

{
      this, "MinSegmentsPerCandidate", 2}

Definition at line 54 of file MlMsTrackSeeder.h.

                                                       {
      this, "MinSegmentsPerCandidate", 2};

m_seedParameterEstimator

ToolHandle<ITrackSeedingTool> MuonR4::MlMsTrackSeeder::m_seedParameterEstimator

private

Initial value:

{
      this, "BaselineSeeder", "",
      "Tool providing initial-parameter estimates for ML-built seeds"}

Definition at line 43 of file MlMsTrackSeeder.h.

                                                        {
      this, "BaselineSeeder", "",
      "Tool providing initial-parameter estimates for ML-built seeds"};

m_segmentKey

SG::ReadHandleKey<xAOD::MuonSegmentContainer> MuonR4::MlMsTrackSeeder::m_segmentKey

private

Initial value:

{
      this, "SegmentContainer", "MuonSegmentsFromR4"}

Definition at line 46 of file MlMsTrackSeeder.h.

                                                        {
      this, "SegmentContainer", "MuonSegmentsFromR4"};

---

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

• MlMsTrackSeeder.h
• MlMsTrackSeeder.cxx