Creating and viewing a Simulation Run - Developer Documentation
Skip to content

Creating and viewing a Simulation Run

User interface

The user interface of "Simulation Runs" is as shown below:

Simulation Runs UI

① Filter the simulation run based on Study, Status, Modified After and Modified Before fields

② Select the required Digital Twin Model

③ Displays the list of available Simulation Runs

④ Creates a new simulation run

⑤ Deletes the selected simulation run

⑥ Displays the simulation results for the selected simulation run

⑦ Displays the details for the selected simulation run

⑧ Displays the options for download, Rerun and refresh the run

Creating a new run

To create a new Run for an existing Study, proceed with the following steps:

  1. In "Factory Twin", click "Workbench" and select "Simulation runs".
  2. Select the required Digital Twin Model Name from the drop-down.
  3. Click add run.
  4. Enter the name and description for the new run.
  5. From the drop-down, select the Digital Twin model, and Study/Studies for which the run needs to be created.
  6. Select the "Timeseries Date range" form the date picker.
  7. Click "Simulate".

Batch mode creates a schedule to run simulations periodically either in batch mode (no manual intervention) or interactive mode. If "Run in Batch Mode" toggle button is enabled, the simulations will be executed in non-interactive mode. It also imports the HTML report of the simulation which can be viewed in the application

You can download, rerun or refresh the run by clicking Next.



  • The application displays an error if the following conditions are not met:
    • If the Run name is not unique
    • If non-numerical value is entered in nano seconds
    • If there is no time-series data to export
  • A Run cannot be created if a Digital Twin Instance is not available for a Digital Twin Template.

Viewing charts and reports

For any asset configured for a specific Digital Twin template, the Runs data can be viewed in "Workbench" in the "Simulation Runs" tab.

The created runs are listed in the "Simulation Runs" tab of the "Workbench" screen. The runs can be in any of the following states:

States Color codes
Pass Green
Submitted Yellow
Error Black
Failed Red

To view the simulation results, click on the required Run and select the type of Simulation result. The available options are explained below:

  • Pre-processed data: The Pre-processed data shows the data for the selected KPI variable. The data is available for Pass and Failed Simulation runs. Click "Pre-processed Data" and select the required "Assets" from the drop-down. The results are displayed as shown below: Pre-processed Data

  • Best fit Distribution: The "Best fit Distribution" option shows all the distribution data along with the best fitting distribution data. It contains observed data and the frequencies, against which the graph is available. The data is available for Pass and Failed Simulation runs. On clicking "Show distribution data", the results are displayed as shown below: Show distribution data

A maximum of 8 distribution types can be plotted in the graph, at a time.

  • Data Simulation Result: To view the Simulation Statistics data, click "Data Simulation Result". Select the required assets, run results and the run results category. Click "Submit". The Simulation Statistics data is available for Pass and Failed Simulation runs.
    The result is as shown below: data simulation result

  • HTML report: The HTML report contains information about Simulation statistics. The HTML report is available for Pass and Failed Simulation runs. On selecting "HTML report" from the drop-down, the report is displayed as shown below: HTML report

In addition, you can Download or Rerun the run by clicking Next at the top right corrner of the page.

To delete a run, select the run/runs by clicking on the checkbox next to that run and click delete-icon. You can select multiple runs and delete them in one click.

Last update: May 3, 2023