Skip to main content

Running a Simulation

Run Sequence​

The Run Sequence button in the Command Sequence panel footer submits all commands in the sequence (pending and queued) to the engine as a batch. The button is disabled while a run is already in progress, and shows Running… while the engine is executing.

The Run Sequence button in the Queued section promotes queued items and starts from the queued position.

Run Progress Box​

While a simulation is running, the Run Progress Box appears at the top of the Run Log panel and displays the current run status:

  • Run name: Shows the scenario ID for a single-line run, or the total number of scenarios for a multi-line sequence.
  • Status text: Displays the current phase — preparing, running (with the current line number and scenario ID), stopping, or finished.
  • Elapsed time: Updates every second during the run. For multi-line sequences, also shows elapsed time for the current line.
  • Progress bar: A visual progress indicator. For sequences, progress advances as each scenario completes.
  • Stop run: Click to stop the engine. A confirmation dialog appears before stopping: "Stop the engine now? The scenario that is running will have missing or incomplete results." Confirm with Stop now or dismiss with Keep running.
  • Expand / collapse: For runs with multiple scenarios or once a run finishes, a toggle (▸ / ▾) shows or hides the per-scenario results list.
  • Per-scenario results: Each scenario in the list shows a status label (Waiting, Running, Finished, Error in log, Failed, or Stopped), the scenario ID, elapsed duration when complete, and an Open results link for scenarios that finished successfully.

Overwrite Warning Dialog​

Before starting a run or Run Sequence, if any scenario in the queue has the same ID as an existing results folder in the scenario directory, Scenario Studio shows a warning dialog:

  • Title: Results will be overwritten
  • Message: The following will be overwritten: [list of scenario IDs]
  • Overwrite and run — proceed with the run (existing results for those scenarios will be replaced)
  • Cancel — go back without starting the run

Close Scenarios​

Before starting a run, if any of the scenarios to be run are currently open in the Dashboard, Scenario Studio shows a dialog:

  • Title: Close open scenarios
  • Message: "These scenarios are open in the Dashboard and must be closed before they can be overwritten:" followed by a list of scenario IDs.
  • Close them and run — closes the listed scenarios in the Dashboard and proceeds with the run.
  • Cancel — go back without starting the run.

Data Readiness Dialog​

Before a run starts, the Data Readiness Dialog checks whether the input files required by each scenario in the sequence are available on disk. The dialog title changes depending on the situation: Check data when opened manually, Some data is missing when triggered before a run and missing files are found, or Worth a second look when triggered before a run with no missing files.

  • Worth a second look: A section listing settings that are allowed but are often not what was intended. Each item shows a status indicator, the scenario number and ID, a warning title, and a descriptive note. Warnings can be dismissed individually per scenario.
  • Whole sequence: Shows the status of the output disk location (OK, Missing, or May be needed).
  • Per-scenario sections: Each scenario in the sequence has its own section listing its input files with status labels — OK, Missing, or May be needed. Missing files show the expected path; "May be needed" files note why they might be required.
  • Footer (pre-run mode): Includes a hint "You can still run." and two buttons — Cancel (go back without running) and Run anyway (proceed despite missing files).
  • Check again: A button to re-run the file-availability check.

Scenario Outputs​

The Outputs button (desktop only) in the Command Sequence panel header opens the Scenario Outputs dialog. The dialog shows each scenario's output folder on disk with its size, the date of the last run, and which sequence items currently use it. From this dialog you can move a folder to the Recycle Bin.

Run History Dialog​

The Run History Dialog shows a record of all simulation runs started from Scenario Studio on the current computer.

  • Title: Run history
  • Subtitle: Scenario runs started from Scenario Studio on this computer, newest first — when each ran, how long it took, the result and the engine that ran it. Kept in the application settings, never in the scenario folders.
  • Filter: A search input to filter runs by scenario ID.
  • Columns: Scenario, Started, Finished, Duration, Result, Engine, Command line.
  • Result: Shows the outcome for each run (for example, Finished, Error in log, Failed, or Stopped). Error runs include the relevant error line.
  • Clear history: Removes all recorded runs after a confirmation step. Scenario results on disk are not affected.

Run Notifications​

Scenario Studio can show a desktop notification when a simulation completes. Enable or disable this under Settings › Scenario Studio › Notify me when a run finishes. The setting is on by default. Clicking the notification brings the app to the front. The notification appears only when the app window is not in focus; it is not shown in the web version.