ParametricCurve

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

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

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

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

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

Use model.component(<ctag>).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 starting point and endpoint coincide). The following properties are available:

Table 3-83: 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.
color	none \| custom \| integer between 1 and the number of colors in the current theme	none	The color of the selection, either given as an integer indicating a color in the color theme, or as a custom color in the customcolor property. Coloring is only available when selresult in active.
coord	String[2] \| String[3]	empty	Coordinates of parametric curve as function of parameter.
customcolor	RGB-triplet	Next available theme color	The color to use. Active when color is set to custom.
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.
reparameterize	true \| false	false	Reparameterize the curve using the arc length.
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.
workplanesrc	this \| Part Instance feature	this	Part Instance feature to take the work plane from (in 3D only).
workplane	xyplane \| Work plane feature	xyplane	Work Plane feature that defines the coordinate system (in 3D only). The default, xyplane, is the global Cartesian coordinate system.

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.component(<ctag>).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");

model.component().create("comp1");

GeomSequence g = model.component("comp1").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');

model.component.create('comp1');

g = model.component('comp1').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;