NETPATH - Version 2.15 June 25, 2007 Interactive program for calculating NET geochemical reactions and radiocarbon dating along a flow PATH For assistance, enhancement requests, or bug reports contact the Hydrologic Analysis Software Support Team via email at h2osoft@usgs.gov. See the file doc/netpath.txt for descriptions, references, and additional contacts for this software. Instructions for installation, execution, and testing are provided below. TABLE OF CONTENTS A. FILES B. EXTRACTING FILES C. COMPILING D. INSTALLING E. RUNNING THE SOFTWARE F. TESTING A. FILES The following distribution packages (containing the software, test data sets, and information files) are currently available for UNIX systems: netpath-2.15-2113.Linux.tar.gz--Compiled with Lahey Fortran For use on Data General workstations, the program source code consists of the following files (found in the netpath-2.15-2113/src directory): netpath.f90 db.f90 wateqfp.f90 Makefile--input instructions to the "make" utility for compiling NETPATH and DB Included in directory netpath-2.15-2113/doc is a Portable Document Format (PDF) version (netpath.pdf) of the NETPATH documentation (USGS WRIR 94-4169). The PDF file is readable and printable on various computer platforms using Acrobat Reader from Adobe. The Acrobat Reader is freely available from the following World Wide Web sites: http://www.adobe.com/ http://www.shareware.com/ B. EXTRACTING FILES The compressed tar file, named netpath-2.15-2113.Linux.tar.gz contains all the files needed to install and test NETPATH on a Linux computer. (If you are using another UNIX operating system, you will have to modify the Makefile for your system.) The following are the steps to extract the files from a distribution tar file. 1. The tar file will extract to a directory named netpath-2.15-2113. 2. Uncompress and extract the distribution file: tar -xzf netpath-2.15-2113.tar.gz This creates the following directory structure (the contents of each directory are shown to the right): netpath-2.15-2113 README.TXT this readme file NOTICE Legal notice RELEASE.TXT Release notes bin compiled executables database data files required during execution doc documentation files src Makefile and source code template_working_directory Example working directory with files necessary to run db and netpath test scripts to run verification tests data standard data sets used in verification tests C. COMPILING If you have retrieved a pre-compiled distribution of the software, skip this section. If a compiled version of the software is not available for your operating system, you will have to compile db and netpath. The source code is provided in the Linux distribution (src directory) so that users can generate the executable files for db and netpath. No support is provided for users generating their own versions of the software. In general, the requirements are a Fortran compiler and a minimal level of knowledge of the compiler and the target operating system. As provided, the Makefile and source code are set up for use on a computer running a recent version of Linux. Normally, only the first few lines of the Makefile will need to be modified. D. RUNNING THE SOFTWARE Copy db and netpath from the bin directory to a working directory. Also copy db.dat and netpath.dat from the database directory to the working directory. Do all work in the working directory. A template_working_directory with these files is provided in the distribution. E. 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. The directory "netpath-2.15-2113/test" contains the scripts to run the tests. The directory netpath-2.15-2113/data contains the input data and expected results for each test. Tests are run in the directory netpath-2.15-2113/test using the script test.sh. Run the tests using any of the commands in the table below. To test the installation, change to the netpath-2.15-2113/test directory and type the command: ./test.sh [m [n]] where: m = the number of the first test to perform, default=1 n = the number of the last test to perform, default=20 For example: command what happens ------------------ ------------------------------------ ./test.sh runs all of the tests ./test.sh n runs test "n" through the last test ./test.sh n m runs test "n" through "m" After the tests are completed, the results are compared to the expected results. If all goes well, the only differences will be due to different processing times or pathnames. To clean up after the tests, type the command: ./clean.sh NOTE: 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. The tests are described in the table below. 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. tests program description of test and files file name & usage ----- ------- ------------------------------------- ----------------- all netpath model files data file names model.fil i suite of files netpath.fil i Lon file class.lon i Pat file class.pat i Response file go i 1-3 netpath Sierra Nevada (Ephemeral and Perennial Springs) Model input file np-1a.dat i summary of processed data netpath1.out o log of screen output from program netpath1.log o Model input file np-1b.dat i summary of processed data netpath2.out o log of screen output from program netpath2.log o Model input file np-1c.dat i summary of processed data netpath3.out o log of screen output from program netpath3.log o 4 netpath GSL, Bear R. weighted 1961 GSL, S. arm at RR Oct. 1960 Model input file np-2.dat i summary of processed data netpath4.out o log of screen output from program netpath4.log o 5-12 netpath Chapelle-Knobel (1985) Fd-12 Chapelle-Knobel (1985) Ff-35 Model input file np-3-1.dat i summary of processed data netpath5.out o log of screen output from program netpath5.log o Model input file np-3-2.dat i summary of processed data netpath6.out o log of screen output from program netpath6.log o Model input file np-3-3a.dat i summary of processed data netpath7.out o log of screen output from program netpath7.log o Model input file np-3-3b.dat i summary of processed data netpath8.out o log of screen output from program netpath8.log o Model input file np-3-4.dat i summary of processed data netpath9.out o log of screen output from program netpath9.log o Model input file np-3-5.dat i summary of processed data netpath10.out o log of screen output from program netpath10.log o Model input file np-3-6.dat i summary of processed data netpath11.out o log of screen output from program netpath11.log o Model input file np-3-7.dat i summary of processed data netpath12.out o log of screen output from program netpath12.log o 13 netpath Pinal Cr. background, #404 Pinal Cr. pH<4 plume, #51 Pinal Cr. pH 4-5, #402 Model input file np-4.dat i summary of processed data netpath13.out o log of screen output from program netpath13.log o 14-18 netpath Chapelle-Knobel (1985) Fd-12 Chapelle-Knobel (1985) Ff-35 Model input file np-5-1.dat i summary of processed data netpath14.out o log of screen output from program netpath14.log o Model input file np-5-2.dat i summary of processed data netpath15.out o log of screen output from program netpath15.log o Model input file np-5-3.dat i summary of processed data netpath16.out o log of screen output from program netpath16.log o Model input file np-5-4.dat i summary of processed data netpath17.out o log of screen output from program netpath17.log o Model input file np-5-5.dat i summary of processed data netpath18.out o log of screen output from program netpath18.log o 19 netpath Madison Recharge #3 Madison Mysse Model input file np-6.dat i summary of processed data netpath19.out o log of screen output from program netpath19.log o 20 netpath Bemidjii Site AA Bemidjii Site BB Model input file np-7.dat i summary of processed data netpath20.out o log of screen output from program netpath20.log o * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * Good Luck! * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *