DR3M Distributed Routing Rainfall-Runoff Model--version II DR3M - Version 2.1 1996/03/01 dr3m2_1.exe - self-extracting DOS distribution prepared on an IBM-compatible PC TABLE OF CONTENTS A. SYSTEM REQUIREMENTS B. DESCRIPTION C. DOCUMENTATION D. INSTALLING o Installing DR3M from self-extracting executable o Installing DR3M from distribution diskette o DR3M directory structure o Making DR3M easily accessible E. RUNNING THE PROGRAM F. TESTING G. CONTACTS A. SYSTEM REQUIREMENTS For installation of DR3M, 1.1 megabytes of free disk space is needed. To run DR3M, the following are necessary: - 386 or greater processor - math coprocessor - 1.7 megabytes of combined free extended memory and free disk space on installation drive (the greater proportion available as memory, the better performance will be) - at least 240K free disk space in current working directory B. DESCRIPTION A watershed model for routing storm runoff through a branched system of pipes and (or) natural channels using rainfall as input. DR3M provides detailed simulation of storm-runoff periods selected by the user. There is daily soil-moisture accounting between storms. A drainage basin is represented as a set of overland-flow, channel, and reservoir segments, which jointly describe the drainage features of the basin. This model is usually used to simulate small urban basins. Interflow and base flow are not simulated. Snow accumulation and snowmelt are not simulated. C. DOCUMENTATION Alley, W.M., and Smith, P.E., 1982, Distributed routing rainfall- runoff model--version II: U.S. Geological Survey Open-File Report 82-344, 201 p. D. INSTALLING Installing DR3M from self-extracting executable ------------------------------------------------- To install DR3M from the self-extracting executable, follow the steps below, replacing with the drive letter where you want to install DR3M 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: dr3m2_1 -d :\[directory] Note: be sure to include the -d option and ":\" in the command. Examples are: dr3m2_1 -d c:\ dr3m2_1 -d c:\wrdapp 3. Go to the newly-created dr3m2.1 directory where the files have been extracted. For example: c: cd \wrdapp\dr3m2.1 4. Complete the installation by typing, install :[\directory] using the same drive letter and directory name as for extracting the files; however, if the files are located in the root directory of the installation drive, don't include the backslash. Examples are: install c: install c:\wrdapp The above install command must run successfully in order to create the batch files, dr3m2.1\bin\dr3m.bat and dr3m2.1\test\dr3m.bat which are necessary for successful execution of DR3M. Be sure that no errors occur when executing the above install command. Installing DR3M from distribution diskette -------------------------------------------- To install DR3M from distribution diskette onto your hard drive, type :install : :[\directory] For example, if your floppy drive is a: and you want to install DR3M directly under the root directory on the c: drive, you would type a:install a: c: This will create the directory c:\dr3m2.1. As an additional example, if you wanted to install DR3M under a directory named "wrdapp" on the c: drive, you would type a:install a: c:\wrdapp This will create the directory c:\wrdapp\dr3m2.1. DR3M directory structure -------------------------- The following directory structure will be created (the contents of each directory are shown to the right): dr3m2.1 copy of this README file `-----bin compiled executable, batch file to run program `-----bin_data file required during execution `-----doc documentation files `-----test batch file to run program; used to run verification tests `-----data standard data sets used in verification tests lib3.0 `-----lib_data the message file message.wdm Note: It is recommended that no user files be kept in the dr3m2.1 directory structure. If you plan to put files in the dr3m2.1 directory structure, do so only by creating subdirectories under dr3m2.1. Making DR3M easily accessible ------------------------------- To make the DR3M program accessible from any directory, the dr3m2.1\bin directory should be included in the PATH environment variable. Add a line similar to the following to AUTOEXEC.BAT: PATH=%PATH%;C:\dr3m2.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 dr3m executable is properly installed (see INSTALLING, above), the program can be executed with the command "dr3m". 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 dr3m2.1\test directory. The directory dr3m2.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 Note: 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 annie program (version 2.2 or later) be installed on the system. 2) tests 2 - 5 require the wdm file created in test 1. Run the tests by following the steps below. Test 1: - Attach to the dr3m2.1\test subdirectory and type "annie" to execute ANNIE (if the annie2.3\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.3\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 sand.wdm will be produced and is used in the remaining tests. Tests 2-5: - Execute DR3M by typing "dr3m" in the dr3m2.1\test subdirectory. - When prompted for the name of the master file, type "..\data\testN.mtr" where N is the number of the test, 2-5. - The files listed below will be produced. These should be compared with the files by the same name found in the dr3m2.1\data subdirectory. For example, if the fc command is available, the first file below can be compared with its counterpart in the dr3m2.1\data directory by typing "fc ..\data\test2.dmp test2.dmp". test2.dmp test2.out test3.dmp test3.out test3.pks test3.unt test4.dmp test4.out test4.pks test4.unt test5.dmp test5.out test5.pks test5.unt 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 one file in the wdm export format annie command file test1.log i data for Sand Creek sand.xpt i data management file sand.wdm o 2 dr3m optimization run, no routing master file test2.mtr i model control file test2.inp i data management file sand.wdm i output/print file test2.out o summary of input time-series data test2.dmp o 3 dr3m storm routing simulation, flows saved to the wdm file master file test3.mtr i model control file test3.inp i data management file sand.wdm i/o output/print file test3.out o summary of input time-series data test3.dmp o pltgen file of peaks test3.pks o pltgen file of hydrographs test3.unt o 4 dr3m storm routing simulation, flows saved to file in old format master file test4.mtr i model control file test4.inp i data management file sand.wdm i output/print file test4.out o summary of input time-series data test4.dmp o pltgen file of peaks test4.pks o pltgen file of hydrographs test4.unt o segment flow file test4.sgs o 5 dr3m storm routing simulation, flows are not saved master file test5.mtr i model control file test5.inp i data management file sand.wdm i output/print file test5.out o summary of input time-series data test5.dmp o pltgen file of peaks test5.pks o pltgen file of hydrographs test5.unt 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