Acts::LineBounds Class Reference

Bounds for a LineSurface. More...

#include <Acts/Surfaces/LineBounds.hpp>

Inheritance diagram for Acts::LineBounds:

Collaboration diagram for Acts::LineBounds:

Public Types
enum	BoundValues : int { eR = 0 , eHalfLengthZ = 1 , eSize = 2 }
	Enumeration for the bound values. More...
Public Types inherited from Acts::SurfaceBounds
enum	BoundsType : int {   eCone = 0 , eCylinder = 1 , eDiamond = 2 , eDisc = 3 ,   eEllipse = 4 , eLine = 5 , eRectangle = 6 , eTrapezoid = 7 ,   eTriangle = 8 , eDiscTrapezoid = 9 , eConvexPolygon = 10 , eAnnulus = 11 ,   eBoundless = 12 , eOther = 13 }
	This is nested to the SurfaceBounds, as also VolumeBounds will have Bounds Type. More...

Public Member Functions
	LineBounds (const std::array< double, eSize > &values) noexcept(false)
	Constructor - from fixed size array.
	LineBounds (double r, double halfZ) noexcept(false)
	Constructor.
SquareMatrix2	boundToCartesianJacobian (const Vector2 &lposition) const final
	Computes the bound to cartesian jacobian at a given local position.
SquareMatrix2	boundToCartesianMetric (const Vector2 &lposition) const final
	Computes the bound to cartesian metric at a given local position.
Vector2	center () const final
	Calculate the center of the surface bounds in local coordinates.
Vector2	closestPoint (const Vector2 &lposition, const SquareMatrix2 &metric) const final
	Calculates the closest point on the bounds to a given local position.
double	get (BoundValues bValue) const
	Access to the bound values.
bool	inside (const Vector2 &lposition) const final
	Inside check for the bounds object.
virtual bool	inside (const Vector2 &lposition, const BoundaryTolerance &boundaryTolerance) const
	Inside check for the bounds object given a boundary tolerance.
bool	isCartesian () const final
	Check if the bound coordinates are cartesian.
std::ostream &	toStream (std::ostream &sl) const final
	Output Method for std::ostream.
BoundsType	type () const final
	Return the bounds type - for persistency optimization.
std::vector< double >	values () const final
	Return the bound values as dynamically sized vector.
Public Member Functions inherited from Acts::SurfaceBounds
virtual	~SurfaceBounds ()=default
virtual double	distance (const Vector2 &lposition) const
	Calculates the distance to the bounds from a given local position.

Detailed Description

Bounds for a LineSurface.

Member Enumeration Documentation

BoundValues

enum Acts::LineBounds::BoundValues : int

Enumeration for the bound values.

Enumerator
eR
eHalfLengthZ
eSize

Constructor & Destructor Documentation

LineBounds() [1/2]

Acts::LineBounds::LineBounds ( double r, double halfZ )

explicit

Constructor.

Parameters

r	The radius of the line
halfZ	The half length in z

LineBounds() [2/2]

Acts::LineBounds::LineBounds ( const std::array< double, eSize > & values )

explicit

Constructor - from fixed size array.

Parameters

values

The bound values stored in a fixed size array

Member Function Documentation

boundToCartesianJacobian()

SquareMatrix2 Acts::LineBounds::boundToCartesianJacobian ( const Vector2 & lposition ) const

finalvirtual

Computes the bound to cartesian jacobian at a given local position.

Parameters

lposition

is the local position at which the jacobian is computed

Returns

the bound to cartesian jacobian

Implements Acts::SurfaceBounds.

boundToCartesianMetric()

SquareMatrix2 Acts::LineBounds::boundToCartesianMetric ( const Vector2 & lposition ) const

finalvirtual

Computes the bound to cartesian metric at a given local position.

Parameters

lposition

is the local position at which the metric is computed

Returns

the bound to cartesian metric

Implements Acts::SurfaceBounds.

center()

Vector2 Acts::LineBounds::center ( ) const

finalvirtual

Calculate the center of the surface bounds in local coordinates.

This method returns a representative center point of the bounds region. The exact definition varies by bounds type and coordinate system:

Cartesian bounds (Rectangle, Diamond, Trapezoid):

• Returns the geometric center or center of symmetry
• For symmetric shapes: center of bounding box or origin (0,0)

Polar/Cylindrical bounds (Radial, Cylinder, Cone):

• Returns (r, phi) where r is average radius, phi is average angle
• Coordinates are in the bounds' natural coordinate system

Complex bounds (Annulus, ConvexPolygon):

• Annulus: Pre-calculated from corner vertices (accounts for coordinate transforms)
• Polygon: Average of all vertices (vertex centroid, not area centroid)

Infinite bounds: Returns conceptual center at (0,0)

Note

The returned point is guaranteed to be a reasonable representative center, but may not be the true geometric centroid for all shapes.

Returns

Vector2 representing the center position in local coordinates

Note

For LineBounds: returns (0,0) since bounds are symmetric around origin

Implements Acts::SurfaceBounds.

closestPoint()

Vector2 Acts::LineBounds::closestPoint ( const Vector2 & lposition, const SquareMatrix2 & metric ) const

finalvirtual

Calculates the closest point on the bounds to a given local position.

Parameters

lposition	is the local position
metric	to be used for the distance calculation

Returns

the closest point on the bounds

Implements Acts::SurfaceBounds.

get()

double Acts::LineBounds::get

(

BoundValues

bValue

)

const

Access to the bound values.

Parameters

bValue

the class nested enum for the array access

Returns

The bound value for the specified parameter

inside() [1/2]

bool Acts::LineBounds::inside ( const Vector2 & lposition ) const

finalvirtual

Inside check for the bounds object.

Parameters

lposition

is the local position

Returns

true if the local position is inside the bounds

Implements Acts::SurfaceBounds.

inside() [2/2]

virtual bool Acts::SurfaceBounds::inside ( const Vector2 & lposition, const BoundaryTolerance & boundaryTolerance ) const

virtual

Inside check for the bounds object given a boundary tolerance.

Parameters

lposition	is the local position
boundaryTolerance	is the boundary tolerance object

Returns

true if the local position is inside the bounds and tolerance

Reimplemented from Acts::SurfaceBounds.

isCartesian()

bool Acts::LineBounds::isCartesian ( ) const

finalvirtual

Check if the bound coordinates are cartesian.

Returns

true if the bound coordinates are cartesian

Implements Acts::SurfaceBounds.

toStream()

std::ostream & Acts::LineBounds::toStream ( std::ostream & sl ) const

finalvirtual

Output Method for std::ostream.

Parameters

sl	is the ostream to be dumped into

Returns

Reference to the output stream for method chaining

Implements Acts::SurfaceBounds.

type()

BoundsType Acts::LineBounds::type ( ) const

finalvirtual

Return the bounds type - for persistency optimization.

Returns

the bounds type

Implements Acts::SurfaceBounds.

values()

std::vector< double > Acts::LineBounds::values ( ) const

finalvirtual

Return the bound values as dynamically sized vector.

Returns

this returns a copy of the internal values

Implements Acts::SurfaceBounds.