VOSWMM

Control Rules

Click the Control Rules button to open the Control Rules window. Type in the window the control rules in the same way as in SWMM5 format.
Control Rules dictate the manner in which pumps and regulators within the conveyance system are modified during the simulation’s duration.

Example 1: Time-Based Pump Control
RULE R13
IF SIMULATION TIME > 12
THEN PUMP 5 STATUS = ON
ELSE PUMP 5 STATUS = OFF
Example 2: Multi-Condition Orifice Gate Control

Example 2: Multi-Condition Orifice Gate Control
RULE R14A
IF NODE 18 DEPTH > 8
AND LINK 76 FLOW > 120
THEN ORIFICE R61 SETTING = 0.6

RULE R14B
IF NODE 18 DEPTH > 8
AND LINK 76 FLOW > 180
THEN ORIFICE R61 SETTING = 1.0

RULE R14C
IF NODE 18 DEPTH <= 8
OR LINK 76 FLOW <= 120
THEN ORIFICE R61 SETTING = 0

Each control rule is structured as a series of statements in the following format:

RULE ruleID

IF condition_1

AND condition_2

OR condition_3

AND condition_4

Etc.

THEN action_1

AND action_2

Etc.

ELSE action_3

AND action_4

Etc.

PRIORITY value

In this format, the keywords are indicated in boldface. “ruleID” represents the label assigned to the rule, “condition_n” signifies a Condition Clause, “action_n” denotes an Action Clause, and “value” corresponds to the priority value, typically a numerical value ranging from 1 to 5.

A Condition Clause in a Control Rule can be expressed in one of the following formats:

  1. object id attribute relation value
  2. object id attribute relation object id attribute

Where:

  • object: Represents a category of object.
  • id: Corresponds to the object’s unique ID label.
  • attribute: Signifies an attribute or property associated with the object.
  • relation: Denotes a relational operator such as (=, <>, <, <=, >, >=).
  • value: Represents the value of the attribute.

Here are some examples of condition clauses:

GAGE G1 6-HR_DEPTH > 0.5
NODE N23 DEPTH > 10
NODE N23 DEPTH > NODE 25 DEPTH
PUMP P45 STATUS = OFF
LINK P45 TIMEOPEN >= 6:30
SIMULATION CLOCKTIME = 22:45:00

An Action Clause within a Control Rule can adopt one of the following formats:

PUMP id STATUS = ON/OFF
CONDUIT id STATUS = OPEN/CLOSED
PUMP/ORIFICE/WEIR/OUTLET id SETTING = value

The interpretation of “SETTING” varies depending on the object under control:

  • For Pumps, it acts as a multiplier applied to the flow calculated from the pump curve (or relative pump speed for a TYPE5 pump).
  • For Orifices, it represents the fraction of the orifice that is fully open (orifice control involves raising or lowering a horizontal gate from the top of the orifice).
  • For Weirs, it signifies the fraction of the original freeboard that remains (weir control involves adjusting the crest height upward or downward).
  • For Outlets, it functions as a multiplier applied to the flow derived from the outlet’s rating curve.

Here are a couple of examples of action clauses:

PUMP P67 STATUS = OFF
ORIFICE O212 SETTING = 0.5