AnyLogic
Expand
Font size

Experiment dashboard

The experiment dashboard displays the current state of the experiment:

  • The Inputs section lists the exposed model version’s parameters and allows to edit their values.
  • The Outputs section lists the model version’s outputs if the experiment has already been run. The section is blurry if the experiment has not been run yet.

Configuring the dashboard

You can configure the experiment dashboard contents by including the desired set of inputs and outputs and organizing them into sections.

To edit the dashboard contents

  1. Expand the model version node containing the experiment the dashboard of which you would like to configure.
  2. Click the settings icon in the experiment item. The pencil icon will change to save.
    The experiment dashboard will switch to editing mode, allowing you to modify the its contents:

  3. Configure the Inputs and Outputs sections as necessary.
  4. Save your changes by clicking the Save dashboard button in the experiment toolbar or the save button in the sidebar. To discard changes, click the Cancel button in the experiment toolbar.

Configuring the Inputs section

When configuring the Inputs section, you can toggle the visibility of the experiment’s inputs, change the input’s control types as well as expose the experiment’s internal settings:

To show or hide an input element

  1. Click the visibility icon on the left of the element. The element will be hidden and the icon will change to visibility_off. Click the icon again to show the element.

Arranging the input parameters

The input parameters section arrangement replicates the one for the top-level agent of the model (usually the Main agent).

To set the order of the parameters in the Inputs section of the AnyLogic Cloud model experiment, you must modify options in the Parameters preview section of the main agent’s properties in AnyLogic.

You can customize each parameter as follows:

  • Use the and arrows to move a parameter up or down in the list.
  • To add a separating line above the parameter, select the Add separator option.
  • To begin a new section starting with the parameter, select the Begin section option and provide the name of the section in the text field.

Setting the input’s name and control type

Model inputs’ names and associated control types are defined in the Value editor section of the corresponding parameter’s properties prior to exporting the model:

You can change the input’s control type in AnyLogic Cloud by selecting it from the drop-down list:

Experiment settings

The Experiment settings section contains the experiment’s internal settings. Certain experiment have their own control types, which are visible by default in the Inputs section:

  • Monte Carlo 1st order:
    • Number of replications
  • Monte Carlo 2nd order:
    • Number of iterations
    • Number of replications
  • Variation with replications:
    • Number of replications

The following default control types are hidden by default, but you can make them available in the experiment’s dashboard if necessary.

  • Seed of randomness — The number the model’s random number generator will be initialized with.
  • Stop mode — Defines the trigger stopping model simulation. To define the simulation period, use the Start time, Start date, Stop time, and Stop date controls.
    The defined start/stop time/date values can override the default values that you provided upon exporting the model to AnyLogic Cloud.
  • Start time — The time point at which experiment will start.
  • Start date — The date at which experiment will start.
  • Stop time — The time point at which experiment will stop.
  • Stop date — The date at which experiment will start.
  • Maximum memory, MB — The maximum size of Java heap allocated for the model. Here you can override the default value that you provided upon exporting the model to AnyLogic Cloud.

If your model’s run configuration includes files that serve as inputs, from there you can also replace the uploaded file using the corresponding control.

Configuring the Outputs section

When configuring the Outputs section, you can add or remove the output data elements and freely position them within the Outputs area.

The following elements can be added:

  • Outputs, which are charts and text labels displaying the values of the model’s outputs.
  • Collapsible sections, which allow for grouping the dashboard elements.
  • Separating lines, which allow for visually dividing the workspace into distinct areas.

To add an element, click the button. To remove an element, click the icon in its top-right corner.

To add an output

  1. Click in the  Add output placeholder. A blank output element will be created:

  2. Provide the label for the output in the text field.
  3. Choose the type of the output from the Choose type drop-down list. Depending on the type of data you want to visualize, select the appropriate option:
    • To visualize a two-dimensional series data set, select Plot, Time plot, Time stack chart, or Time color chart.
    • To visualize histogram data, select Histogram.
      • To visualize data data from a collection of two-dimensional histograms, select Histogram 2D.
    • To visualize single values using a text label, select Scalar / single value.
    • To visualize several single values for comparison, select Stack chart, Bar chart, or Pie chart.
    To use certain output types, you need to make sure your model contains the corresponding data analysis items. For example, if you want to select Histogram as an output type, your model should contain the Histogram data element.

  4. Click the  Add item button inside the output and choose the desired model output value from the drop-down list to serve as the data item. The set of available data items depends on the type of the output that you have selected:

  5. Customize the output if necessary:
    • To change the color of the chart’s data item, click the circle next to the data item and select the desired color from the drop-down menu:

    • To move an element to a new place within the Outputs area, drag it using the dragging handle in the top-left corner of the element.
    • To resize an element, drag the arrow in the bottom-right corner of the element.

Extended customization

Most of the output charts have extended customization settings. To open them, click the icon next to the Choose type drop-down list.

Plot

Interpolation — Defines the interpolation of the plot, that is, what values plot takes between two adjacent data set points:

Vertical scale type — Choose the type of scale for Y axis:

Horizontal scale type — Choose the type of scale for X axis:

Select output — Select the model output value as a data item of the plot.

Time plot

Interpolation — Defines the interpolation of the plot, that is, what values plot takes between two adjacent data set points:

Vertical scale type — Choose the type of scale for Y axis:

Time axis format — Switch between different formats of how the model time is shown on the X axis. The control is available right under the chart. It shows the currently selected format.

Fill area under the line — If selected, the area under the line will be filled with the line color.

Select output — Select the model output value as a data item of the plot.

Time stack chart

Vertical scale type — Choose the type of scale for Y axis:

Time axis format — Switch between different formats of how the model time is shown on the X axis. The control is available right under the chart. It shows the currently selected format.

Time window — Specify the length and the time units of the time axis.

Select output — Select the model output value as a data item of the plot.

Time color chart

Color mapping — Map the color to values that satisfy a specific condition and set this condition.

Time axis format — Switch between different formats of how the model time is shown on the X axis. The control is available right under the chart. It shows the currently selected format.

Time window — Specify the length and the time units of the time axis.

Histogram

Show PDF — Probability distribution function is displayed in the form of vertical bars. Every bar represents an interval where the height is proportional to the number of data set points within the interval.

Show CDF — Cumulative distribution function will be displayed as a polyline over the vertical bars.

Show mean — Mean value is displayed as a vertical line at the corresponding value axis position.

Relative bars width — Adjust the width of a bar.

Select output — Select the model output value as a data item of the plot.

Histogram 2D

Show envelopes — Data of histograms are displayed as envelopes — The areas containing a given percent of data in each simple histogram. You can specify the comma-separated list of lower bounds for resulting envelopes.

Show bins — Data of histograms are displayed as bins.

Select output — Select the model output value as a data item of the plot.

Stack chart

Relative bars width — Adjust the width of a bar.

Select output — Select the model output value as a data item of the plot.

Bar chart

Relative bars width — Adjust the width of a bar.

Select output — Select the model output value as a data item of the plot.

The output elements that you add to the dashboard can be organized into collapsible sections.

To add a section

  1. Click in the  Add section placeholder. A section header will be created:

  2. Type the name of the section in the text field:

  3. The section is initially empty. Add outputs to the section by dragging them below the section header:

    Alternatively, you can drag the section header itself using the dragging handle on its left edge. Position the section above the outputs you would like to include into it.
The section header marks the beginning of the section. All elements located below the header are included in the section. The section ends only with the beginning of a new section.

To visually divide the workspace into distinct areas, you can add a horizontal line between the output elements.

To add a separating line

  1. Click the button. The separating line will appear in the workspace.
  2. Position the line as necessary by dragging it using the dragging handle on its left edge.
How can we improve this article?