INFIL3.0 - Version 1 06/19/2008
              A Distributed-Parameter Watershed Model to Estimate 
                      Net Infiltration Below the Root Zone
             
             
This version of INFIL3.0 is packaged for personal computers using Microsoft 
Windows operating systems.




                              TABLE OF CONTENTS
                      
                           A. DISTRIBUTION FILE
                           B. EXTRACTING FILES
                           C. COMPILING
                           D. INSTALLING
                           E. RUNNING THE SOFTWARE
                           F. SAMPLE PROBLEM
                           G. DOCUMENTATION
                   

A. DISTRIBUTION FILE

The following self-extracting distribution file is for use on personal computers:

     INFIL3.0.1.exe
     
The distribution file contains:

     Compiled executable file for INFIL3.0.
     Fortran source code.
     Sample problem dataset.
     Documentation report describing INFIL3.0 and the sample problem.
     
     
B. EXTRACTING FILES

The distribution file is a self-extracting program. Execution of the distribution file creates numerous individual files. The extraction program allows you to specify the directory in which the files are placed. The installation instructions assume that the files are placed into the directory C:\WRDAPP. The following directory structure will be created in C:\WRDAPP:

     |
     |-- INFIL3.0.1
     |      |-- bin        ; compiled executable file
     |      |-- doc        ; documentation report
     |      |-- sample     ; sample problem dataset
     |      |-- src        ; source code  
     |
     
It is recommended that no user files be kept in the INFIL3.0.1 directory structure. If user files must be placed in the INFIL3.0.1 directory structure, they should be placed in new, user-created subdirectories within the structure.


C. COMPILING

In addition to the executable version of INFIL3.0, the source code is also provided so that the program can be recompiled, if necessary. The program is written in Fortran. A Fortran-90 compiler is required to recompile the program.


D. INSTALLING

To make the executable versions of the program accessible from any directory, the directory containing the executable file (C:\WRDAPP\INFIL3.0.1\bin) should be included in the PATH environment variable. As an alternative, the executable file in INFIL3.0.1\bin can be copied into another directory that is already included in the PATH environment variable. Consult your Windows operating system manual for instructions on how to set the PATH environment variable. 

If multiple versions of the program are installed on the same computer, care should be taken to store the executable files in separate directories. 


E. RUNNING THE SOFTWARE

These instructions for running INFIL3.0 assume that the executable file resides in a directory that is specified in the PATH environment variable. To run INFIL3.0:

     1. Create a command-prompt window and navigate to the directory that contains the INFIL3.0 dataset that you wish to run. To create a command-prompt window on Windows XP, click Start>Programs>Accessories>Command Prompt.
     
     2. To run the program, type: 
     
          INFIL3.0.exe 
          
     3. As the program runs it writes summary output to the command-prompt window and generates a number of output files in the dataset directory.
  
  
F. SAMPLE PROBLEM

The directory INFIL3.0.1\sample contains the data files for the sample problem described in the INFIL3.0 documentaion report (USGS Scientific Investigations Report 2008-5006). The dataset is completely prepared and ready to run. Before running the sample problem, copy all of the files in INFIL3.0.1\sample into a new directory and make all of your runs using the files in the new directory. That will preserve the files in INFIL3.0.1\sample as a master copy and will free you to experiment with the dataset in the new directory. Once the files have been copied to the new directory, follow the steps presented in the preceding section to run the sample problem. A complete description of the sample problem input and output is provided in the documentation report.


G.DOCUMENTATION

The INFIL3.0 model is documented in the report:

     U.S. Geological Survey, 2008, Documentation of Computer Program INFIL3.0 - A Distributed-Parameter Watershed Model to Estimate Net Infiltration Below the Root Zone: U.S. Geological Survey Scientific Investigations Report 2008-5006, 98 p.
     
A copy of the report in Adobe PDF format is provided in directory INFIL3.0.1\doc.