WSPC05429

• File Number: 8283.200
• Description: Colorado River Basin-Colorado River Computer Models-Colorado River Decision Support System-Ray
• State: CO
• Water Division: 5
• Date: 1/1/1996
• Author: CADSWES
• Title: South Platte Water Rights Management System-Programmers Manual
• Water Supply Pro - Doc Type: Report/Study

Viewing calls

The first step in displaying the Water Infonnation Sheet is to fonnatthe data in the
rows. The formatting process includes calculating values in any rows that are derived
from stored data (i.e., for rows of type fonnula. subtotal, and total). As the data is
displayed, the calculations are done at this level (because changing values elsewhere
in the sheet affects the values in these rows). Values for these rows are computed by a
simple algorithm that inteIprets the fonnula string read from the fonnat file and stored
in memory with the row.

The display of a Water Information Sheet contains several elements in addition to the
sheet data. These include some information about calls affecting the district,
exchanges to structures in the district. and the status of the Water Information Sheet.

The Calls box on the Water Information Sheet dialog displays two different kinds of
information: calls within the district and governing calls downstream from the
district. Calls within the district are found by selecting all calls in effect during the
time period represented by the sheet, and then checking if the calls belong to a struc-
ture in the district or to a structure displayed on the sheet. Governing calls down-
stream are found by using a planar sweep algorithm to detennine all calls during the
time period that were governing at the structure immediately downstream from the
district. The function GetGoverningCalls () perfonns this search. See the
"Governing CaBs Over Time at a Structure" section on page 49 for a description of
this algorithm.

The Exchanges hox on the Water Infonnation Sheet displays all exchanges to struc-
tures in the district or structures displayed on the sheet. This is a display of the
contents of the current_exchanges member of the Water Information Sheet
data structure populated when the information sheet is loaded.

The Water Information Sheet status bar indicates the state of the sheet-whether it
was loaded from a previous day, overlaid (the overlay was then submiUed)-and the
date and time the sheet was saved to the database. The three Water Information Sheet
flags new, dirty, and from_overlay are the main source of information
for the status bar.

Call.Management

SPWRMS contains tools to monitor and maintain the state of the call structure on the
river. The call structure is the set of calls in place on the river and its subsequent effect
on the diversion structures in the system. Every structure in the system has a
governing call; in some cases, this is the free river caB, and in other cases, it is the
most senior call at any downstream structure. SPWRMS represents the call structure
in teons of the governing call at each structure.

Calls may be viewed in three ways on the UNIX application: I) the MaplMap Call
function allows the user to display the call structure on the graphical map display of
the South Plaue River Basin; 2) the Query/Call Chronology dialog is a display of the
calls that were in effect during the time interval indicated in the Preferences dialog.
and 3) the Water Infonnation Sheet contains a text window that displays relevant call
information.

The graphical depiction of the call structure provided by Map Call is a color display
of the different calls on the river system. Selecting this function results in the stream
network being colored a different hue for each call that is currently in place on the

20