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)