Transformation2D, Transformation3D

Create a transformation 2D or transformation 3D dataset. Use a transformation dataset to scale, rotate, and move a geometry in another dataset. If you use multiple transformations, note that they are performed in that order and that they do not always commute. If you need a transformation in another order, use multiple transformation datasets in succession with only one type of transformation in each dataset.

Syntax

model.result().dataset().create(<dtag>,"Transformation2D");

model.result().dataset().create(<dtag>,"Transformation3D");

model.result().dataset(<dtag>).setIndex(...);

model.result().dataset(<dtag>).set(property,<value>);

Description

model.result().dataset().create(<dtag>,"Transformation2D") creates a 2D transformation dataset feature named <dtag>.

model.result().dataset().create(<dtag>,"Transformation3D") creates a 3D transformation dataset feature named <dtag>.

This dataset takes a geometry from another dataset and adds a transformation that can include scaling, rotation, and translation (moving).

The following properties are available for Transformation2D and Transformation3D:

Table 7-159: Valid Properties for Transformation Datasets (if not noted, properties are for the Structured Transformation Type).
Name	Value	Default	Description
ax2	double array	{0,0}	Theta and phi angles for the rotation, if type is set to linear and axistype is set to spherical for a Rotation3D dataset, and if enablerot is true.
ax3	double array	{0, 0, 0}	Axis coordinates (x, y, and z) for the rotation, if type is set to linear and axistype is set to cartesian for a Rotation3D dataset, and if enablerot is true.
axistype	x \| y \| z \| cartesian \| spherical	z	The axis type for a rotation, if type is set to linear for a Rotation3D dataset, if enablerot is true.
data	none \| dataset name	First compatible dataset	The dataset this feature refers to
enablemove	Boolean	false	Enable moving (translating) the geometry.
enablerot	Boolean	false	Enable rotating the geometry.
enablescale	Boolean	false	Enable scaling of the geometry.
move	double array	{0, 0} (2D), {0, 0, 0} (3D)	The move (translation), if transtype is general, if enablemove is true.
rotangle	double	0	The angle increment for a rotation, if enablerot is true.
rotcenter	double array	{0, 0}	The rotation center for a Rotation2D dataset.
scale	Numerical array	Depends on the feature’s tag	The scaling in the x, y (2D and 3D), and z (3D only) directions, if enablescale is true.
spacevars	String array	Depends on the feature’s tag	The name of space variables, which evaluate to the coordinates after the transformation.
translation	double array	{0, 0} (2D), {0, 0, 0} (3D)	The translation, if transtype is general.
transmatrix	double array	2-by-2 or 3-by-3 matrix of zeros	The base vectors of a transformation, specified using setIndex syntax, if transtype is general.
transtype	structured \| general	structured	The transformation type.