Referencing a Matrix Using an Input Grid Control

If you select “Matrix-type Data Elements” (the default) from the Controlled Types drop-list in the Input Grid control dialog, you can use the Input Grid to control a single Data elements.

To do so, you must first specify the matrix Data element that you wish to add to the grid.  This is done by pressing the Add Item button.  This will display a browser which shows all of the matrix Data elements in the model.

   Note: You can only control a single matrix Data element in a grid.

Once you select an element, the dialog will look like this:

You can remove the selected element (by pressing Remove Item), or select a different element by pressing the name of the element itself.

By default, grid cells are displayed in the Dashboard as simple edit boxes (with no minimum or maximum value and a default value of 0). You can specify minimum and maximum values, and edit other grid cell properties (i.e., controlling whether they are edit boxes, check boxes or combo boxes) by clicking the blue text corresponding to that particular cell in the “Value Properties” column.

The check boxes in the “Grid Appearance & Behavior” section of the dialog control how the input grid appears in the Dashboard. The Show Unit in Item Labels and Show Array Set Item Labels are on by default, such that the grid appears like this in the Dashboard:

In this example, the matrix has 4 rows and 3 columns.

Note the unit for the item, if shown, is indicated in the upper left hand corner of the grid.

You can choose to hide the item labels, array set labels and units by clearing the boxes.

If you select Reverse Table Layout, the rows and columns are reversed:

Within a Dashboard, if the grid is too small to display all of the grid cells, scroll bars are added.

   Note: When a Dashboard is active (such that controls can be edited) either in GoldSim or the GoldSim Player, you can paste multiple data points from the clipboard (e.g., which may have been copied from a spreadsheet) into a grid. Several points should be noted: 1) if pasting into a Check Box, only 0 and 1 are recognized; 2) if pasting into a Combo Box, only matching text (not case-sensitive) is recognized; and 3) the orientation must be consistent (e.g., if you are pasting data with 5 rows and 3 columns, the grid should consist of 5 rows and 3 columns).

The Allow changes while paused check box determines whether Dashboard users will be able to edit the input grid in the middle of a simulation (i.e., after the model is paused).  If this check box is cleared (the default) the user can only edit the grid prior to the start of the simulation.  If the model is paused, the field will not be editable.  If the check box is checked, the user will be permitted to edit the grid while the model is paused in the middle of a simulation.

   Note: Even if this box is checked, if the model contains any scenarios, no changes can be made while the model is paused.

Related Topics…

Learn more about: