Description

Geometric object representing a NURBS surface.

#include <ChSurfaceNurbs.h>

Inheritance diagram for chrono::geometry::ChSurfaceNurbs:

Collaboration diagram for chrono::geometry::ChSurfaceNurbs:

Public Member Functions
	ChSurfaceNurbs ()
	Constructor. By default, a segment (order = 1, two points on X axis, at -1, +1)

	ChSurfaceNurbs (int morder_u, int morder_v, ChMatrixDynamic< ChVector<>> &mpoints, ChVectorDynamic<> mknots_u=0, ChVectorDynamic<> mknots_v=0, ChMatrixDynamic<> *weights=0)
	Constructor from a given array of control points. More...

	ChSurfaceNurbs (const ChSurfaceNurbs &source)

virtual ChSurfaceNurbs *	Clone () const override
	"Virtual" copy constructor (covariant return type).

virtual ChVector	Evaluate (double parU, double parV) const override
	Return a point on the surface, given parametric coordinates U,V. More...

double	ComputeUfromKnotU (double u) const
	When using Evaluate() etc. More...

double	ComputeKnotUfromU (double U) const
	When using Evaluate() etc. More...

double	ComputeVfromKnotV (double v) const
	When using Evaluate() etc. More...

double	ComputeKnotVfromV (double V) const
	When using Evaluate() etc. More...

ChMatrixDynamic< ChVector<> > &	Points ()
	Access the points.

ChMatrixDynamic &	Weights ()
	Access the weights.

ChVectorDynamic &	Knots_u ()
	Access the U knots.

ChVectorDynamic &	Knots_v ()
	Access the U knots.

int	GetOrder_u ()
	Get the order in u direction.

int	GetOrder_v ()
	Get the order in v direction.

virtual void	SetupData (int morder_u, int morder_v, ChMatrixDynamic< ChVector<> > &mpoints, ChVectorDynamic<> mknots_u=0, ChVectorDynamic<> mknots_v=0, ChMatrixDynamic<> *weights=0)
	Initial easy setup from a given array of control points. More...

virtual void	ArchiveOut (ChArchiveOut &marchive) override
	Method to allow serialization of transient data to archives.

virtual void	ArchiveIn (ChArchiveIn &marchive) override
	Method to allow de-serialization of transient data from archives.

Public Member Functions inherited from chrono::geometry::ChSurface
	ChSurface (const ChSurface &source)

virtual ChVector	GetNormal (double parU, double parV) const
	Return the normal unit vector at the parametric coordinates U,V (in the range [0,1]). More...

virtual bool	Get_closed_U () const
	Tell if the surface is closed (periodic) on U.

virtual bool	Get_closed_V () const
	Tell if the surface is closed (periodic) on V.

virtual int	GetManifoldDimension () const override
	This is a surface, so manifold dimension=2.

bool	IsWireframe ()
	Tell if the visualization is done only as UV isolines.

void	SetWireframe (bool mw)
	Set if the visualization is done only as UV isolines.

Public Member Functions inherited from chrono::geometry::ChGeometry
	ChGeometry (const ChGeometry &source)

virtual Type	GetClassType () const
	Get the class type as an enum.

virtual ChAABB	GetBoundingBox () const
	Compute bounding box along the directions of the shape definition frame. More...

void	InflateBoundingBox (ChAABB &bbox) const
	Enlarge the given existing bounding box with the bounding box of this object.

virtual double	GetBoundingSphereRadius () const
	Returns the radius of a bounding sphere for this geometry. More...

virtual ChVector	Baricenter () const
	Compute center of mass.

virtual void	Update ()
	Generic update of internal data.

Public Attributes
ChMatrixDynamic< ChVector<> >	points

ChMatrixDynamic	weights

ChVectorDynamic	knots_u

ChVectorDynamic	knots_v

int	p_u

int	p_v

Additional Inherited Members
Public Types inherited from chrono::geometry::ChGeometry
enum	Type { NONE, SPHERE, ELLIPSOID, BOX, CYLINDER, TRIANGLE, CAPSULE, CONE, LINE, LINE_ARC, LINE_BEZIER, LINE_CAM, LINE_PATH, LINE_POLY, LINE_SEGMENT, ROUNDED_BOX, ROUNDED_CYLINDER, TRIANGLEMESH, TRIANGLEMESH_CONNECTED, TRIANGLEMESH_SOUP }
	Enumeration of geometric object types.

Protected Attributes inherited from chrono::geometry::ChSurface
bool	wireframe

Constructor & Destructor Documentation

◆ ChSurfaceNurbs()

chrono::geometry::ChSurfaceNurbs::ChSurfaceNurbs	(	int	morder_u,
		int	morder_v,
		ChMatrixDynamic< ChVector<>> &	mpoints,
		ChVectorDynamic<> *	mknots_u = `0`,
		ChVectorDynamic<> *	mknots_v = `0`,
		ChMatrixDynamic<> *	weights = `0`
	)

Constructor from a given array of control points.

Input data is copied. If the knots are not provided, a uniformly spaced knot vector is made. If the weights are not provided, a constant weight vector is made.

Parameters

morder_u	order pu: 1= linear, 2=quadratic, etc.
morder_v	order pv: 1= linear, 2=quadratic, etc.
mpoints	control points, size nuxnv. Required: nu at least pu+1, same for v
mknots_u	knots, size ku. Required ku=nu+pu+1. If not provided, initialized to uniform.
mknots_v	knots, size kv. Required ku=nu+pu+1. If not provided, initialized to uniform.
weights	weights, size nuxnv. If not provided, all weights as 1.

Member Function Documentation

◆ ComputeKnotUfromU()

double chrono::geometry::ChSurfaceNurbs::ComputeKnotUfromU ( double U ) const

inline

When using Evaluate() etc.

you need U parameter to be in 0..1 range, but knot range is not necessarily in 0..1. So you can convert U->u, where u is in knot range, calling this:

◆ ComputeKnotVfromV()

double chrono::geometry::ChSurfaceNurbs::ComputeKnotVfromV ( double V ) const

inline

When using Evaluate() etc.

you need V parameter to be in 0..1 range, but knot range is not necessarily in 0..1. So you can convert V->v, where v is in knot range, calling this:

◆ ComputeUfromKnotU()

double chrono::geometry::ChSurfaceNurbs::ComputeUfromKnotU ( double u ) const

inline

When using Evaluate() etc.

you need U parameter to be in 0..1 range, but knot range is not necessarily in 0..1. So you can convert u->U, where u is in knot range, calling this:

◆ ComputeVfromKnotV()

double chrono::geometry::ChSurfaceNurbs::ComputeVfromKnotV ( double v ) const

inline

When using Evaluate() etc.

you need V parameter to be in 0..1 range, but knot range is not necessarily in 0..1. So you can convert v->V, where v is in knot range, calling this:

◆ Evaluate()

ChVector chrono::geometry::ChSurfaceNurbs::Evaluate	(	double	parU,
		double	parV
	)		const

overridevirtual

Return a point on the surface, given parametric coordinates U,V.

Parameters U and V always work in 0..1 range. As such, to use u' in knot range, use ComputeUfromKnotU().

Reimplemented from chrono::geometry::ChSurface.

◆ SetupData()

void chrono::geometry::ChSurfaceNurbs::SetupData	(	int	morder_u,
		int	morder_v,
		ChMatrixDynamic< ChVector<> > &	mpoints,
		ChVectorDynamic<> *	mknots_u = `0`,
		ChVectorDynamic<> *	mknots_v = `0`,
		ChMatrixDynamic<> *	weights = `0`
	)

virtual

Initial easy setup from a given array of control points.

Input data is copied. If the knots are not provided, a uniformly spaced knot vector is made. If the weights are not provided, a constant weight vector is made.

Parameters

morder_u	order pu: 1= linear, 2=quadratic, etc.
morder_v	order pv: 1= linear, 2=quadratic, etc.
mpoints	control points, size nuxnv. Required: at least nu >= pu+1, same for v
mknots_u	knots u, size ku. Required ku=nu+pu+1. If not provided, initialized to uniform.
mknots_v	knots v, size kv. Required ku=nu+pu+1. If not provided, initialized to uniform.
weights	weights, size nuxnv. If not provided, all weights as 1.

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

/builds/uwsbel/chrono/src/chrono/geometry/ChSurfaceNurbs.h
/builds/uwsbel/chrono/src/chrono/geometry/ChSurfaceNurbs.cpp

Description

Public Member Functions

Public Attributes

Additional Inherited Members

Constructor & Destructor Documentation

◆ ChSurfaceNurbs()

Member Function Documentation

◆ ComputeKnotUfromU()

◆ ComputeKnotVfromV()

◆ ComputeUfromKnotU()

◆ ComputeVfromKnotV()

◆ Evaluate()

◆ SetupData()