ECCE @ EIC Software
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
Acts::CylinderVolumeBounds Class Reference

#include <acts/blob/master/Core/include/Acts/Geometry/CylinderVolumeBounds.hpp>

+ Inheritance diagram for Acts::CylinderVolumeBounds:
+ Collaboration diagram for Acts::CylinderVolumeBounds:

Public Types

enum  BoundValues {
  eMinR = 0, eMaxR = 1, eHalfLengthZ = 2, eHalfPhiSector = 3,
  eAveragePhi = 4, eSize = 5
}
 for streaming and access More...
 
- Public Types inherited from Acts::VolumeBounds
enum  BoundsType : int {
  eCone = 0, eCuboid = 1, eCutoutCylinder = 2, eCylinder = 3,
  eGenericCuboid = 4, eTrapezoid = 5, eOther = 6
}
 

Public Member Functions

 CylinderVolumeBounds ()=delete
 
 CylinderVolumeBounds (double rmin, double rmax, double halfz, double halfphi=M_PI, double avgphi=0.) noexcept(false)
 
 buildSurfaceBounds ()
 
 CylinderVolumeBounds (const std::array< double, eSize > &values) noexcept(false)
 
 CylinderVolumeBounds (const CylinderBounds &cBounds, double thickness) noexcept(false)
 
 CylinderVolumeBounds (const RadialBounds &rBounds, double thickness) noexcept(false)
 
 CylinderVolumeBounds (const CylinderVolumeBounds &cylbo)=default
 
 ~CylinderVolumeBounds () override=default
 
CylinderVolumeBoundsoperator= (const CylinderVolumeBounds &cylbo)=default
 
VolumeBounds::BoundsType type () const final
 
std::vector< double > values () const final
 
bool inside (const Vector3D &pos, double tol=0.) const override
 
std::vector< std::shared_ptr
< const Surface > > 
decomposeToSurfaces (const Transform3D *transformPtr=nullptr) const override
 
Volume::BoundingBox boundingBox (const Transform3D *trf=nullptr, const Vector3D &envelope={0, 0, 0}, const Volume *entity=nullptr) const final
 
Vector3D binningOffset (BinningValue bValue) const override
 
double binningBorder (BinningValue bValue) const override
 
std::ostream & toStream (std::ostream &sl) const override
 Output Method for std::ostream.
 
double get (BoundValues bValue) const
 
- Public Member Functions inherited from Acts::VolumeBounds
 VolumeBounds ()=default
 
virtual ~VolumeBounds ()=default
 

Private Member Functions

void checkConsistency () noexcept(false)
 
void buildSurfaceBounds ()
 Helper method to create the surface bounds.
 
template<class T >
TdumpT (T &tstream) const
 templated dumpT method
 

Private Attributes

std::array< double, eSizem_values
 The internal version of the bounds can be float/double.
 
std::shared_ptr< const
CylinderBounds
m_innerCylinderBounds {nullptr}
 Bounds of the inner CylinderSurfaces.
 
std::shared_ptr< const
CylinderBounds
m_outerCylinderBounds {nullptr}
 Bounds of the inner CylinderSurfaces.
 
std::shared_ptr< const
RadialBounds
m_discBounds {nullptr}
 Bounds of the bottom/top DiscSurface.
 
std::shared_ptr< const
PlanarBounds
m_sectorPlaneBounds {nullptr}
 Bounds of the sector planes.
 

Detailed Description

           [0] and [1] at positive \form#27
CylinderVolumeBounds_decomp.gif

Bounds for a cylindrical Volume, the decomposeToSurfaces method creates a vector of up to 6 surfaces:

case A) 3 Surfaces (full cylindrical tube): BoundarySurfaceFace [index]:

  • negativeFaceXY [0] : Acts::DiscSurface with $ r_{inner}=0 $, parallel to $ xy $ plane at negative $ z$
  • positiveFaceXY [1] : Acts::DiscSurface with $ r_{inner}=0 $, parallel to $ xy $ plane at positive $ z$
  • cylinderCover [2] : Acts::CylinderSurface confining the Acts::Volume

case B) 4 Surfaces (tube with inner and outer radius): BoundarySurfaceFace [index]:

  • negativeFaceXY [0] : Acts::DiscSurface with $ r_{inner}>0 $, parallel to $ xy $ plane at negative $ z$
  • positiveFaceXY [1] : Acts::DiscSurface with $ r_{inner}>0 $, parallel to $ xy $ plane at positive $ z$
  • tubeOuterCover [2] : Acts::CylinderSurface with $ r = r_{outer} $
  • tubeInnerCover [3] : Acts::CylinderSurface with $ r = r_{inner} $

case C) 6 Surfaces (sectoral tube with inner and outer radius): BoundarySurfaceFace [index]:

  • negativeFaceXY [0] : Acts::DiscSurface with $ r_{inner}>0$ and $ \phi < \pi $, parallel to $ xy $ plane at negative $z$
  • positiveFaceXY [1] : Acts::DiscSurface with $ r_{inner}>0 $ and $ \phi < \pi $, parallel to $ xy $ plane at positive $z$
  • tubeSectorOuterCover [2] : Acts::CylinderSurface with $ r = r_{outer}$
  • tubeSectorInnerCover [3] : Acts::CylinderSurface with $ r = r_{inner} $
  • tubeSectorNegativePhi [4] : Rectangular Acts::PlaneSurface attached to [0] and [1] at negative $ \phi $
    • tubeSectorNegativePhi [5] :

Definition at line 76 of file CylinderVolumeBounds.hpp.

View newest version in sPHENIX GitHub at line 76 of file CylinderVolumeBounds.hpp

Member Enumeration Documentation

for streaming and access

Enumerator:
eMinR 
eMaxR 
eHalfLengthZ 
eHalfPhiSector 
eAveragePhi 
eSize 

Definition at line 79 of file CylinderVolumeBounds.hpp.

View newest version in sPHENIX GitHub at line 79 of file CylinderVolumeBounds.hpp

Constructor & Destructor Documentation

Acts::CylinderVolumeBounds::CylinderVolumeBounds ( )
delete
Acts::CylinderVolumeBounds::CylinderVolumeBounds ( double  rmin,
double  rmax,
double  halfz,
double  halfphi = M_PI,
double  avgphi = 0. 
)
inlinenoexcept

Constructor

Parameters
rminThe inner radius of the cylinder
rmaxThe outer radius of the cylinder
halfzThe half length in z
halfphiThe half lopening angle
avgphiThe average phi value

Definition at line 97 of file CylinderVolumeBounds.hpp.

View newest version in sPHENIX GitHub at line 97 of file CylinderVolumeBounds.hpp

References rmax().

+ Here is the call graph for this function:

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

Constructor - from a fixed size array

Parameters
valuesThe bound values

Definition at line 108 of file CylinderVolumeBounds.hpp.

View newest version in sPHENIX GitHub at line 108 of file CylinderVolumeBounds.hpp

References buildSurfaceBounds(), and checkConsistency().

+ Here is the call graph for this function:

Acts::CylinderVolumeBounds::CylinderVolumeBounds ( const CylinderBounds cBounds,
double  thickness 
)
noexcept

Constructor - extruded from cylinder bounds and thickness

Parameters
cboundsthe cylinder bounds
thicknessof the extrusion

Definition at line 26 of file CylinderVolumeBounds.cpp.

View newest version in sPHENIX GitHub at line 26 of file CylinderVolumeBounds.cpp

References thickness.

Acts::CylinderVolumeBounds::CylinderVolumeBounds ( const RadialBounds rBounds,
double  thickness 
)
noexcept

Constructor - extruded from radial bounds and thickness

Parameters
rboundsthe Radial bounds
thickness

Definition at line 42 of file CylinderVolumeBounds.cpp.

View newest version in sPHENIX GitHub at line 42 of file CylinderVolumeBounds.cpp

References thickness.

Acts::CylinderVolumeBounds::CylinderVolumeBounds ( const CylinderVolumeBounds cylbo)
default

Copy Constructor

Parameters
cylbois the source cylinder volume bounds for the copy
Acts::CylinderVolumeBounds::~CylinderVolumeBounds ( )
overridedefault

Member Function Documentation

double Acts::CylinderVolumeBounds::binningBorder ( BinningValue  bValue) const
inlineoverridevirtual

Binning borders in double

Parameters
bValueis the type used for the binning

Reimplemented from Acts::VolumeBounds.

Definition at line 231 of file CylinderVolumeBounds.hpp.

View newest version in sPHENIX GitHub at line 231 of file CylinderVolumeBounds.hpp

References Acts::VolumeBounds::binningBorder(), Acts::binR, Acts::binZ, eHalfLengthZ, eMaxR, and eMinR.

+ Here is the call graph for this function:

Vector3D Acts::CylinderVolumeBounds::binningOffset ( BinningValue  bValue) const
inlineoverridevirtual

Binning offset - overloaded for some R-binning types

Parameters
bValueis the type used for the binning

Reimplemented from Acts::VolumeBounds.

Definition at line 223 of file CylinderVolumeBounds.hpp.

View newest version in sPHENIX GitHub at line 223 of file CylinderVolumeBounds.hpp

References Acts::VolumeBounds::binningOffset(), Acts::binR, Acts::binRPhi, eMaxR, and eMinR.

+ Here is the call graph for this function:

Acts::Volume::BoundingBox Acts::CylinderVolumeBounds::boundingBox ( const Transform3D trf = nullptr,
const Vector3D envelope = {0, 0, 0},
const Volume entity = nullptr 
) const
finalvirtual

Construct bounding box for this shape

Parameters
trfOptional transform
envelopeOptional envelope to add / subtract from min/max
entityEntity to associate this bounding box with
Returns
Constructed bounding box

Implements Acts::VolumeBounds.

Definition at line 133 of file CylinderVolumeBounds.cpp.

View newest version in sPHENIX GitHub at line 133 of file CylinderVolumeBounds.cpp

References M_PI, xmax, xmin, ymax, and ymin.

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

+ Here is the caller graph for this function:

void Acts::CylinderVolumeBounds::buildSurfaceBounds ( )

Definition at line 113 of file CylinderVolumeBounds.cpp.

View newest version in sPHENIX GitHub at line 113 of file CylinderVolumeBounds.cpp

References kdfinder::abs(), M_PI, and Acts::s_epsilon.

Referenced by CylinderVolumeBounds().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void Acts::CylinderVolumeBounds::buildSurfaceBounds ( )
private

Helper method to create the surface bounds.

void Acts::CylinderVolumeBounds::checkConsistency ( )
inlineprivatenoexcept

Check the input values for consistency, will throw a logic_exception if consistency is not given

Definition at line 258 of file CylinderVolumeBounds.hpp.

View newest version in sPHENIX GitHub at line 258 of file CylinderVolumeBounds.hpp

References eAveragePhi, eHalfLengthZ, eHalfPhiSector, eMaxR, eMinR, M_PI, and Acts::detail::radian_sym().

Referenced by CylinderVolumeBounds().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

std::vector< std::shared_ptr< const Acts::Surface > > Acts::CylinderVolumeBounds::decomposeToSurfaces ( const Transform3D transformPtr = nullptr) const
overridevirtual

Method to decompose the Bounds into boundarySurfaces

Parameters
transformPtris the transform where the boundary surfaces are situated

Implements Acts::VolumeBounds.

Definition at line 58 of file CylinderVolumeBounds.cpp.

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

References eHalfLengthZ, eHalfPhiSector, eMaxR, eMinR, m_discBounds, m_innerCylinderBounds, m_outerCylinderBounds, M_PI, m_sectorPlaneBounds, and Acts::Test::transform.

Referenced by Acts::Test::BOOST_AUTO_TEST_CASE(), and Acts::Test::BOOST_DATA_TEST_CASE().

+ Here is the caller graph for this function:

template<class T >
T & Acts::CylinderVolumeBounds::dumpT ( T tstream) const
private

templated dumpT method

Definition at line 242 of file CylinderVolumeBounds.hpp.

View newest version in sPHENIX GitHub at line 242 of file CylinderVolumeBounds.hpp

References eAveragePhi, eHalfLengthZ, eHalfPhiSector, eMaxR, and eMinR.

double Acts::CylinderVolumeBounds::get ( BoundValues  bValue) const
inline

Access to the bound values

Parameters
bValuethe class nested enum for the array access

Definition at line 183 of file CylinderVolumeBounds.hpp.

View newest version in sPHENIX GitHub at line 183 of file CylinderVolumeBounds.hpp

References m_values.

Referenced by Acts::adjustBinUtility(), Acts::CylinderVolumeBuilder::analyzeContent(), Acts::Test::BOOST_AUTO_TEST_CASE(), Acts::Test::BOOST_DATA_TEST_CASE(), Acts::CylinderVolumeHelper::createContainerTrackingVolume(), Acts::CylinderVolumeHelper::estimateAndCheckDimension(), Acts::CylinderVolumeHelper::glueTrackingVolumes(), and Acts::CylinderVolumeBuilder::trackingVolume().

+ Here is the caller graph for this function:

bool Acts::CylinderVolumeBounds::inside ( const Vector3D pos,
double  tol = 0. 
) const
inlineoverridevirtual

This method checks if position in the 3D volume frame is inside the cylinder

Parameters
posis a global position to be checked
tolis the tolerance for the check

Implements Acts::VolumeBounds.

Definition at line 209 of file CylinderVolumeBounds.hpp.

View newest version in sPHENIX GitHub at line 209 of file CylinderVolumeBounds.hpp

References kdfinder::abs(), eHalfLengthZ, eHalfPhiSector, eMaxR, eMinR, Acts::VectorHelpers::perp(), Acts::VectorHelpers::phi(), and phi.

+ Here is the call graph for this function:

CylinderVolumeBounds& Acts::CylinderVolumeBounds::operator= ( const CylinderVolumeBounds cylbo)
default
std::ostream & Acts::CylinderVolumeBounds::toStream ( std::ostream &  sl) const
overridevirtual

Output Method for std::ostream.

Implements Acts::VolumeBounds.

Definition at line 129 of file CylinderVolumeBounds.cpp.

View newest version in sPHENIX GitHub at line 129 of file CylinderVolumeBounds.cpp

VolumeBounds::BoundsType Acts::CylinderVolumeBounds::type ( ) const
inlinefinalvirtual

Return the bounds type - for persistency optimization

Returns
is a BoundsType enum

Implements Acts::VolumeBounds.

Definition at line 137 of file CylinderVolumeBounds.hpp.

View newest version in sPHENIX GitHub at line 137 of file CylinderVolumeBounds.hpp

References Acts::VolumeBounds::eCylinder.

std::vector< double > Acts::CylinderVolumeBounds::values ( ) const
inlinefinalvirtual

Return the bound values as dynamically sized vector

Returns
this returns a copy of the internal values

Implements Acts::VolumeBounds.

Definition at line 252 of file CylinderVolumeBounds.hpp.

View newest version in sPHENIX GitHub at line 252 of file CylinderVolumeBounds.hpp

References m_values.

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

+ Here is the caller graph for this function:

Member Data Documentation

std::shared_ptr<const RadialBounds> Acts::CylinderVolumeBounds::m_discBounds {nullptr}
private

Bounds of the bottom/top DiscSurface.

Definition at line 193 of file CylinderVolumeBounds.hpp.

View newest version in sPHENIX GitHub at line 193 of file CylinderVolumeBounds.hpp

Referenced by decomposeToSurfaces().

std::shared_ptr<const CylinderBounds> Acts::CylinderVolumeBounds::m_innerCylinderBounds {nullptr}
private

Bounds of the inner CylinderSurfaces.

Definition at line 189 of file CylinderVolumeBounds.hpp.

View newest version in sPHENIX GitHub at line 189 of file CylinderVolumeBounds.hpp

Referenced by decomposeToSurfaces().

std::shared_ptr<const CylinderBounds> Acts::CylinderVolumeBounds::m_outerCylinderBounds {nullptr}
private

Bounds of the inner CylinderSurfaces.

Definition at line 191 of file CylinderVolumeBounds.hpp.

View newest version in sPHENIX GitHub at line 191 of file CylinderVolumeBounds.hpp

Referenced by decomposeToSurfaces().

std::shared_ptr<const PlanarBounds> Acts::CylinderVolumeBounds::m_sectorPlaneBounds {nullptr}
private

Bounds of the sector planes.

Definition at line 195 of file CylinderVolumeBounds.hpp.

View newest version in sPHENIX GitHub at line 195 of file CylinderVolumeBounds.hpp

Referenced by decomposeToSurfaces().

std::array<double, eSize> Acts::CylinderVolumeBounds::m_values
private

The internal version of the bounds can be float/double.

Definition at line 187 of file CylinderVolumeBounds.hpp.

View newest version in sPHENIX GitHub at line 187 of file CylinderVolumeBounds.hpp

Referenced by get(), and values().


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