Skip to content

Reservoir or Plan Spill (ityopr=29)

The type 29 operating rule provides a method to spill water from a Reservoir or Reuse Plan or Accounting Plan or a Changed Water Right Plan to the system. The following are noted:

  • When water is spilled from a plan it must be a Reuse Plan, an Accounting Plan or a Changed Water Right Plan.
    • A “ReUse Plan” is a special structure type that can be used identify the location of a reusable water supply associated with a CU transfer or transmountain import (see Section 7.8 for more details about plans).
    • An “Accounting Plan” is a special structure type that can be used to identify the location of transferred water that might be used for a variety of demands (see Section 7.8 for more details about plans).
    • A “Changed Water Right Plan” is a special structure that can be used to temporarily store a changed water right at its decreed priority and released at a priority that is junior by a direct release using a type 27 operating rule or by exchange using a type 28 operating rule or spilled using a type 29 operating rule (see Section 7.11 for more details about a Changed Water Right plan).
  • If the reuse plan is tied to a reservoir (e.g. it is a plan type 3 or 5) then source 1 (ciopso(1)) should be a reservoir ID and source 2 (ciopso(2)) may or may not be a Plan ID.
  • If the reuse plan is not tied to a reservoir then source 1 (ciopso(1)) should be a plan ID and source 2 (ciopso(2)) should be NA.
  • If the variable OprLimit is set to 1 the operating rule ID specified in row 4 will have its monthly and annual limits increased by the amount released.
  • If the source is an Changed Water Right plan then the destination (ciopde) should be the location of the source water right.
  • The type 29 operating rule allows the source to be a reservoir that may or may not be associated with a plan. As opposed to a standard reservoir spill operating rule (type 9) that releases water from a reservoir to meet a target storage, a type 29 reservoir spills the amount currently in storage when the operating rule executes (e.g. it releases without regard to the target storage).
  • The variable ciopde allows the user to specify where a spill will occur. The following are recommended:
    • If a plan is specified, with or without a reservoir, the user has the ability to control if the available flow at the node where the reservoir is located does or does not get adjusted. This capability is often required for a Changed Water Right Plan where the water may be diverted, temporarily stored in a plan that subsequently gets spilt for temporary storage in other plans associated with multiple users and ultimately released. If simulating a changed water right, the spill location, variable ciopde, should be the location of the changed water right.
    • If a plan is not specified, e.g. water is being spilled from a reservoir for an administrative purpose, the spill will occur at the reservoir node and the River Outflow and Available Flow are adjusted using the same approach as a type 9 operating rule. If the source is a reservoir the spill location, variable ciopde, should be NA since the reservoir location is the default spill location.
Row-data Variable Description
Control Data
1 Format (a12, a24, 12x, 4x, f12.5, f8.0, i8, 3(1x,a12,i8), i8, 1x,a12, 1x,a12, 1x,2f8.0, 2i8)
1-1 cidvri(1) Operational right ID
1-2 nameo(1) Operational right name
1-3 rtem(1) Administration number
1-4 dumx Monthly Switch
0 = No monthly on/off values
12 = Monthly on/off switches
1-5 ioprsw(1) Annual On/Off Switch
0 = off
1 = on
+n = Begin in year n
-n = Stop after year n
1-6 ciopde Spill location.
If the supply (ciopso(1)) is a plan:
NA = spill downstream of the plan location
+n = river ID where the plan spill occurs
If the supply (ciopso(1)) is a reservoir:
NA = the spill will occur at the Reservoir location
1-7 iopdes(2,1) 0
Supply Data
1-8 ciopso(1) Supply Reservoir ID or ReUse plan ID or Administrative plan ID
1-9 iopsou(2,1) Supply Reservoir account or ReUse Account (enter 0 if not applicable)
1-10 ciopso(2) Supply Plan ID associated with a reservoir
Enter NA if none
1-11 iopsou(4,1) 0
Type Data
1-12 ityopr(1) 29
Associated Plan Data
1-13 creuse NA
Diversion Type
1-14 cdivtyp NA
Conveyance Loss (%)
1-15 OprLoss 0
Miscellaneous Limits
1-16 OprLimit 0 Do not adjust Monthly or Annual
Operational limits:
+n = Adjust monthly and Annual limits of the operational rule specified in row 3 below
Start Date
1-17 IoBeg First year of operation
End Date
1-18 IoEnd Last year of operation
Monthly Data
2 Free Format (Include only if the variable (dumx) = 12 or less than -12)
2-1 imonsw(1) Monthly switch 0 = off, 1 = on
+n = Day first used that month
-n = Day last used that month
Note the first entry corresponds to the first month specified in the control file
Monthly and Annual Limitation Data
3 Format (36x, 10a12) (Include only if the switch (OprLimit) = 1)
3-1 cx Operating Rule ID for which monthly and annual limits will be increased by the amount spilled