User Input

) for a feature or property becomes a data storage editable by the user for the corresponding instance in the Model Builder (see User Inputs for an overview).

To add a , first add a feature node, for example, a Generic Feature, Domain Condition, or Device Model Feature, then:

•

From the contextual toolbar (in this example, , , or ), click the (

) button.

•

Right-click the feature node (in this example, , , or ) and select it from the submenu.

The window of a user input contains the following sections:

Declaration

In the section you specify the name of the parameter in the field. The description, symbol, and physical quantity of the user input works identical to variable declaration; see Variable Declaration and Dependent Variable Declaration.

The dimension and default value of the user input is a bit different compared to variables. For scalars, vectors, and matrices you set the desired dimension in the list. Use the array type for the list, which also is the default. When you need user inputs that are vectors of vectors, or vector of matrices, choose in the list. You can then choose the outer dimension with the list and the inner dimension with the list. The list is identical to the list, but the list has fewer options. For all double-array user inputs, the default value refers to the inner dimension and fills up the outer dimension with identical defaults.

When the user input is a scalar, there is an option to define a set of allowed values. In the list, you can choose or . If you choose , a table shows up that you can fill the with allowed values. The list only contains the values entered in the list. If you choose in the list, you specify the default in the field.

User inputs of the type is a special case of a scalar with two allowed values, internally represented with 0 and 1. The obvious control type for this user input is a check box that either can be cleared (0) or selected (1). To make the check box selected by default, select the check box.

When you want vectors where each element must be in a set of allowed values or is a Boolean, you use a double-array user input. Set the outer dimension as desired, and choose or from the list. If you choose , you can set the allowed values as described above.

Restrictions

In the list you can define what space dimensions this particular user input can be used in. The option (the default option) means that the user input supports the same space dimensions as the parent feature or property. If you want to control the space dimensions manually, choose from the list. You can then select the allowed space dimensions from a list of all space dimensions.


	If the user input does not support a space dimension, it becomes completely removed from the feature or property, not just hidden from the user interface. If you then try to access it in a variable definition, for example, an error message appears.

Advanced

This section contains advanced options that you do not have to change in most cases. In the list, you can override the input base vector system specified by the parent (for example, a feature or property) by choosing something else than the default option . See Using Coordinate Systems and Transformation Between Coordinate Systems for more information about selecting base vector systems.

GUI Options

If you want the user input to disappear when it is inactive, select the check box. Select the check box to hide the text label containing the description above the GUI component of the user input. Similarly, you can hide the symbol from the GUI by selecting the check box. As a final option, it is possible to add a divider above the GUI component and any description text label. The divider is a horizontal line with an optional descriptive text. Select the check box to add the divider. When selected, you can enter the divider text in the field.


	See Designing the GUI Layout for more information