PRMS Precipitation-Runoff Modeling System PRMS - Version 2.1 1996/01/17 prms2_1.exe - self-extracting DOS distribution prepared on an IBM-compatible PC TABLE OF CONTENTS A. DESCRIPTION B. DOCUMENTATION C. SYSTEM REQUIREMENTS D. INSTALLING o Installing PRMS from self-extracting executable o Installing PRMS from distribution diskette o PRMS directory structure o Making PRMS easily accessible E. RUNNING THE PROGRAM F. TESTING G. CONTACTS A. DESCRIPTION The precipitation-runoff modeling system (PRMS) is a modular-design, deterministic, distributed-parameter modeling system developed to evaluate the impacts of various combinations of precipitation, climate, and land use on streamflow, sediment yields, and general basin hydrology. Basin response to normal and extreme rainfall and snowmelt can be simulated to evaluate changes in water-balance relationships, flow regimes, flood peaks and volumes, soil-water relationships, sediment yields, and ground-water recharge. Parameter optimization and sensitivity analysis capabilities are provided to fit selected model parameters and evaluate their individual and joint effects on model output. The modular design provides a flexible framework for continued model-system enhancement and hydrologic-modeling research and development. B. DOCUMENTATION Leavesley, G.H., Lichty, R.W., Troutman, B.M., and Saindon, L.G., 1983, Precipitation-Runoff Modeling System: User's Manual: U.S. Geological Survey Water-Resources Investigations Report 83-4238, 207 p. C. SYSTEM REQUIREMENTS For installation of PRMS, 1.5 megabytes of free disk space is needed. To run PRMS, the following are necessary: - 386 or greater processor - math coprocessor - 2.5 megabytes of combined free extended memory and free disk space on installation drive (the greater proportion available as memory, the better performance will be) D. INSTALLING Installing PRMS from self-extracting executable ----------------------------------------------- To install PRMS from the self-extracting executable, follow the steps below, replacing with the drive letter where you want to install PRMS and optionally replacing [directory] with the name of a directory on that drive: 1. If you are not in the directory where the distribution file is located, go there. For example: c: cd \wrdapp 2. Extract the files contained in the distribution file using the command: prms2_1 -d :\[directory] Note: be sure to include the -d option and ":\" in the command. Examples are: prms2_1 -d c:\ prms2_1 -d c:\wrdapp Installing PRMS from distribution diskette ------------------------------------------ To install PRMS from distribution diskette onto your hard drive, type :prms2_1 -d :\[directory] Note: be sure to include the -d option and ":\" in the command. For example, if your floppy drive is a: and you want to install PRMS directly under the root directory on the c: drive, you would type a:prms2_1 -d c:\ This will create the directory c:\prms2.1. As an additional example, if you wanted to install PRMS under a directory named "wrdapp" on the c: drive, you would type a:prms2_1 -d c:\wrdapp This will create the directory c:\wrdapp\prms2.1. PRMS directory structure ------------------------ The following directory structure will be created (the contents of each directory are shown to the right): prms2.1 copy of this README file `-----bin compiled executable `-----doc documentation files `-----test batch file to run verification tests `-----data standard data sets used in verification tests Note: It is recommended that no user files be kept in the prms2.1 directory structure. If you plan to put files in the prms2.1 directory structure, do so only by creating subdirectories under prms2.1. Making PRMS easily accessible ----------------------------- To make the PRMS program accessible from any directory, the prms2.1\bin directory should be included in the PATH environment variable. Add a line similar to the following to AUTOEXEC.BAT: PATH=%PATH%;C:\prms2.1\bin Substitute the appropriate drive letter and pathname if not C:\ as shown above. Reboot your system after modifying AUTOEXEC.BAT. E. RUNNING THE PROGRAM After the prms executable is properly installed (see INSTALLING, above), the program can be executed with the command "prms". F. TESTING Test data sets are provided to verify that the program is correctly installed and running on the system. The tests may also be looked at as examples of how to use the program. Tests are run in the prms2.1\test directory. The directory prms2.1\data contains the input data and the expected results for each test. After each test is completed, compare the results to the expected results using a file comparison utility such as fc. If all goes well, there should be no differences. To clean up after the tests, type the command: clean Notes: a) Some of the tests may require input generated by a previous test, so they should be run in sequential order. 1) test 1 requires that the annie2.2 program be installed on the system. 2) tests 2 and 3 require the wdm file created in test 1. b) The standard data sets were created on a Data General AViiON workstation. You may notice slight numeric differences in the results on other computers. These are generally due to different round-off algorithms and the different architecture of the central processing unit chip. Run the tests by following the steps below. Test 1: - Attach to the prms2.1\test subdirectory and type "annie" to execute ANNIE (if the annie2.2\bin directory has not been included in the PATH environment variable so that ANNIE can be executed from any directory, type the full path name of annie2.2\bin\annie, including the drive and directory under which ANNIE is installed). - On the opening screen, type "@". In the small panel that appears, type "..\data\test1.log". ANNIE will be run using the keystrokes in ..\data\test1.log as if they were typed in. The file cane.wdm will be produced and is used in the following test. Test 2: - In the prms2.1\test subdirectory, type "test 2". - The file test2.out will be produced. Compare this file to the copy found in the prms2.1\data subdirectory. For example, if the fc command is available, the files can be compared by typing "fc ..\data\test2.out test2.out". Test 3: - In the prms2.1\test subdirectory, type "test 3". - The file test3.out will be produced. Compare this file to the copy found in the prms2.1\data subdirectory. The tests are described in the table below, where 'test' is the test number, 'program' is the program used to run the test, and the 'usage' column indicates how a file is used, with i for input, o for output, and i/o for both input and output. test program description of test and files file name & usage ---- ------- --------------------------------- ----------------- 1 annie create the wdm file, import two files in the wdm export format annie command file test1.log i observed data for Cane Branch caneob.exp i attributes for simulated data canepr.exp i data management file cane.wdm o 2 prms Cane Branch daily simulation master file test2.mtr i model control file test2.g1 i data management file cane.wdm i/o output/print file test2.out o 3 prms Cane Branch storm simulation master file test3.mtr i model control file test3.g1 i storm period selection test3.g2 i infiltration/upland erosion test3.g3 i routing specifications test3.g4 i data management file cane.wdm i/o output/print file test3.out o G. CONTACTS Inquiries about this software distribution should be directed to: U.S. Geological Survey Hydrologic Analysis Software Support Team Kathleen M. Flynn e-mail: h2osoft@usgs.gov 437 National Center phone: 703-648-5313 Reston, VA 20192 fax: 703-648-5722