Abstract Base Class for tracking surfaces. More...

#include <acts/blob/master/Core/include/Acts/Surfaces/Surface.hpp>

Inheritance diagram for Acts::Surface:

Collaboration diagram for Acts::Surface:

Public Types
enum	SurfaceType { Cone = 0, Cylinder = 1, Disc = 2, Perigee = 3, Plane = 4, Straw = 5, Curvilinear = 6, Other = 7 }

Public Member Functions
virtual	~Surface ()

std::shared_ptr< Surface >	getSharedPtr ()

std::shared_ptr< const Surface >	getSharedPtr () const

Surface &	operator= (const Surface &other)

virtual bool	operator== (const Surface &other) const

virtual bool	operator!= (const Surface &sf) const

virtual SurfaceType	type () const =0
	Return method for the Surface type to avoid dynamic casts.

virtual const Transform3D &	transform (const GeometryContext &gctx) const

virtual const Vector3D	center (const GeometryContext &gctx) const

virtual const Vector3D	normal (const GeometryContext &gctx, const Vector2D &lposition) const =0

virtual const Vector3D	normal (const GeometryContext &gctx, const Vector3D &position) const

virtual const Vector3D	normal (const GeometryContext &gctx) const

virtual const SurfaceBounds &	bounds () const =0

const DetectorElementBase *	associatedDetectorElement () const

const Layer *	associatedLayer () const

void	associateLayer (const Layer &lay)

const ISurfaceMaterial *	surfaceMaterial () const

const std::shared_ptr< const ISurfaceMaterial > &	surfaceMaterialSharedPtr () const

void	assignSurfaceMaterial (std::shared_ptr< const ISurfaceMaterial > material)

bool	isOnSurface (const GeometryContext &gctx, const Vector3D &position, const Vector3D &momentum, const BoundaryCheck &bcheck=true) const

virtual bool	insideBounds (const Vector2D &lposition, const BoundaryCheck &bcheck=true) const

virtual void	localToGlobal (const GeometryContext &gctx, const Vector2D &lposition, const Vector3D &momentum, Vector3D &position) const =0

virtual bool	globalToLocal (const GeometryContext &gctx, const Vector3D &position, const Vector3D &momentum, Vector2D &lposition) const =0

virtual const Acts::RotationMatrix3D	referenceFrame (const GeometryContext &gctx, const Vector3D &position, const Vector3D &momentum) const

virtual void	initJacobianToGlobal (const GeometryContext &gctx, BoundToFreeMatrix &jacobian, const Vector3D &position, const Vector3D &direction, const BoundVector &pars) const

virtual const RotationMatrix3D	initJacobianToLocal (const GeometryContext &gctx, FreeToBoundMatrix &jacobian, const Vector3D &position, const Vector3D &direction) const

virtual const BoundRowVector	derivativeFactors (const GeometryContext &gctx, const Vector3D &position, const Vector3D &direction, const RotationMatrix3D &rft, const BoundToFreeMatrix &jacobian) const

virtual double	pathCorrection (const GeometryContext &gctx, const Vector3D &position, const Vector3D &direction) const =0

virtual SurfaceIntersection	intersect (const GeometryContext &gctx, const Vector3D &position, const Vector3D &direction, const BoundaryCheck &bcheck) const

virtual Intersection	intersectionEstimate (const GeometryContext &gctx, const Vector3D &position, const Vector3D &direction, const BoundaryCheck &bcheck) const =0

virtual std::ostream &	toStream (const GeometryContext &gctx, std::ostream &sl) const

virtual std::string	name () const =0
	Return properly formatted class name.

virtual Polyhedron	polyhedronRepresentation (const GeometryContext &gctx, size_t lseg) const =0

Public Member Functions inherited from Acts::GeometryObject
	GeometryObject ()=default
	Defaulted construrctor.

	GeometryObject (const GeometryObject &)=default
	Defaulted copy constructor.

	GeometryObject (const GeometryID &geoID)

GeometryObject &	operator= (const GeometryObject &geoID)

const GeometryID &	geoID () const

virtual const Vector3D	binningPosition (const GeometryContext &gctx, BinningValue bValue) const =0

virtual double	binningPositionValue (const GeometryContext &gctx, BinningValue bValue) const

void	assignGeoID (const GeometryID &geoID)

Static Public Member Functions
template<class T , typename... Args>
static std::shared_ptr< T >	makeShared (Args &&...args)

Protected Member Functions
	Surface (std::shared_ptr< const Transform3D > tform=nullptr)

	Surface (const Surface &other)

	Surface (const DetectorElementBase &detelement)

	Surface (const GeometryContext &gctx, const Surface &other, const Transform3D &shift)

Protected Attributes
std::shared_ptr< const Transform3D >	m_transform

const DetectorElementBase *	m_associatedDetElement {nullptr}
	Pointer to the a DetectorElementBase.

const Layer *	m_associatedLayer {nullptr}

const TrackingVolume *	m_associatedTrackingVolume {nullptr}

std::shared_ptr< const ISurfaceMaterial >	m_surfaceMaterial
	Possibility to attach a material descrption.

Protected Attributes inherited from Acts::GeometryObject
GeometryID	m_geoID

Detailed Description

Abstract Base Class for tracking surfaces.

The Surface class builds the core of the Acts Tracking Geometry. All other geometrical objects are either extending the surface or are built from it.

Surfaces are either owned by Detector elements or the Tracking Geometry, in which case they are not copied within the data model objects.

Definition at line 48 of file Surface.hpp.

View newest version in sPHENIX GitHub at line 48 of file Surface.hpp

Member Enumeration Documentation

enum Acts::Surface::SurfaceType

This enumerator simplifies the persistency & calculations, by saving a dynamic_cast, e.g. for persistency

Enumerator:

Cone
Cylinder
Disc
Perigee
Plane
Straw
Curvilinear
Other

Definition at line 55 of file Surface.hpp.

View newest version in sPHENIX GitHub at line 55 of file Surface.hpp

Constructor & Destructor Documentation

Acts::Surface::Surface ( std::shared_ptr< const Transform3D > tform = nullptr )

protected

Constructor with Transform3D as a shared object

Parameters

tform Transform3D positions the surface in 3D global space

Note: also acts as default constructor

Definition at line 15 of file Surface.cpp.

View newest version in sPHENIX GitHub at line 15 of file Surface.cpp

Acts::Surface::Surface ( const Surface & other )

protected

Copy constructor

Note: copy construction invalidates the association to detector element and layer

Parameters

other Source surface for copy.

Definition at line 23 of file Surface.cpp.

View newest version in sPHENIX GitHub at line 23 of file Surface.cpp

Acts::Surface::Surface ( const DetectorElementBase & detelement )

protected

Constructor fromt DetectorElementBase: Element proxy

Parameters

detelement Detector element which is represented by this surface

Definition at line 18 of file Surface.cpp.

View newest version in sPHENIX GitHub at line 18 of file Surface.cpp

Acts::Surface::Surface	(	const GeometryContext &	gctx,
		const Surface &	other,
		const Transform3D &	shift
	)

protected

Copy constructor with optional shift

Note: copy construction invalidates the association to detector element and layer

Parameters

gctx	The current geometry context object, e.g. alignment
other	Source surface for copy
shift	Additional transform applied after copying from the source

Definition at line 29 of file Surface.cpp.

View newest version in sPHENIX GitHub at line 29 of file Surface.cpp

Acts::Surface::~Surface ( )

virtualdefault

Member Function Documentation

void Surface::assignSurfaceMaterial ( std::shared_ptr< const ISurfaceMaterial > material )

inline

Assign the surface material description

The material is usually derived in a complicated way and loaded from a framework given source. As various surfaces may share the same source this is provided by a shared pointer

Parameters

material Material description associated to this surface

Definition at line 141 of file Surface.ipp.

View newest version in sPHENIX GitHub at line 141 of file Surface.ipp

Referenced by Acts::addLayerProtoMaterial(), Acts::TrackingVolume::assignBoundaryMaterial(), Acts::Test::BOOST_AUTO_TEST_CASE(), FW::Generic::LayerBuilderT< detector_element_t >::centralLayers(), FW::Generic::LayerBuilderT< detector_element_t >::constructEndcapLayers(), FW::Generic::GenericDetectorElement::GenericDetectorElement(), Acts::TrackingVolume::glueTrackingVolume(), Acts::CylinderVolumeHelper::glueTrackingVolumes(), Acts::Test::CylindricalTrackingGeometry::operator()(), and Acts::TrackingVolume::updateBoundarySurface().

Here is the caller graph for this function:

const DetectorElementBase * Surface::associatedDetectorElement ( ) const

inline

Return method for the associated Detector Element

Returns: plain pointer to the DetectorElement, can be nullptr

Definition at line 124 of file Surface.ipp.

View newest version in sPHENIX GitHub at line 124 of file Surface.ipp

Referenced by Acts::Test::BOOST_AUTO_TEST_CASE(), Acts::KalmanFitter< propagator_t, updater_t, smoother_t, outlier_finder_t, calibrator_t, input_converter_t, output_converter_t >::Actor< source_link_t, parameters_t >::filter(), Acts::CombinatorialKalmanFilter< propagator_t, updater_t, smoother_t, source_link_selector_t, branch_stopper_t, calibrator_t, input_converter_t, output_converter_t >::Actor< source_link_t, parameters_t >::filter(), Acts::SurfaceSelector::operator()(), and FW::Obj::ObjSurfaceWriter::write().

Here is the caller graph for this function:

const Layer * Surface::associatedLayer ( ) const

inline

Return method for the associated Layer in which the surface is embedded

Returns: Layer by plain pointer, can be nullptr

Definition at line 128 of file Surface.ipp.

View newest version in sPHENIX GitHub at line 128 of file Surface.ipp

Referenced by Acts::Test::BOOST_AUTO_TEST_CASE().

Here is the caller graph for this function:

void Surface::associateLayer ( const Layer & lay )

inline

Set Associated Layer Many surfaces can be associated to a Layer, but it might not be known yet during construction of the layer, this can be set afterwards

Parameters

lay	the assignment Layer by reference

Definition at line 146 of file Surface.ipp.

View newest version in sPHENIX GitHub at line 146 of file Surface.ipp

Referenced by Acts::LayerCreator::associateSurfacesToLayer(), Acts::Test::BOOST_AUTO_TEST_CASE(), Acts::PlaneLayer::buildApproachDescriptor(), Acts::CylinderLayer::CylinderLayer(), Acts::Test::CubicTrackingGeometry::operator()(), Acts::PlaneLayer::PlaneLayer(), and Acts::GenericApproachDescriptor::registerLayer().

Here is the caller graph for this function:

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

pure virtual

Return method for SurfaceBounds

Returns: SurfaceBounds by reference

Implemented in Acts::LineSurface, Acts::CylinderSurface, Acts::ConeSurface, Acts::PlaneSurface, and Acts::SurfaceStub.

Referenced by Acts::JsonGeometryConverter::addSurfaceToJson(), Acts::adjustBinUtility(), Acts::LayerArrayCreator::createNavigationSurface(), Acts::SurfaceArrayCreator::createVariableAxis(), Acts::JsonGeometryConverter::DefaultBin(), operator==(), FW::Obj::ObjSurfaceWriter::write(), and FW::RootMaterialTrackWriter::writeT().

Here is the caller graph for this function:

const Vector3D Surface::center ( const GeometryContext & gctx ) const

inlinevirtual

Return method for the surface center by reference

Note: the center is always recalculated in order to not keep a cache

Parameters

gctx	The current geometry context object, e.g. alignment

Returns: center position by value

Definition at line 13 of file Surface.ipp.

View newest version in sPHENIX GitHub at line 13 of file Surface.ipp

References Acts::Test::transform.

Referenced by Acts::Test::BOOST_AUTO_TEST_CASE(), Acts::PlaneLayer::buildApproachDescriptor(), Acts::AtlasStepper< ConstantBField >::covarianceTransport(), Acts::ImpactPointEstimator< input_track_t, propagator_t, propagator_options_t >::getDistanceAndMomentum(), Acts::ProtoLayer::measure(), and normal().

Here is the caller graph for this function:

const BoundRowVector Surface::derivativeFactors	(	const GeometryContext &	gctx,
		const Vector3D &	position,
		const Vector3D &	direction,
		const RotationMatrix3D &	rft,
		const BoundToFreeMatrix &	jacobian
	)		const

inlinevirtual

Calculate the form factors for the derivatives the calculation is identical for all surfaces where the reference frame does not depend on the direction

Parameters

gctx	The current geometry context object, e.g. alignment
position	is the position of the paramters in global
direction	is the direction of the track
rft	is the transposed reference frame (avoids recalculation)
jacobian	is the transport jacobian

Returns: a five-dim vector

Reimplemented in Acts::LineSurface.

Definition at line 113 of file Surface.ipp.

View newest version in sPHENIX GitHub at line 113 of file Surface.ipp

References Acts::eBoundParametersSize.

std::shared_ptr< Acts::Surface > Acts::Surface::getSharedPtr ( )

Retrieve a std::shared_ptr for this surface (non-const version)

Note: Will error if this was not created through the makeShared factory since it needs access to the original reference. In C++14 this is undefined behavior (but most likely implemented as a bad_weak_ptr exception), in C++17 it is defined as that exception.; Only call this if you need shared ownership of this object.

Returns: The shared pointer

Definition at line 54 of file Surface.cpp.

View newest version in sPHENIX GitHub at line 54 of file Surface.cpp

Referenced by Acts::MultiTrajectory< source_link_t >::addTrackState(), Acts::Test::PropagatorState::Stepper::boundState(), Acts::detail::boundState(), Acts::AtlasStepper< ConstantBField >::boundState(), Acts::DD4hepLayerBuilder::createSensitiveSurface(), Acts::KalmanFitter< propagator_t, updater_t, smoother_t, outlier_finder_t, calibrator_t, input_converter_t, output_converter_t >::Actor< source_link_t, parameters_t >::filter(), Acts::Test::make_trackstate(), FW::SimSourceLink::operator*(), FW::CsvPlanarClusterReader::read(), and Acts::detail_lt::TrackStateProxy< source_link_t, N, M, ReadOnly >::setCalibrated().

Here is the caller graph for this function:

std::shared_ptr< const Acts::Surface > Acts::Surface::getSharedPtr ( ) const

Retrieve a std::shared_ptr for this surface (const version)

Note: Will error if this was not created through the makeShared factory since it needs access to the original reference. In C++14 this is undefined behavior, but most likely implemented as a bad_weak_ptr exception, in C++17 it is defined as that exception.; Only call this if you need shared ownership of this object.

Returns: The shared pointer

Definition at line 58 of file Surface.cpp.

View newest version in sPHENIX GitHub at line 58 of file Surface.cpp

virtual bool Acts::Surface::globalToLocal	(	const GeometryContext &	gctx,
		const Vector3D &	position,
		const Vector3D &	momentum,
		Vector2D &	lposition
	)		const

pure virtual

Global to local transformation Generalized global to local transformation for the surface types. Since some surface types need the global momentum/direction to resolve sign ambiguity this is also provided

Parameters

gctx	The current geometry context object, e.g. alignment
position	global 3D position - considered to be on surface but not inside bounds (check is done)
momentum	global 3D momentum representation (optionally ignored)
lposition	local 2D position to be filled (given by reference for method symmetry)

Returns: boolean indication if operation was successful (fail means global position was not on surface)

Implemented in Acts::LineSurface, Acts::CylinderSurface, Acts::ConeSurface, Acts::PlaneSurface, and Acts::SurfaceStub.

Referenced by FW::HitSmearing::execute(), ActsFatras::Interactor< generator_t, physics_list_t, hit_surface_selector_t >::operator()(), and FW::CsvPlanarClusterReader::read().

Here is the caller graph for this function:

void Surface::initJacobianToGlobal	(	const GeometryContext &	gctx,
		BoundToFreeMatrix &	jacobian,
		const Vector3D &	position,
		const Vector3D &	direction,
		const BoundVector &	pars
	)		const

inlinevirtual

Initialize the jacobian from local to global the surface knows best, hence the calculation is done here. The jacobian is assumed to be initialised, so only the relevant entries are filled

Parameters

gctx	The current geometry context object, e.g. alignment
jacobian	is the jacobian to be initialized
position	is the global position of the parameters
direction	is the direction at of the parameters
pars	is the parameter vector

Reimplemented in Acts::LineSurface.

Definition at line 46 of file Surface.ipp.

View newest version in sPHENIX GitHub at line 46 of file Surface.ipp

References Acts::ePHI, Acts::eQOP, Acts::eT, Acts::eTHETA, x, y, and z.

Referenced by Acts::CombinatorialKalmanFilter< propagator_t, updater_t, smoother_t, source_link_selector_t, branch_stopper_t, calibrator_t, input_converter_t, output_converter_t >::Actor< source_link_t, parameters_t >::reset().

Here is the caller graph for this function:

const RotationMatrix3D Surface::initJacobianToLocal	(	const GeometryContext &	gctx,
		FreeToBoundMatrix &	jacobian,
		const Vector3D &	position,
		const Vector3D &	direction
	)		const

inlinevirtual

Initialize the jacobian from global to local the surface knows best, hence the calculation is done here. The jacobian is assumed to be initialised, so only the relevant entries are filled

Parameters

jacobian	is the jacobian to be initialized
position	is the global position of the parameters
direction	is the direction at of the parameters
gctx	The current geometry context object, e.g. alignment

Returns: the transposed reference frame (avoids recalculation)

Definition at line 82 of file Surface.ipp.

View newest version in sPHENIX GitHub at line 82 of file Surface.ipp

References Acts::ePHI, Acts::eQOP, Acts::eT, Acts::eTHETA, x, y, and z.

bool Surface::insideBounds	(	const Vector2D &	lposition,
		const BoundaryCheck &	bcheck = `true`
	)		const

inlinevirtual

The insideBounds method for local positions

Parameters

lposition	The local position to check
bcheck	BoundaryCheck directive for this onSurface check

Returns: boolean indication if operation was successful

Definition at line 35 of file Surface.ipp.

View newest version in sPHENIX GitHub at line 35 of file Surface.ipp

Referenced by Acts::Test::BOOST_AUTO_TEST_CASE().

Here is the caller graph for this function:

virtual SurfaceIntersection Acts::Surface::intersect	(	const GeometryContext &	gctx,
		const Vector3D &	position,
		const Vector3D &	direction,
		const BoundaryCheck &	bcheck
	)		const

inlinevirtual

Straight line intersection schema from position/direction

Parameters

gctx	The current geometry context object, e.g. alignment
position	The position to start from
direction	The direction at start
bcheck	the Boundary Check

Returns: SurfaceIntersection object (contains intersection & surface)

Reimplemented in Acts::CylinderSurface, and Acts::ConeSurface.

Definition at line 397 of file Surface.hpp.

View newest version in sPHENIX GitHub at line 397 of file Surface.hpp

References intersectionEstimate().

Referenced by Acts::Layer::compatibleSurfaces(), Acts::SurfaceReached::operator()(), Acts::Layer::surfaceOnApproach(), and Acts::detail::updateSingleSurfaceStatus().

Here is the call graph for this function:

Here is the caller graph for this function:

virtual Intersection Acts::Surface::intersectionEstimate	(	const GeometryContext &	gctx,
		const Vector3D &	position,
		const Vector3D &	direction,
		const BoundaryCheck &	bcheck
	)		const

pure virtual

Straight line intersection from position and momentum

Parameters

gctx	The current geometry context object, e.g. alignment
position	global 3D position - considered to be on surface but not inside bounds (check is done)
direction	3D direction representation - expected to be normalized (no check done)
bcheck	boundary check directive for this operation

Returns: Intersection object

Implemented in Acts::LineSurface, Acts::PlaneSurface, Acts::CylinderSurface, Acts::ConeSurface, and Acts::SurfaceStub.

Referenced by Acts::TrackingVolume::compatibleSurfacesFromHierarchy(), intersect(), and FW::RootMaterialTrackWriter::writeT().

Here is the caller graph for this function:

bool Acts::Surface::isOnSurface	(	const GeometryContext &	gctx,
		const Vector3D &	position,
		const Vector3D &	momentum,
		const BoundaryCheck &	bcheck = `true`
	)		const

The geometric onSurface method

Geometrical check whether position is on Surface

Parameters

gctx	The current geometry context object, e.g. alignment
position	global position to be evaludated
momentum	global momentum (required for line-type surfaces)
bcheck	BoundaryCheck directive for this onSurface check

Returns: boolean indication if operation was successful

Definition at line 39 of file Surface.cpp.

View newest version in sPHENIX GitHub at line 39 of file Surface.cpp

Referenced by Acts::Test::BOOST_AUTO_TEST_CASE(), and Acts::BoundarySurfaceT< T >::onBoundary().

Here is the caller graph for this function:

virtual void Acts::Surface::localToGlobal	(	const GeometryContext &	gctx,
		const Vector2D &	lposition,
		const Vector3D &	momentum,
		Vector3D &	position
	)		const

pure virtual

Local to global transformation Generalized local to global transformation for the surface types. Since some surface types need the global momentum/direction to resolve sign ambiguity this is also provided

Parameters

gctx	The current geometry context object, e.g. alignment
lposition	local 2D position in specialized surface frame
momentum	global 3D momentum representation (optionally ignored)
position	global 3D position to be filled (given by reference for method symmetry)

Implemented in Acts::LineSurface, Acts::CylinderSurface, Acts::ConeSurface, Acts::PlaneSurface, and Acts::SurfaceStub.

Referenced by Acts::SurfaceArrayCreator::makeGlobalVertices(), FW::CsvPlanarClusterWriter::writeT(), and FW::RootPlanarClusterWriter::writeT().

Here is the caller graph for this function:

template<class T , typename... Args>

static std::shared_ptr<T> Acts::Surface::makeShared ( Args &&... args )

inlinestatic

Factory for producing memory managed instances of Surface. Will forward all parameters and will attempt to find a suitable constructor.

Definition at line 104 of file Surface.hpp.

View newest version in sPHENIX GitHub at line 104 of file Surface.hpp

References T.

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

pure virtual

Return properly formatted class name.

Implemented in Acts::LineSurface, Acts::ConeSurface, Acts::CylinderSurface, Acts::PlaneSurface, Acts::SurfaceStub, Acts::StrawSurface, and Acts::PerigeeSurface.

virtual const Vector3D Acts::Surface::normal	(	const GeometryContext &	gctx,
		const Vector2D &	lposition
	)		const

pure virtual

Return method for the normal vector of the surface The normal vector can only be generally defined at a given local position It requires a local position to be given (in general)

Parameters

gctx	The current geometry context object, e.g. alignment
lposition	is the local position where the normal vector is constructed

Returns: normal vector by value

Implemented in Acts::CylinderSurface, Acts::ConeSurface, Acts::PlaneSurface, Acts::LineSurface, and Acts::SurfaceStub.

Referenced by Acts::Test::BOOST_AUTO_TEST_CASE(), Acts::PlaneLayer::buildApproachDescriptor(), normal(), and ActsFatras::Interactor< generator_t, physics_list_t, hit_surface_selector_t >::operator()().

Here is the caller graph for this function:

virtual const Vector3D Acts::Surface::normal	(	const GeometryContext &	gctx,
		const Vector3D &	position
	)		const

virtual

Return method for the normal vector of the surface The normal vector can only be generally defined at a given local position It requires a local position to be given (in general)

Parameters

position	is the global position where the normal vector is constructed
gctx	The current geometry context object, e.g. alignment

Returns: normal vector by value

Reimplemented in Acts::CylinderSurface, Acts::ConeSurface, and Acts::SurfaceStub.

virtual const Vector3D Acts::Surface::normal ( const GeometryContext & gctx ) const

inlinevirtual

Return method for the normal vector of the surface

It will return a normal vector at the center() position

Parameters

gctx	The current geometry context object, e.g. alignment

Returns: normal vector by value

Reimplemented in Acts::SurfaceStub.

Definition at line 206 of file Surface.hpp.

View newest version in sPHENIX GitHub at line 206 of file Surface.hpp

References center(), and normal().

Here is the call graph for this function:

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

virtual

Comparison (non-equality) operator

Parameters

sf	Source surface for the comparison

Definition at line 131 of file Surface.cpp.

View newest version in sPHENIX GitHub at line 131 of file Surface.cpp

References Acts::operator==().

Here is the call graph for this function:

Acts::Surface & Acts::Surface::operator= ( const Surface & other )

Assignment operator

Note: copy construction invalidates the association to detector element and layer

Parameters

other Source surface for the assignment

Definition at line 62 of file Surface.cpp.

View newest version in sPHENIX GitHub at line 62 of file Surface.cpp

References m_associatedDetElement, m_associatedLayer, m_surfaceMaterial, m_transform, and Acts::GeometryObject::operator=().

Referenced by Acts::LineSurface::operator=(), Acts::PlaneSurface::operator=(), Acts::ConeSurface::operator=(), and Acts::CylinderSurface::operator=().

Here is the call graph for this function:

Here is the caller graph for this function:

bool Acts::Surface::operator== ( const Surface & other ) const

virtual

Comparison (equality) operator The strategy for comparison is (a) first pointer comparison (b) then type comparison (c) then bounds comparison (d) then transform comparison

Parameters

other source surface for the comparison

Definition at line 74 of file Surface.cpp.

View newest version in sPHENIX GitHub at line 74 of file Surface.cpp

References bounds(), e, m_associatedDetElement, m_surfaceMaterial, m_transform, and type().

Here is the call graph for this function:

virtual double Acts::Surface::pathCorrection	(	const GeometryContext &	gctx,
		const Vector3D &	position,
		const Vector3D &	direction
	)		const

pure virtual

Calucation of the path correction for incident

Parameters

gctx	The current geometry context object, e.g. alignment
position	global 3D position - considered to be on surface but not inside bounds (check is done)
direction	global 3D momentum direction

Returns: Path correction with respect to the nominal incident.

Implemented in Acts::LineSurface, Acts::CylinderSurface, Acts::ConeSurface, Acts::PlaneSurface, and Acts::SurfaceStub.

Referenced by Acts::Layer::compatibleSurfaces(), and Acts::detail::PointwiseMaterialInteraction::evaluateMaterialProperties().

Here is the caller graph for this function:

virtual Polyhedron Acts::Surface::polyhedronRepresentation	(	const GeometryContext &	gctx,
		size_t	lseg
	)		const

pure virtual

Return a Polyhedron for this object

Parameters

gctx	The current geometry context object, e.g. alignment
lseg	Number of segments along curved lines, if the lseg is set to one, only the corners and the extrema are given, otherwise it represents the number of segments for a full 2*M_PI circle and is scaled to the relevant sector

Note: An internal surface transform can invalidate the extrema in the transformed space

Returns: A list of vertices and a face/facett description of it

Implemented in Acts::CylinderSurface, Acts::ConeSurface, Acts::PlaneSurface, Acts::SurfaceStub, Acts::StrawSurface, Acts::PerigeeSurface, and Acts::Test::LineSurfaceStub.

const RotationMatrix3D Surface::referenceFrame	(	const GeometryContext &	gctx,
		const Vector3D &	position,
		const Vector3D &	momentum
	)		const

inlinevirtual

Return mehtod for the reference frame This is the frame in which the covariance matrix is defined (specialized by all surfaces)

Parameters

gctx	The current geometry context object, e.g. alignment
position	global 3D position - considered to be on surface but not inside bounds (check is done)
momentum	global 3D momentum representation (optionally ignored)

Returns: RotationMatrix3D which defines the three axes of the measurement frame

Reimplemented in Acts::LineSurface, Acts::ConeSurface, and Acts::CylinderSurface.

Definition at line 40 of file Surface.ipp.

View newest version in sPHENIX GitHub at line 40 of file Surface.ipp

References Acts::Test::transform.

Referenced by Acts::Test::BOOST_AUTO_TEST_CASE(), and Acts::AtlasStepper< ConstantBField >::covarianceTransport().

Here is the caller graph for this function:

const ISurfaceMaterial * Surface::surfaceMaterial ( ) const

inline

Return method for the associated Material to this surface

Returns: SurfaceMaterial as plain pointer, can be nullptr

Definition at line 132 of file Surface.ipp.

View newest version in sPHENIX GitHub at line 132 of file Surface.ipp

Referenced by Acts::Test::BOOST_AUTO_TEST_CASE(), Acts::SurfaceMaterialMapper::checkAndInsert(), Acts::JsonGeometryConverter::convertToRep(), Acts::KalmanFitter< propagator_t, updater_t, smoother_t, outlier_finder_t, calibrator_t, input_converter_t, output_converter_t >::Actor< source_link_t, parameters_t >::filter(), Acts::CombinatorialKalmanFilter< propagator_t, updater_t, smoother_t, source_link_selector_t, branch_stopper_t, calibrator_t, input_converter_t, output_converter_t >::Actor< source_link_t, parameters_t >::filter(), Acts::KalmanFitter< propagator_t, updater_t, smoother_t, outlier_finder_t, calibrator_t, input_converter_t, output_converter_t >::Actor< source_link_t, parameters_t >::materialInteractor(), Acts::CombinatorialKalmanFilter< propagator_t, updater_t, smoother_t, source_link_selector_t, branch_stopper_t, calibrator_t, input_converter_t, output_converter_t >::Actor< source_link_t, parameters_t >::materialInteractor(), Acts::MaterialSurface::operator()(), Acts::SurfaceSelector::operator()(), Acts::MaterialInteractor::operator()(), ActsFatras::Interactor< generator_t, physics_list_t, hit_surface_selector_t >::operator()(), and Acts::Layer::surfaceOnApproach().

Here is the caller graph for this function:

const std::shared_ptr< const ISurfaceMaterial > & Surface::surfaceMaterialSharedPtr ( ) const

inline

Return method for the shared pointer to the associated Material

Returns: SurfaceMaterial as shared_pointer, can be nullptr

Definition at line 137 of file Surface.ipp.

View newest version in sPHENIX GitHub at line 137 of file Surface.ipp

Referenced by FW::RootMaterialWriter::collectMaterial(), and Acts::TrackingVolume::glueTrackingVolume().

Here is the caller graph for this function:

std::ostream & Acts::Surface::toStream	(	const GeometryContext &	gctx,
		std::ostream &	sl
	)		const

virtual

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

Parameters

gctx	The current geometry context object, e.g. alignment
sl	is the ostream to be dumped into

Reimplemented in Acts::PerigeeSurface.

Definition at line 107 of file Surface.cpp.

View newest version in sPHENIX GitHub at line 107 of file Surface.cpp

References Acts::Test::transform.

const Transform3D & Surface::transform ( const GeometryContext & gctx ) const

inlinevirtual

Return method for the surface Transform3D by reference In case a detector element is associated the surface transform is just forwarded to the detector element in order to keep the (mis-)alignment cache cetrally handled

Parameters

gctx	The current geometry context object, e.g. alignment

Returns: the contextual transform

Definition at line 24 of file Surface.ipp.

View newest version in sPHENIX GitHub at line 24 of file Surface.ipp

References Acts::s_idTransform.

Referenced by Acts::JsonGeometryConverter::addSurfaceToJson(), Acts::Test::BOOST_AUTO_TEST_CASE(), Acts::PlaneLayer::buildApproachDescriptor(), Acts::LayerArrayCreator::createNavigationSurface(), Acts::ImpactPointEstimator< input_track_t, propagator_t, propagator_options_t >::get3dVertexCompatibility(), Acts::ProtoLayer::measure(), Acts::PlaneSurface::PlaneSurface(), and FW::Obj::ObjSurfaceWriter::write().

Here is the caller graph for this function:

virtual SurfaceType Acts::Surface::type ( ) const

pure virtual

Return method for the Surface type to avoid dynamic casts.

Implemented in Acts::CylinderSurface, Acts::PlaneSurface, Acts::ConeSurface, Acts::StrawSurface, Acts::PerigeeSurface, Acts::Test::LineSurfaceStub, and Acts::SurfaceStub.

Referenced by Acts::adjustBinUtility(), Acts::AtlasStepper< ConstantBField >::covarianceTransport(), Acts::LayerArrayCreator::createNavigationSurface(), Acts::Test::PlaneSelector::operator()(), operator==(), and FW::RootMaterialTrackWriter::writeT().

Here is the caller graph for this function:

Member Data Documentation

const DetectorElementBase* Acts::Surface::m_associatedDetElement {nullptr}

protected

Pointer to the a DetectorElementBase.

Definition at line 455 of file Surface.hpp.

View newest version in sPHENIX GitHub at line 455 of file Surface.hpp

Referenced by operator=(), and operator==().

const Layer* Acts::Surface::m_associatedLayer {nullptr}

protected

The associated layer Layer - layer in which the Surface is be embedded, nullptr if not associated

Definition at line 459 of file Surface.hpp.

View newest version in sPHENIX GitHub at line 459 of file Surface.hpp

Referenced by operator=().

const TrackingVolume* Acts::Surface::m_associatedTrackingVolume {nullptr}

protected

The assoicated TrackingVolume - tracking volume in case the surface is a boundary surface, nullptr if not associated

Definition at line 463 of file Surface.hpp.

View newest version in sPHENIX GitHub at line 463 of file Surface.hpp

std::shared_ptr<const ISurfaceMaterial> Acts::Surface::m_surfaceMaterial

protected

Possibility to attach a material descrption.

Definition at line 466 of file Surface.hpp.

View newest version in sPHENIX GitHub at line 466 of file Surface.hpp

Referenced by operator=(), and operator==().

std::shared_ptr<const Transform3D> Acts::Surface::m_transform

protected

Transform3D definition that positions (translation, rotation) the surface in global space

Definition at line 452 of file Surface.hpp.

View newest version in sPHENIX GitHub at line 452 of file Surface.hpp

Referenced by Acts::CylinderLayer::CylinderLayer(), operator=(), operator==(), Acts::PerigeeSurface::PerigeeSurface(), and Acts::PlaneSurface::PlaneSurface().

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

acts/blob/master/Core/include/Acts/Surfaces/Surface.hpp
acts/blob/master/Core/include/Acts/Surfaces/detail/Surface.ipp
acts/blob/master/Core/src/Surfaces/Surface.cpp

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation