Torus

Create a solid or surface torus in 3D.

Syntax

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

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>).setAttribute(attribute,<value>);

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

Description

Use model.component(<ctag>).geom(<tag>).create(<ftag>,"Torus") to create a torus. The following properties are available:

Table 3-173: Valid Property/Value Pairs for Torus
Property	Value	Default	Description
angle	double	360	Revolution angle.
axis	double[]	{0,0,1}	Direction of the revolution axis. 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.
contributeto	String	none	Tag of cumulative selection to contribute to.
customcolor	RGB-triplet	Next available theme color	The color to use. Active when color is set to custom.
intfaces	on \| off	off	Create cross section faces inside the torus.
pos	double[]	{0,0,0}	Center coordinates.
rmaj	double	1	Directrix radius.
rmin	double	0.5	Generatrix radius.
rot	double	0	Rotational angle about axis.
selresult	on \| off	off	Create selections of all resulting objects.
selresultshow	all \| obj \| dom \| bnd \| edg \| pnt \| off	dom	Show selections, if selresult is on, of resulting objects in physics, materials, and so on, or in part instances. obj is not available in a component’s geometry. dom, bnd, and edg are not available in all features.
type	solid \| surface	solid	Object type.
workplanesrc	this \| Part Instance feature	this	Part Instance feature to take the work plane from.
workplane	xyplane \| Work plane feature	xyplane	Work Plane feature that defines the coordinate system. The default, xyplane, is the global Cartesian coordinate system.

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

The following attributes are available:

Table 3-174: Valid attributes
Name	Value	Default	Description
construction	on \| off	off	Designate the resulting objects as construction geometry.

Compatibility

model.component(<ctag>).geom(<tag>).create(<ftag>,"torus3") creates a solid torus.

model.component(<ctag>).geom(<tag>).create(<ftag>,"torus2") creates a surface torus.

The following properties are also available:

Table 3-175: Valid Property/Value Pairs for Torus
Property	Value	Default	Description
ax2	double[]	{0,0}	Alias for axis when axistype is spherical.
ax3	double[]	{0,0,1}	Alias for axis when axistype is cartesian.
x, y, z	double	0	Alias for pos.