A cylinder of given radius around an axis, trimmed to a (phi, h) rectangle or by curve wires; innerWall points the normal to the axis. More...

#include <BoundedSurface.h>

Inherits o2::cad::surface::BoundedSurface.

Public Member Functions
bool	initialize (const Vec3 &centerPoint, const Vec3 &axis, const Vec3 &referenceAxisU, double radius, double heightMin, double heightMax, double phiStart, double phiSweep, bool innerWall, std::string &errorMessage)

bool	initialize (const Vec3 &centerPoint, const Vec3 &axis, const Vec3 &referenceAxisU, double radius, double heightMin, double heightMax, double phiStart, double phiSweep, bool innerWall, const std::vector< Curve2D > &outerTrim, const std::vector< std::vector< Curve2D > > &innerTrims, std::string &errorMessage, double joinTolerance=kWireJoinTolerance)
	Wire-trimmed overload: the wires in the (phi[rad], h[cm]) domain decide containment; the window tightens to their bounds.

bool	hasWireTrim () const

bool	pointInTrim (double phi, double height, bool *boundary=nullptr) const
	True if the (phi, h) point lies in the trim wire (phi unwrapped into the wire window).

bool	fullSweep () const

Vec3	toLocal (const Vec3 &point) const

bool	heightInRange (double height) const

bool	phiInSweep (double phi) const

Vec3	pointAt (double phi, double height) const

bool	containsPointOnSurface (const Vec3 &point) const override
	True if the 3D point lies on the trimmed patch within tolerance.

void	appendIntersections (const Vec3 &rayOrigin, const Vec3 &rayDirection, double minDistance, double maxDistance, std::vector< RayHit > &hits) const override
	Append every hit of the ray with the trimmed patch in [minDistance, maxDistance], with the outward normal; no tangential grazes.

double	distanceSqToPatch (const Vec3 &point) const override
	Distance to the patch: exact for the parametric rectangle, a lower bound for a wire trim.

Vec3	normalAt (const Vec3 &point) const override
	Outward-oriented normal at (or nearest to) the given point.

void	parametricMetric (const Vec2 &, double &gUU, double &gUV, double &gVV) const override
	(u, v) = (phi[rad], h[cm]): X_phi has length r and X_h is the unit axis.

double	capacityContribution () const override
	Divergence-theorem contribution over the (phi, h) rectangle; a wire trim uses the contour form, F = (s r / 3)(a sin phi - b cos phi + r phi).

bool	capacityIsExact () const override
	Whether capacityContribution() is analytically exact for this surface.

void	conservativeBounds (Vec3 &lower, Vec3 &upper) const override
	Accumulate a conservative axis-aligned bounding box of the trimmed patch.

void	appendCoverBoxes (std::vector< CoverBox > &boxes) const override
	Cover boxes: the sweep window in angular chunks, which holds every point that realises distanceSqToPatch.

int	rimSegments () const

void	appendDisplayMesh (std::vector< Vec3 > &vertices, std::vector< std::array< int, 3 > > &triangles) const override
	Append this patch's visualization triangulation (navigation must never depend on it).

void	appendDirectedEdges (std::vector< std::pair< Vec3, Vec3 > > &edges) const override
	Append the 3D directed boundary edges of the patch, for solid-closure validation.

bool	sampleTrimCurve (size_t index, std::vector< Vec3 > &samples) const override
	Sample trim curve index into 3D, in construction order; false when this face has no such curve.

Public Member Functions inherited from o2::cad::surface::BoundedSurface
virtual	~BoundedSurface ()=default

double	parametricLengthSqAt (const Vec2 &uv, const Vec2 &delta) const
	The 3D length squared spanned by a parametric displacement delta starting at uv.

virtual void	appendRims (std::vector< SurfaceRim > &rims) const
	Append the trim boundary as rims, one polyline per loop; the default chains appendDirectedEdges().

void	setBoundaryEdges (std::vector< BoundaryEdgeRef > refs)

const std::vector< BoundaryEdgeRef > &	boundaryEdges () const

Static Public Member Functions
static bool	makeFrame (const Vec3 &axis, const Vec3 &referenceAxisU, Vec3 &axisU, Vec3 &axisV, Vec3 &axisW, std::string &errorMessage)

Additional Inherited Members
Public Types inherited from o2::cad::surface::BoundedSurface
using	CoverBox = std::pair< Vec3, Vec3 >
	One axis-aligned cover box of the sub-patch BVH, as a (lower corner, upper corner) pair.

Protected Attributes inherited from o2::cad::surface::BoundedSurface
std::vector< BoundaryEdgeRef >	mBoundaryEdges

Detailed Description

A cylinder of given radius around an axis, trimmed to a (phi, h) rectangle or by curve wires; innerWall points the normal to the axis.

Definition at line 3125 of file BoundedSurface.h.

Member Function Documentation

◆ appendCoverBoxes()

void o2::cad::surface::CylindricalBoundedSurface::appendCoverBoxes ( std::vector< CoverBox > & boxes ) const

inlineoverridevirtual

Cover boxes: the sweep window in angular chunks, which holds every point that realises distanceSqToPatch.

Reimplemented from o2::cad::surface::BoundedSurface.

Definition at line 3382 of file BoundedSurface.h.

◆ appendDirectedEdges()

void o2::cad::surface::CylindricalBoundedSurface::appendDirectedEdges ( std::vector< std::pair< Vec3, Vec3 > > & edges ) const

inlineoverridevirtual

Append the 3D directed boundary edges of the patch, for solid-closure validation.

Implements o2::cad::surface::BoundedSurface.

Definition at line 3415 of file BoundedSurface.h.

◆ appendDisplayMesh()

void o2::cad::surface::CylindricalBoundedSurface::appendDisplayMesh	(	std::vector< Vec3 > &	vertices,
		std::vector< std::array< int, 3 > > &	triangles
	)		const

inlineoverridevirtual

Append this patch's visualization triangulation (navigation must never depend on it).

Implements o2::cad::surface::BoundedSurface.

Definition at line 3395 of file BoundedSurface.h.

◆ appendIntersections()

void o2::cad::surface::CylindricalBoundedSurface::appendIntersections	(	const Vec3 &	rayOrigin,
		const Vec3 &	rayDirection,
		double	minDistance,
		double	maxDistance,
		std::vector< RayHit > &	hits
	)		const

inlineoverridevirtual

Append every hit of the ray with the trimmed patch in [minDistance, maxDistance], with the outward normal; no tangential grazes.

Implements o2::cad::surface::BoundedSurface.

Definition at line 3257 of file BoundedSurface.h.

◆ capacityContribution()

double o2::cad::surface::CylindricalBoundedSurface::capacityContribution ( ) const

inlineoverridevirtual

Divergence-theorem contribution over the (phi, h) rectangle; a wire trim uses the contour form, F = (s r / 3)(a sin phi - b cos phi + r phi).

Implements o2::cad::surface::BoundedSurface.

Definition at line 3340 of file BoundedSurface.h.

◆ capacityIsExact()

bool o2::cad::surface::CylindricalBoundedSurface::capacityIsExact ( ) const

inlineoverridevirtual

Whether capacityContribution() is analytically exact for this surface.

Implements o2::cad::surface::BoundedSurface.

Definition at line 3357 of file BoundedSurface.h.

◆ conservativeBounds()

void o2::cad::surface::CylindricalBoundedSurface::conservativeBounds	(	Vec3 &	lower,
		Vec3 &	upper
	)		const

inlineoverridevirtual

Accumulate a conservative axis-aligned bounding box of the trimmed patch.

Implements o2::cad::surface::BoundedSurface.

Definition at line 3359 of file BoundedSurface.h.

◆ containsPointOnSurface()

bool o2::cad::surface::CylindricalBoundedSurface::containsPointOnSurface ( const Vec3 & point ) const

inlineoverridevirtual

True if the 3D point lies on the trimmed patch within tolerance.

Implements o2::cad::surface::BoundedSurface.

Definition at line 3240 of file BoundedSurface.h.

◆ distanceSqToPatch()

double o2::cad::surface::CylindricalBoundedSurface::distanceSqToPatch ( const Vec3 & point ) const

inlineoverridevirtual

Distance to the patch: exact for the parametric rectangle, a lower bound for a wire trim.

Implements o2::cad::surface::BoundedSurface.

Definition at line 3306 of file BoundedSurface.h.

◆ fullSweep()

bool o2::cad::surface::CylindricalBoundedSurface::fullSweep ( ) const

inline

Definition at line 3217 of file BoundedSurface.h.

◆ hasWireTrim()

bool o2::cad::surface::CylindricalBoundedSurface::hasWireTrim ( ) const

inline

Definition at line 3188 of file BoundedSurface.h.

◆ heightInRange()

bool o2::cad::surface::CylindricalBoundedSurface::heightInRange ( double height ) const

inline

Definition at line 3225 of file BoundedSurface.h.

◆ initialize() [1/2]

bool o2::cad::surface::CylindricalBoundedSurface::initialize	(	const Vec3 &	centerPoint,
		const Vec3 &	axis,
		const Vec3 &	referenceAxisU,
		double	radius,
		double	heightMin,
		double	heightMax,
		double	phiStart,
		double	phiSweep,
		bool	innerWall,
		const std::vector< Curve2D > &	outerTrim,
		const std::vector< std::vector< Curve2D > > &	innerTrims,
		std::string &	errorMessage,
		double	joinTolerance = `kWireJoinTolerance`
	)

inline

Wire-trimmed overload: the wires in the (phi[rad], h[cm]) domain decide containment; the window tightens to their bounds.

Definition at line 3166 of file BoundedSurface.h.

◆ initialize() [2/2]

bool o2::cad::surface::CylindricalBoundedSurface::initialize	(	const Vec3 &	centerPoint,
		const Vec3 &	axis,
		const Vec3 &	referenceAxisU,
		double	radius,
		double	heightMin,
		double	heightMax,
		double	phiStart,
		double	phiSweep,
		bool	innerWall,
		std::string &	errorMessage
	)

inline

Definition at line 3128 of file BoundedSurface.h.

◆ makeFrame()

static bool o2::cad::surface::CylindricalBoundedSurface::makeFrame	(	const Vec3 &	axis,
		const Vec3 &	referenceAxisU,
		Vec3 &	axisU,
		Vec3 &	axisV,
		Vec3 &	axisW,
		std::string &	errorMessage
	)

inlinestatic

Build an orthonormal frame (U, V, W) with W along axis and U the projection of referenceAxisU perpendicular to W. Shared by all axis-symmetric quadric surfaces.

Definition at line 3199 of file BoundedSurface.h.

◆ normalAt()

Vec3 o2::cad::surface::CylindricalBoundedSurface::normalAt ( const Vec3 & point ) const

inlineoverridevirtual

Outward-oriented normal at (or nearest to) the given point.

Implements o2::cad::surface::BoundedSurface.

Definition at line 3322 of file BoundedSurface.h.

◆ parametricMetric()

void o2::cad::surface::CylindricalBoundedSurface::parametricMetric	(	const Vec2 &	,
		double &	gUU,
		double &	gUV,
		double &	gVV
	)		const

inlineoverridevirtual

(u, v) = (phi[rad], h[cm]): X_phi has length r and X_h is the unit axis.

Implements o2::cad::surface::BoundedSurface.

Definition at line 3334 of file BoundedSurface.h.

◆ phiInSweep()

bool o2::cad::surface::CylindricalBoundedSurface::phiInSweep ( double phi ) const

inline

Definition at line 3230 of file BoundedSurface.h.

◆ pointAt()

Vec3 o2::cad::surface::CylindricalBoundedSurface::pointAt	(	double	phi,
		double	height
	)		const

inline

Definition at line 3235 of file BoundedSurface.h.

◆ pointInTrim()

bool o2::cad::surface::CylindricalBoundedSurface::pointInTrim	(	double	phi,
		double	height,
		bool *	boundary = `nullptr`
	)		const

inline

True if the (phi, h) point lies in the trim wire (phi unwrapped into the wire window).

Definition at line 3191 of file BoundedSurface.h.

◆ rimSegments()

int o2::cad::surface::CylindricalBoundedSurface::rimSegments ( ) const

inline

Number of chord segments used for rim sampling, consistent with CurveWire::sampledBoundary so shared circular boundaries close against curved planar caps.

Definition at line 3390 of file BoundedSurface.h.

◆ sampleTrimCurve()

bool o2::cad::surface::CylindricalBoundedSurface::sampleTrimCurve	(	size_t	index,
		std::vector< Vec3 > &	samples
	)		const

inlineoverridevirtual

Sample trim curve index into 3D, in construction order; false when this face has no such curve.

Reimplemented from o2::cad::surface::BoundedSurface.

Definition at line 3445 of file BoundedSurface.h.

◆ toLocal()

Vec3 o2::cad::surface::CylindricalBoundedSurface::toLocal ( const Vec3 & point ) const

inline

Definition at line 3219 of file BoundedSurface.h.

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

/home/runner/work/AliceO2/AliceO2/Detectors/CADSupport/src/BoundedSurface.h

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ appendCoverBoxes()

◆ appendDirectedEdges()

◆ appendDisplayMesh()

◆ appendIntersections()

◆ capacityContribution()

◆ capacityIsExact()

◆ conservativeBounds()

◆ containsPointOnSurface()

◆ distanceSqToPatch()

◆ fullSweep()

◆ hasWireTrim()

◆ heightInRange()

◆ initialize() [1/2]

◆ initialize() [2/2]

◆ makeFrame()

◆ normalAt()

◆ parametricMetric()

◆ phiInSweep()

◆ pointAt()

◆ pointInTrim()

◆ rimSegments()

◆ sampleTrimCurve()

◆ toLocal()