A sphere of given radius trimmed to a (theta, phi) rectangle or by curve wires; innerWall points the normal to the centre. More...

#include <BoundedSurface.h>

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

Public Member Functions
bool	initialize (const Vec3 &center, const Vec3 &polarAxis, const Vec3 &referenceAxisU, double radius, double thetaMin, double thetaMax, double phiStart, double phiSweep, bool innerWall, std::string &errorMessage)

bool	initialize (const Vec3 &center, const Vec3 &polarAxis, const Vec3 &referenceAxisU, double radius, double thetaMin, double thetaMax, 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], theta[rad]) domain decide containment; the window tightens to their bounds.

bool	hasWireTrim () const

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

bool	fullSweep () const

Vec3	toLocal (const Vec3 &point) const

bool	directionInTrim (const Vec3 &localPoint, bool *boundary=nullptr) const

Vec3	pointAt (double theta, double phi) 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 inside the trim, else the full-sphere distance, a lower bound.

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

void	parametricMetric (const Vec2 &uv, double &gUU, double &gUV, double &gVV) const override
	(u, v) = (phi[rad], theta[rad]); gUU vanishes at either pole.

double	capacityContribution () const override
	Divergence-theorem contribution over the (theta, phi) rectangle; a wire trim uses the contour form in (phi, theta).

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 whole sphere in (theta, phi) chunks, since distanceSqToPatch ignores the trim.

int	phiSegments () const

int	thetaSegments () 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

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 sphere of given radius trimmed to a (theta, phi) rectangle or by curve wires; innerWall points the normal to the centre.

Definition at line 3471 of file BoundedSurface.h.

Member Function Documentation

◆ appendCoverBoxes()

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

inlineoverridevirtual

Cover boxes: the whole sphere in (theta, phi) chunks, since distanceSqToPatch ignores the trim.

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

Definition at line 3701 of file BoundedSurface.h.

◆ appendDirectedEdges()

void o2::cad::surface::SphericalBoundedSurface::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 3765 of file BoundedSurface.h.

◆ appendDisplayMesh()

void o2::cad::surface::SphericalBoundedSurface::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 3740 of file BoundedSurface.h.

◆ appendIntersections()

void o2::cad::surface::SphericalBoundedSurface::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 3596 of file BoundedSurface.h.

◆ capacityContribution()

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

inlineoverridevirtual

Divergence-theorem contribution over the (theta, phi) rectangle; a wire trim uses the contour form in (phi, theta).

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

Definition at line 3659 of file BoundedSurface.h.

◆ capacityIsExact()

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

inlineoverridevirtual

Whether capacityContribution() is analytically exact for this surface.

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

Definition at line 3688 of file BoundedSurface.h.

◆ conservativeBounds()

void o2::cad::surface::SphericalBoundedSurface::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 3690 of file BoundedSurface.h.

◆ containsPointOnSurface()

bool o2::cad::surface::SphericalBoundedSurface::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 3587 of file BoundedSurface.h.

◆ directionInTrim()

bool o2::cad::surface::SphericalBoundedSurface::directionInTrim	(	const Vec3 &	localPoint,
		bool *	boundary = `nullptr`
	)		const

inline

Definition at line 3550 of file BoundedSurface.h.

◆ distanceSqToPatch()

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

inlineoverridevirtual

Distance to the patch: exact inside the trim, else the full-sphere distance, a lower bound.

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

Definition at line 3634 of file BoundedSurface.h.

◆ fullSweep()

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

inline

Definition at line 3542 of file BoundedSurface.h.

◆ hasWireTrim()

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

inline

Definition at line 3533 of file BoundedSurface.h.

◆ initialize() [1/2]

bool o2::cad::surface::SphericalBoundedSurface::initialize	(	const Vec3 &	center,
		const Vec3 &	polarAxis,
		const Vec3 &	referenceAxisU,
		double	radius,
		double	thetaMin,
		double	thetaMax,
		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], theta[rad]) domain decide containment; the window tightens to their bounds.

Definition at line 3511 of file BoundedSurface.h.

◆ initialize() [2/2]

bool o2::cad::surface::SphericalBoundedSurface::initialize	(	const Vec3 &	center,
		const Vec3 &	polarAxis,
		const Vec3 &	referenceAxisU,
		double	radius,
		double	thetaMin,
		double	thetaMax,
		double	phiStart,
		double	phiSweep,
		bool	innerWall,
		std::string &	errorMessage
	)

inline

Definition at line 3474 of file BoundedSurface.h.

◆ normalAt()

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

inlineoverridevirtual

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

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

Definition at line 3641 of file BoundedSurface.h.

◆ parametricMetric()

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

inlineoverridevirtual

(u, v) = (phi[rad], theta[rad]); gUU vanishes at either pole.

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

Definition at line 3653 of file BoundedSurface.h.

◆ phiSegments()

int o2::cad::surface::SphericalBoundedSurface::phiSegments ( ) const

inline

Definition at line 3730 of file BoundedSurface.h.

◆ pointAt()

Vec3 o2::cad::surface::SphericalBoundedSurface::pointAt	(	double	theta,
		double	phi
	)		const

inline

Definition at line 3579 of file BoundedSurface.h.

◆ pointInTrim()

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

inline

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

Definition at line 3536 of file BoundedSurface.h.

◆ sampleTrimCurve()

bool o2::cad::surface::SphericalBoundedSurface::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 3810 of file BoundedSurface.h.

◆ thetaSegments()

int o2::cad::surface::SphericalBoundedSurface::thetaSegments ( ) const

inline

Definition at line 3735 of file BoundedSurface.h.

◆ toLocal()

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

inline

Definition at line 3544 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

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ appendCoverBoxes()

◆ appendDirectedEdges()

◆ appendDisplayMesh()

◆ appendIntersections()

◆ capacityContribution()

◆ capacityIsExact()

◆ conservativeBounds()

◆ containsPointOnSurface()

◆ directionInTrim()

◆ distanceSqToPatch()

◆ fullSweep()

◆ hasWireTrim()

◆ initialize() [1/2]

◆ initialize() [2/2]

◆ normalAt()

◆ parametricMetric()

◆ phiSegments()

◆ pointAt()

◆ pointInTrim()

◆ sampleTrimCurve()

◆ thetaSegments()

◆ toLocal()