Description

Base class for all geometric objects representing lines in 3D space.

This is the base for all U-parametric object, implementing Evaluate() that returns a point as a function of the U parameter.

#include <ChLine.h>

Inheritance diagram for chrono::geometry::ChLine:

[legend]

Collaboration diagram for chrono::geometry::ChLine:

[legend]

Public Member Functions
	ChLine (const ChLine &source)

virtual GeometryType	GetClassType () const override
	"Virtual" copy constructor (covariant return type). More...

virtual void	Evaluate (ChVector<> &pos, const double parU) const =0
	Evaluates a point on the line, given parametric coordinate U. More...

virtual void	Derive (ChVector<> &dir, const double parU) const
	Evaluates a tangent versor, given parametric coordinate. More...

virtual bool	Get_closed () const
	Tell if the curve is closed.

virtual void	Set_closed (bool mc)

virtual int	Get_complexity () const
	Tell the complexity.

virtual void	Set_complexity (int mc)

virtual int	GetManifoldDimension () const override
	This is a line.

bool	FindNearestLinePoint (ChVector<> &point, double &resU, double approxU, double tol) const
	Find the parameter resU for the nearest point on curve to "point".

virtual double	Length (int sampling) const
	Returns curve length. Typical sampling 1..5 (1 already gives correct result with degree1 curves)

virtual ChVector	GetEndA () const
	Return the start point of the line. More...

virtual ChVector	GetEndB () const
	Return the end point of the line. More...

double	CurveCurveDist (ChLine *compline, int samples) const
	Returns adimensional information on "how much" this curve is similar to another in its overall shape (does not matter parametrization or start point). More...

double	CurveSegmentDist (ChLine *complinesegm, int samples) const
	Same as before, but returns "how near" is complinesegm to whatever segment of this line (does not matter the percentual of line). More...

double	CurveCurveDistMax (ChLine *compline, int samples) const
	Same as above, but instead of making average of the distances, these functions return the maximum of the distances...

double	CurveSegmentDistMax (ChLine *complinesegm, int samples) const

virtual bool	DrawPostscript (ChFile_ps *mfle, int markpoints, int bezier_interpolate)
	Draw into the current graph viewport of a ChFile_ps file.

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::ChGeometry
	ChGeometry (const ChGeometry &source)

virtual ChGeometry *	Clone () const =0
	"Virtual" copy constructor.

virtual void	GetBoundingBox (ChVector<> &cmin, ChVector<> &cmax, const ChMatrix33<> &rot) const
	Compute bounding box along the directions defined by the given rotation matrix. More...

void	InflateBoundingBox (ChVector<> &cmin, ChVector<> &cmax, const ChMatrix33<> &rot) 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.

Protected Attributes
bool	closed

int	complexityU

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

Member Function Documentation

◆ CurveCurveDist()

double chrono::geometry::ChLine::CurveCurveDist	(	ChLine *	compline,
		int	samples
	)		const

Returns adimensional information on "how much" this curve is similar to another in its overall shape (does not matter parametrization or start point).

Try with 20 samples. The return value is somewhat the "average distance between the two curves". Note that the result is affected by "weight" of curves. If it chnges from default 1.0, the distance estimation is higher/lower (ex: if a curve defines low 'weight' in its central segment, its CurveCurveDistance from another segment is not much affected by errors near the central segment).

◆ CurveSegmentDist()

double chrono::geometry::ChLine::CurveSegmentDist	(	ChLine *	complinesegm,
		int	samples
	)		const

Same as before, but returns "how near" is complinesegm to whatever segment of this line (does not matter the percentual of line).

Again, this is affected by "weight" of curves. If weight changes along curves ->'weighted' distance

◆ Derive()

void chrono::geometry::ChLine::Derive	(	ChVector<> &	dir,
		const double	parU
	)		const

virtual

Evaluates a tangent versor, given parametric coordinate.

Parameter U always work in 0..1 range. Computed value goes into the 'pos' reference. It could be overridden by inherited classes if a precise solution is known (otherwise it defaults to numerical BDF using the Evaluate() function).

Reimplemented in chrono::geometry::ChLineNurbs, and chrono::geometry::ChLineBspline.