Acts::ConeLayer Class Reference

Class to describe a conical detector layer for tracking, it inherits from both, Layer base class and ConeSurface class. More...

#include <Acts/Geometry/ConeLayer.hpp>

Inheritance diagram for Acts::ConeLayer:

Collaboration diagram for Acts::ConeLayer:

Public Member Functions
	ConeLayer ()=delete
	ConeLayer (const ConeLayer &cla)=delete
	~ConeLayer () override=default
ConeLayer &	operator= (const ConeLayer &)=delete
const ConeSurface &	surfaceRepresentation () const override
	Transforms the layer into a Surface representation for extrapolation.
ConeSurface &	surfaceRepresentation () override
	Non-const version of surface representation access.
Public Member Functions inherited from Acts::ConeSurface
AlignmentToPathMatrix	alignmentToPathDerivative (const GeometryContext &gctx, const Vector3 &position, const Vector3 &direction) const final
	Calculate the derivative of path length at the geometry constraint or point-of-closest-approach w.r.t.
void	assignSurfaceBounds (std::shared_ptr< const ConeBounds > newBounds)
	Overwrite the existing surface bounds with new ones.
const ConeBounds &	bounds () const final
	This method returns the ConeBounds by reference.
const std::shared_ptr< const ConeBounds > &	boundsPtr () const
	This method returns the shared_ptr to the ConeBounds.
Result< Vector2 >	globalToLocal (const GeometryContext &gctx, const Vector3 &position, const Vector3 &direction, double tolerance=s_onSurfaceTolerance) const final
	Convert a global position to a local one this is the most generic interface, which is implemented by all surfaces.
Result< Vector2 >	globalToLocal (const GeometryContext &gctx, const Vector3 &position, double tolerance=s_onSurfaceTolerance) const final
	Global to local transformation.
MultiIntersection3D	intersect (const GeometryContext &gctx, const Vector3 &position, const Vector3 &direction, const BoundaryTolerance &boundaryTolerance=BoundaryTolerance::Infinite(), double tolerance=s_onSurfaceTolerance) const final
	Straight line intersection schema from position/direction.
ActsMatrix< 2, 3 >	localCartesianToBoundLocalDerivative (const GeometryContext &gctx, const Vector3 &position) const final
	Calculate the derivative of bound track parameters local position w.r.t.
Vector3	localToGlobal (const GeometryContext &gctx, const Vector2 &lposition) const final
	Local to global transformation.
Vector3	localToGlobal (const GeometryContext &gctx, const Vector2 &lposition, const Vector3 &direction) const final
	Local to global transformation.
std::string	name () const override
	Return properly formatted class name for screen output.
Vector3	normal (const GeometryContext &gctx, const Vector2 &lposition) const final
	Return method for surface normal information.
Vector3	normal (const GeometryContext &gctx, const Vector3 &pos, const Vector3 &direction) const final
	Calculate the normal vector of the surface This overload is fully generic, fulfills the Surface interface and accepts a global position and a direction.
Vector3	normal (const GeometryContext &gctx, const Vector3 &position) const final
	Return method for surface normal information.
ConeSurface &	operator= (const ConeSurface &other)
	Assignment operator.
double	pathCorrection (const GeometryContext &gctx, const Vector3 &position, const Vector3 &direction) const final
	The pathCorrection for derived classes with thickness.
Polyhedron	polyhedronRepresentation (const GeometryContext &gctx, unsigned int quarterSegments=2u) const override
	Return a Polyhedron for the surfaces.
RotationMatrix3	referenceFrame (const GeometryContext &gctx, const Vector3 &position, const Vector3 &direction) const final
	Return the measurement frame - this is needed for alignment, in particular for StraightLine and Perigee Surface.
Vector3	referencePosition (const GeometryContext &gctx, AxisDirection aDir) const final
	The binning position method - is overloaded for r-type binning.
virtual Vector3	rotSymmetryAxis (const GeometryContext &gctx) const
SurfaceType	type () const override
	Return the surface type.
Public Member Functions inherited from Acts::RegularSurface
Result< Vector2 >	globalToLocal (const GeometryContext &gctx, const Vector3 &position, const Vector3 &direction, double tolerance=s_onSurfaceTolerance) const final
	Convert a global position to a local one this is the most generic interface, which is implemented by all surfaces.
bool	isOnSurface (const GeometryContext &gctx, const Vector3 &position, const BoundaryTolerance &boundaryTolerance=BoundaryTolerance::None(), double tolerance=s_onSurfaceTolerance) const
	The geometric onSurface method.
bool	isOnSurface (const GeometryContext &gctx, const Vector3 &position, const Vector3 &direction, const BoundaryTolerance &boundaryTolerance=BoundaryTolerance::None(), double tolerance=s_onSurfaceTolerance) const
	The geometric onSurface method.
Vector3	localToGlobal (const GeometryContext &gctx, const Vector2 &lposition, const Vector3 &direction) const final
	Local to global transformation.
Vector3	normal (const GeometryContext &gctx, const Vector3 &pos, const Vector3 &direction) const final
	Calculate the normal vector of the surface This overload is fully generic, fulfills the Surface interface and accepts a global position and a direction.
	Surface (const GeometryContext &gctx, const Surface &other, const Transform3 &shift) noexcept
	Copy constructor with optional shift.
	Surface (const Surface &other) noexcept
	Copy constructor.
	Surface (const SurfacePlacementBase &placement) noexcept
	Constructor from SurfacePlacement: Element proxy.
	Surface (const Transform3 &transform=Transform3::Identity())
	Constructor with Transform3 as a shared object.
Public Member Functions inherited from Acts::Surface
	~Surface () noexcept override
AlignmentToBoundMatrix	alignmentToBoundDerivative (const GeometryContext &gctx, const Vector3 &position, const Vector3 &direction, const FreeVector &pathDerivative) const
	The derivative of bound track parameters w.r.t.
void	assignDetectorElement (const SurfacePlacementBase &detelement)
	Assign a detector element.
void	assignIsSensitive (bool isSensitive)
	Assign whether the surface is sensitive.
void	assignSurfaceMaterial (std::shared_ptr< const ISurfaceMaterial > material)
	Assign the surface material description.
void	assignSurfacePlacement (const SurfacePlacementBase &placement)
	Assign a placement object which may dynamically align the surface in space.
void	assignThickness (double thick)
	Assign the thickness of the surface in the orthogonal dimension.
const DetectorElementBase *	associatedDetectorElement () const
	Return method for the associated Detector Element.
const Layer *	associatedLayer () const
	Return method for the associated Layer in which the surface is embedded.
void	associateLayer (const Layer &lay)
	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.
virtual BoundToFreeMatrix	boundToFreeJacobian (const GeometryContext &gctx, const Vector3 &position, const Vector3 &direction) const
	Calculate the jacobian from local to global which the surface knows best, hence the calculation is done here.
virtual Vector3	center (const GeometryContext &gctx) const
	Return method for the surface center.
virtual Vector2	closestPointOnBoundary (const Vector2 &lposition, const SquareMatrix2 &metric) const
	Calculates the closest point on the boundary of the surface to a given point in local coordinates.
virtual double	distanceToBoundary (const Vector2 &lposition) const
	Calculates the distance to the boundary of the surface from a given point in local coordinates.
virtual FreeToBoundMatrix	freeToBoundJacobian (const GeometryContext &gctx, const Vector3 &position, const Vector3 &direction) const
	Calculate the jacobian from global to local which the surface knows best, hence the calculation is done here.
virtual FreeToPathMatrix	freeToPathDerivative (const GeometryContext &gctx, const Vector3 &position, const Vector3 &direction) const
	Calculate the derivative of path length at the geometry constraint or point-of-closest-approach w.r.t.
std::shared_ptr< Surface >	getSharedPtr ()
	Retrieve a std::shared_ptr for this surface (non-const version).
std::shared_ptr< const Surface >	getSharedPtr () const
	Retrieve a std::shared_ptr for this surface (const version).
virtual bool	insideBounds (const Vector2 &lposition, const BoundaryTolerance &boundaryTolerance=BoundaryTolerance::None()) const
	The insideBounds method for local positions.
bool	isAlignable () const
	Returns whether the Surface is alignable.
bool	isOnSurface (const GeometryContext &gctx, const Vector3 &position, const Vector3 &direction, const BoundaryTolerance &boundaryTolerance=BoundaryTolerance::None(), double tolerance=s_onSurfaceTolerance) const
	The geometric onSurface method.
bool	isSensitive () const
	Returns whether the Surface is sensitive.
const Transform3 &	localToGlobalTransform (const GeometryContext &gctx) const
	Return method for the surface Transform3 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.
Surface &	operator= (const Surface &other)
	Assignment operator.
bool	operator== (const Surface &other) const
	Comparison (equality) operator The strategy for comparison is (a) first pointer comparison (b) then type comparison (c) then bounds comparison (d) then transform comparison.
const ISurfaceMaterial *	surfaceMaterial () const
	Return method for the associated Material to this surface.
const std::shared_ptr< const ISurfaceMaterial > &	surfaceMaterialSharedPtr () const
	Return method for the shared pointer to the associated Material.
const SurfacePlacementBase *	surfacePlacement () const
	Return the associated surface placement if there is any.
double	thickness () const
	Return the thickness of the surface in the normal direction.
GeometryContextOstreamWrapper< Surface >	toStream (const GeometryContext &gctx) const
	Helper method for printing: the returned object captures the surface and the geometry context and will print the surface.
std::string	toString (const GeometryContext &gctx) const
	Output into a std::string.
const Transform3 &	transform (const GeometryContext &gctx) const
	Return method for the surface Transform3 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.
void	visualize (IVisualization3D &helper, const GeometryContext &gctx, const ViewConfig &viewConfig=s_viewSurface) const
	Visualize the surface for debugging and inspection.
Public Member Functions inherited from Acts::GeometryObject
	GeometryObject ()=default
	Defaulted constructor.
	GeometryObject (const GeometryIdentifier &geometryId)
	Constructor from a value.
	GeometryObject (const GeometryObject &)=default
	Defaulted copy constructor.
virtual	~GeometryObject () noexcept=default
void	assignGeometryId (const GeometryIdentifier &geometryId)
	Set the value.
GeometryIdentifier	geometryId () const
virtual double	referencePositionValue (const GeometryContext &gctx, AxisDirection aDir) const
	Implement the binningValue.
Public Member Functions inherited from Acts::Layer
	~Layer () noexcept override
	Destructor.
ApproachDescriptor *	approachDescriptor ()
	Non-const version of the approach descriptor.
const ApproachDescriptor *	approachDescriptor () const
	Return method for the approach descriptor, can be nullptr.
boost::container::small_vector< NavigationTarget, 10 >	compatibleSurfaces (const GeometryContext &gctx, const Vector3 &position, const Vector3 &direction, const NavigationOptions< Surface > &options) const
	Decompose Layer into (compatible) surfaces.
virtual bool	isOnLayer (const GeometryContext &gctx, const Vector3 &position, const BoundaryTolerance &boundaryTolerance=BoundaryTolerance::None()) const
	geometrical isOnLayer() method
double	layerThickness () const
	Return the Thickness of the Layer this is by definition along the normal vector of the surfaceRepresentation.
LayerType	layerType () const
	return the LayerType
const Layer *	nextLayer (const GeometryContext &gctx, const Vector3 &position, const Vector3 &direction) const
	Fast navigation to next layer.
const Volume *	representingVolume () const
	Return the abstract volume that represents the layer.
virtual bool	resolve (bool resolveSensitive, bool resolveMaterial, bool resolvePassive) const
	Accept layer according to the following collection directives.
template<typename options_t>
bool	resolve (const options_t &options) const
	Accept layer according to the following collection directives.
SurfaceArray *	surfaceArray ()
	Non-const version.
const SurfaceArray *	surfaceArray () const
	Return the entire SurfaceArray, returns a nullptr if no SurfaceArray.
NavigationTarget	surfaceOnApproach (const GeometryContext &gctx, const Vector3 &position, const Vector3 &direction, const NavigationOptions< Layer > &options) const
	Surface seen on approach for layers without sub structure, this is the surfaceRepresentation for layers with sub structure, this is the approachSurface.
const TrackingVolume *	trackingVolume () const
	Get the confining TrackingVolume.

Static Public Member Functions
static std::shared_ptr< ConeLayer >	create (const Transform3 &transform, std::shared_ptr< const ConeBounds > cbounds, std::unique_ptr< SurfaceArray > surfaceArray, double thickness=0., std::unique_ptr< ApproachDescriptor > ad=nullptr, LayerType laytyp=active)
	Factory for shared layer.
Static Public Member Functions inherited from Acts::Surface
template<class T, typename... Args>
static std::shared_ptr< T >	makeShared (Args &&... args)
	Factory for producing memory managed instances of Surface.

Protected Member Functions
	ConeLayer (const ConeLayer &cla, const Transform3 &shift)
	Private copy constructor with shift, called by create(args*).
	ConeLayer (const Transform3 &transform, std::shared_ptr< const ConeBounds > cbounds, std::unique_ptr< SurfaceArray > surfaceArray, double thickness=0., std::unique_ptr< ApproachDescriptor > ade=nullptr, LayerType laytyp=active)
	Private constructor with arguments.
Protected Member Functions inherited from Acts::ConeSurface
	ConeSurface (const ConeSurface &other)
	Copy constructor.
	ConeSurface (const GeometryContext &gctx, const ConeSurface &other, const Transform3 &shift)
	Copy constructor - with shift.
	ConeSurface (const Transform3 &transform, double alpha, bool symmetric=false)
	Constructor form HepTransform and an opening angle.
	ConeSurface (const Transform3 &transform, double alpha, double zmin, double zmax, double halfPhi=std::numbers::pi)
	Constructor form HepTransform and an opening angle.
	ConeSurface (const Transform3 &transform, std::shared_ptr< const ConeBounds > cbounds)
	Constructor from HepTransform and ConeBounds.
Protected Member Functions inherited from Acts::Surface
	Surface (const GeometryContext &gctx, const Surface &other, const Transform3 &shift) noexcept
	Copy constructor with optional shift.
	Surface (const Surface &other) noexcept
	Copy constructor.
	Surface (const SurfacePlacementBase &placement) noexcept
	Constructor from SurfacePlacement: Element proxy.
	Surface (const Transform3 &transform=Transform3::Identity())
	Constructor with Transform3 as a shared object.
virtual std::ostream &	toStreamImpl (const GeometryContext &gctx, std::ostream &sl) const
	Output Method for std::ostream, to be overloaded by child classes.
Protected Member Functions inherited from Acts::Layer
	Layer (std::unique_ptr< SurfaceArray > surfaceArray, double thickness=0., std::unique_ptr< ApproachDescriptor > ades=nullptr, LayerType laytyp=passive)
	Constructor with pointer to SurfaceArray (passing ownership).
void	encloseTrackingVolume (const TrackingVolume &tvol)
	private method to set enclosing TrackingVolume, called by friend class only optionally, the layer can be resized to the dimensions of the TrackingVolume

Additional Inherited Members
Public Types inherited from Acts::Surface
enum	SurfaceType {   Cone = 0 , Cylinder = 1 , Disc = 2 , Perigee = 3 ,   Plane = 4 , Straw = 5 , Curvilinear = 6 , Other = 7 }
	This enumerator simplifies the persistency & calculations, by saving a dynamic_cast, e.g. More...
Static Public Attributes inherited from Acts::Surface
static constexpr std::array< std::string_view, Surface::SurfaceType::Other+1 >	s_surfaceTypeNames
	Helper strings for screen output.
Protected Attributes inherited from Acts::ConeSurface
std::shared_ptr< const ConeBounds >	m_bounds
	bounds (shared)
Protected Attributes inherited from Acts::Surface
std::unique_ptr< const Transform3 >	m_transform {}
	Transform3 definition that positions (translation, rotation) the surface in global space.
Protected Attributes inherited from Acts::GeometryObject
GeometryIdentifier	m_geometryId
	Unique geometry identifier for this object.
Protected Attributes inherited from Acts::Layer
std::unique_ptr< const ApproachDescriptor >	m_approachDescriptor
	descriptor for surface on approach
double	m_layerThickness = 0
	Thickness of the Layer.
LayerType	m_layerType
	make a passive/active either way
NextLayers	m_nextLayers
	the previous Layer according to BinGenUtils
const BinUtility *	m_nextLayerUtility = nullptr
	A binutility to find the next layer.
std::unique_ptr< Volume >	m_representingVolume
	Representing Volume can be used as approach surface sources.
int	m_ssApproachSurfaces = 0
	Substructure flag indicating approach surface configuration.
int	m_ssRepresentingSurface = 0
	sub structure indication Substructure flag indicating representing surface configuration
int	m_ssSensitiveSurfaces = 0
	Substructure flag indicating sensitive surface configuration.
std::unique_ptr< const SurfaceArray >	m_surfaceArray
	SurfaceArray on this layer Surface.
const TrackingVolume *	m_trackingVolume = nullptr
	the enclosing TrackingVolume

Detailed Description

Class to describe a conical detector layer for tracking, it inherits from both, Layer base class and ConeSurface class.

Constructor & Destructor Documentation

ConeLayer() [1/4]

Acts::ConeLayer::ConeLayer ( )

delete

ConeLayer() [2/4]

Acts::ConeLayer::ConeLayer ( const ConeLayer & cla )

delete

~ConeLayer()

Acts::ConeLayer::~ConeLayer ( )

overridedefault

ConeLayer() [3/4]

Acts::ConeLayer::ConeLayer ( const Transform3 & transform, std::shared_ptr< const ConeBounds > cbounds, std::unique_ptr< SurfaceArray > surfaceArray, double thickness = 0., std::unique_ptr< ApproachDescriptor > ade = nullptr, LayerType laytyp = active )

protected

Private constructor with arguments.

Parameters

transform	is the 3D transform that positions the layer in 3D frame
cbounds	is the conical bound description
surfaceArray	is the array of sensitive surfaces
thickness	is the layer thickness along the normal axis
ade	is the approach descriptor for navigation towards the layer
laytyp	is the layer type

Todo

change od and ad to unique_ptr

ConeLayer() [4/4]

Acts::ConeLayer::ConeLayer ( const ConeLayer & cla, const Transform3 & shift )

protected

Private copy constructor with shift, called by create(args*).

Parameters

cla	is the source clone layer
shift	is the additional shift applied after copying

Member Function Documentation

create()

std::shared_ptr< ConeLayer > Acts::ConeLayer::create ( const Transform3 & transform, std::shared_ptr< const ConeBounds > cbounds, std::unique_ptr< SurfaceArray > surfaceArray, double thickness = 0., std::unique_ptr< ApproachDescriptor > ad = nullptr, LayerType laytyp = active )

static

Factory for shared layer.

Parameters

transform	is the 3D transform that positions the layer in 3D frame
cbounds	is the conical bound description
surfaceArray	is the array of sensitive surfaces
thickness	is the layer thickness along the normal axis
ad	is the approach descriptor for navigation towards the layer
laytyp	is the layer type

Todo

change od and ad to unique_ptr

Returns

is a shared pointer to a layer

operator=()

ConeLayer & Acts::ConeLayer::operator= ( const ConeLayer & )

delete

surfaceRepresentation() [1/2]

const ConeSurface & Acts::ConeLayer::surfaceRepresentation ( ) const

overridevirtual

Transforms the layer into a Surface representation for extrapolation.

Returns

Const reference to the cone surface representing this layer

Implements Acts::Layer.

surfaceRepresentation() [2/2]

ConeSurface & Acts::ConeLayer::surfaceRepresentation ( )

overridevirtual

Non-const version of surface representation access.

Returns

Mutable reference to the cone surface

Implements Acts::Layer.