AnyLogic
Expand
Font size

Experiment screen

The experiment screen is your workspace for running experiments in AnyLogic Cloud and viewing the results of the run:

The experiment screen consists of the following areas:

  1. The experiment toolbar extends the main AnyLogic Cloud toolbar and contains buttons for performing basic experiment tasks in AnyLogic Cloud.
  2. The sidebar lists the existing model versions and the experiments created for each model version. Select an experiment in the sidebar to open it in the experiment screen.
  3. The experiment dashboard displays the parameters and the results of the experiment:
    • The Inputs section: Shows the model version’s parameters and allows for editing them.
    • The Outputs section: Shows the model version’s outputs, provided the experiment has already been run. The section appears blurry if the experiment has not been run yet.

Experiment toolbar in AnyLogic Cloud

The experiment toolbar expands the main toolbar of AnyLogic Cloud. It is displayed on top of the experiment screen:

Use the experiment toolbar buttons to perform basic experiment tasks in AnyLogic Cloud. Hover the mouse pointer over a toolbar button to display the name of this button.

Main control elements

Toggle the sidebar.
Navigate to the AnyLogic Cloud title screen.
Private Cloud administrators can replace this image on the Customization tab of the administrator panel.
[Model name] Navigate to the model screen.
play_arrow Run the experiment (without animation). If the experiment has already been run, the button is inactive and is displayed as done.
play_arrow Play vector animation.
save Save inputs for the current experiment.
undo Discard changes in inputs (restore the inputs to the previously saved values).
Compare experiment runs.
download Download experiment results as an Excel or JSON file.

Additional control elements

The more_horiz button opens the additional commands menu:

logout Export inputs.
This feature is not available yet.
share Share the model.
info Model info (Navigate to the model screen).

The sidebar is displayed on the left of the experiment screen. The sidebar is organized as a two-level tree.

  • On the upper level, it lists the existing model versions.
  • On the lower level, it lists the experiments created for each model version:

To show or hide the sidebar

  1. Click the button in the top-left corner of the experiment screen.

To expand or collapse the list of experiments for the model version

  1. Click the model version node in the sidebar.

Running experiments

A model in AnyLogic Cloud is treated as a black box: you provide the values for the model’s inputs, run the experiment, and observe the output results.

To run the experiment

  1. Click the play_arrow Run button in the experiment toolbar or the run link in the Outputs section of the experiment dashboard.
    Since experiments are executed on a remote server, you do not need to stay on the experiment page until the experiment is finished. You can freely leave the experiment page (for example, to run another experiment) and return to it at a later point.
  2. The experiment execution progress is visualized with the progress bar in the Outputs section and circular indicator next to the experiment’s name in the sidebar:

    Besides running an experiment, you can view the running model animation in the vector graphics animation. Unlike running an experiment, viewing model animation considers the input values that you specify but does not produce output values.

Once you have run the experiment, the Run button in the toolbar becomes inactive and is displayed as done.

The first run of the experiment produces the set of outputs, which are saved and shared between all experiments of the current model version. You can view the saved outputs state by providing the input values, for which an experiment has already been run.

Working with the experiment’s input and output values

Each experiment contains the saved set of the default input values. You can modify the values as necessary and save them as the new default values.

To modify the experiment’s default input values

  1. In the Inputs section of the experiment, provide the input values.
    If you have set up your experiment’s Run configuration to use files as input, you can also replace the files using the corresponding controls.
    When changes are made, the save Save inputs button on the experiment toolbar becomes active.
  2. Click the save Save inputs button. The input values will be saved and used as the new default values for the experiment.

If the input values that you have provided differ from the experiment’s default values, you can discard the changes thus reverting the input values to their default state.

To discard changes in the experiment’s input values

  1. Click the undo Discard changes button. The input values will be reverted to their default state.

To download the results stored in the output file

  1. On the right of the Outputs section of the experiment screen, locate the link to the needed output file.
  2. Click the link.

The download will be handled by the browser. Depending on the browser settings, you can specify the download location or rename the file as needed.

Managing experiments

To create a new experiment

  1. Click the button in the model version node. The New experiment dialog box opens up:

  2. Type the name of the experiment in the Experiment name field.
  3. Choose the experiment type from the Experiment type drop-down list. AnyLogic Cloud currently supports the following experiments:
    • Simulation — A simple experiment for obtaining model outputs or observing model animation.
    • Monte Carlo 1st order — Runs the model multiple times with different seed of randomness for each replication to obtain a collection of outputs. Input values are fixed.
    • Monte Carlo 2nd order — Performs multiple iterations with different input values provided by the probability distribution. Optionally, replications can be done for each iteration.
    • Variation — Multiple iterations with one or more inputs varied with the given step within the specified range.
    • Variation with replications — A variation experiment with replications performed for each iteration.
    • Optimization — Helps to identify the optimal combination of input conditions resulting in the best possible solution.
      This experiment type is not available yet.
  4. Click the Add button. The created experiment will appear as the topmost item under the corresponding model version.

To rename an experiment

  1. Expand the model version node containing the experiment you want to rename.
  2. Click the edit icon in the experiment item. The pencil icon will change to save.
    The name of the experiment will become editable. The experiment dashboard will also switch to the editing mode.
  3. Type the name of the experiment in the text field and click the save icon to apply your changes.

To copy an experiment

  1. Expand the model version node containing the experiment you want to rename.
  2. Select the experiment in the sidebar.
  3. Click content_copy.

The experiment copy will appear immediately. It will have the default name: Experiment name - Copy.

To delete an experiment

  1. Expand the model version node containing the experiment you want to delete.
  2. Click the delete icon in the corresponding experiment item.
    The experiment will be deleted. A notification message will appear in the top right corner of the screen confirming the successful deletion. You can restore the deleted experiment if necessary by clicking the Restore button in the notification message:

Model animation in AnyLogic Cloud

You can view the animation of a running model.

While the model animation reflects the input values that you specify, it does not produce the corresponding output values.

To view model animation

  1. Select the experiment in the sidebar.
  2. Provide the experiment input values in the Inputs section of the experiment dashboard.
  3. Click the play_arrow button in the experiment toolbar. Model animation will open in a pop-up window:

    In AnyLogic Cloud, the model window is subject to the screen ratio of the device where the model is run. If the device screen ratio differs from the frame ratio specified in AnyLogic IDE, it may lead to the exposure of the elements the model developer intentionally placed outside the model frame to hide them from the model’s end users.
    The progress bar above the playback controls shows the progress of the model. It is active if the animation is set to stop According to model time settings in Run configuration properties.

Controlling the animation

The model animation window provides you with a set of common playback controls:

Visible if the animation is not running at the moment.
Runs the animation or, if it was paused, resumes it from its current state.

Visible if the animation is not running at the moment.
Pause animation.
Stop the animation and close the animation window.
Stop the animation and close the animation window.
Set the real-time mode to the default scale.
Slow down the animation by decreasing the scale of model time to real-time.
Displays the current scale ratio of model time and real-time. To change the current value, use the and buttons. Displays , if the animation is running in the virtual time mode.
Speed up the animation by increasing the scale of model time to real-time.
Switches the animation between the virtual time and real-time modes. If the virtual time mode is set, appears pressed.
Displays the responsiveness of the model presentation.
Provides access to:
Shows the simulation status of the current run:
Displayed in the windowed playback mode.
Switch the playback window to fullscreen mode.
Displayed in the fullscreen playback mode.
Switch the playback window to windowed mode.
Opens the developer panel, which provides access to the additional model controls, simulation data, and console with the experiment’s output.
For this button to be available, the developer panel must be enabled in the corresponding property of the model’s run configuration.
How can we improve this article?