Description

Geometric object representing a NURBS surface.

#include <ChSurfaceNurbs.h>

Inheritance diagram for chrono::ChSurfaceNurbs:

Collaboration diagram for chrono::ChSurfaceNurbs:

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

	ChSurfaceNurbs (int order_u, int order_v, const ChMatrixDynamic< ChVector3d > &points, const ChVectorDynamic<> knots_u=nullptr, const ChVectorDynamic<> knots_v=nullptr, const ChMatrixDynamic<> *new_weights=nullptr)
	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 ChVector3d	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() you need U parameter to be in 0..1 range, but knot range is not necessarily in 0..1. More...

double	ComputeKnotUfromU (double U) const
	When using Evaluate() you need U parameter to be in 0..1 range, but knot range is not necessarily in 0..1. More...

double	ComputeVfromKnotV (double v) const
	When using Evaluate() you need V parameter to be in 0..1 range, but knot range is not necessarily in 0..1. More...

double	ComputeKnotVfromV (double V) const
	When using Evaluate() you need V parameter to be in 0..1 range, but knot range is not necessarily in 0..1. More...

ChMatrixDynamic< ChVector3d > &	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	Setup (int order_u, int order_v, const ChMatrixDynamic< ChVector3d > &points, const ChVectorDynamic<> knots_u=nullptr, const ChVectorDynamic<> knots_v=nullptr, const ChMatrixDynamic<> *weights=nullptr)
	Initial easy setup from a given array of control points. More...

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

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

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

virtual ChVector3d	GetNormal (double parU, double parV) const
	Return the normal unit vector at the parametric coordinates (U,V). More...

virtual bool	IsClosedU () const
	Return true if the surface is closed (periodic) in the 1st parametric coordinate.

virtual bool	IsClosedV () const
	Return true if the surface is closed (periodic) in the 2nd parametric coordinate.

virtual int	GetManifoldDimension () const override final
	Return dimensionality of this object. More...

bool	IsWireframe ()
	Return true if visualization is done only as UV isolines.

void	SetWireframe (bool mw)
	Enable/disable visualization as wireframe.

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

virtual Type	GetType () 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 ChVector3d	Barycenter () const
	Compute center of mass.

virtual void	Update ()
	Generic update of internal data.

Additional Inherited Members
Public Types inherited from chrono::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::ChSurface
bool	wireframe

Constructor & Destructor Documentation

◆ ChSurfaceNurbs()

chrono::ChSurfaceNurbs::ChSurfaceNurbs	(	int	order_u,
		int	order_v,
		const ChMatrixDynamic< ChVector3d > &	points,
		const ChVectorDynamic<> *	knots_u = `nullptr`,
		const ChVectorDynamic<> *	knots_v = `nullptr`,
		const ChMatrixDynamic<> *	new_weights = `nullptr`
	)

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

order_u	order pu: 1= linear, 2=quadratic, etc.
order_v	order pv: 1= linear, 2=quadratic, etc.
points	control points, size nuxnv. Required: nu at least pu+1, same for v
knots_u	knots, size ku. Required ku=nu+pu+1. If not provided, initialized to uniform.
knots_v	knots, size kv. Required ku=nu+pu+1. If not provided, initialized to uniform.
new_weights	weights, size nuxnv. If not provided, all weights as 1.

Member Function Documentation

◆ ComputeKnotUfromU()

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

inline

When using Evaluate() 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, by calling this.

◆ ComputeKnotVfromV()

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

inline

When using Evaluate() 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, by calling this.

◆ ComputeUfromKnotU()

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

inline

When using Evaluate() 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, by calling this.

◆ ComputeVfromKnotV()

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

inline

When using Evaluate() 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, by calling this.

◆ Evaluate()

ChVector3d chrono::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::ChSurface.

◆ Setup()

void chrono::ChSurfaceNurbs::Setup	(	int	order_u,
		int	order_v,
		const ChMatrixDynamic< ChVector3d > &	points,
		const ChVectorDynamic<> *	knots_u = `nullptr`,
		const ChVectorDynamic<> *	knots_v = `nullptr`,
		const ChMatrixDynamic<> *	weights = `nullptr`
	)

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

order_u	order pu: 1= linear, 2=quadratic, etc.
order_v	order pv: 1= linear, 2=quadratic, etc.
points	control points, size nuxnv. Required: at least nu >= pu+1, same for v
knots_u	knots u, size ku. Required ku=nu+pu+1. If not provided, initialized to uniform.
knots_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

Additional Inherited Members

Constructor & Destructor Documentation

◆ ChSurfaceNurbs()

Member Function Documentation

◆ ComputeKnotUfromU()

◆ ComputeKnotVfromV()

◆ ComputeUfromKnotU()

◆ ComputeVfromKnotV()

◆ Evaluate()

◆ Setup()