Schedule Hydraulic Run View (SWMM)

This view lets you to schedule one or more hydraulic simulations for a SWMM network and is displayed:

and is shown below:

Clickable Image

To run simulations, click on:

Note that the name of the button is context sensitive, and therefore may change to reflect any modifications made in this window.

The total number of hydraulic simulations performed in a run is dependent on which items are specified in the SWMM Run view. The maximum number of hydraulic simulations generated will be:

Number of Time varying events (Rainfall events/Flow surveys or TSDB objects) x number of Scenarios

The items included in the SWMM Run view are described in the following sections and information about how to create a new run or re-run an existing one is contained in the Runs topic.

Dialog description

Run Title

Run title

The name of the run.

If the entered title already exists, exclamation marks (!) will be appended to the run name until a unique name is created.

If a title is not entered, a unique title of the form r0000012 will be generated for you.


SWMM network

Select an SWMM network by using one of the following methods:

  • Drag and drop a SWMM network from the Explorer window tree.
  • Click Browse , select a SWMM network from the displayed tree and click OK.
  • Click Select version to display the Select Commit dialog. Click an entry in the dialog and click OK to select a version of the network currently selected in the SWMM network box.

If the network contains uncommitted changes, the most recently committed version of the network will be used when running the simulation.

A simulation can not be carried out if the network has not been validated.

Update to latest

A red border around this button indicates that there is a more recent committed version of the selected SWMM network available.

Click Update to latest to update the selected SWMM network to the most recent committed version.

Allow re-runs using updated network Check this option to allow simulations to be carried out for different versions of the same network without creating a new run each time a different version of the SWMM network is selected.

If the currently selected SWMM network has scenarios, the scenarios will be displayed in the Scenarios box.

Check the scenarios for which simulations are to be run.

To select multiple scenarios, use the CTRL or SHIFT keys. Click on the check box of one of the selected scenarios to set the status of the check boxes of all selected scenarios.


Sim providing initial state

A dropbox for a SWMM simulation that is to be used as the initial state for this simulation.

A network state from a previous simulation can be used as the initial state for the first simulation in the current run by dragging an existing simulation (for which state information was saved) into the box.

Save state at end of simulation

If checked, the state of the simulation should be saved when the simulation is complete. Unchecked (not saved) by default.

Time-varying inputs



Indicates whether or not live data from external sources (e.g. SCADA/telemetry or RADAR data) is to be used in the simulation. Unchecked (external data not used) by default



Displayed when the Use TSDB option is checked.

A dropbox for time series database / spatial time series database on which the simulation is to be based. More than one database can be selected and the Simulation Controller will use the databases in the order they appear in the box (the time series database at the top will be used first).

TSDB options


Displayed when the Use TSDB option is checked.

Opens the TSDB Options dialog allowing you to configure the user edits for use for the simulation.

Rainfall event/Flow survey

Displayed when the Use TSDB option is unchecked.

A dropbox for the rainfall events or flow surveys on which the simulation is to be based

More than one rainfall event can be selected by dragging a Model Group to add all rainfall events that are within that group. Rainfall events within sub-groups will not be added.

If more than one rainfall event is selected, the Simulation Controller will run a separate simulation for each rainfall event.

If you wish to run a dry weather simulation, then a rainfall event should not be included in this dropbox.

Level, Inflow, Regulator, SWMM Pollutograph

Enabled when the Use TSDB option is unchecked.

When running a simulation with rainfall event/flow survey data, dropboxes for time varying events other than rainfall may also be selected, if required.

Multiple SWMM Pollutographs may be chosen but only one time varying event of the type Level, Inflow and Regulator may be selected.


If a SWMM Pollutograph has been selected that has a Units factor set for a pollutant in its profile properties and the same pollutant also has a Mass units factor set for it in the same node's pollutant inflow property, and both factors are set to a value other than 1, then both factors will be applied to the relevant pollutant inflow values for the applicable node during a simulation.
A message will be included in the simulation log file that provides the name of the node and SWMM Pollutograph for which a units factor has been applied twice.

SWMM Climatology, SWMM Time Patterns

Dropboxes for time varying data from SWMM Climatology or SWMM Time Pattern objects. Only one time varying data object per type may be selected.

Dynamic Wave

Adjust variable timesteps by

Indicates whether or not an internally computed variable time step is to be used at each routing time period.

If checked, the value (%) that is to be used as the adjustment factor for the timestep can be specified in the adjacent field.

The variable time step is computed so as to satisfy the Courant condition within each conduit, and to prevent an excessive change in water depth at each node. A default adjustment factor of 75% is provided which allows for some margin of conservatism.

The computed variable time step will not be less than the specified Minimum timestep nor be greater than the fixed time step specified on the Timstep Control dialog.

This option is checked by default.

Minimum timestep

The value of the smallest timestep allowed when variable time steps are used. The default is 0.5 seconds.

Smaller timesteps may be used but this may lead to longer simulation runs with little improvement in solution quality.

Conduit lengthening timestep

The value of the timestep, in seconds, used to artificially lengthen conduits so that they meet the Courant stability criterion under full-flow conditions (i.e., the travel time of a wave will not be smaller than the specified conduit lengthening time step).

As this value is decreased, fewer conduits will require lengthening. A value of zero means that no conduits will be lengthened.

The roughness value of the conduit will also be artificially lowered so that the same velocity and flow are maintained after lengthening. Also note that the conduit slope reported in the output will reflect a numerically smaller slope due to a longer conduit length.

The ratio of the artificial length to the original length for each conduit is listed in the Flow Classification table that appears in the simulation's Summary Report.

Number of threads The number of parallel computing threads to use on machines equipped with multi-core processors. The default is 1.


Objects for detailed reporting

A dropbox for a selection list containing the objects of interest within the network that a report is to be generated for. Detailed time series results will be saved to the selected reports for viewing after a simulation has been run.

The following object types can be reported:

Continuity checks

If checked, the statistical summary of continuity results will be included in the output text report. Checked by default.

Summary flow statistics If checked, the statistical summary of simulation results will be included in the output text report. Checked by default.
Input summary

If checked, input data will be included in the output text report. Unchecked by default.

Control actions If checked, control information (e.g., when a pump turns ON/OFF or , etc.) will be included in the output text report. Unchecked by default.
Average results

Indicates whether or not average results for nodes and links are to be reported in the output text report.

If checked, time series results for nodes and links will be reported as average values computed over a reporting time step. If unchecked, the results will be interpolated point values at the end of the reporting time step. Unchecked by default.


Timestep control

Displays the Timestep Control dialog which is used to define the:

  • start and end dates/times of a simulation
  • length of the time steps used for runoff computation, routing computation and results reporting, as well as identifying periods of time when the hydraulic network is considered to be in a steady flow

Displays the Options dialog which is used to set up the processing options and surcharge methods which are to be used for a SWMM run.

2D parameters Displays the 2D Parameters dialog. Use this dialog to edit tolerance and advanced 2D modelling parameters. See 2D Parameters for more details.



Results Data

Timestep Control Dialog (SWMM)

Options Dialog (SWMM)

2D Parameters Dialog (SWMM)