Array 1D, Array 2D, Array3D

Create array datasets.

Syntax

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

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

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

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

Description

model.result().dataset().create(<dtag>,"Array1D") creates a 1D array dataset feature named <dtag>.

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

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

This dataset takes data from another dataset and adds an array of copies in cells as a linear, rectangular (2D), or three-dimensional (3D) array of cells.

The following properties are available for Array 1D, Array 2D, and Array 3D:

Table 7-11: Valid Properties for array Datasets.
Name	Value	Default	Description
ax2	String array	{"0","0"}	Theta and phi angles for the rotation, if type is set to linear and axistype is set to spherical for a 3D Array dataset.
ax3	String 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 3D Array dataset.
axistype	x \| y \| z \| cartesian \| spherical	z	The axis type for a rotation, if type is set to linear for a 3D Array dataset.
base	corner \| center	corner	Base point for the position of the input cell if inputmethod is set to manual.
celllinearvar	String	Depends on the feature’s tag	If hasvar is true: an integer variable that identify the current cell in the array.
cellvars	String array	Depends on the feature’s tag	If hasvar is true: an integer array that identify the current cell in the array.
checkoverlap	Boolean	true	Check for overlap between cells in the array.
data	none \| dataset name	First compatible dataset	The dataset this feature refers to.
displ	String array	{"0","0"} (2D); {"0","0","0"} (3D)	The displacement used to move each cell in the array if displmethod is set to manual.
displmethod	auto \| manual	auto	Use automatic or manual definition of the displacement for the cells in the array.
floquetper	on \| off	off	Include Floquet-Bloch periodicity.
fullsize	array (integer or string)	1 (1D); {1, 1} (2D); {1, 1,1} (3D)	Size of the array (number of cells in each direction) for a linear, rectangular, or three-dimensional array.
hasvars	Boolean	false	If true, space and cell indicator variables are defined.
inputmethod	auto \| manual	auto	Use automatic or manual definition of the part of space that the array is created from,
linearsize	positive integer or string	1	Size of the linear array in number of cells.
pos	String array	{"0","0"} (2D); {"0","0","0"} (3D)	If inputmethod is manual: The coordinates (position) of the base point. If base is set to corner, it is the lower-left corner of the base cell.
rotangle	double	0	The angle increment, in radians, for a rotation, if type is set to linear for a 2D or 3D Array dataset.
rotcenter	String array	{"0","0"}	The center of rotation, if type is set to linear for a 2D Array dataset.
rotpos	String array	{"0","0","0"}	Point on axis of rotation, if type is set to linear for a 3D Array dataset.
size	String array	{"1","1"} (2D); {"1","1","1"} (3D)	If inputmethod is manual: The size of the input.
spacevars	String array	Depends on the feature’s tag	If hasvar is true: The name of space variables, which evaluate to the coordinates in the dataset’s coordinate system.
type	linear \| rectangular \| three-dimensional	rectangular (2D); three-dimensional (3D)	The type of array: Linear, rectangular (2D only), or three-dimensional (3D only). Not available in 1D.
wavevector	String array		The wave vector for Floquet-Bloch periodicity as a 1-, 2-, or 3-element string array.

Attribute

Selection (Dataset Attribute)