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

OU0079

25

Saved Preferences

Data retrieval

The function SavePreferences () creates the file .rights.rc in the home direc-
tory of the user, storing all the information in the Preferences dialog. The format of
the preferences file is not presented here because it is not advised to modify the
contents of this file by editing it directly.

During system initialization, the function ReadPreferences () reads the saved
file and uses the contents to establish the initial state of preferences for the system. If
the file is not present in the home directory of the user, a default set of preferences is
used. The algorithm which parses the contents to the preferences file is unsophisti-
cated. so it is unwise to modify this file in any way. Corrupting the format of the pref-
erences file may prohibit the user from starting SPWRMS.

Hydrograph Data Retrieval

The following three DMI functions retrieve satellite-transmitted data from the data-
base and aggregate it according to the specified interval:

PLOT_DATA_PACKAGE *GetRealTimeStreamflow(char*station,
char*from_time,char*to_time) ,

PLOT_DATA_PACKAGE *GetHourlyStreamflow(char*station,char*
from_time,char*to_time),

and

PLOT_DATA_PACKAGE *GetDailYStreamflow(char*station,cha~*
from_time,char*to_time) .

The following section describes the steps perfonned by these functions.

Retrieval of data for gauge(s) selected by the user is affected by the time interval indi-
cated in the Preferences dialog (and stored in the global variables start_date
and end_date), as well as by the averaging interval that the user has specified.

In all cases, the pair of functions

QueryStreamflowInit(char*station, char*from_date,
char*to_date)

and

QueryStreamflowNext(double*value, char*time)

are used to retrieve the raw data from the database_ The Ini t function checks to see
if any requested data is available in the database, and the Next function retrieves
these pieces of data, one per call to the function. All values present in the database
between from_date and to_date are retrieved for station. In all cases, the
time interval from the Preferences dialog is used as the base to construct
from_date and to_date. The averaging interval affects this in the following
ways:

1. If the user selected Real Time as the averaging interval, the s tart_da te and
end_date from the Preferences dialog are used for from_date and