Interface class to refine the space point calibration with an external seed. More...

#include <ISpacePointCalibrator.h>

Inheritance diagram for MuonR4::ISpacePointCalibrator:

Collaboration diagram for MuonR4::ISpacePointCalibrator:

Public Types
using	CalibSpacePointPtr = std::unique_ptr< CalibratedSpacePoint >

using	CalibSpacePointVec = std::vector< CalibSpacePointPtr >

Public Member Functions
	DeclareInterfaceID (ISpacePointCalibrator, 1, 0)

virtual	~ISpacePointCalibrator ()=default

virtual CalibSpacePointPtr	calibrate (const EventContext &ctx, const SpacePoint *spacePoint, const Amg::Vector3D &seedPosInChamb, const Amg::Vector3D &seedDirInChamb, const double timeDelay) const =0
	Calibrates a single space point. More...

virtual CalibSpacePointPtr	calibrate (const EventContext &ctx, const CalibratedSpacePoint &spacePoint, const Amg::Vector3D &seedPosInChamb, const Amg::Vector3D &seedDirInChamb, const double timeDelay) const =0
	Calibrates a single space point. More...

virtual CalibSpacePointVec	calibrate (const EventContext &ctx, const std::vector< const SpacePoint * > &spacePoints, const Amg::Vector3D &seedPosInChamb, const Amg::Vector3D &seedDirInChamb, const double timeDelay) const =0
	Calibrates a set of space points. More...

virtual CalibSpacePointVec	calibrate (const Acts::CalibrationContext &cctx, const Amg::Vector3D &seedPosInChamb, const Amg::Vector3D &seedDirInChamb, const double timeDelay, const CalibSpacePointVec &spacePoints) const =0
	Refines the calibration constants of already calibrated space points. More...

virtual double	driftVelocity (const Acts::CalibrationContext &cctx, const CalibratedSpacePoint &spacePoint) const =0
	Returns the drift velocity for a given drift-circle space point. More...

virtual double	driftAcceleration (const Acts::CalibrationContext &cctx, const CalibratedSpacePoint &spacePoint) const =0
	Returns the drift acceleration for a given drift-circle space point. More...

virtual void	calibrateSourceLink (const Acts::GeometryContext &geoctx, const Acts::CalibrationContext &cctx, const Acts::SourceLink &link, ActsTrk::MutableTrackStateBackend::TrackStateProxy state) const =0
	Function that's hooked to the calibration delegate of the implemented Acts fitters. More...

virtual void	updateSigns (const Amg::Vector3D &trackPos, const Amg::Vector3D &trackDir, CalibSpacePointVec &hitsToCalib) const =0
	Update the signs of the drift radii for a given straight line track to fix the left <-> right ambiguity. More...

virtual void	stampSignsOnMeasurements (const xAOD::MuonSegment &segment) const =0
	Stamps the signs of the drift radii w.r.t. More...

Detailed Description

Interface class to refine the space point calibration with an external seed.

Definition at line 33 of file ISpacePointCalibrator.h.

Member Typedef Documentation

◆ CalibSpacePointPtr

using MuonR4::ISpacePointCalibrator::CalibSpacePointPtr = std::unique_ptr<CalibratedSpacePoint>

Definition at line 39 of file ISpacePointCalibrator.h.

◆ CalibSpacePointVec

using MuonR4::ISpacePointCalibrator::CalibSpacePointVec = std::vector<CalibSpacePointPtr>

Definition at line 40 of file ISpacePointCalibrator.h.

Constructor & Destructor Documentation

◆ ~ISpacePointCalibrator()

virtual MuonR4::ISpacePointCalibrator::~ISpacePointCalibrator ( )

virtualdefault

Member Function Documentation

◆ calibrate() [1/4]

virtual CalibSpacePointVec MuonR4::ISpacePointCalibrator::calibrate	(	const Acts::CalibrationContext &	cctx,
		const Amg::Vector3D &	seedPosInChamb,
		const Amg::Vector3D &	seedDirInChamb,
		const double	timeDelay,
		const CalibSpacePointVec &	spacePoints
	)		const

pure virtual

Refines the calibration constants of already calibrated space points.

Parameters

cctx	Calibration context which is a packed pointer to the current ATLAS EventContext
seedPosInChamb	Position of the external seed expressed in the sector frame
seedDirInChamb	Direction of the external seed expressed in the sector frame
timeDelay	Shift in time to be added to the time of flight of a particle going a straight path
spacePoints	List of already calibrated space points that's eaten by the method

◆ calibrate() [2/4]

virtual CalibSpacePointPtr MuonR4::ISpacePointCalibrator::calibrate	(	const EventContext &	ctx,
		const CalibratedSpacePoint &	spacePoint,
		const Amg::Vector3D &	seedPosInChamb,
		const Amg::Vector3D &	seedDirInChamb,
		const double	timeDelay
	)		const

pure virtual

Calibrates a single space point.

Mdt drift radii are corrected for time slew, signal propagation & LorentzAngle effects. The second coordinate of 1D space points is updated according to the closest approach of the strip to the complemntary coordinate. The space point calibrator always returns a calibrated object. But the state of the space point is set to FailedCalib in if the calibration fails.

Parameters

ctx	EventContext to access conditions data
spacePoint	Pointer to the space point to calibrate.
seedPosInChamb	Position of the external seed expressed in the sector frame
seedDirInChamb	Direction of the external seed expressed in the sector frame
timeDelay	Shift in time to be added to the time of flight of a particle going a straight path

◆ calibrate() [3/4]

virtual CalibSpacePointPtr MuonR4::ISpacePointCalibrator::calibrate	(	const EventContext &	ctx,
		const SpacePoint *	spacePoint,
		const Amg::Vector3D &	seedPosInChamb,
		const Amg::Vector3D &	seedDirInChamb,
		const double	timeDelay
	)		const

pure virtual

Calibrates a single space point.

Mdt drift radii are corrected for time slew, signal propagation & LorentzAngle effects. The second coordinate of 1D space points is updated according to the closest approach of the strip to the complemntary coordinate. The space point calibrator always returns a calibrated object. But the state of the space point is set to FailedCalib in if the calibration fails.

Parameters

ctx	EventContext to access conditions data
spacePoint	Pointer to the space point to calibrate.
seedPosInChamb	Position of the external seed expressed in the sector frame
seedDirInChamb	Direction of the external seed expressed in the sector frame
timeDelay	Shift in time to be added to the time of flight of a particle going a straight path

◆ calibrate() [4/4]

virtual CalibSpacePointVec MuonR4::ISpacePointCalibrator::calibrate	(	const EventContext &	ctx,
		const std::vector< const SpacePoint * > &	spacePoints,
		const Amg::Vector3D &	seedPosInChamb,
		const Amg::Vector3D &	seedDirInChamb,
		const double	timeDelay
	)		const

pure virtual

Calibrates a set of space points.

Parameters

ctx	EventContext to access conditions data
spacePoints	List of space points that will be calibrated
seedPosInChamb	Position of the external seed expressed in the sector frame
seedDirInChamb	Direction of the external seed expressed in the sector frame
timeDelay	Shift in time to be added to the time of flight of a particle going a straight path

◆ calibrateSourceLink()

virtual void MuonR4::ISpacePointCalibrator::calibrateSourceLink	(	const Acts::GeometryContext &	geoctx,
		const Acts::CalibrationContext &	cctx,
		const Acts::SourceLink &	link,
		ActsTrk::MutableTrackStateBackend::TrackStateProxy	state
	)		const

pure virtual

Function that's hooked to the calibration delegate of the implemented Acts fitters.

Parameters

geoctx	The geometry context to fetch the local -> global transformations for the surfaces
cctx	Calibration context which is a packed pointer to the current ATLAS EventContext
link	Sourcelink to the actual measurement to calibrate
state	Proxy to the track-state to which the calibrated constants are written

◆ DeclareInterfaceID()

MuonR4::ISpacePointCalibrator::DeclareInterfaceID	(	ISpacePointCalibrator	,
		1	,
		0
	)

◆ driftAcceleration()

virtual double MuonR4::ISpacePointCalibrator::driftAcceleration	(	const Acts::CalibrationContext &	cctx,
		const CalibratedSpacePoint &	spacePoint
	)		const

pure virtual

Returns the drift acceleration for a given drift-circle space point.

Parameters

ctx	Calibration context which is a packed pointer to the current ATLAS EventContext
spacePoint	Reference to the calibrated space point for which the acceleration needs to be calculated.

◆ driftVelocity()

virtual double MuonR4::ISpacePointCalibrator::driftVelocity	(	const Acts::CalibrationContext &	cctx,
		const CalibratedSpacePoint &	spacePoint
	)		const

pure virtual

Returns the drift velocity for a given drift-circle space point.

Parameters

ctx	Calibration context which is a packed pointer to the current ATLAS EventContext
spacePoint	Reference to the calibrated space point for which the velocity needs to be calculated.

◆ stampSignsOnMeasurements()

virtual void MuonR4::ISpacePointCalibrator::stampSignsOnMeasurements ( const xAOD::MuonSegment & segment ) const

pure virtual

Stamps the signs of the drift radii w.r.t.

the segment line onto the uncalibrated measurements. The stamped signs are later picked up by the source link calibration in the context of the track fit to stabilize the fit.

Parameters

segment Reference to the reconstructed segment for which the sign stamp shall be executed

◆ updateSigns()

virtual void MuonR4::ISpacePointCalibrator::updateSigns	(	const Amg::Vector3D &	trackPos,
		const Amg::Vector3D &	trackDir,
		CalibSpacePointVec &	hitsToCalib
	)		const

pure virtual

Update the signs of the drift radii for a given straight line track to fix the left <-> right ambiguity.

Parameters

trackPos	Position of the track intercept in the sector frame
trackDir	Direction of the track in the sector frame
hitsToCalib	List of space points to calibrate

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

ISpacePointCalibrator.h

Public Types

Public Member Functions

Detailed Description

Member Typedef Documentation

◆ CalibSpacePointPtr

◆ CalibSpacePointVec

Constructor & Destructor Documentation

◆ ~ISpacePointCalibrator()

Member Function Documentation

◆ calibrate() [1/4]

◆ calibrate() [2/4]

◆ calibrate() [3/4]

◆ calibrate() [4/4]

◆ calibrateSourceLink()

◆ DeclareInterfaceID()

◆ driftAcceleration()

◆ driftVelocity()

◆ stampSignsOnMeasurements()

◆ updateSigns()