User Inputs and GUI Components

The settings under the Declaration section often determines what GUI component you see when the user input is visible.

Use this section in combination with the features described in the User Inputs section.

Single-Array Inputs

The table below summarizes the behavior for single-array inputs (option Array type set to Single).

Dimension	Allowed Values	GUI Component
Scalar or 1x1	Any	field (text box)
Scalar or 1x1	From list	Combo box
Vector (3x1)	Not applicable	Table with 1–3 rows, depending on the option Vector component to display.
Matrix (3x3)	Not applicable	Table with 1–3 rows and 1–3 columns, depending on the option Matrix component to display. You also get a combo box for matrix symmetry.
Boolean	Not applicable	Check box. Note that there is a special node for creating Boolean inputs.
Custom	Not applicable	Table with rows and columns representing the specified dimension. If it represents a square matrix, you can specify a symmetry with the option Matrix symmetry for square matrix.
Changeable	Not applicable	Single column table with the possibility to add rows.

Depending on the dimension of the input, you get different options in the GUI Options section. You find the available options below:

•	Hide user input in GUI when inactive. The logic controlling the user input determines that it is inactive, the input’s GUI component disappears from the layout. This is not necessary if the user input is a member of a user input group that can disappear.

•	Show no description. Removes the label above the GUI component.

•	Show no symbol. Removes the symbol to the left of the GUI component.

•	Add divider above the user input. Places a horizontal line above the GUI component, possibly with a descriptive text.

•	Show no coordinate labels. For spatial vectors, by default you get the coordinate labels in the left-most column. Selecting this option removes that column.

•	Vector components to display. Controls what components of a spatial vector you want to display in non-3D geometries. You can choose between All, In-plane, and Out-of-plane.

•	Matrix components to display. Same as above but for spatial matrices.

•

Matrix symmetry for square matrix. For non-spatial, square matrices you can force a matrix symmetry with this option. The choices are Diagonal, Symmetric, Anisotropic, and Symmetric, fixed diagonal, and they control the cells that the user can edit. For Symmetric, fixed diagonal, the diagonal is fixed to the default values, and the user can only edit the off-diagonal elements.

Double-Array Inputs

Double-array inputs are far more complex to design GUI components for, and some combinations are not supported. The table below summarizes the behavior for the supported double-array inputs (option Array type set to Double).

Outer dim.	Inner dim.	Allowed Values	GUI Component
Vector (3x1)	Scalar or 1x1	Any	Behaves as a single-array vector
Vector (3x1)	Scalar or 1x1	From list	Several combo boxes when the input is a member to a special input group, see User Input Group GUI Options. Otherwise, behaves as a single-array vector with restrictions what you can enter in the table cells.
Matrix (3x3)	Scalar or 1x1	Any	Behaves as a single-array matrix
Vector (3x1)	Boolean	Not applicable	Several check boxes when the input is a member to a special input group, see User Input Group GUI Options. Otherwise, behaves as a single-array vector with restrictions what you can enter in the table cells.

For double-array inputs, you might get an error when you try to use an unsupported combination. In other situations, especially when the inner dimension is a scalar, you can get a component, but with an unpractical behavior. For example, when the outer dimension is fixed but nonscalar, the inner dimension is scalar, and Allowed values is set to From list. Then the input behaves as the single-array version, but with restrictions on what you can enter in the table cells.

There are fewer GUI options for double-array inputs, but those supported are identical to the options for single-array inputs.

User Input