Algorithm to handle the phi hough transform. More...

#include <MuonPhiHoughTransformAlg.h>

Inheritance diagram for MuonR4::MuonPhiHoughTransformAlg:

Collaboration diagram for MuonR4::MuonPhiHoughTransformAlg:

Public Member Functions
	MuonPhiHoughTransformAlg (const std::string &name, ISvcLocator *pSvcLocator)

virtual	~MuonPhiHoughTransformAlg ()=default

virtual StatusCode	initialize () override

virtual StatusCode	execute (const EventContext &ctx) const override

virtual StatusCode	sysInitialize () override
	Override sysInitialize. More...

virtual bool	isClonable () const override
	Specify if the algorithm is clonable. More...

virtual unsigned int	cardinality () const override
	Cardinality (Maximum number of clones that can exist) special value 0 means that algorithm is reentrant. More...

virtual StatusCode	sysExecute (const EventContext &ctx) override
	Execute an algorithm. More...

virtual const DataObjIDColl &	extraOutputDeps () const override
	Return the list of extra output dependencies. More...

virtual bool	filterPassed (const EventContext &ctx) const

virtual void	setFilterPassed (bool state, const EventContext &ctx) const

ServiceHandle< StoreGateSvc > &	evtStore ()
	The standard `StoreGateSvc` (event store) Returns (kind of) a pointer to the `StoreGateSvc`. More...

const ServiceHandle< StoreGateSvc > &	evtStore () const
	The standard `StoreGateSvc` (event store) Returns (kind of) a pointer to the `StoreGateSvc`. More...

const ServiceHandle< StoreGateSvc > &	detStore () const
	The standard `StoreGateSvc/DetectorStore` Returns (kind of) a pointer to the `StoreGateSvc`. More...

virtual StatusCode	sysStart () override
	Handle START transition. More...

virtual std::vector< Gaudi::DataHandle * >	inputHandles () const override
	Return this algorithm's input handles. More...

virtual std::vector< Gaudi::DataHandle * >	outputHandles () const override
	Return this algorithm's output handles. More...

Gaudi::Details::PropertyBase &	declareProperty (Gaudi::Property< T > &t)

Gaudi::Details::PropertyBase *	declareProperty (const std::string &name, SG::VarHandleKey &hndl, const std::string &doc, const SG::VarHandleKeyType &)
	Declare a new Gaudi property. More...

Gaudi::Details::PropertyBase *	declareProperty (const std::string &name, SG::VarHandleBase &hndl, const std::string &doc, const SG::VarHandleType &)
	Declare a new Gaudi property. More...

Gaudi::Details::PropertyBase *	declareProperty (const std::string &name, SG::VarHandleKeyArray &hndArr, const std::string &doc, const SG::VarHandleKeyArrayType &)

Gaudi::Details::PropertyBase *	declareProperty (const std::string &name, T &property, const std::string &doc, const SG::NotHandleType &)
	Declare a new Gaudi property. More...

Gaudi::Details::PropertyBase *	declareProperty (const std::string &name, T &property, const std::string &doc="none")
	Declare a new Gaudi property. More...

void	updateVHKA (Gaudi::Details::PropertyBase &)

MsgStream &	msg () const

MsgStream &	msg (const MSG::Level lvl) const

bool	msgLvl (const MSG::Level lvl) const

Protected Member Functions
void	renounceArray (SG::VarHandleKeyArray &handlesArray)
	remove all handles from I/O resolution More...

std::enable_if_t< std::is_void_v< std::result_of_t< decltype(&T::renounce)(T)> > &&!std::is_base_of_v< SG::VarHandleKeyArray, T > &&std::is_base_of_v< Gaudi::DataHandle, T >, void >	renounce (T &h)

void	extraDeps_update_handler (Gaudi::Details::PropertyBase &ExtraDeps)
	Add StoreName to extra input/output deps as needed. More...

Private Types
typedef ServiceHandle< StoreGateSvc >	StoreGateSvc_t

Private Member Functions
template<class ContainerType >
StatusCode	retrieveContainer (const EventContext &ctx, const SG::ReadHandleKey< ContainerType > &key, const ContainerType *&contToPush) const
	Helper method to fetch data from StoreGate. More...

StatusCode	prepareHoughPlane (MuonHoughEventData &data) const
	prepare the hough plane once per event. More...

StatusCode	preProcessMaximum (MuonHoughEventData &data, const MuonR4::HoughMaximum &maximum) const
	pre-processing for a given input eta-maximum Counts potential phi-hits and defines the search space More...

HoughSegmentSeed	recoverSinglePhiMax (MuonHoughEventData &data, const MuonR4::HoughMaximum &maximum) const
	extend an eta maximum with just a single attached phi measurement. More...

std::vector< MuonR4::ActsPeakFinderForMuon::Maximum >	findRankedSegmentSeeds (MuonHoughEventData &data, const MuonR4::HoughMaximum &maximum) const
	perform a hough search for the most promising phi extension of an eta-maximum Performs a local hough transform using the phi-measurements on the maximum and returns the maxima ranked by their compatibility with the eta-measurements on the maximum. More...

int	countIncompatibleEtaHits (const MuonR4::ActsPeakFinderForMuon::Maximum &phiMaximum, const MuonR4::HoughMaximum &etaMaximum) const
	helper to count the number of eta measurements that would be discarded for a given phi extension candidate. More...

MuonR4::HoughSegmentSeed	buildSegmentSeed (const HoughMaximum &etaMax, const MuonR4::ActsPeakFinderForMuon::Maximum &phiMax) const
	constructs a segment seed from an eta maximum and a phi-extension. More...

Gaudi::Details::PropertyBase &	declareGaudiProperty (Gaudi::Property< T > &hndl, const SG::VarHandleKeyType &)
	specialization for handling Gaudi::Property<SG::VarHandleKey> More...

Gaudi::Details::PropertyBase &	declareGaudiProperty (Gaudi::Property< T > &hndl, const SG::VarHandleKeyArrayType &)
	specialization for handling Gaudi::Property<SG::VarHandleKeyArray> More...

Gaudi::Details::PropertyBase &	declareGaudiProperty (Gaudi::Property< T > &hndl, const SG::VarHandleType &)
	specialization for handling Gaudi::Property<SG::VarHandleBase> More...

Gaudi::Details::PropertyBase &	declareGaudiProperty (Gaudi::Property< T > &t, const SG::NotHandleType &)
	specialization for handling everything that's not a Gaudi::Property<SG::VarHandleKey> or a <SG::VarHandleKeyArray> More...

Private Attributes
SG::ReadHandleKey< StationHoughMaxContainer >	m_maxima {this, "StationHoughMaxContainer", "MuonHoughStationMaxima"}

SG::WriteHandleKey< StationHoughSegmentSeedContainer >	m_segmentSeeds {this, "StationHoughSegmentSeedContainer", "MuonHoughStationSegmentSeeds"}

SG::ReadHandleKey< ActsGeometryContext >	m_geoCtxKey {this, "AlignmentKey", "ActsAlignment", "cond handle key"}

DoubleProperty	m_targetResoTanPhi {this, "ResolutionTargetTanAngle", 0.01}

DoubleProperty	m_targetResoIntercept {this, "ResolutionTargetIntercept", 10.}

DoubleProperty	m_minSigmasSearchTanPhi {this, "minSigmasSearchTanPhi", 3.}

DoubleProperty	m_minSigmasSearchIntercept {this, "minSigmasSearchIntercept", 3.}

IntegerProperty	m_nBinsTanPhi {this, "nBinsTanAngle", 15}

IntegerProperty	m_nBinsIntercept {this, "nBinsIntercept", 100}

IntegerProperty	m_maxEtaHolesOnMax {this, "maxEtaHoles", 1}

BooleanProperty	m_recoverSinglePhiWithBS {this, "recoverSinglePhiHitsWithBS", true}

DataObjIDColl	m_extendedExtraObjects
	Extra output dependency collection, extended by AthAlgorithmDHUpdate to add symlinks. More...

StoreGateSvc_t	m_evtStore
	Pointer to StoreGate (event store by default) More...

StoreGateSvc_t	m_detStore
	Pointer to StoreGate (detector store by default) More...

std::vector< SG::VarHandleKeyArray * >	m_vhka

bool	m_varHandleArraysDeclared

Detailed Description

Algorithm to handle the phi hough transform.

This algorithm is responsible for extending existing hough maxima found in a previous eta-transform. It will try to form a phi extension from the phi-sensitive measurements attached to the maximum and remove incompatible ones. It will write MuonSegmentSeeds into the event store for downstream use.

Definition at line 36 of file MuonPhiHoughTransformAlg.h.

Member Typedef Documentation

◆ StoreGateSvc_t

typedef ServiceHandle<StoreGateSvc> AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::StoreGateSvc_t

privateinherited

Definition at line 388 of file AthCommonDataStore.h.

Constructor & Destructor Documentation

◆ MuonPhiHoughTransformAlg()

MuonPhiHoughTransformAlg::MuonPhiHoughTransformAlg	(	const std::string &	name,
		ISvcLocator *	pSvcLocator
	)

Definition at line 14 of file MuonPhiHoughTransformAlg.cxx.

16 : AthReentrantAlgorithm(name, pSvcLocator) {}

◆ ~MuonPhiHoughTransformAlg()

virtual MuonR4::MuonPhiHoughTransformAlg::~MuonPhiHoughTransformAlg ( )

virtualdefault

Member Function Documentation

◆ buildSegmentSeed()

MuonR4::HoughSegmentSeed MuonPhiHoughTransformAlg::buildSegmentSeed	(	const HoughMaximum &	etaMax,
		const MuonR4::ActsPeakFinderForMuon::Maximum &	phiMax
	)		const

private

constructs a segment seed from an eta maximum and a phi-extension.

Will keep all pure eta-measurements on the original maximum and add those eta-phi or pure phi measurements compatible with the extension.

Parameters

etaMax	the eta-maximum
phiMax	the phi-transform maximum

Returns: a HoughSegmentSeed representing the updated candidate

Definition at line 81 of file MuonPhiHoughTransformAlg.cxx.

                                                              {
         // book a new hit list
         std::vector<MuonR4::HoughHitType> hitsOnMax; 
         // copy the pure eta hits onto the hit list 
         std::copy_if(etaMax.getHitsInMax().begin(), etaMax.getHitsInMax().end(), std::back_inserter(hitsOnMax), [](const HoughHitType &hit){
             return (hit->measuresEta() && !hit->measuresPhi()); 
         }); 
         // and then add all hits (2D and pure phi) from the phi-extension to it 
         hitsOnMax.insert(hitsOnMax.end(), phiMax.hitIdentifiers.begin(), phiMax.hitIdentifiers.end()); 
         // use this to construct the segment seed
         return HoughSegmentSeed( etaMax.tanTheta(), etaMax.interceptY(), phiMax.x, phiMax.y, hitsOnMax.size(), std::move(hitsOnMax));         
 }

◆ cardinality()

unsigned int AthReentrantAlgorithm::cardinality ( ) const

overridevirtualinherited

Cardinality (Maximum number of clones that can exist) special value 0 means that algorithm is reentrant.

Override this to return 0 for reentrant algorithms.

Definition at line 55 of file AthReentrantAlgorithm.cxx.

 {
   return 0;
 }

◆ countIncompatibleEtaHits()

int MuonPhiHoughTransformAlg::countIncompatibleEtaHits	(	const MuonR4::ActsPeakFinderForMuon::Maximum &	phiMaximum,
		const MuonR4::HoughMaximum &	etaMaximum
	)		const

private

helper to count the number of eta measurements that would be discarded for a given phi extension candidate.

Correct extensions should have a very small or zero number.

Parameters

phiMaximum	Phi-maximum to evaluate
etaMaximum	Eta-maximum the candidate was obtained from

Definition at line 59 of file MuonPhiHoughTransformAlg.cxx.

                                                 {
     std::unordered_map<const xAOD::UncalibratedMeasurement*, bool> foundEtas;
     // loop over the original eta maximum and check all hits measuring the eta-coordinate 
     for (auto& hit : etaMaximum.getHitsInMax()) {
         if (hit->measuresEta() && hit->measuresPhi()) {
             auto [iter, added] =
                 foundEtas.emplace(hit->primaryMeasurement(), false);
             // test if the PRD for the eta-measurement appears on at least 
             // one space point of this phi extension.
             // This will be done for all space points containing the eta-PRD
             iter->second |= phiMaximum.hitIdentifiers.count(hit);
         }
     }
     // count the number of eta PRD not compatible with this extension.
     return std::count_if(
         foundEtas.begin(), foundEtas.end(),
         [](const std::pair<const xAOD::UncalibratedMeasurement*, bool>& p) {
             return !p.second;
         });
 }

◆ declareGaudiProperty() [1/4]

Gaudi::Details::PropertyBase& AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::declareGaudiProperty	(	Gaudi::Property< T > &	hndl,
		const SG::VarHandleKeyArrayType &
	)

inlineprivateinherited

specialization for handling Gaudi::Property<SG::VarHandleKeyArray>

Definition at line 170 of file AthCommonDataStore.h.

   {
     return *AthCommonDataStore<PBASE>::declareProperty(hndl.name(),
                                                        hndl.value(), 
                                                        hndl.documentation());
  
   }

◆ declareGaudiProperty() [2/4]

Gaudi::Details::PropertyBase& AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::declareGaudiProperty	(	Gaudi::Property< T > &	hndl,
		const SG::VarHandleKeyType &
	)

inlineprivateinherited

specialization for handling Gaudi::Property<SG::VarHandleKey>

Definition at line 156 of file AthCommonDataStore.h.

   {
     return *AthCommonDataStore<PBASE>::declareProperty(hndl.name(),
                                                        hndl.value(), 
                                                        hndl.documentation());
  
   }

◆ declareGaudiProperty() [3/4]

Gaudi::Details::PropertyBase& AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::declareGaudiProperty	(	Gaudi::Property< T > &	hndl,
		const SG::VarHandleType &
	)

inlineprivateinherited

specialization for handling Gaudi::Property<SG::VarHandleBase>

Definition at line 184 of file AthCommonDataStore.h.

   {
     return *AthCommonDataStore<PBASE>::declareProperty(hndl.name(),
                                                        hndl.value(), 
                                                        hndl.documentation());
   }

◆ declareGaudiProperty() [4/4]

Gaudi::Details::PropertyBase& AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::declareGaudiProperty	(	Gaudi::Property< T > &	t,
		const SG::NotHandleType &
	)

inlineprivateinherited

specialization for handling everything that's not a Gaudi::Property<SG::VarHandleKey> or a <SG::VarHandleKeyArray>

Definition at line 199 of file AthCommonDataStore.h.

   {
     return PBASE::declareProperty(t);
   }

◆ declareProperty() [1/6]

Gaudi::Details::PropertyBase* AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::declareProperty	(	const std::string &	name,
		SG::VarHandleBase &	hndl,
		const std::string &	doc,
		const SG::VarHandleType &
	)

inlineinherited

Declare a new Gaudi property.

Parameters

name	Name of the property.
hndl	Object holding the property value.
doc	Documentation string for the property.

This is the version for types that derive from SG::VarHandleBase. The property value object is put on the input and output lists as appropriate; then we forward to the base class.

Definition at line 245 of file AthCommonDataStore.h.

   {
     this->declare(hndl.vhKey());
     hndl.vhKey().setOwner(this);
  
     return PBASE::declareProperty(name,hndl,doc);
   }

◆ declareProperty() [2/6]

Gaudi::Details::PropertyBase* AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::declareProperty	(	const std::string &	name,
		SG::VarHandleKey &	hndl,
		const std::string &	doc,
		const SG::VarHandleKeyType &
	)

inlineinherited

Declare a new Gaudi property.

Parameters

name	Name of the property.
hndl	Object holding the property value.
doc	Documentation string for the property.

This is the version for types that derive from SG::VarHandleKey. The property value object is put on the input and output lists as appropriate; then we forward to the base class.

Definition at line 221 of file AthCommonDataStore.h.

   {
     this->declare(hndl);
     hndl.setOwner(this);
  
     return PBASE::declareProperty(name,hndl,doc);
   }

◆ declareProperty() [3/6]

Gaudi::Details::PropertyBase* AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::declareProperty	(	const std::string &	name,
		SG::VarHandleKeyArray &	hndArr,
		const std::string &	doc,
		const SG::VarHandleKeyArrayType &
	)

inlineinherited

Definition at line 259 of file AthCommonDataStore.h.

   {
  
     // std::ostringstream ost;
     // ost << Algorithm::name() << " VHKA declareProp: " << name 
     //     << " size: " << hndArr.keys().size() 
     //     << " mode: " << hndArr.mode() 
     //     << "  vhka size: " << m_vhka.size()
     //     << "\n";
     // debug() << ost.str() << endmsg;
  
     hndArr.setOwner(this);
     m_vhka.push_back(&hndArr);
  
     Gaudi::Details::PropertyBase* p =  PBASE::declareProperty(name, hndArr, doc);
     if (p != 0) {
       p->declareUpdateHandler(&AthCommonDataStore<PBASE>::updateVHKA, this);
     } else {
       ATH_MSG_ERROR("unable to call declareProperty on VarHandleKeyArray " 
                     << name);
     }
  
     return p;
  
   }

◆ declareProperty() [4/6]

Gaudi::Details::PropertyBase* AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::declareProperty	(	const std::string &	name,
		T &	property,
		const std::string &	doc,
		const SG::NotHandleType &
	)

inlineinherited

Declare a new Gaudi property.

Parameters

name	Name of the property.
property	Object holding the property value.
doc	Documentation string for the property.

This is the generic version, for types that do not derive from SG::VarHandleKey. It just forwards to the base class version of declareProperty.

Definition at line 333 of file AthCommonDataStore.h.

   {
     return PBASE::declareProperty(name, property, doc);
   }

◆ declareProperty() [5/6]

Gaudi::Details::PropertyBase* AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::declareProperty	(	const std::string &	name,
		T &	property,
		const std::string &	doc = `"none"`
	)

inlineinherited

Declare a new Gaudi property.

Parameters

name	Name of the property.
property	Object holding the property value.
doc	Documentation string for the property.

This dispatches to either the generic declareProperty or the one for VarHandle/Key/KeyArray.

Definition at line 352 of file AthCommonDataStore.h.

   {
     typedef typename SG::HandleClassifier<T>::type htype;
     return declareProperty (name, property, doc, htype());
   }

◆ declareProperty() [6/6]

Gaudi::Details::PropertyBase& AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::declareProperty ( Gaudi::Property< T > & t )

inlineinherited

Definition at line 145 of file AthCommonDataStore.h.

                                                                  {
     typedef typename SG::HandleClassifier<T>::type htype;
     return AthCommonDataStore<PBASE>::declareGaudiProperty(t, htype());
   }

◆ detStore()

const ServiceHandle<StoreGateSvc>& AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::detStore ( ) const

inlineinherited

The standard StoreGateSvc/DetectorStore Returns (kind of) a pointer to the StoreGateSvc.

Definition at line 95 of file AthCommonDataStore.h.

95 { return m_detStore; }

◆ evtStore() [1/2]

ServiceHandle<StoreGateSvc>& AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::evtStore ( )

inlineinherited

The standard StoreGateSvc (event store) Returns (kind of) a pointer to the StoreGateSvc.

Definition at line 85 of file AthCommonDataStore.h.

85 { return m_evtStore; }

◆ evtStore() [2/2]

const ServiceHandle<StoreGateSvc>& AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::evtStore ( ) const

inlineinherited

The standard StoreGateSvc (event store) Returns (kind of) a pointer to the StoreGateSvc.

Definition at line 90 of file AthCommonDataStore.h.

90 { return m_evtStore; }

◆ execute()

StatusCode MuonPhiHoughTransformAlg::execute ( const EventContext & ctx ) const

overridevirtual

Definition at line 187 of file MuonPhiHoughTransformAlg.cxx.

                                                                           {
    
     // read the inputs
     const StationHoughMaxContainer* maxima{nullptr};
     ATH_CHECK(retrieveContainer(ctx, m_maxima, maxima));
  
     const ActsGeometryContext* gctx{nullptr};
     ATH_CHECK(retrieveContainer(ctx, m_geoCtxKey, gctx));
  
     // book the event data object
     MuonHoughEventData eventData(*gctx);
  
     // prepare the accumulator
     ATH_CHECK(prepareHoughPlane(eventData));
  
     // prepare our output collection
     SG::WriteHandle<StationHoughSegmentSeedContainer> writeMaxima(
         m_segmentSeeds, ctx);
     ATH_CHECK(writeMaxima.record(
         std::make_unique<StationHoughSegmentSeedContainer>()));
  
     // loop over the previously found eta-maxima for each station
     for (auto& stationAndMax : *maxima) {
         std::vector<MuonR4::HoughSegmentSeed> segmentSeedsInStation;
         for (auto& max : stationAndMax.getMaxima()) {
             // for each maximum, pre-process 
             ATH_CHECK(preProcessMaximum(eventData,max)); 
             bool foundSolution=false; 
             // if we have enough hits, run a phi transform 
             if (eventData.phiHitsOnMax > 1){        
                 std::vector<MuonR4::ActsPeakFinderForMuon::Maximum> rankedSeeds = findRankedSegmentSeeds(eventData, max); 
                 for (auto & phiSolution : rankedSeeds){
                     foundSolution = true; 
                     segmentSeedsInStation.push_back(buildSegmentSeed(max, phiSolution)); 
                 }
             }
             // if we do not have at least two phi-hits for a proper transform: 
             if (!foundSolution){
                 // if we have a single phi hit, we can approximate the phi 
                 // solution using the beam spot (as the IP is far). 
                 // This is steered by a flag, and not appropriate for splashes
                 // or cosmics. 
                 if (m_recoverSinglePhiWithBS && eventData.phiHitsOnMax == 1){
                     segmentSeedsInStation.push_back(recoverSinglePhiMax(eventData,max)); 
                 }
                 // otherwise we have no phi-solution, and we fall back to writing a 1D eta-maximum 
                 else{ 
                     segmentSeedsInStation.push_back(HoughSegmentSeed(max)); 
                 }
             }   
         }
         // add the maxima for this station to the output
         writeMaxima->emplace(StationHoughSegmentSeeds(stationAndMax.chamber(),
                                                       segmentSeedsInStation));
  
     }
     return StatusCode::SUCCESS;
 }

◆ extraDeps_update_handler()

void AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::extraDeps_update_handler ( Gaudi::Details::PropertyBase & ExtraDeps )

protectedinherited

Add StoreName to extra input/output deps as needed.

use the logic of the VarHandleKey to parse the DataObjID keys supplied via the ExtraInputs and ExtraOuputs Properties to add the StoreName if it's not explicitly given

◆ extraOutputDeps()

const DataObjIDColl & AthReentrantAlgorithm::extraOutputDeps ( ) const

overridevirtualinherited

Return the list of extra output dependencies.

This list is extended to include symlinks implied by inheritance relations.

Definition at line 79 of file AthReentrantAlgorithm.cxx.

 {
   // If we didn't find any symlinks to add, just return the collection
   // from the base class.  Otherwise, return the extended collection.
   if (!m_extendedExtraObjects.empty()) {
     return m_extendedExtraObjects;
   }
   return Algorithm::extraOutputDeps();
 }

◆ filterPassed()

virtual bool AthReentrantAlgorithm::filterPassed ( const EventContext & ctx ) const

inlinevirtualinherited

Definition at line 135 of file AthReentrantAlgorithm.h.

                                                            {
     return execState( ctx ).filterPassed();
   }

◆ findRankedSegmentSeeds()

std::vector< MuonR4::ActsPeakFinderForMuon::Maximum > MuonPhiHoughTransformAlg::findRankedSegmentSeeds	(	MuonHoughEventData &	data,
		const MuonR4::HoughMaximum &	maximum
	)		const

private

perform a hough search for the most promising phi extension of an eta-maximum Performs a local hough transform using the phi-measurements on the maximum and returns the maxima ranked by their compatibility with the eta-measurements on the maximum.

Parameters

data	event data object
maximum	eta maximum to extend

Returns: : The best maxima found by the extension (lowest number of eta measurements that would need to be discarded)

Definition at line 141 of file MuonPhiHoughTransformAlg.cxx.

                                                                                                                                                                        {
     std::map<int, std::vector<MuonR4::ActsPeakFinderForMuon::Maximum>>  rankedSeeds;  
     // reset the accumulator
     eventData.houghPlane->reset();
     // fill the accumulator with the phi measurements   
     for (auto hit : maximum.getHitsInMax()){
         if (!hit->measuresPhi())
             continue;
         eventData.houghPlane->fill<HoughHitType>(
             hit, eventData.currAxisRanges,
             MuonR4::HoughHelpers::Phi::houghParamStrip,
             MuonR4::HoughHelpers::Phi::houghWidthStrip, hit, 0, 
             // up-weigh 2D spacepoints w.r.t 1D phi hits to prevent 
             // discarding measurements known to be compatible in eta 
             (hit->measuresEta() ? 2.0 : 1.0)
             );
     }
     // run the peak finder 
     auto foundMaxPhi = eventData.peakFinder->findPeaks(
         *(eventData.houghPlane), eventData.currAxisRanges);
     // now rank the found peaks by the number of eta-compatible PRDs they would discard. 
     for (auto solution : foundMaxPhi) {
         // for each solution, count how many eta PRDs would not be compatible with this phi extension. 
         // rank by the lowest number of such "holes". 
         rankedSeeds[countIncompatibleEtaHits(solution, maximum)].push_back(solution); 
     }
     // return only the best solution(s) 
     auto best = rankedSeeds.begin(); 
     // and apply the maximum hole cut. 
     if (best != rankedSeeds.end() && best->first <= m_maxEtaHolesOnMax){
         return best->second; 
     } 
     return {}; 
 }            

◆ initialize()

StatusCode MuonPhiHoughTransformAlg::initialize ( )

overridevirtual

Definition at line 18 of file MuonPhiHoughTransformAlg.cxx.

                                                 {
     ATH_CHECK(m_geoCtxKey.initialize());
     ATH_CHECK(m_maxima.initialize());
     ATH_CHECK(m_segmentSeeds.initialize());
  
     return StatusCode::SUCCESS;
 }

◆ inputHandles()

virtual std::vector<Gaudi::DataHandle*> AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::inputHandles ( ) const

overridevirtualinherited

Return this algorithm's input handles.

We override this to include handle instances from key arrays if they have not yet been declared. See comments on updateVHKA.

◆ isClonable()

bool AthReentrantAlgorithm::isClonable ( ) const

overridevirtualinherited

Specify if the algorithm is clonable.

Reentrant algorithms are clonable.

Reimplemented in Simulation::BeamEffectsAlg, InDet::SiTrackerSpacePointFinder, InDet::SCT_Clusterization, InDet::SiSPSeededTrackFinder, SCTRawDataProvider, InDet::GNNSeedingTrackMaker, SCT_PrepDataToxAOD, RoIBResultToxAOD, SCT_CablingCondAlgFromCoraCool, SCT_ReadCalibDataTestAlg, SCT_CablingCondAlgFromText, InDet::SiSPGNNTrackMaker, SCT_ReadCalibChipDataTestAlg, SCT_TestCablingAlg, SCT_ConfigurationConditionsTestAlg, ITkPixelCablingAlg, SCTEventFlagWriter, SCT_ConditionsSummaryTestAlg, SCT_ModuleVetoTestAlg, SCT_MonitorConditionsTestAlg, SCT_LinkMaskingTestAlg, SCT_MajorityConditionsTestAlg, SCT_RODVetoTestAlg, SCT_SensorsTestAlg, SCT_TdaqEnabledTestAlg, SCT_SiliconConditionsTestAlg, SCTSiLorentzAngleTestAlg, SCT_ByteStreamErrorsTestAlg, SCT_ConditionsParameterTestAlg, SCT_FlaggedConditionTestAlg, SCT_StripVetoTestAlg, SCT_RawDataToxAOD, and SCTSiPropertiesTestAlg.

Definition at line 44 of file AthReentrantAlgorithm.cxx.

 {
   // Reentrant algorithms are clonable.
   return true;
 }

◆ msg() [1/2]

MsgStream& AthCommonMsg< Gaudi::Algorithm >::msg ( ) const

inlineinherited

Definition at line 24 of file AthCommonMsg.h.

                                 {
     return this->msgStream();
   }

◆ msg() [2/2]

MsgStream& AthCommonMsg< Gaudi::Algorithm >::msg ( const MSG::Level lvl ) const

inlineinherited

Definition at line 27 of file AthCommonMsg.h.

                                                   {
     return this->msgStream(lvl);
   }

◆ msgLvl()

bool AthCommonMsg< Gaudi::Algorithm >::msgLvl ( const MSG::Level lvl ) const

inlineinherited

Definition at line 30 of file AthCommonMsg.h.

                                                {
     return this->msgLevel(lvl);
   }

◆ outputHandles()

virtual std::vector<Gaudi::DataHandle*> AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::outputHandles ( ) const

overridevirtualinherited

Return this algorithm's output handles.

We override this to include handle instances from key arrays if they have not yet been declared. See comments on updateVHKA.

◆ prepareHoughPlane()

StatusCode MuonPhiHoughTransformAlg::prepareHoughPlane ( MuonHoughEventData & data ) const

private

prepare the hough plane once per event.

Books the accumulator and attaches it to the event data

Parameters

data	Event data object

Returns: a status code

Definition at line 42 of file MuonPhiHoughTransformAlg.cxx.

                                     {
     HoughPlaneConfig cfg;
     cfg.nBinsX = m_nBinsTanPhi;
     cfg.nBinsY = m_nBinsIntercept;
     // configure the peak finder for the phi-extension. 
     // Expect "shallow" maxima with 2-3 hits. 
     ActsPeakFinderForMuonCfg peakFinderCfg;
     peakFinderCfg.fractionCutoff = 0.4;
     peakFinderCfg.threshold = 2;    // 2D spacepoints receive a weight of 2
     peakFinderCfg.minSpacingBetweenPeaks = {0., 30.};
     data.houghPlane = std::make_unique<HoughPlane>(cfg);
     data.peakFinder = std::make_unique<ActsPeakFinderForMuon>(peakFinderCfg);
  
     return StatusCode::SUCCESS;
 }

◆ preProcessMaximum()

StatusCode MuonPhiHoughTransformAlg::preProcessMaximum	(	MuonHoughEventData &	data,
		const MuonR4::HoughMaximum &	maximum
	)		const

private

pre-processing for a given input eta-maximum Counts potential phi-hits and defines the search space

Parameters

data	Event data object
maximum	An (eta) maximum

Returns: a status code

Definition at line 96 of file MuonPhiHoughTransformAlg.cxx.

                                                                                                                               {
     // reset the event data 
     eventData.phiHitsOnMax = 0; 
     eventData.searchSpaceTanAngle = std::make_pair(1e10, -1e10); 
     eventData.searchSpaceIntercept = std::make_pair(1e10, -1e10); 
     // loop over the measurements on the maximum
     for (auto hit : maximum.getHitsInMax()) {
         // reject the pure eta measurements - not relevant here
         if (!hit->measuresPhi())
             continue;
         // find the direction of the IP viewed from the chamber frame 
         Amg::Vector3D extrapDir = (hit->positionInChamber() - hit->muonChamber()->globalToLocalTrans(eventData.gctx).translation()).unit(); 
         // express the x location of our phi hits on the chamber plane (z = 0) when projecting from the beam spot
         std::optional<double> dummyIntercept = Amg::intersect<3>(hit->positionInChamber(),extrapDir,Amg::Vector3D::UnitZ(),0); 
         double x0 = (hit->positionInChamber() + dummyIntercept.value_or(0) * extrapDir).x(); 
         // now we can obtain the most likely tan(phi) via the pointing vector from the origin to our hit
         double tanPhi = extrapDir.x()/extrapDir.z(); 
         // update our search space with this info 
         MuonR4::updateSearchWindow(eventData.searchSpaceTanAngle, tanPhi);
         MuonR4::updateSearchWindow(eventData.searchSpaceIntercept, x0);
         // and increment the hit counter
         ++ eventData.phiHitsOnMax; 
     }
     // now use the results from the individual hits to define an axis range adapted to the binning we desire 
     double chamberCenter = (eventData.searchSpaceIntercept.second + eventData.searchSpaceIntercept.first) * 0.5; 
     double searchStart = chamberCenter - 0.5 * eventData.houghPlane->nBinsY() * m_targetResoIntercept; 
     double searchEnd = chamberCenter + 0.5 * eventData.houghPlane->nBinsY()  * m_targetResoIntercept; 
     // Protection for very wide buckets - if the search space does not cover all of the bucket, widen the bin size 
     // so that we cover everything  
     searchStart = std::min(searchStart, eventData.searchSpaceIntercept.first- m_minSigmasSearchIntercept * m_targetResoIntercept); 
     searchEnd = std::max(searchEnd, eventData.searchSpaceIntercept.second + m_minSigmasSearchIntercept * m_targetResoIntercept); 
     // also treat tan(phi) 
     double tanPhiMean = 0.5 * (eventData.searchSpaceTanAngle.first + eventData.searchSpaceTanAngle.second); 
     double searchStartTanPhi = tanPhiMean - 0.5 *  eventData.houghPlane->nBinsX() * m_targetResoTanPhi; 
     double searchEndTanPhi = tanPhiMean + 0.5* eventData.houghPlane->nBinsX() * m_targetResoTanPhi; 
     searchStartTanPhi = std::min(searchStartTanPhi, eventData.searchSpaceTanAngle.first- m_minSigmasSearchTanPhi * m_targetResoTanPhi); 
     searchEndTanPhi = std::max(searchEndTanPhi, eventData.searchSpaceTanAngle.second + m_minSigmasSearchTanPhi * m_targetResoTanPhi); 
  
     // and update the axis ranges for the search space according to our results
     eventData.currAxisRanges =
     Acts::HoughTransformUtils::HoughAxisRanges{searchStartTanPhi, searchEndTanPhi, searchStart, searchEnd};
  
     return StatusCode::SUCCESS; 
 }

◆ recoverSinglePhiMax()

HoughSegmentSeed MuonPhiHoughTransformAlg::recoverSinglePhiMax	(	MuonHoughEventData &	data,
		const MuonR4::HoughMaximum &	maximum
	)		const

private

extend an eta maximum with just a single attached phi measurement.

Uses the beam spot direction to guess an approximate phi-intercept and direction.

Parameters

data	event data object
maximum	eta-maximum to extend

Returns: a HoughSegmentSeed extended using the pointing assumption

Definition at line 175 of file MuonPhiHoughTransformAlg.cxx.

                                                                                                                                  {
     // recovers cases of a single phi hit assuming a straight 
     // line extrapolation from the beam line to the phi measurement
     return HoughSegmentSeed(maximum.tanTheta(), maximum.interceptY(), 
                             data.searchSpaceTanAngle.first, 
                             data.searchSpaceIntercept.first, 
                             maximum.getCounts(), 
                             std::vector<HoughHitType>(maximum.getHitsInMax())); 
  
 } 

◆ renounce()

std::enable_if_t<std::is_void_v<std::result_of_t<decltype(&T::renounce)(T)> > && !std::is_base_of_v<SG::VarHandleKeyArray, T> && std::is_base_of_v<Gaudi::DataHandle, T>, void> AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::renounce ( T & h )

inlineprotectedinherited

Definition at line 380 of file AthCommonDataStore.h.

   {
     h.renounce();
     PBASE::renounce (h);
   }

◆ renounceArray()

void AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::renounceArray ( SG::VarHandleKeyArray & handlesArray )

inlineprotectedinherited

remove all handles from I/O resolution

Definition at line 364 of file AthCommonDataStore.h.

                                                           {
     handlesArray.renounce();
   }

◆ retrieveContainer()

template<class ContainerType >

StatusCode MuonPhiHoughTransformAlg::retrieveContainer	(	const EventContext &	ctx,
		const SG::ReadHandleKey< ContainerType > &	key,
		const ContainerType *&	contToPush
	)		const

private

Helper method to fetch data from StoreGate.

If the key is empty, a nullptr is assigned to the container ptr Failure is returned in cases, of non-empty keys and failed retrieval

Definition at line 27 of file MuonPhiHoughTransformAlg.cxx.

                                             {
     contToPush = nullptr;
     if (key.empty()) {
         ATH_MSG_VERBOSE("No key has been parsed for object "
                         << typeid(ContainerType).name());
         return StatusCode::SUCCESS;
     }
     SG::ReadHandle<ContainerType> readHandle{key, ctx};
     ATH_CHECK(readHandle.isPresent());
     contToPush = readHandle.cptr();
     return StatusCode::SUCCESS;
 }

◆ setFilterPassed()

virtual void AthReentrantAlgorithm::setFilterPassed	(	bool	state,
		const EventContext &	ctx
	)		const

inlinevirtualinherited

Definition at line 139 of file AthReentrantAlgorithm.h.

                                                                             {
     execState( ctx ).setFilterPassed( state );
   }

◆ sysExecute()

StatusCode AthReentrantAlgorithm::sysExecute ( const EventContext & ctx )

overridevirtualinherited

Execute an algorithm.

We override this in order to work around an issue with the Algorithm base class storing the event context in a member variable that can cause crashes in MT jobs.

Definition at line 67 of file AthReentrantAlgorithm.cxx.

 {
   return Gaudi::Algorithm::sysExecute (ctx);
 }

◆ sysInitialize()

StatusCode AthReentrantAlgorithm::sysInitialize ( )

overridevirtualinherited

Override sysInitialize.

Override sysInitialize from the base class.

Loop through all output handles, and if they're WriteCondHandles, automatically register them and this Algorithm with the CondSvc

Scan through all outputHandles, and if they're WriteCondHandles, register them with the CondSvc

Reimplemented from AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >.

Reimplemented in InputMakerBase, and HypoBase.

Definition at line 96 of file AthReentrantAlgorithm.cxx.

                                                 {
   StatusCode sc=AthCommonDataStore<AthCommonMsg<Gaudi::Algorithm>>::sysInitialize();
  
   if (sc.isFailure()) {
     return sc;
   }
   
   ServiceHandle<ICondSvc> cs("CondSvc",name());
   for (auto h : outputHandles()) {
     if (h->isCondition() && h->mode() == Gaudi::DataHandle::Writer) {
       // do this inside the loop so we don't create the CondSvc until needed
       if ( cs.retrieve().isFailure() ) {
         ATH_MSG_WARNING("no CondSvc found: won't autoreg WriteCondHandles");
         return StatusCode::SUCCESS;
       }      
       if (cs->regHandle(this,*h).isFailure()) {
         sc = StatusCode::FAILURE;
         ATH_MSG_ERROR("unable to register WriteCondHandle " << h->fullKey()
                       << " with CondSvc");
       }
     }
   }
   return sc;  
 }

◆ sysStart()

virtual StatusCode AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::sysStart ( )

overridevirtualinherited

Handle START transition.

We override this in order to make sure that conditions handle keys can cache a pointer to the conditions container.

◆ updateVHKA()

void AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::updateVHKA ( Gaudi::Details::PropertyBase & )

inlineinherited

Definition at line 308 of file AthCommonDataStore.h.

                                                {
     // debug() << "updateVHKA for property " << p.name() << " " << p.toString() 
     //         << "  size: " << m_vhka.size() << endmsg;
     for (auto &a : m_vhka) {
       std::vector<SG::VarHandleKey*> keys = a->keys();
       for (auto k : keys) {
         k->setOwner(this);
       }
     }
   }

Member Data Documentation

◆ m_detStore

StoreGateSvc_t AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::m_detStore

privateinherited

Pointer to StoreGate (detector store by default)

Definition at line 393 of file AthCommonDataStore.h.

◆ m_evtStore

StoreGateSvc_t AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::m_evtStore

privateinherited

Pointer to StoreGate (event store by default)

Definition at line 390 of file AthCommonDataStore.h.

◆ m_extendedExtraObjects

DataObjIDColl AthReentrantAlgorithm::m_extendedExtraObjects

privateinherited

Extra output dependency collection, extended by AthAlgorithmDHUpdate to add symlinks.

Empty if no symlinks were found.

Definition at line 153 of file AthReentrantAlgorithm.h.

◆ m_geoCtxKey

SG::ReadHandleKey<ActsGeometryContext> MuonR4::MuonPhiHoughTransformAlg::m_geoCtxKey {this, "AlignmentKey", "ActsAlignment", "cond handle key"}

private

Definition at line 99 of file MuonPhiHoughTransformAlg.h.

◆ m_maxEtaHolesOnMax

IntegerProperty MuonR4::MuonPhiHoughTransformAlg::m_maxEtaHolesOnMax {this, "maxEtaHoles", 1}

private

Definition at line 119 of file MuonPhiHoughTransformAlg.h.

◆ m_maxima

SG::ReadHandleKey<StationHoughMaxContainer> MuonR4::MuonPhiHoughTransformAlg::m_maxima {this, "StationHoughMaxContainer", "MuonHoughStationMaxima"}

private

Definition at line 94 of file MuonPhiHoughTransformAlg.h.

◆ m_minSigmasSearchIntercept

DoubleProperty MuonR4::MuonPhiHoughTransformAlg::m_minSigmasSearchIntercept {this, "minSigmasSearchIntercept", 3.}

private

Definition at line 110 of file MuonPhiHoughTransformAlg.h.

◆ m_minSigmasSearchTanPhi

DoubleProperty MuonR4::MuonPhiHoughTransformAlg::m_minSigmasSearchTanPhi {this, "minSigmasSearchTanPhi", 3.}

private

Definition at line 107 of file MuonPhiHoughTransformAlg.h.

◆ m_nBinsIntercept

IntegerProperty MuonR4::MuonPhiHoughTransformAlg::m_nBinsIntercept {this, "nBinsIntercept", 100}

private

Definition at line 116 of file MuonPhiHoughTransformAlg.h.

◆ m_nBinsTanPhi

IntegerProperty MuonR4::MuonPhiHoughTransformAlg::m_nBinsTanPhi {this, "nBinsTanAngle", 15}

private

Definition at line 114 of file MuonPhiHoughTransformAlg.h.

◆ m_recoverSinglePhiWithBS

BooleanProperty MuonR4::MuonPhiHoughTransformAlg::m_recoverSinglePhiWithBS {this, "recoverSinglePhiHitsWithBS", true}

private

Definition at line 122 of file MuonPhiHoughTransformAlg.h.

◆ m_segmentSeeds

SG::WriteHandleKey<StationHoughSegmentSeedContainer> MuonR4::MuonPhiHoughTransformAlg::m_segmentSeeds {this, "StationHoughSegmentSeedContainer", "MuonHoughStationSegmentSeeds"}

private

Definition at line 96 of file MuonPhiHoughTransformAlg.h.

◆ m_targetResoIntercept

DoubleProperty MuonR4::MuonPhiHoughTransformAlg::m_targetResoIntercept {this, "ResolutionTargetIntercept", 10.}

private

Definition at line 104 of file MuonPhiHoughTransformAlg.h.

◆ m_targetResoTanPhi

DoubleProperty MuonR4::MuonPhiHoughTransformAlg::m_targetResoTanPhi {this, "ResolutionTargetTanAngle", 0.01}

private

Definition at line 102 of file MuonPhiHoughTransformAlg.h.

◆ m_varHandleArraysDeclared

bool AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::m_varHandleArraysDeclared

privateinherited

Definition at line 399 of file AthCommonDataStore.h.

◆ m_vhka

std::vector<SG::VarHandleKeyArray*> AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::m_vhka

privateinherited

Definition at line 398 of file AthCommonDataStore.h.

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

Public Member Functions

Protected Member Functions

Private Types

Private Member Functions

Private Attributes

Detailed Description

Member Typedef Documentation

◆ StoreGateSvc_t

Constructor & Destructor Documentation

◆ MuonPhiHoughTransformAlg()

◆ ~MuonPhiHoughTransformAlg()

Member Function Documentation

◆ buildSegmentSeed()

◆ cardinality()

◆ countIncompatibleEtaHits()

◆ declareGaudiProperty() [1/4]

◆ declareGaudiProperty() [2/4]

◆ declareGaudiProperty() [3/4]

◆ declareGaudiProperty() [4/4]

◆ declareProperty() [1/6]

◆ declareProperty() [2/6]

◆ declareProperty() [3/6]

◆ declareProperty() [4/6]

◆ declareProperty() [5/6]

◆ declareProperty() [6/6]

◆ detStore()

◆ evtStore() [1/2]

◆ evtStore() [2/2]

◆ execute()

◆ extraDeps_update_handler()

◆ extraOutputDeps()

◆ filterPassed()

◆ findRankedSegmentSeeds()

◆ initialize()

◆ inputHandles()

◆ isClonable()

◆ msg() [1/2]

◆ msg() [2/2]

◆ msgLvl()

◆ outputHandles()

◆ prepareHoughPlane()

◆ preProcessMaximum()

◆ recoverSinglePhiMax()

◆ renounce()

◆ renounceArray()

◆ retrieveContainer()

◆ setFilterPassed()

◆ sysExecute()

◆ sysInitialize()

◆ sysStart()

◆ updateVHKA()

Member Data Documentation

◆ m_detStore

◆ m_evtStore

◆ m_extendedExtraObjects

◆ m_geoCtxKey

◆ m_maxEtaHolesOnMax

◆ m_maxima

◆ m_minSigmasSearchIntercept

◆ m_minSigmasSearchTanPhi

◆ m_nBinsIntercept

◆ m_nBinsTanPhi

◆ m_recoverSinglePhiWithBS

◆ m_segmentSeeds

◆ m_targetResoIntercept

◆ m_targetResoTanPhi

◆ m_varHandleArraysDeclared

◆ m_vhka