#include <DomainShape_fwd.hpp>

Detailed Description

template<typename vec_t>
class mm::DomainShape< vec_t >

Base class for geometric shapes of domains.

This class implements the interface and utilities for working with and discretizing geometric shapes.

Usage example:

    BoxShape<Vec3d> inner({1.5, 1.5, 1.5}, {2.5, 2.5, 2.5});
    BallShape<Vec3d> middle({2, 2, 2}, 1);
    BoxShape<Vec3d> outer({0, 0, 0}, {4, 4, 4});
    auto u = outer - middle + inner;
    std::cout << u << std::endl;

Definition at line 52 of file DomainShape_fwd.hpp.

Inheritance diagram for mm::DomainShape< vec_t >:

Public Member Functions
	DomainShape ()
	Construct domain with default margin. More...

virtual	~DomainShape ()=default
	Virtual destructor to properly destruct base class when invoked polymorphically. More...

scalar_t	margin () const
	Returns current margin. More...

virtual void	setMargin (scalar_t margin)
	Sets domain margin to `margin`. More...

void	toggleMargin ()
	Toggles the margin from positive to negative. More...

ShapeUnion< vec_t >	add (const DomainShape &other) const
	Returns a shape representing a union of `*this` and `other`. More...

ShapeUnion< vec_t >	operator+ (const DomainShape &other) const
	Operator form of DomainShape::add. More...

ShapeDifference< vec_t >	subtract (const DomainShape &other) const
	Returns a shape representing a difference of `*this` and `other`. More...

ShapeDifference< vec_t >	operator- (const DomainShape &other) const
	Operator form of DomainShape::subtract. More...

virtual std::pair< bool, vec_t >	projectPointToBoundary (const vec_t &point, const vec_t &unit_normal) const
	Project point to boundary using bisection along the line define by `unit_normal`. More...

virtual bool	contains (const vec_t &point) const =0
	Return true if `point` is not more than `margin()` outside the domain. More...

virtual bool	hasContains () const
	Return true if shape has `contains()` method implemented. More...

virtual std::pair< vec_t, vec_t >	bbox () const =0
	Return the bounding box of the domain. More...

virtual DomainShape *	clone () const =0
	Polymorphic clone pattern. More...

virtual std::ostream &	print (std::ostream &os) const =0
	Output information about this shape to given output stream `os`. More...

virtual DomainDiscretization< vec_t >	discretizeBoundaryWithStep (scalar_t step, int type) const
	Returns a discretization of the boundary of this shape with approximately uniform distance `step` between nodes. More...

DomainDiscretization< vec_t >	discretizeBoundaryWithStep (scalar_t step) const
	Returns a discretization of the boundary of this shape with approximately uniform distance `step` between nodes. More...

virtual DomainDiscretization< vec_t >	discretizeWithStep (scalar_t step, int internal_type, int boundary_type) const
	Returns a discretization of this shape with approximately uniform distance `step` between nodes. More...

DomainDiscretization< vec_t >	discretizeWithStep (scalar_t step) const
	discretizeWithStep but with default types as assigned by the shape. More...

virtual DomainDiscretization< vec_t >	discretizeWithDensity (const std::function< scalar_t(vec_t)> &dr, int internal_type, int boundary_type) const
	Returns a discretization of the domain with spatially variable step. More...

template<typename func_t , typename fill_t >
DomainDiscretization< vec_t >	discretizeWithDensity (const func_t &dr, const fill_t &fill, int internal_type, int boundary_type) const
	Overload for fill engine. More...

DomainDiscretization< vec_t >	discretizeWithDensity (const std::function< scalar_t(vec_t)> &dr) const
	Overload with default types. More...

template<typename func_t , typename fill_t >
DomainDiscretization< vec_t >	discretizeWithDensity (const func_t &dr, const fill_t &fill) const
	Overload for fill engine with default types. More...

virtual DomainDiscretization< vec_t >	discretizeBoundaryWithDensity (const std::function< scalar_t(vec_t)> &dr, int type) const =0
	Discretizes boundary with given density and fill engine. More...

DomainDiscretization< vec_t >	discretizeBoundaryWithDensity (const std::function< scalar_t(vec_t)> &dr) const
	Overload with default type. More...

TranslatedShape< vec_t >	translate (const vec_t &a)
	Translate the shape by given vector `a`. More...

RotatedShape< vec_t >	rotate (const Eigen::Matrix< scalar_t, dim, dim > &Q)
	Transform the shape by given orthogonal matrix `Q`. More...

RotatedShape< vec_t >	rotate (scalar_t angle)
	2D version of rotate accepting an angle. More...

Public Types
enum	{ dim = vec_t::dim }
	Store dimension of the domain. More...

typedef vec_t	vector_t
	Vector data type used in computations. More...

typedef vec_t::Scalar	scalar_t
	Scalar data type used in computation. More...

Friends
template<typename V >
std::ostream &	operator<< (std::ostream &os, const DomainShape< V > &shape)
	Output info about given shape to ostream. More...

Protected Attributes
scalar_t	margin_
	Tolerance for the geometric operation of the domain. More...

Member Enumeration Documentation

◆ anonymous enum

template<typename vec_t >

anonymous enum

Store dimension of the domain.

Enumerator
dim	Dimensionality of the domain.

Definition at line 57 of file DomainShape_fwd.hpp.

Constructor & Destructor Documentation

◆ DomainShape()

template<typename vec_t >

mm::DomainShape< vec_t >::DomainShape ( )

inline

Construct domain with default margin.

Definition at line 67 of file DomainShape_fwd.hpp.

◆ ~DomainShape()

template<typename vec_t >

virtual mm::DomainShape< vec_t >::~DomainShape ( )

virtualdefault

Virtual destructor to properly destruct base class when invoked polymorphically.

Member Function Documentation

◆ add()

template<typename vec_t >

ShapeUnion< vec_t > mm::DomainShape< vec_t >::add ( const DomainShape< vec_t > & other ) const

Returns a shape representing a union of *this and other.

Definition at line 66 of file DomainShape.hpp.

◆ bbox()

template<typename vec_t >

virtual std::pair<vec_t, vec_t> mm::DomainShape< vec_t >::bbox ( ) const

pure virtual

Return the bounding box of the domain.

Bounding box is returned in format bbox() == {{mx, my, ...}, {MX, MY, ...}}, such that mx <= Mx and my <= My etc.\ and that the whole domain is contained in the cuboid [mx, my, ...] x [Mx, My, ...].

Implemented in mm::PolyhedronShape< vec_t >, mm::NURBSShape< vec_t, param_vec_t >, mm::ShapeDifference< vec_t >, mm::PolygonShape< vec_t >, mm::RotatedShape< vec_t >, mm::ShapeUnion< vec_t >, mm::BoxShape< vec_t >, mm::STLShape< vec_t >, mm::BallShape< vec_t >, mm::TranslatedShape< vec_t >, and mm::UnknownShape< vec_t >.

◆ clone()

template<typename vec_t >

virtual DomainShape* mm::DomainShape< vec_t >::clone ( ) const

pure virtual

Polymorphic clone pattern.

Implemented in mm::PolyhedronShape< vec_t >, mm::NURBSShape< vec_t, param_vec_t >, mm::BoxShape< vec_t >, mm::PolygonShape< vec_t >, mm::ShapeUnion< vec_t >, mm::ShapeDifference< vec_t >, mm::STLShape< vec_t >, mm::RotatedShape< vec_t >, mm::BallShape< vec_t >, mm::TranslatedShape< vec_t >, and mm::UnknownShape< vec_t >.

◆ contains()

template<typename vec_t >

virtual bool mm::DomainShape< vec_t >::contains ( const vec_t & point ) const

pure virtual

Return true if point is not more than margin() outside the domain.

Implemented in mm::PolyhedronShape< vec_t >, mm::PolygonShape< vec_t >, mm::BoxShape< vec_t >, mm::RotatedShape< vec_t >, mm::ShapeDifference< vec_t >, mm::ShapeUnion< vec_t >, mm::BallShape< vec_t >, mm::TranslatedShape< vec_t >, mm::NURBSShape< vec_t, param_vec_t >, mm::STLShape< vec_t >, and mm::UnknownShape< vec_t >.

◆ discretizeBoundaryWithDensity() [1/2]

template<typename vec_t >

DomainDiscretization<vec_t> mm::DomainShape< vec_t >::discretizeBoundaryWithDensity ( const std::function< scalar_t(vec_t)> & dr ) const

inline

Overload with default type.

Definition at line 189 of file DomainShape_fwd.hpp.

◆ discretizeBoundaryWithDensity() [2/2]

template<typename vec_t >

virtual DomainDiscretization<vec_t> mm::DomainShape< vec_t >::discretizeBoundaryWithDensity	(	const std::function< scalar_t(vec_t)> &	dr,
		int	type
	)		const

pure virtual

Discretizes boundary with given density and fill engine.

If type is 0, the underlying shape provides the default.

Implemented in mm::PolyhedronShape< vec_t >, mm::PolygonShape< vec_t >, mm::TranslatedShape< vec_t >, mm::ShapeUnion< vec_t >, mm::BoxShape< vec_t >, mm::ShapeDifference< vec_t >, mm::BallShape< vec_t >, mm::NURBSShape< vec_t, param_vec_t >, mm::STLShape< vec_t >, and mm::UnknownShape< vec_t >.

◆ discretizeBoundaryWithStep() [1/2]

template<typename vec_t >

DomainDiscretization<vec_t> mm::DomainShape< vec_t >::discretizeBoundaryWithStep ( scalar_t step ) const

inline

Returns a discretization of the boundary of this shape with approximately uniform distance step between nodes.

Node type are decided by the underlying shape.

Definition at line 126 of file DomainShape_fwd.hpp.

◆ discretizeBoundaryWithStep() [2/2]

template<typename vec_t >

virtual DomainDiscretization<vec_t> mm::DomainShape< vec_t >::discretizeBoundaryWithStep	(	scalar_t	step,
		int	type
	)		const

inlinevirtual

Returns a discretization of the boundary of this shape with approximately uniform distance step between nodes.

step must be positive. Added nodes are of type type, which must be non-positive. Value 0 indicates that types are dependant on the implementation of concrete shape.

Reimplemented in mm::PolygonShape< vec_t >, mm::TranslatedShape< vec_t >, mm::ShapeUnion< vec_t >, mm::BoxShape< vec_t >, mm::ShapeDifference< vec_t >, and mm::BallShape< vec_t >.

Definition at line 118 of file DomainShape_fwd.hpp.

◆ discretizeWithDensity() [1/4]

template<typename vec_t >

template<typename func_t , typename fill_t >

DomainDiscretization<vec_t> mm::DomainShape< vec_t >::discretizeWithDensity	(	const func_t &	dr,
		const fill_t &	fill
	)		const

inline

Overload for fill engine with default types.

Definition at line 177 of file DomainShape_fwd.hpp.

◆ discretizeWithDensity() [2/4]

template<typename vec_t >

template<typename func_t , typename fill_t >

DomainDiscretization<vec_t> mm::DomainShape< vec_t >::discretizeWithDensity	(	const func_t &	dr,
		const fill_t &	fill,
		int	internal_type,
		int	boundary_type
	)		const

inline

Overload for fill engine.

Definition at line 162 of file DomainShape_fwd.hpp.

◆ discretizeWithDensity() [3/4]

template<typename vec_t >

DomainDiscretization<vec_t> mm::DomainShape< vec_t >::discretizeWithDensity ( const std::function< scalar_t(vec_t)> & dr ) const

inline

Overload with default types.

Definition at line 170 of file DomainShape_fwd.hpp.

◆ discretizeWithDensity() [4/4]

template<typename vec_t >

DomainDiscretization< vec_t > mm::DomainShape< vec_t >::discretizeWithDensity	(	const std::function< scalar_t(vec_t)> &	dr,
		int	internal_type,
		int	boundary_type
	)		const

virtual

Returns a discretization of the domain with spatially variable step.

Parameters

dr	Function giving desired internodal distance at each point.
internal_type	User supplied type of internal nodes. Must be non-negative.
boundary_type	User supplied type of boundary nodes. Must be non-positive. If any of the types is 0, the underlying shape provides the default.

Returns: Discretization with nodes distributed according to dr.

Reimplemented in mm::TranslatedShape< vec_t >, mm::ShapeUnion< vec_t >, and mm::ShapeDifference< vec_t >.

Definition at line 77 of file DomainShape.hpp.

◆ discretizeWithStep() [1/2]

template<typename vec_t >

DomainDiscretization<vec_t> mm::DomainShape< vec_t >::discretizeWithStep ( scalar_t step ) const

inline

discretizeWithStep but with default types as assigned by the shape.

Definition at line 144 of file DomainShape_fwd.hpp.

◆ discretizeWithStep() [2/2]

template<typename vec_t >

virtual DomainDiscretization<vec_t> mm::DomainShape< vec_t >::discretizeWithStep	(	scalar_t	step,
		int	internal_type,
		int	boundary_type
	)		const

inlinevirtual

Returns a discretization of this shape with approximately uniform distance step between nodes.

step must be positive.

Parameters

step	Desired internodal distance.
internal_type	User supplied type of internal nodes. Must be non-negative.
boundary_type	User supplied type of boundary nodes. Must be non-positive. If any of the types is 0, the underlying shape provides the default.

Reimplemented in mm::TranslatedShape< vec_t >, mm::ShapeUnion< vec_t >, mm::BoxShape< vec_t >, mm::ShapeDifference< vec_t >, and mm::BallShape< vec_t >.

Definition at line 137 of file DomainShape_fwd.hpp.

◆ hasContains()

template<typename vec_t >

virtual bool mm::DomainShape< vec_t >::hasContains ( ) const

inlinevirtual

Return true if shape has contains() method implemented.

Reimplemented in mm::NURBSShape< vec_t, param_vec_t >, mm::RotatedShape< vec_t >, mm::ShapeDifference< vec_t >, mm::ShapeUnion< vec_t >, mm::STLShape< vec_t >, mm::TranslatedShape< vec_t >, and mm::UnknownShape< vec_t >.

Definition at line 96 of file DomainShape_fwd.hpp.

◆ margin()

template<typename vec_t >

scalar_t mm::DomainShape< vec_t >::margin ( ) const

inline

Returns current margin.

Definition at line 72 of file DomainShape_fwd.hpp.

◆ operator+()

template<typename vec_t >

ShapeUnion<vec_t> mm::DomainShape< vec_t >::operator+ ( const DomainShape< vec_t > & other ) const

inline

Operator form of DomainShape::add.

See also: add

Definition at line 81 of file DomainShape_fwd.hpp.

◆ operator-()

template<typename vec_t >

ShapeDifference<vec_t> mm::DomainShape< vec_t >::operator- ( const DomainShape< vec_t > & other ) const

inline

Operator form of DomainShape::subtract.

See also: subtract

Definition at line 86 of file DomainShape_fwd.hpp.

◆ print()

template<typename vec_t >

virtual std::ostream& mm::DomainShape< vec_t >::print ( std::ostream & os ) const

pure virtual

Output information about this shape to given output stream os.

Implemented in mm::NURBSShape< vec_t, param_vec_t >, mm::STLShape< vec_t >, mm::UnknownShape< vec_t >, mm::PolyhedronShape< vec_t >, mm::BoxShape< vec_t >, mm::PolygonShape< vec_t >, mm::ShapeUnion< vec_t >, mm::ShapeDifference< vec_t >, mm::RotatedShape< vec_t >, mm::BallShape< vec_t >, and mm::TranslatedShape< vec_t >.

◆ projectPointToBoundary()

template<typename vec_t >

std::pair< bool, vec_t > mm::DomainShape< vec_t >::projectPointToBoundary	(	const vec_t &	point,
		const vec_t &	unit_normal
	)		const

virtual

Project point to boundary using bisection along the line define by unit_normal.

Definition at line 21 of file DomainShape.hpp.

◆ rotate() [1/2]

template<typename vec_t >

RotatedShape< vec_t > mm::DomainShape< vec_t >::rotate ( const Eigen::Matrix< scalar_t, dim, dim > & Q )

Transform the shape by given orthogonal matrix Q.

Note: It is usually faster to first discretize the domain and than transform the whole discretization using DomainDiscretization::rotate.

Definition at line 98 of file DomainShape.hpp.

◆ rotate() [2/2]

template<typename vec_t >

RotatedShape< vec_t > mm::DomainShape< vec_t >::rotate ( scalar_t angle )

2D version of rotate accepting an angle.

Definition at line 89 of file DomainShape.hpp.

◆ setMargin()

template<typename vec_t >

virtual void mm::DomainShape< vec_t >::setMargin ( scalar_t margin )

inlinevirtual

Sets domain margin to margin.

Reimplemented in mm::PolygonShape< vec_t >.

Definition at line 75 of file DomainShape_fwd.hpp.

◆ subtract()

template<typename vec_t >

ShapeDifference< vec_t > mm::DomainShape< vec_t >::subtract ( const DomainShape< vec_t > & other ) const

Returns a shape representing a difference of *this and other.

Definition at line 71 of file DomainShape.hpp.

◆ toggleMargin()

template<typename vec_t >

void mm::DomainShape< vec_t >::toggleMargin ( )

inline

Toggles the margin from positive to negative.

Definition at line 77 of file DomainShape_fwd.hpp.

◆ translate()

template<typename vec_t >

TranslatedShape< vec_t > mm::DomainShape< vec_t >::translate ( const vec_t & a )

Translate the shape by given vector a.

Note: It is usually faster to first discretize the domain and than translate the whole discretization using DomainDiscretization::translate.

Definition at line 84 of file DomainShape.hpp.

Friends And Related Function Documentation

◆ operator<<

template<typename vec_t >

template<typename V >

std::ostream& operator<<	(	std::ostream &	os,
		const DomainShape< V > &	shape
	)

friend

Output info about given shape to ostream.

Calls polymorphic DomainShape::print function.

See also: print

Definition at line 220 of file DomainShape_fwd.hpp.

Member Data Documentation

◆ margin_

template<typename vec_t >

scalar_t mm::DomainShape< vec_t >::margin_

protected

Tolerance for the geometric operation of the domain.

The domain should behave as if it was margin_ thicker. Default margin is 1e-10.

Definition at line 64 of file DomainShape_fwd.hpp.

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

include/medusa/bits/domains/DomainShape_fwd.hpp
include/medusa/bits/domains/DomainShape.hpp

Detailed Description

template<typename vec_t> class mm::DomainShape< vec_t >

Public Member Functions

Public Types

Friends

Protected Attributes

Member Enumeration Documentation

◆ anonymous enum

Constructor & Destructor Documentation

◆ DomainShape()

◆ ~DomainShape()

Member Function Documentation

◆ add()

◆ bbox()

◆ clone()

◆ contains()

◆ discretizeBoundaryWithDensity() [1/2]

◆ discretizeBoundaryWithDensity() [2/2]

◆ discretizeBoundaryWithStep() [1/2]

◆ discretizeBoundaryWithStep() [2/2]

◆ discretizeWithDensity() [1/4]

◆ discretizeWithDensity() [2/4]

◆ discretizeWithDensity() [3/4]

◆ discretizeWithDensity() [4/4]

◆ discretizeWithStep() [1/2]

◆ discretizeWithStep() [2/2]

◆ hasContains()

◆ margin()

◆ operator+()

◆ operator-()

◆ print()

◆ projectPointToBoundary()

◆ rotate() [1/2]

◆ rotate() [2/2]

◆ setMargin()

◆ subtract()

◆ toggleMargin()

◆ translate()

Friends And Related Function Documentation

◆ operator<<

Member Data Documentation

◆ margin_

template<typename vec_t>
class mm::DomainShape< vec_t >