CSGSphere creates an internal representation of a Constructive Solid Geometry (CSG) sphere, represented in the form (x - x0)^2 + (y - y0)^2 + (z - z0)^2 = r^2. More...

#include <CSGSphere.h>

Inheritance diagram for CSG::CSGSphere:

[legend]

Public Types
enum	Halfspace { Halfspace::POSITIVE, Halfspace::NEGATIVE }
	Enum for the sign of the half-space being represented by a point and surface. More...

Public Member Functions
	CSGSphere (const std::string &name, const Point &center, const Real r)
	Construct a new CSGSphere surface. More...

	CSGSphere (const std::string &name, const Real r)
	Construct a new CSGSphere surface. More...

virtual	~CSGSphere ()=default
	Destructor. More...

virtual std::unordered_map< std::string, Real >	getCoeffs () const override
	Get the coefficients (x0, y0, z0, r) for the equation of a sphere (x - x0)^2 + (y - y0)^2 + (z - z0)^2 = r^2. More...

virtual Real	evaluateSurfaceEquationAtPoint (const Point &p) const override
	given a point, determine its evaluation based on the equation of the sphere More...

const std::string &	getSurfaceType () const
	Get the Surface Type. More...

CSGSurface::Halfspace	getHalfspaceFromPoint (const Point &p) const
	given a point, determine if it is in the positive or negative half-space for the surface More...

const std::string &	getName () const
	Get the name of surface. More...

bool	operator== (const CSGSurface &other) const
	Operator overload for checking if two CSGSurface objects are equal. More...

bool	operator!= (const CSGSurface &other) const
	Operator overload for checking if two CSGSurface objects are not equal. More...

Protected Member Functions
void	checkRadius () const

void	setName (const std::string &name)


	FRIEND_TEST (CSGSurfaceTest, testSetName)
	Friends for unit testing. More...

Protected Attributes
Real	_x0
	Value of x0 in equation of sphere. More...

Real	_y0
	Value of y0 in equation of sphere. More...

Real	_z0
	Value of z0 in equation of sphere. More...

Real	_r
	Value of r in equation of sphere. More...

std::string	_name
	Name of surface. More...

const std::string	_surface_type
	Type of surface that is being represented string is taken directly from the surface class name. More...

Detailed Description

CSGSphere creates an internal representation of a Constructive Solid Geometry (CSG) sphere, represented in the form (x - x0)^2 + (y - y0)^2 + (z - z0)^2 = r^2.

Definition at line 23 of file CSGSphere.h.

Member Enumeration Documentation

◆ Halfspace

enum CSG::CSGSurface::Halfspace

stronginherited

Enum for the sign of the half-space being represented by a point and surface.

Enumerator
POSITIVE
NEGATIVE

Definition at line 30 of file CSGSurface.h.

   {
     POSITIVE,
     NEGATIVE
   };

Constructor & Destructor Documentation

◆ CSGSphere() [1/2]

CSG::CSGSphere::CSGSphere	(	const std::string &	name,
		const Point &	center,
		const Real	r
	)

Construct a new CSGSphere surface.

Parameters

name	unique name for the sphere surface
center	center point of sphere
r	radius of sphere

Definition at line 15 of file CSGSphere.C.

   : CSGSurface(name, MooseUtils::prettyCppType<CSGSphere>()),
     _x0(center(0)),
     _y0(center(1)),
     _z0(center(2)),
     _r(r)
 {
   checkRadius();
 }

◆ CSGSphere() [2/2]

CSG::CSGSphere::CSGSphere	(	const std::string &	name,
		const Real	r
	)

Construct a new CSGSphere surface.

Parameters

name	unique name for the sphere surface
r	radius of sphere

Definition at line 25 of file CSGSphere.C.

   : CSGSurface(name, MooseUtils::prettyCppType<CSGSphere>()), _x0(0.0), _y0(0.0), _z0(0.0), _r(r)
 {
   checkRadius();
 }

◆ ~CSGSphere()

virtual CSG::CSGSphere::~CSGSphere ( )

virtualdefault

Destructor.

Member Function Documentation

◆ checkRadius()

void CSG::CSGSphere::checkRadius ( ) const

protected

Definition at line 50 of file CSGSphere.C.

Referenced by CSGSphere().

 {
   if (_r <= 0.0)
     mooseError("Radius of sphere must be positive.");
 }

◆ evaluateSurfaceEquationAtPoint()

Real CSG::CSGSphere::evaluateSurfaceEquationAtPoint ( const Point & p ) const

overridevirtual

given a point, determine its evaluation based on the equation of the sphere

Parameters

p point

Returns: evaluation of point based on surface equation

Implements CSG::CSGSurface.

Definition at line 39 of file CSGSphere.C.

 {
   // Compute distance from the sphere center to determine if inside (< r^2)
   // or outside (> r^2) the sphere
   const Real dist_sq =
       Utility::pow<2>((p(0) - _x0)) + Utility::pow<2>((p(1) - _y0)) + Utility::pow<2>((p(2) - _z0));
 
   return dist_sq - Utility::pow<2>(_r);
 }

◆ FRIEND_TEST()

CSG::CSGSurface::FRIEND_TEST	(	CSGSurfaceTest	,
		testSetName
	)

protectedinherited

Friends for unit testing.

◆ getCoeffs()

std::unordered_map< std::string, Real > CSG::CSGSphere::getCoeffs ( ) const

overridevirtual

Get the coefficients (x0, y0, z0, r) for the equation of a sphere (x - x0)^2 + (y - y0)^2 + (z - z0)^2 = r^2.

Returns: map of coefficients (x0, y0, z0, and r) and their values

Implements CSG::CSGSurface.

Definition at line 32 of file CSGSphere.C.

 {
   std::unordered_map<std::string, Real> coeffs = {{"x0", _x0}, {"y0", _y0}, {"z0", _z0}, {"r", _r}};
   return coeffs;
 }

◆ getHalfspaceFromPoint()

CSGSurface::Halfspace CSG::CSGSurface::getHalfspaceFromPoint ( const Point & p ) const

inherited

given a point, determine if it is in the positive or negative half-space for the surface

Parameters

p point

Returns: sign of the half-space

Definition at line 21 of file CSGSurface.C.

 {
   auto eval = evaluateSurfaceEquationAtPoint(p);
   if (MooseUtils::absoluteFuzzyGreaterThan(eval, 0))
     return Halfspace::POSITIVE;
   else if (MooseUtils::absoluteFuzzyLessThan(eval, 0))
     return Halfspace::NEGATIVE;
   else
     mooseError("Point ",
                p,
                " used to determine halfspace evaluation lies on the surface ",
                _name,
                ", leading to an ambiguously defined halfspace.");
 }

◆ getName()

const std::string& CSG::CSGSurface::getName ( ) const

inlineinherited

Get the name of surface.

Returns: std::string name of surface

Definition at line 95 of file CSGSurface.h.

Referenced by CSG::CSGSurfaceList::addSurface(), CSG::CSGRegion::CSGRegion(), CSG::CSGSurface::operator==(), and CSG::CSGSurfaceList::renameSurface().

95 { return _name; }

CSG::CSGSurface::_name

std::string _name

Name of surface.

Definition: CSGSurface.h:109

◆ getSurfaceType()

const std::string& CSG::CSGSurface::getSurfaceType ( ) const

inlineinherited

Get the Surface Type.

Returns: type of surface

Definition at line 61 of file CSGSurface.h.

Referenced by CSG::CSGSurface::operator==().

61 { return _surface_type; }

CSG::CSGSurface::_surface_type

const std::string _surface_type

Type of surface that is being represented string is taken directly from the surface class name...

Definition: CSGSurface.h:113

◆ operator!=()

bool CSG::CSGSurface::operator!= ( const CSGSurface & other ) const

inherited

Operator overload for checking if two CSGSurface objects are not equal.

Definition at line 45 of file CSGSurface.C.

 {
   return !(*this == other);
 }

◆ operator==()

bool CSG::CSGSurface::operator== ( const CSGSurface & other ) const

inherited

Operator overload for checking if two CSGSurface objects are equal.

Definition at line 37 of file CSGSurface.C.

 {
   return (this->getName() == other.getName()) &&
          (this->getSurfaceType() == other.getSurfaceType()) &&
          (this->getCoeffs() == other.getCoeffs());
 }