Abstract Base Class for tracking surfaces. More...

#include <Surface.h>

Inheritance diagram for Trk::Surface:

Collaboration diagram for Trk::Surface:

Classes
struct	Transforms

Public Types
using	ChargedTrackParametersUniquePtr
	Unique ptr types.
using	NeutralTrackParametersUniquePtr

Public Member Functions
	Surface ()
	Default Constructor for inheriting classes.
virtual	~Surface ()
	Virtual Destructor.
	Surface (const Amg::Transform3D &htrans)
	Constructor with Amg::Transform3D reference.
	Surface (const TrkDetElementBase &detelement)
	Constructor from TrkDetElement.
	Surface (const TrkDetElementBase &detelement, const Identifier &id)
	Constructor form TrkDetElement and Identifier.
virtual bool	operator== (const Surface &sf) const =0
	Equality operator.
bool	operator!= (const Surface &sf) const
	Non-equality operator.
virtual Surface *	clone () const =0
	Implicit constructor - uses the copy constructor.
std::unique_ptr< Surface >	uniqueClone () const
	NVI method returning unique_ptr clone.
virtual constexpr SurfaceType	type () const =0
	Returns the Surface type to avoid dynamic casts.
const Amg::Transform3D *	cachedTransform () const
	Return the cached transformation directly.
const Amg::Transform3D &	transform () const
	Returns HepGeom::Transform3D by reference.
const Amg::Vector3D &	center () const
	Returns the center position of the Surface.
virtual const Amg::Vector3D &	normal () const
	Returns the normal vector of the Surface (i.e.
virtual Amg::Vector3D	normal (const Amg::Vector2D &lp) const
	Returns a normal vector at a specific local position.
virtual const Amg::Vector3D &	globalReferencePoint () const
	Returns a global reference point on the surface, for PlaneSurface, StraightLineSurface, PerigeeSurface this is equal to center(), for CylinderSurface and DiscSurface this is a new member.
const TrkDetElementBase *	associatedDetectorElement () const
	return associated Detector Element
Identifier	associatedDetectorElementIdentifier () const
	return Identifier of the associated Detector Element
const Trk::Layer *	associatedLayer () const
	return the associated Layer
const Trk::MaterialLayer *	materialLayer () const
	return the material Layer
Trk::MaterialLayer *	materialLayer ()
virtual const Trk::Surface *	baseSurface () const
	return the base surface (simplified for persistification)
virtual ChargedTrackParametersUniquePtr	createUniqueTrackParameters (double l1, double l2, double phi, double theat, double qop, std::optional< AmgSymMatrix(5)> cov=std::nullopt) const =0
	Use the Surface as a ParametersBase constructor, from local parameters - charged.
virtual ChargedTrackParametersUniquePtr	createUniqueTrackParameters (const Amg::Vector3D &, const Amg::Vector3D &, double, std::optional< AmgSymMatrix(5)> cov=std::nullopt) const =0
	Use the Surface as a ParametersBase constructor, from global parameters - charged.
virtual NeutralTrackParametersUniquePtr	createUniqueNeutralParameters (double l1, double l2, double phi, double theat, double qop, std::optional< AmgSymMatrix(5)> cov=std::nullopt) const =0
	Use the Surface as a ParametersBase constructor, from local parameters - neutral.
virtual NeutralTrackParametersUniquePtr	createUniqueNeutralParameters (const Amg::Vector3D &, const Amg::Vector3D &, double charge=0., std::optional< AmgSymMatrix(5)> cov=std::nullopt) const =0
	Use the Surface as a ParametersBase constructor, from global parameters - neutral.
std::optional< Amg::Vector2D >	positionOnSurface (const Amg::Vector3D &glopo, const BoundaryCheck &bchk=true, double tol1=0., double tol2=0.) const
	positionOnSurface() returns the LocalPosition on the Surface, If BoundaryCheck==false it just returns the value of globalToLocal (including nullptr possibility), if BoundaryCheck==true it checks whether the point is inside bounds or not (returns std::nullopt in this case).
template<class T>
bool	onSurface (const T &parameters, const BoundaryCheck &bchk=BoundaryCheck(true)) const
	The templated Parameters OnSurface method - checks on surface pointer first.
virtual bool	isOnSurface (const Amg::Vector3D &glopo, const BoundaryCheck &bchk=true, double tol1=0., double tol2=0.) const
	This method returns true if the GlobalPosition is on the Surface for both, within or without check of whether the local position is inside boundaries or not.
virtual bool	insideBounds (const Amg::Vector2D &locpos, double tol1=0., double tol2=0.) const =0
	virtual methods to be overwritten by the inherited surfaces
virtual bool	insideBoundsCheck (const Amg::Vector2D &locpos, const BoundaryCheck &bchk) const =0
virtual void	localToGlobal (const Amg::Vector2D &locp, const Amg::Vector3D &mom, Amg::Vector3D &glob) const =0
	Specified by each surface type: LocalToGlobal method without dynamic memory allocation.
Amg::Vector3D	localToGlobal (const Amg::Vector2D &locpos) const
	This method returns the GlobalPosition from a LocalPosition uses the per surface localToGlobal.
Amg::Vector3D	localToGlobal (const Amg::Vector2D &locpos, const Amg::Vector3D &glomom) const
	This method returns the GlobalPosition from a LocalPosition The LocalPosition can be outside Surface bounds - for generality with momentum.
Amg::Vector3D	localToGlobal (const LocalParameters &locpars) const
	This method returns the GlobalPosition from LocalParameters The LocalParameters can be outside Surface bounds.
Amg::Vector3D	localToGlobal (const LocalParameters &locpars, const Amg::Vector3D &glomom) const
	This method returns the GlobalPosition from LocalParameters The LocalParameters can be outside Surface bounds - for generality with momentum.
virtual bool	globalToLocal (const Amg::Vector3D &glob, const Amg::Vector3D &mom, Amg::Vector2D &loc) const =0
	Specified by each surface type: GlobalToLocal method without dynamic memory allocation - boolean checks if on surface.
std::optional< Amg::Vector2D >	globalToLocal (const Amg::Vector3D &glopos, double tol=0.) const
	This method returns the LocalPosition from a provided GlobalPosition.
std::optional< Amg::Vector2D >	globalToLocal (const Amg::Vector3D &glopos, const Amg::Vector3D &glomom) const
	This method returns the LocalPosition from a provided GlobalPosition.
virtual Amg::Vector2D	localParametersToPosition (const LocalParameters &locpars) const
	Optionally specified by each surface type : LocalParameters to Vector2D.
virtual double	pathCorrection (const Amg::Vector3D &pos, const Amg::Vector3D &mom) const
	the pathCorrection for derived classes with thickness - it reflects if the direction projection is positive or negative
virtual Amg::RotationMatrix3D	measurementFrame (const Amg::Vector3D &glopos, const Amg::Vector3D &glomom) const
	Return the measurement frame - this is needed for alignment, in particular for StraightLine and Perigee Surface.
template<typename T>
Intersection	straightLineIntersection (const T &pars, bool forceDir=false, const Trk::BoundaryCheck &bchk=false) const
	fst straight line intersection schema - templated for charged and neutral parameters
virtual Intersection	straightLineIntersection (const Amg::Vector3D &pos, const Amg::Vector3D &dir, bool forceDir=false, Trk::BoundaryCheck bchk=false) const =0
	fast straight line intersection schema - standard: provides closest intersection and (signed) path length forceDir provides the closest forward solution
virtual DistanceSolution	straightLineDistanceEstimate (const Amg::Vector3D &pos, const Amg::Vector3D &dir) const =0
	fast straight line distance evaluation to Surface
virtual DistanceSolution	straightLineDistanceEstimate (const Amg::Vector3D &pos, const Amg::Vector3D &dir, bool Bound) const =0
	fast straight line distance evaluation to Surface - with bound option
virtual const SurfaceBounds &	bounds () const =0
	Surface Bounds method.
bool	isFree () const
	Returns 'true' if this surface is 'free', i.e.
bool	isActive () const
	Return 'true' if this surface is owned by the detector element.
void	setTransform (const Amg::Transform3D &trans)
	Set the transform updates center and normal.
void	setOwner (SurfaceOwner x)
	set Ownership
SurfaceOwner	owner () const
	return ownership
void	setMaterialLayer (std::shared_ptr< Trk::MaterialLayer > mlay)
	set material layer
virtual MsgStream &	dump (MsgStream &sl) const
	Output Method for MsgStream, to be overloaded by child classes.
virtual std::ostream &	dump (std::ostream &sl) const
	Output Method for std::ostream, to be overloaded by child classes.
virtual std::string	name () const =0
	Return properly formatted class name.
void	associateLayer (const Layer &lay)
	method to associate a Trk::Layer.

Static Public Member Functions
static std::size_t	numberOfInstantiations ()

Static Public Attributes
static std::atomic_size_t	s_numberOfInstantiations

Protected Member Functions
	Surface (const Surface &sf)
	Copy operators for inheriting classes They reset the associated detector element to nullptr and the identifier to invalid.
Surface &	operator= (const Surface &sf)
	Surface (const Surface &sf, const Amg::Transform3D &transf)
	Copy constructor with shift.
	Surface (Surface &&sf) noexcept=default
Surface &	operator= (Surface &&sf) noexcept=default
Amg::Transform3D	inverseTransformHelper () const
	Helper method to factorize in one place common operations calculate inverse transofrm and multiply with position.
Amg::Vector3D	inverseTransformMultHelper (const Amg::Vector3D &glopos) const

Protected Attributes
std::unique_ptr< Transforms >	m_transforms {}
	Unique Pointer to the Transforms struct.
const TrkDetElementBase *	m_associatedDetElement {}
	Not owning Pointer to the Detector Element.
Identifier	m_associatedDetElementId {}
	Identifier to the Detector Element.
const Layer *	m_associatedLayer {}
	The associated layer Trk::Layer This is the layer in which the Surface is embedded.
std::shared_ptr< MaterialLayer >	m_materialLayer {}
	Possibility to attach a material description to the surface.
SurfaceOwner	m_owner {SurfaceOwner::noOwn}
	enum for surface owner : default free surface

Static Protected Attributes
static constexpr double	s_onSurfaceTolerance = 10e-5
	Tolerance for being on Surface.

Friends
class	::SurfaceCnv_p1

Detailed Description

Abstract Base Class for tracking surfaces.

For all isOnSurface, or positionOnSurface and insideBounds methods two tolerance parameters can be given which correspond to the two local natural coordinates of the surface loc1, loc2.

Author: Andre.nosp@m.as.S.nosp@m.alzbu.nosp@m.rger.nosp@m.@cern.nosp@m..ch; Christos Anastopoulos (Thread safety and interface cleanup); Shaun Roe (interface cleanup)

Definition at line 78 of file Tracking/TrkDetDescr/TrkSurfaces/TrkSurfaces/Surface.h.

Member Typedef Documentation

◆ ChargedTrackParametersUniquePtr

using Trk::Surface::ChargedTrackParametersUniquePtr

Initial value:

std::unique_ptr<ParametersBase<5, Trk::Charged>>

Unique ptr types.

Definition at line 128 of file Tracking/TrkDetDescr/TrkSurfaces/TrkSurfaces/Surface.h.

◆ NeutralTrackParametersUniquePtr

using Trk::Surface::NeutralTrackParametersUniquePtr

Initial value:

std::unique_ptr<ParametersBase<5, Trk::Neutral>>

Definition at line 130 of file Tracking/TrkDetDescr/TrkSurfaces/TrkSurfaces/Surface.h.

Constructor & Destructor Documentation

◆ Surface() [1/7]

Surface::Surface ( )

default

Default Constructor for inheriting classes.

◆ ~Surface()

Surface::~Surface ( )

virtualdefault

Virtual Destructor.

◆ Surface() [2/7]

ATH_FLATTEN Surface::Surface ( const Amg::Transform3D & htrans )

Constructor with Amg::Transform3D reference.

Definition at line 26 of file Surface.cxx.

  : Trk::ObjectCounter<Trk::Surface>()
  , m_transforms(std::make_unique<Transforms>(tform))
{
}

◆ Surface() [3/7]

Surface::Surface ( const TrkDetElementBase & detelement )

Constructor from TrkDetElement.

Definition at line 32 of file Surface.cxx.

  : Trk::ObjectCounter<Trk::Surface>()
  , m_associatedDetElement(&detelement)
  , m_owner(Trk::DetElOwn)
{
}

◆ Surface() [4/7]

Surface::Surface	(	const TrkDetElementBase &	detelement,
		const Identifier &	id )

Constructor form TrkDetElement and Identifier.

Definition at line 39 of file Surface.cxx.

  : Trk::ObjectCounter<Trk::Surface>()
  , m_associatedDetElement(&detelement)
  , m_associatedDetElementId(id)
  , m_owner(Trk::DetElOwn)
{
}

◆ Surface() [5/7]

ATH_FLATTEN Surface::Surface ( const Surface & sf )

protected

Copy operators for inheriting classes They reset the associated detector element to nullptr and the identifier to invalid.

The copy cannot be owned by the same detector element as the original

Definition at line 56 of file Surface.cxx.

  : Trk::ObjectCounter<Trk::Surface>(sf)
  , m_transforms(std::make_unique<Transforms>(sf.transform()))
  , m_associatedLayer(sf.m_associatedLayer)
  , m_materialLayer(sf.m_materialLayer)
  , m_owner(Trk::noOwn)
{
}

◆ Surface() [6/7]

ATH_FLATTEN Surface::Surface	(	const Surface &	sf,
		const Amg::Transform3D &	transf )

protected

Copy constructor with shift.

Definition at line 73 of file Surface.cxx.

  : Trk::ObjectCounter<Trk::Surface>(sf)
  , m_owner(Trk::noOwn)
{
  if (sf.m_transforms) {
    m_transforms = std::make_unique<Transforms>(
      shift * sf.m_transforms->transform, shift * sf.m_transforms->center);
  } else {
    m_transforms = std::make_unique<Transforms>(Amg::Transform3D(shift));
  }
}

◆ Surface() [7/7]

Trk::Surface::Surface ( Surface && sf )

protecteddefaultnoexcept

Member Function Documentation

◆ associatedDetectorElement()

const TrkDetElementBase * Trk::Surface::associatedDetectorElement ( ) const

return associated Detector Element

◆ associatedDetectorElementIdentifier()

Identifier Trk::Surface::associatedDetectorElementIdentifier ( ) const

return Identifier of the associated Detector Element

◆ associatedLayer()

const Trk::Layer * Trk::Surface::associatedLayer ( ) const

return the associated Layer

◆ associateLayer()

void Trk::Surface::associateLayer ( const Layer & lay )

method to associate a Trk::Layer.

We do not take ownership as this is typically already owned by the Geometry

◆ baseSurface()

virtual const Trk::Surface * Trk::Surface::baseSurface ( ) const

virtual

return the base surface (simplified for persistification)

◆ bounds()

virtual const SurfaceBounds & Trk::Surface::bounds ( ) const

pure virtual

Surface Bounds method.

Implemented in GXF::CylinderSurface, GXF::DiscSurface, PlaneSurface, Trk::ConeSurface, Trk::CylinderSurface, Trk::DetElementSurface, Trk::DiscSurface, Trk::PerigeeSurface, Trk::PlaneSurface, and Trk::StraightLineSurface.

◆ cachedTransform()

const Amg::Transform3D * Trk::Surface::cachedTransform ( ) const

Return the cached transformation directly.

Don't try to make a new transform if it's not here.

◆ center()

const Amg::Vector3D & Trk::Surface::center ( ) const

Returns the center position of the Surface.

◆ clone()

virtual Surface * Trk::Surface::clone ( ) const

pure virtual

Implicit constructor - uses the copy constructor.

Implemented in GXF::CylinderSurface, GXF::DiscSurface, PlaneSurface, Trk::ConeSurface, Trk::CylinderSurface, Trk::DetElementSurface, Trk::DiscSurface, Trk::PerigeeSurface, Trk::PlaneSurface, Trk::SlidingDiscSurface, and Trk::StraightLineSurface.

◆ createUniqueNeutralParameters() [1/2]

virtual NeutralTrackParametersUniquePtr Trk::Surface::createUniqueNeutralParameters	(	const Amg::Vector3D &	,
		const Amg::Vector3D &	,
		double	charge = 0.,
		std::optional< AmgSymMatrix(5)>	cov = std::nullopt ) const

pure virtual

Use the Surface as a ParametersBase constructor, from global parameters - neutral.

Implemented in GXF::CylinderSurface, GXF::DiscSurface, PlaneSurface, Trk::ConeSurface, Trk::CylinderSurface, Trk::DetElementSurface, Trk::DiscSurface, Trk::PerigeeSurface, Trk::PlaneSurface, and Trk::StraightLineSurface.

◆ createUniqueNeutralParameters() [2/2]

virtual NeutralTrackParametersUniquePtr Trk::Surface::createUniqueNeutralParameters	(	double	l1,
		double	l2,
		double	phi,
		double	theat,
		double	qop,
		std::optional< AmgSymMatrix(5)>	cov = std::nullopt ) const

pure virtual

Use the Surface as a ParametersBase constructor, from local parameters - neutral.

Implemented in GXF::CylinderSurface, GXF::DiscSurface, PlaneSurface, Trk::ConeSurface, Trk::CylinderSurface, Trk::DetElementSurface, Trk::DiscSurface, Trk::PerigeeSurface, Trk::PlaneSurface, and Trk::StraightLineSurface.

◆ createUniqueTrackParameters() [1/2]

virtual ChargedTrackParametersUniquePtr Trk::Surface::createUniqueTrackParameters	(	const Amg::Vector3D &	,
		const Amg::Vector3D &	,
		double	,
		std::optional< AmgSymMatrix(5)>	cov = std::nullopt ) const

pure virtual

Use the Surface as a ParametersBase constructor, from global parameters - charged.

Implemented in GXF::CylinderSurface, GXF::DiscSurface, PlaneSurface, Trk::ConeSurface, Trk::CylinderSurface, Trk::DetElementSurface, Trk::DiscSurface, Trk::PerigeeSurface, Trk::PlaneSurface, and Trk::StraightLineSurface.

◆ createUniqueTrackParameters() [2/2]

virtual ChargedTrackParametersUniquePtr Trk::Surface::createUniqueTrackParameters	(	double	l1,
		double	l2,
		double	phi,
		double	theat,
		double	qop,
		std::optional< AmgSymMatrix(5)>	cov = std::nullopt ) const

pure virtual

Use the Surface as a ParametersBase constructor, from local parameters - charged.

Implemented in GXF::CylinderSurface, GXF::DiscSurface, PlaneSurface, Trk::ConeSurface, Trk::CylinderSurface, Trk::DetElementSurface, Trk::DiscSurface, Trk::PerigeeSurface, Trk::PlaneSurface, and Trk::StraightLineSurface.

◆ dump() [1/2]

MsgStream & Surface::dump ( MsgStream & sl ) const

virtual

Output Method for MsgStream, to be overloaded by child classes.

Reimplemented in Trk::DetElementSurface, and Trk::PerigeeSurface.

Definition at line 157 of file Surface.cxx.

{
  sl << std::setiosflags(std::ios::fixed);
  sl << std::setprecision(4);
  sl << name() << std::endl;
  if (associatedDetectorElement()!=nullptr){
    sl<<"     Detector Type              = "<<associatedDetectorElement()->detectorTypeString()<<std::endl;
  }
  sl << "     Center position  (x, y, z) = (" << center().x() << ", " << center().y() << ", " << center().z() << ")"
     << std::endl;
  Amg::RotationMatrix3D rot(transform().linear());
  Amg::Vector3D rotX(rot.col(0));
  Amg::Vector3D rotY(rot.col(1));
  Amg::Vector3D rotZ(rot.col(2));
  sl << std::setprecision(6);
  sl << "     Rotation:             colX = (" << rotX(0) << ", " << rotX(1) << ", " << rotX(2) << ")" << std::endl;
  sl << "                           colY = (" << rotY(0) << ", " << rotY(1) << ", " << rotY(2) << ")" << std::endl;
  sl << "                           colZ = (" << rotZ(0) << ", " << rotZ(1) << ", " << rotZ(2) << ")" << std::endl;
  sl << "     Bounds  : " << bounds();
  if (!checkTransform(*this)) {
     sl << std::endl << "     NOT a strict rotation matrix." << std::endl;
  }
  sl << std::setprecision(-1);
  return sl;
}

◆ dump() [2/2]

std::ostream & Surface::dump ( std::ostream & sl ) const

virtual

Output Method for std::ostream, to be overloaded by child classes.

Reimplemented in Trk::DetElementSurface, and Trk::PerigeeSurface.

Definition at line 185 of file Surface.cxx.

{
  sl << std::setiosflags(std::ios::fixed);
  sl << std::setprecision(4);
  sl << name() << std::endl;
  if (associatedDetectorElement()!=nullptr){
    sl<<"     Detector Type              = "<<associatedDetectorElement()->detectorTypeString()<<std::endl;
  }
  sl << "     Center position  (x, y, z) = (" << center().x() << ", " << center().y() << ", " << center().z() << ")"
     << std::endl;
  Amg::RotationMatrix3D rot(transform().linear());
  Amg::Vector3D rotX(rot.col(0));
  Amg::Vector3D rotY(rot.col(1));
  Amg::Vector3D rotZ(rot.col(2));
  sl << std::setprecision(6);
  sl << "     Rotation:             colX = (" << rotX(0) << ", " << rotX(1) << ", " << rotX(2) << ")" << std::endl;
  sl << "                           colY = (" << rotY(0) << ", " << rotY(1) << ", " << rotY(2) << ")" << std::endl;
  sl << "                           colZ = (" << rotZ(0) << ", " << rotZ(1) << ", " << rotZ(2) << ")" << std::endl;
  sl << "     Bounds  : " << bounds();
  if (!checkTransform(*this)) {
     sl << std::endl << "     NOT a strict rotation matrix." << std::endl;
  }
  sl << std::setprecision(-1);
  return sl;
}

◆ globalReferencePoint()

virtual const Amg::Vector3D & Trk::Surface::globalReferencePoint ( ) const

virtual

Returns a global reference point on the surface, for PlaneSurface, StraightLineSurface, PerigeeSurface this is equal to center(), for CylinderSurface and DiscSurface this is a new member.

Reimplemented in GXF::CylinderSurface, GXF::DiscSurface, Trk::ConeSurface, Trk::CylinderSurface, and Trk::DiscSurface.

◆ globalToLocal() [1/3]

virtual bool Trk::Surface::globalToLocal	(	const Amg::Vector3D &	glob,
		const Amg::Vector3D &	mom,
		Amg::Vector2D &	loc ) const

pure virtual

Specified by each surface type: GlobalToLocal method without dynamic memory allocation - boolean checks if on surface.

Implemented in GXF::CylinderSurface, GXF::DiscSurface, PlaneSurface, Trk::ConeSurface, Trk::CylinderSurface, Trk::DetElementSurface, Trk::DiscSurface, Trk::PerigeeSurface, Trk::PlaneSurface, Trk::SlidingCylinderSurface, Trk::SlidingDiscSurface, and Trk::StraightLineSurface.

◆ globalToLocal() [2/3]

std::optional< Amg::Vector2D > Trk::Surface::globalToLocal	(	const Amg::Vector3D &	glopos,
		const Amg::Vector3D &	glomom ) const

This method returns the LocalPosition from a provided GlobalPosition.

If the GlobalPosition is not on the Surface, it returns a nullopt This method does not check if the calculated LocalPosition is inside surface bounds. If this check is needed, use positionOnSurface - for generality with momentum

◆ globalToLocal() [3/3]

std::optional< Amg::Vector2D > Trk::Surface::globalToLocal	(	const Amg::Vector3D &	glopos,
		double	tol = 0. ) const

This method returns the LocalPosition from a provided GlobalPosition.

If the GlobalPosition is not on the Surface, it returns nullopt This method does not check if the calculated LocalPosition is inside surface bounds. If this check is needed, use positionOnSurface - only for planar, cylinder surface fully defined

◆ insideBounds()

virtual bool Trk::Surface::insideBounds	(	const Amg::Vector2D &	locpos,
		double	tol1 = 0.,
		double	tol2 = 0. ) const

pure virtual

virtual methods to be overwritten by the inherited surfaces

Implemented in GXF::CylinderSurface, GXF::DiscSurface, PlaneSurface, Trk::ConeSurface, Trk::CylinderSurface, Trk::DetElementSurface, Trk::DiscSurface, Trk::PerigeeSurface, Trk::PlaneSurface, Trk::StraightLineSurface, Trk::SubtractedCylinderLayer, Trk::SubtractedCylinderSurface, Trk::SubtractedDiscSurface, and Trk::SubtractedPlaneSurface.

◆ insideBoundsCheck()

virtual bool Trk::Surface::insideBoundsCheck	(	const Amg::Vector2D &	locpos,
		const BoundaryCheck &	bchk ) const

pure virtual

Implemented in Trk::ConeSurface, Trk::CylinderSurface, Trk::DetElementSurface, Trk::DiscSurface, Trk::PerigeeSurface, Trk::PlaneSurface, and Trk::StraightLineSurface.

◆ inverseTransformHelper()

Amg::Transform3D Trk::Surface::inverseTransformHelper ( ) const

protected

Helper method to factorize in one place common operations calculate inverse transofrm and multiply with position.

◆ inverseTransformMultHelper()

Amg::Vector3D Trk::Surface::inverseTransformMultHelper ( const Amg::Vector3D & glopos ) const

protected

◆ isActive()

bool Trk::Surface::isActive ( ) const

Return 'true' if this surface is owned by the detector element.

◆ isFree()

bool Trk::Surface::isFree ( ) const

Returns 'true' if this surface is 'free', i.e.

it does not belong to a detector element (and returns false otherwise

◆ isOnSurface()

bool Surface::isOnSurface	(	const Amg::Vector3D &	glopo,
		const BoundaryCheck &	bchk = true,
		double	tol1 = 0.,
		double	tol2 = 0. ) const

virtual

This method returns true if the GlobalPosition is on the Surface for both, within or without check of whether the local position is inside boundaries or not.

Reimplemented in GXF::CylinderSurface, GXF::DiscSurface, PlaneSurface, Trk::CylinderSurface, Trk::DetElementSurface, Trk::DiscSurface, Trk::PerigeeSurface, Trk::PlaneSurface, Trk::SlidingCylinderSurface, Trk::SlidingDiscSurface, and Trk::StraightLineSurface.

Definition at line 123 of file Surface.cxx.

{
  std::optional<Amg::Vector2D> posOnSurface =
    positionOnSurface(glopo, bchk, tol1, tol2);
  return static_cast<bool>(posOnSurface);
}

◆ localParametersToPosition()

virtual Amg::Vector2D Trk::Surface::localParametersToPosition ( const LocalParameters & locpars ) const

virtual

Optionally specified by each surface type : LocalParameters to Vector2D.

Reimplemented in Trk::ConeSurface, Trk::CylinderSurface, and Trk::DiscSurface.

◆ localToGlobal() [1/5]

virtual void Trk::Surface::localToGlobal	(	const Amg::Vector2D &	locp,
		const Amg::Vector3D &	mom,
		Amg::Vector3D &	glob ) const

pure virtual

Specified by each surface type: LocalToGlobal method without dynamic memory allocation.

Implemented in GXF::CylinderSurface, GXF::DiscSurface, PlaneSurface, Trk::ConeSurface, Trk::CylinderSurface, Trk::DetElementSurface, Trk::DiscSurface, Trk::PerigeeSurface, Trk::PlaneSurface, Trk::SlidingCylinderSurface, Trk::SlidingDiscSurface, and Trk::StraightLineSurface.

◆ localToGlobal() [2/5]

Amg::Vector3D Trk::Surface::localToGlobal ( const Amg::Vector2D & locpos ) const

This method returns the GlobalPosition from a LocalPosition uses the per surface localToGlobal.

◆ localToGlobal() [3/5]

Amg::Vector3D Trk::Surface::localToGlobal	(	const Amg::Vector2D &	locpos,
		const Amg::Vector3D &	glomom ) const

This method returns the GlobalPosition from a LocalPosition The LocalPosition can be outside Surface bounds - for generality with momentum.

◆ localToGlobal() [4/5]

Amg::Vector3D Trk::Surface::localToGlobal ( const LocalParameters & locpars ) const

This method returns the GlobalPosition from LocalParameters The LocalParameters can be outside Surface bounds.

◆ localToGlobal() [5/5]

Amg::Vector3D Trk::Surface::localToGlobal	(	const LocalParameters &	locpars,
		const Amg::Vector3D &	glomom ) const

This method returns the GlobalPosition from LocalParameters The LocalParameters can be outside Surface bounds - for generality with momentum.

◆ materialLayer() [1/2]

Trk::MaterialLayer * Trk::Surface::materialLayer ( )

◆ materialLayer() [2/2]

const Trk::MaterialLayer * Trk::Surface::materialLayer ( ) const

return the material Layer

◆ measurementFrame()

Amg::RotationMatrix3D Surface::measurementFrame	(	const Amg::Vector3D &	glopos,
		const Amg::Vector3D &	glomom ) const

virtual

Return the measurement frame - this is needed for alignment, in particular for StraightLine and Perigee Surface.

the default implementation is the the RotationMatrix3D of the transform

Reimplemented in GXF::CylinderSurface, Trk::ConeSurface, Trk::CylinderSurface, Trk::PerigeeSurface, and Trk::StraightLineSurface.

Definition at line 135 of file Surface.cxx.

{
  return transform().linear();
}

◆ name()

virtual std::string Trk::Surface::name ( ) const

pure virtual

Return properly formatted class name.

Implemented in GXF::CylinderSurface, GXF::DiscSurface, PlaneSurface, Trk::ConeSurface, Trk::CylinderSurface, Trk::DetElementSurface, Trk::DiscSurface, Trk::PerigeeSurface, Trk::PlaneSurface, Trk::SlidingCylinderSurface, Trk::SlidingDiscSurface, Trk::StraightLineSurface, Trk::SubtractedCylinderSurface, Trk::SubtractedDiscSurface, and Trk::SubtractedPlaneSurface.

◆ normal() [1/2]

virtual const Amg::Vector3D & Trk::Surface::normal ( ) const

virtual

Returns the normal vector of the Surface (i.e.

in generall z-axis of rotation)

Reimplemented in GXF::CylinderSurface, Trk::ConeSurface, Trk::CylinderSurface, and Trk::PerigeeSurface.

◆ normal() [2/2]

virtual Amg::Vector3D Trk::Surface::normal ( const Amg::Vector2D & lp ) const

virtual

Returns a normal vector at a specific local position.

Reimplemented in GXF::CylinderSurface, Trk::ConeSurface, Trk::CylinderSurface, and Trk::PerigeeSurface.

◆ numberOfInstantiations()

std::size_t Trk::ObjectCounter< Trk::Surface >::numberOfInstantiations ( )

inlinestaticinherited

Definition at line 25 of file TrkObjectCounter.h.

  {
#ifndef NDEBUG
    return s_numberOfInstantiations.load();
#endif
    return 0;
  }

◆ onSurface()

template<class T>

bool Trk::Surface::onSurface	(	const T &	parameters,
		const BoundaryCheck &	bchk = BoundaryCheck(true) ) const

The templated Parameters OnSurface method - checks on surface pointer first.

◆ operator!=()

bool Trk::Surface::operator!= ( const Surface & sf ) const

Non-equality operator.

◆ operator=() [1/2]

Trk::Surface & Surface::operator= ( const Surface & sf )

protected

Definition at line 91 of file Surface.cxx.

{
  if (this != &sf) {
    m_transforms = std::make_unique<Transforms>(sf.transform());
    m_associatedDetElement = nullptr;
    m_associatedDetElementId = Identifier();
    m_associatedLayer = sf.m_associatedLayer;
    m_materialLayer = sf.m_materialLayer;
    m_owner = Trk::noOwn;
  }
  return *this;
}

◆ operator=() [2/2]

Surface & Trk::Surface::operator= ( Surface && sf )

protecteddefaultnoexcept

◆ operator==()

virtual bool Trk::Surface::operator== ( const Surface & sf ) const

pure virtual

Equality operator.

Implemented in GXF::CylinderSurface, GXF::DiscSurface, PlaneSurface, Trk::ConeSurface, Trk::CylinderSurface, Trk::DetElementSurface, Trk::DiscSurface, Trk::PerigeeSurface, Trk::PlaneSurface, Trk::SlidingCylinderSurface, Trk::SlidingDiscSurface, Trk::StraightLineSurface, Trk::SubtractedCylinderSurface, Trk::SubtractedDiscSurface, and Trk::SubtractedPlaneSurface.

◆ owner()

SurfaceOwner Trk::Surface::owner ( ) const

return ownership

◆ pathCorrection()

virtual double Trk::Surface::pathCorrection	(	const Amg::Vector3D &	pos,
		const Amg::Vector3D &	mom ) const

virtual

the pathCorrection for derived classes with thickness - it reflects if the direction projection is positive or negative

Reimplemented in GXF::CylinderSurface, Trk::ConeSurface, Trk::CylinderSurface, Trk::PerigeeSurface, and Trk::StraightLineSurface.

◆ positionOnSurface()

std::optional< Amg::Vector2D > Surface::positionOnSurface	(	const Amg::Vector3D &	glopo,
		const BoundaryCheck &	bchk = true,
		double	tol1 = 0.,
		double	tol2 = 0. ) const

positionOnSurface() returns the LocalPosition on the Surface,
If BoundaryCheck==false it just returns the value of globalToLocal (including nullptr possibility), if BoundaryCheck==true it checks whether the point is inside bounds or not (returns std::nullopt in this case).

Definition at line 106 of file Surface.cxx.

{
  std::optional<Amg::Vector2D> posOnSurface = globalToLocal(glopo, tol1);
  if (!bchk){
    return posOnSurface;
  }
  if (posOnSurface && insideBounds(*posOnSurface, tol1, tol2)){
    return posOnSurface;
  }
  return std::nullopt;
}

◆ setMaterialLayer()

void Trk::Surface::setMaterialLayer ( std::shared_ptr< Trk::MaterialLayer > mlay )

set material layer

◆ setOwner()

void Trk::Surface::setOwner ( SurfaceOwner x )

set Ownership

◆ setTransform()

void Trk::Surface::setTransform ( const Amg::Transform3D & trans )

Set the transform updates center and normal.

◆ straightLineDistanceEstimate() [1/2]

virtual DistanceSolution Trk::Surface::straightLineDistanceEstimate	(	const Amg::Vector3D &	pos,
		const Amg::Vector3D &	dir ) const

pure virtual

fast straight line distance evaluation to Surface

Implemented in GXF::CylinderSurface, GXF::DiscSurface, PlaneSurface, Trk::ConeSurface, Trk::CylinderSurface, Trk::DetElementSurface, Trk::DiscSurface, Trk::PerigeeSurface, Trk::PlaneSurface, Trk::SlidingCylinderSurface, Trk::SlidingDiscSurface, and Trk::StraightLineSurface.

◆ straightLineDistanceEstimate() [2/2]

virtual DistanceSolution Trk::Surface::straightLineDistanceEstimate	(	const Amg::Vector3D &	pos,
		const Amg::Vector3D &	dir,
		bool	Bound ) const

pure virtual

fast straight line distance evaluation to Surface - with bound option

Implemented in GXF::CylinderSurface, GXF::DiscSurface, PlaneSurface, Trk::ConeSurface, Trk::CylinderSurface, Trk::DetElementSurface, Trk::DiscSurface, Trk::PerigeeSurface, Trk::PlaneSurface, Trk::SlidingCylinderSurface, Trk::SlidingDiscSurface, and Trk::StraightLineSurface.

◆ straightLineIntersection() [1/2]

virtual Intersection Trk::Surface::straightLineIntersection	(	const Amg::Vector3D &	pos,
		const Amg::Vector3D &	dir,
		bool	forceDir = false,
		Trk::BoundaryCheck	bchk = false ) const

pure virtual

fast straight line intersection schema - standard: provides closest intersection and (signed) path length forceDir provides the closest forward solution

Implemented in GXF::CylinderSurface, GXF::DiscSurface, PlaneSurface, Trk::ConeSurface, Trk::CylinderSurface, Trk::DetElementSurface, Trk::DiscSurface, Trk::PerigeeSurface, Trk::PlaneSurface, and Trk::StraightLineSurface.

◆ straightLineIntersection() [2/2]

template<typename T>

Intersection Trk::Surface::straightLineIntersection	(	const T &	pars,
		bool	forceDir = false,
		const Trk::BoundaryCheck &	bchk = false ) const

inline

fst straight line intersection schema - templated for charged and neutral parameters

Definition at line 352 of file Tracking/TrkDetDescr/TrkSurfaces/TrkSurfaces/Surface.h.

  {
    return straightLineIntersection(
      pars.position(), pars.momentum().unit(), forceDir, bchk);
  }

◆ transform()

const Amg::Transform3D & Trk::Surface::transform ( ) const

Returns HepGeom::Transform3D by reference.

◆ type()

virtual constexpr SurfaceType Trk::Surface::type ( ) const

constexprpure virtual

Returns the Surface type to avoid dynamic casts.

Implemented in GXF::CylinderSurface, GXF::DiscSurface, PlaneSurface, Trk::ConeSurface, Trk::CylinderSurface, Trk::DetElementSurface, Trk::DiscSurface, Trk::PerigeeSurface, Trk::PlaneSurface, and Trk::StraightLineSurface.

◆ uniqueClone()

std::unique_ptr< Surface > Trk::Surface::uniqueClone ( ) const

NVI method returning unique_ptr clone.

◆ ::SurfaceCnv_p1

friend class ::SurfaceCnv_p1

friend

Definition at line 436 of file Tracking/TrkDetDescr/TrkSurfaces/TrkSurfaces/Surface.h.

Member Data Documentation

◆ m_associatedDetElement

const TrkDetElementBase* Trk::Surface::m_associatedDetElement {}

protected

Not owning Pointer to the Detector Element.

Definition at line 441 of file Tracking/TrkDetDescr/TrkSurfaces/TrkSurfaces/Surface.h.

441{};

◆ m_associatedDetElementId

Identifier Trk::Surface::m_associatedDetElementId {}

protected

Identifier to the Detector Element.

Definition at line 443 of file Tracking/TrkDetDescr/TrkSurfaces/TrkSurfaces/Surface.h.

443{};

◆ m_associatedLayer

const Layer* Trk::Surface::m_associatedLayer {}

protected

The associated layer Trk::Layer This is the layer in which the Surface is embedded.

so not owning pointer.

Definition at line 448 of file Tracking/TrkDetDescr/TrkSurfaces/TrkSurfaces/Surface.h.

448{};

◆ m_materialLayer

std::shared_ptr<MaterialLayer> Trk::Surface::m_materialLayer {}

protected

Possibility to attach a material description to the surface.

In this case the surface is what holds the MaterialLayer. This is usually done for boundary surfaces so shared ptr.

Definition at line 453 of file Tracking/TrkDetDescr/TrkSurfaces/TrkSurfaces/Surface.h.

453{};

◆ m_owner

SurfaceOwner Trk::Surface::m_owner {SurfaceOwner::noOwn}

protected

enum for surface owner : default free surface

Definition at line 455 of file Tracking/TrkDetDescr/TrkSurfaces/TrkSurfaces/Surface.h.

455{SurfaceOwner::noOwn};

◆ m_transforms

std::unique_ptr<Transforms> Trk::Surface::m_transforms {}

protected

Unique Pointer to the Transforms struct.

Definition at line 439 of file Tracking/TrkDetDescr/TrkSurfaces/TrkSurfaces/Surface.h.

439{};

◆ s_numberOfInstantiations

std::atomic_size_t Trk::ObjectCounter< Trk::Surface >::s_numberOfInstantiations

inlinestaticinherited

Definition at line 22 of file TrkObjectCounter.h.

◆ s_onSurfaceTolerance

double Trk::Surface::s_onSurfaceTolerance = 10e-5

staticconstexprprotected

Tolerance for being on Surface.

Definition at line 458 of file Tracking/TrkDetDescr/TrkSurfaces/TrkSurfaces/Surface.h.

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

Classes

Public Types

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Member Functions

Protected Attributes

Static Protected Attributes

Friends

Detailed Description

Member Typedef Documentation

◆ ChargedTrackParametersUniquePtr

◆ NeutralTrackParametersUniquePtr

Constructor & Destructor Documentation

◆ Surface() [1/7]

◆ ~Surface()

◆ Surface() [2/7]

◆ Surface() [3/7]

◆ Surface() [4/7]

◆ Surface() [5/7]

◆ Surface() [6/7]

◆ Surface() [7/7]

Member Function Documentation

◆ associatedDetectorElement()

◆ associatedDetectorElementIdentifier()

◆ associatedLayer()

◆ associateLayer()

◆ baseSurface()

◆ bounds()

◆ cachedTransform()

◆ center()

◆ clone()

◆ createUniqueNeutralParameters() [1/2]

◆ createUniqueNeutralParameters() [2/2]

◆ createUniqueTrackParameters() [1/2]

◆ createUniqueTrackParameters() [2/2]

◆ dump() [1/2]

◆ dump() [2/2]

◆ globalReferencePoint()

◆ globalToLocal() [1/3]

◆ globalToLocal() [2/3]

◆ globalToLocal() [3/3]

◆ insideBounds()

◆ insideBoundsCheck()

◆ inverseTransformHelper()

◆ inverseTransformMultHelper()

◆ isActive()

◆ isFree()

◆ isOnSurface()

◆ localParametersToPosition()

◆ localToGlobal() [1/5]

◆ localToGlobal() [2/5]

◆ localToGlobal() [3/5]

◆ localToGlobal() [4/5]

◆ localToGlobal() [5/5]

◆ materialLayer() [1/2]

◆ materialLayer() [2/2]

◆ measurementFrame()

◆ name()

◆ normal() [1/2]

◆ normal() [2/2]

◆ numberOfInstantiations()

◆ onSurface()

◆ operator!=()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ operator==()

◆ owner()

◆ pathCorrection()

◆ positionOnSurface()

◆ setMaterialLayer()

◆ setOwner()

◆ setTransform()

◆ straightLineDistanceEstimate() [1/2]

◆ straightLineDistanceEstimate() [2/2]

◆ straightLineIntersection() [1/2]

◆ straightLineIntersection() [2/2]

◆ transform()

◆ type()

◆ uniqueClone()