[Manual] [Contents] [Prev] [Next]
Input - Output Tools are accessible from the I/O menu. These include a load/save window to handle CRiSP.1 parameters in files, a message window giving errors and results, and a Report Tool that allows model parameters to be accessed by any desired grouping.
The menu is accessed by right clicking on the I/O button (Fig. 50).
edit control file: Management of Files
Parameters values can be read in from files and stored to files with this Load/Save tool (Fig. 51). The window controls input and output of all model parameters and files in a directory. The controls for this window are:
- The window 1 is an active command tool showing files in the current directory. The default directory is where CRiSP.1 was started and can be changed using UNIX commands in the window or by clicking the "Change Directory" button at the top of the frame.
- List button 2 - lists files in the current directory according to the search string specified.
- Read All button 3 - left-clicking reads a specified data file indicated on Control File line 4 and right-clicking opens a menu allowing either replacement of fish releases in CRiSP.1 or appending additional releases1 when the specified control file is read.
- Write All Data button 5 - left-click to save all subunits (behavior file, reservoir file, etc.) in the file identified on the Control File line. This function allows temporary changes in model parameters to be permanently stored on disk for reuse. These temporary changes would be ones set by using the buttons on the upper half of the main control panel.
- Clear Frame button 6 - left-clicking clears all file names from the control file and subunit file lines.
- The various Write buttons give the user flexibility to manipulate and store all data used in CRiSP.1 except flow archive data. If you left-click the Write button 7 next to the Control File line, CRiSP.1 will write all the information thus far specified for that file i.e. parameters that might have been set with the various input parameter tools -- this includes all the subunit files that have been given names. Each subunit file can be written separately by naming the file and clicking on the Write button for that line. For more information about control files, see Control File Editor section II.5.9.
- The parameters stored in each corresponding subunit file are:
- Behavior menu parameters:
- - predation coefficient in reach, forebay and tailrace
- - migration speed variance
- - migration equation coefficients
- - gas mortality equation
- Reservoir menu parameters:
- - predator densities in reach and dams
- - predation probability
- - water temperature
- - river parameters
- Spill percent spill information at each dam:
- - spill efficiency parameters
- - planned spill schedule information
- Flow parameters:
- - flow headwaters
- - reservoir, reach, and dam loss (kcfs) on a daily basis
- - elevation below full pool (ft) on a daily basis
- - flow maximum in headwaters (kcfs)
- - daily storage reservoir volume and output flow
- Dam guidance and mortality factors
- - transportation parameters
- - mortality in dam passage routes
- - nitrogen saturation equation parameters
- - passage delay parameters
- - predator density in forebay, and tailrace
- - diel predation probability
- - day and night fish guidance efficiency
- Release information
- - species
- - day of the start of release
- - number released each day
- - day of the smoltification onset
- River information
- - predation activity exponent
- - gas dissipation exponent
- - headwater flow proportion
- - ufree
- Config information
- - runtime settings
- - monte carlo output settings
- Standard data files (as opposed to control files) can be read in and written out using the Read and Write buttons next to the specific Data File line 8. Type the file name you want to read from or write to and click the appropriate button.
Message Window: Accessing Messages
The Message Tool under the I/O button of the main panel provides a number of messages from model runs (Fig. 52). The user can choose which kinds of messages will be displayed by choosing one or more of the following buttons that control different categories.
- Error - warns of data problems that will cause CRiSP.1 to stop. Note that this message level cannot be disabled.
- Warning - gives non-lethal error information including extra and missing key words in data files.
- Messages - three types of information are provided:
- - Results for all Julian Day output windows open when CRiSP.1 is run
- - Average flow at a particular dam over the period of migration for all releases if the flow window is open for that dam when the model is run
- - Summary of survival and travel time for all releases. This information is also saved in summary.dat.
- Raw Dump - if a passage histogram is open, this option will append two strings of numbers: the first is the total number of fish for each release passing that site, and the second is the mean day of passage for each release.
- Debug - information on river velocity and other parameters at Julian Day 0 in each river segment. This information is used to debug a columbia.desc file by checking if flows and cross-sectional area of segments are reasonable.
- Done - to close the window.
Recovering messages
If CRiSP.1 aborts and disappears from the screen messages associated with the abort may be recovered in the /tmp directory. To access these use file manager and open the most recent file with the designation crispmsg with an appended id number (e.g. "crispmsg.11054").
Monte Output Settings: Specifying Desired Outputs
When CRiSP.1 runs in Monte Carlo mode, a number of results are calculated by the model, but only those requested by the user will be available following the run. The outputs requested are stored in the data file used. Warning: be sure to specify the desired outputs and save them to the config data file(s) to be used in the Monte Carlo run!
The Monte Output Settings tool (Fig. 53) toggles 1 between settings for Dams and for Reaches (settings for dams are illustrated above). At each dam, the user can choose to record:
- total fish passage (survival)
- fish transport parameters (how many fish were transported out and how many survived)
- routing at the dam (what fractions of releases passed via the different dam passage routes: turbine, bypass, and spillway).
Left-click the check-boxes to select the desired outputs. You can also select a Flow Indicator dam 2. Right-click to pop up a menu of available dams. This keeps track of the average flow at the indicator dam during passage of the various stocks. For reaches, total fish passage is the only available output parameter. After you have selected the desired outputs, don't forget to save to a config data file!
Input Data Report: Generating Lists of Model Parameters
The parameters used in CRiSP.1 can be written into tables that can be viewed on the screen saved to a file or printed out. Any grouping of data can be put into the tables using the functions of the Report Tool. The Report Tool has the following controls:
- Data category control buttons 1 - which are used to select the types of information that will be reported: dams, headwaters, reservoirs, global, and/or species
- Variables, Categories and Subcategories buttons 2 - select parameters by left-clicking on an item (highlights the item). To deselect an item left-click on a highlighted item. RApid selection and de-selection can be done by left-holding and dragging mouse across items.
- View buttons 3 - opens text window of parameters selected under the highlighted category
- View All buttons 4 - opens text window of the parameters selected under all categories
Listing of parameters
Left-clicking the View or View All creates a listing of parameters. This list can be printed or stored as a file as outlined below:
- Output to File 1 - file name under which listing is stored in the CRiSP.1 default directory2.
- Print Command 2 - system print command is entered on this line. Default is lpr. UNIX print flags to change printing can be entered on Print Flags line.
- Write File and Print File buttons 3 - print the file or write it to disk using the given file name 1 under the default directory.
Monte Report: Generating Summaries of Monte Carlo Output
The Monte Report tool (Fig. 56), allows the user to generate reports from Monte Carlo runs that are tailored to individual needs. The tool provides four columns: the leftmost column lists the alternatives available for analysis in the default directory. Scroll up and down the list, and select the alternatives you want. The next column displays the releases that are available for analysis; again, select the releases of interest. The third column displays sites where data were stored in the Monte Carlo runs. This column lists ALL sites present in ANY of the alternatives; some alternatives may not have the same sites as others, and the report tool will return "N/A" for those cases. The final column lists the parameters that are available for analysis. Again, if different data files were used in different runs, some parameters may not be available for some alternatives.
The amount of time necessary for generating output from this tool depends on the number of alternatives and the number of games in each alternative.
[Manual] [Contents] [Prev] [Next]
1 Append only adds releases at sites existing on the map. To add a new site to the map it must be added to the columbia.desc file.
2 The default directory is the directory in which CRiSP.1 was started.
Columbia River Salmon Passage Model CRiSP.1.5 User Manual
Copyright © 1996, Columbia Basin Research. All rights reserved.
web@cbr.washington.edu
