ParametricCurve

Create a parametric curve defined by coordinate expressions in 2D or 3D.

Syntax

model.geom(<tag>).create(<ftag>,"ParametricCurve");

model.geom(<tag>).feature(<ftag>).set(property,<value>);

model.geom(<tag>).feature(<ftag>).getType(property);

model.geom(<tag>).feature(<ftag>).importData();

Description

Use model.geom(<tag>).create(<ftag>,"ParametericCurve") to create a parametric curve. Self-intersecting curves are not supported, except the case of a closed curve (that is, when the start and end points coincide). The following properties are available:

Table 3-77: Valid Property/Value Pairs

Property	Value	Default	Description
axis	double[]	{0,0,1}	Direction of the z-axis of the local coordinate system. Vector has length 3 if axistype is cartesian, and length 2 if axistype is spherical.
axistype	x | y | z | cartesian | spherical	z	Coordinate system used for axis. The value is synchronized with axis.
coord	String[2] | String[3]	empty	Coordinates of parametric curve as function of parameter.
maxknots	int	1000	Maximum number of knots.
parname	String	s	Parameter name.
parmax	double	1	Maximum parameter value.
parmin	double	0	Minimum parameter value.
pos	double[]	{0,0,0}	Position of the object.
rot	double	0	Rotational angle about axis.
rtol	double	1e-6	Relative tolerance.
selresult	on | off	off	Create selections of all resulting objects.
selresultshow	all | obj | dom | bnd | edg | pnt | off	bnd in 2D; edg in 3D	Show selections, if selresult is on, in physics, materials, and so on; in part instances; or in 3D from a plane geometry. obj is not available in a component’s geometry. dom, bnd, and edg are not available in all features.
contributeto	String	none	Tag of cumulative selection to contribute to.

The expressions in coord can contain functions defined in the model. If the definition of such a function is changed, the parametric curve is not automatically rebuilt. Use model.geom(<tag>).feature(<ftag>).importData() to rebuild the parametric curve after such a change.

For information about the selresult and contributeto properties, see Selections of Geometric Entities.

Example

The following commands create a parametric curve in 3D with the shape of a helix:

Code for use with Java

Model model = ModelUtil.create("Model1");

GeomSequence g = model.geom().create("geom1",3);

g.create("pc1","ParametricCurve");

g.feature("pc1").set("parmax","2*pi");

g.feature("pc1").set("coord",new String[]{"cos(s)","sin(s)","s*0.2"});

g.run();

Code for use with MATLAB

model = ModelUtil.create('Model1');

g = model.geom.create('geom1',3);

g.create('pc1','ParametricCurve');

g.feature('pc1').set('parmax','2*pi');

g.feature('pc1').set('coord',{'cos(s)','sin(s)','s*0.2'});

g.run;

See Also

BezierPolygon, ParametricSurface