EIC Software
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
Public Types | Public Member Functions | Private Member Functions | Private Attributes | List of all members
Acts::CylinderVolumeBounds Class Reference

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

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

Public Types

enum  BoundValues : unsigned int {
  eMinR = 0, eMaxR = 1, eHalfLengthZ = 2, eHalfPhiSector = 3,
  eAveragePhi = 4, eSize
}
 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
 
CylinderVolumeBounds & operator= (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
 
OrientedSurfaces orientedSurfaces (const Transform3D &transform=Transform3D::Identity()) 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 stream_t >
stream_t & dumpT (stream_t &dt) const
 

Private Attributes

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

Detailed Description

[0] and [1] at positive $ \phi $

Bounds for a cylindrical Volume, the orientedSurfaces(..) 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 72 of file CylinderVolumeBounds.hpp.

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

Member Enumeration Documentation

enum Acts::CylinderVolumeBounds::BoundValues : unsigned int

for streaming and access

Enumerator:
eMinR 
eMaxR 
eHalfLengthZ 
eHalfPhiSector 
eAveragePhi 
eSize 

Definition at line 75 of file CylinderVolumeBounds.hpp.

View newest version in sPHENIX GitHub at line 75 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 93 of file CylinderVolumeBounds.hpp.

View newest version in sPHENIX GitHub at line 93 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 104 of file CylinderVolumeBounds.hpp.

View newest version in sPHENIX GitHub at line 104 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 23 of file CylinderVolumeBounds.cpp.

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

References buildSurfaceBounds(), and thickness.

+ Here is the call graph for this function:

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

Constructor - extruded from radial bounds and thickness

Parameters
rboundsthe Radial bounds
thickness

Definition at line 39 of file CylinderVolumeBounds.cpp.

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

References buildSurfaceBounds(), and thickness.

+ Here is the call graph for this function:

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 235 of file CylinderVolumeBounds.hpp.

View newest version in sPHENIX GitHub at line 235 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 227 of file CylinderVolumeBounds.hpp.

View newest version in sPHENIX GitHub at line 227 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 122 of file CylinderVolumeBounds.cpp.

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

References cos(), M_PI, xmax, xmin, ymax, and ymin.

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

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void Acts::CylinderVolumeBounds::buildSurfaceBounds ( )

Definition at line 102 of file CylinderVolumeBounds.cpp.

View newest version in sPHENIX GitHub at line 102 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 262 of file CylinderVolumeBounds.hpp.

View newest version in sPHENIX GitHub at line 262 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:

template<class stream_t >
stream_t & Acts::CylinderVolumeBounds::dumpT ( stream_t &  dt) const
private

Templated dumpT method

Template Parameters
stream_tThe type fo the dump stream
Parameters
dtThe dump stream object

Definition at line 246 of file CylinderVolumeBounds.hpp.

View newest version in sPHENIX GitHub at line 246 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 185 of file CylinderVolumeBounds.hpp.

View newest version in sPHENIX GitHub at line 185 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 213 of file CylinderVolumeBounds.hpp.

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

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

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

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

CylinderVolumeBounds& Acts::CylinderVolumeBounds::operator= ( const CylinderVolumeBounds &  cylbo)
default
Acts::OrientedSurfaces Acts::CylinderVolumeBounds::orientedSurfaces ( const Transform3D &  transform = Transform3D::Identity()) const
overridevirtual

Oriented surfaces, i.e. the decomposed boundary surfaces and the according navigation direction into the volume given the normal vector on the surface

Parameters
transformis the 3D transform to be applied to the boundary surfaces to position them in 3D space

It will throw an exception if the orientation prescription is not adequate

Returns
a vector of surfaces bounding this volume

Implements Acts::VolumeBounds.

Definition at line 54 of file CylinderVolumeBounds.cpp.

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

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

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

+ Here is the caller graph for this function:

std::ostream & Acts::CylinderVolumeBounds::toStream ( std::ostream &  sl) const
overridevirtual

Output Method for std::ostream.

Implements Acts::VolumeBounds.

Definition at line 118 of file CylinderVolumeBounds.cpp.

View newest version in sPHENIX GitHub at line 118 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 132 of file CylinderVolumeBounds.hpp.

View newest version in sPHENIX GitHub at line 132 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 256 of file CylinderVolumeBounds.hpp.

View newest version in sPHENIX GitHub at line 256 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 Radial.

Definition at line 195 of file CylinderVolumeBounds.hpp.

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

Referenced by orientedSurfaces().

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

Bounds of the inner CylinderBounds.

Definition at line 191 of file CylinderVolumeBounds.hpp.

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

Referenced by orientedSurfaces().

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

Bounds of the inner CylinderBounds.

Definition at line 193 of file CylinderVolumeBounds.hpp.

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

Referenced by orientedSurfaces().

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

Bounds of the sector planes.

Definition at line 197 of file CylinderVolumeBounds.hpp.

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

Referenced by orientedSurfaces().

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

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

Definition at line 189 of file CylinderVolumeBounds.hpp.

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

Referenced by get(), and values().

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