File: README.TXT 3DFEMWATER/3DLEWASTE Numerical Codes for Delineating Wellhead Protection Areas in Agricultural Regions Based on the Assimilative Capacity Criterion Version 1.00 (Source code only) February 2007 Center for Exposure Assessment Modeling (CEAM) U.S. Environmental Protection Agency Office of Research and Development Environmental Research Laboratory 960 College Station Road Athens, Georgia 30605-2720 706/355-8400 _________________________________________________________________ CONTENTS Introduction Release Information File Name and Content Routine Execution Modification Technical Help Contact Disclaimer _________________________________________________________________ INTRODUCTION The 1986 Amendments to the Safe Drinking Water Act require each State to develop and submit to the U.S. EPA a wellhead protection program. As part of the program, States must establish procedures for delineating wellhead protection areas around each water well or well field that supplies a public water system. Of the five criteria that have been suggested by the U.S. EPA for delineating wellhead protection areas, the assimilative capacity criterion is potentially the most accurate. It takes into account the reduction in concentration of contaminants being transported toward a well caused by chemical and environmental processes at the land surface and in the vadose and saturated zones. Nationwide, agricultural areas are located in many diverse hydrogeologic environments. Recharge and pumping rates can vary widely within an area because of irrigation practices and/or climate. Contamination scenarios must consider multiple point and nonpoint source loadings of pesticides that vary spatially and temporally. In order to delineate wellhead protection areas in agricultural regions using the assimilative capacity criterion, the use of a numerical model that accounts for 1) flow and transport in three-dimensional variably-saturated porous media under transient conditions, 2) multiple distributed and point sources/sinks, and 3) processes that retard the transport of contaminants is needed. 3DFEMWATER and 3DLEWASTE can be used to delineate wellhead protection areas in agricultural regions using the assimilative capacity criterion. 3DFEMWATER (A Three-dimensional Finite Element Model of WATER Flow through Saturated-Unsaturated Media) simulates subsurface flows, whereas 3DLEWASTE (A Hybrid Three-Dimensional Lagrangian-Eulerian Finite Element Model of WASTE Transport through Saturated-Unsaturated Media) models contaminant transport. Both programs 1) treat heterogeneous and anisotropic media consisting of as many geologic formations as desired, 2) consider distributed and point sources/sinks that are spatially and temporally dependent, and 3) accept four types of boundary conditions (i.e., Dirichlet (fixed-head or concentration), specified-flux, Neumann (specified-pressure-head gradient or specified-dispersive flux), and variable). The variable boundary condition in 3DFEMWATER simulates evaporation/infiltration/ seepage on the soil-air interface and in 3DLEWASTE, simulates mass infiltration into or advection out of the system. 3DLEWASTE contains options to model adsorption using a linear, Freundlich, or Langmuir isotherm, dispersion, and first-order decay. NOTE: For convenience, the term "FEMWATER model system" will be used in this document to refer to the 3DFEMWATER model, the 3DLEWASTE model, and all associated support files and programs as a single unit. The term "FEMWATER model" is synonymous with "3DFEMWATER model", and the term "LEWASTE model" is synonymous with "3DLEWASTE model" for purposes of this document. _________________________________________________________________ RELEASE INFORMATION Please see the companion file "Release.txt" in the DOCUMENT directory for important release information. _________________________________________________________________ FILE NAME AND CONTENT The following set of files are packaged into a self-executing zip file that, upon execution, copies them to a user-supplied disk location. ** Installation directory *.DAT - Five (3 for FEMWATER, 2 for LEWASTE) sample input data files to test the installation and demonstrate application of the FEMWATER and LEWASTE models. These data files are the same files as listed and discussed in the user's manual (3DFEMWATER.PDF) and are furnished to provide instruction by example. To test installation, execute the FEMWATER or LEWASTE model then select an appropriate file individually as input data. These are ASCII (non-binary) text files that can be displayed on the monitor screen with the DOS TYPE command or printed using the DOS PRINT command. These files can also be viewed or edited using any editor program that can read and save a file to disk in ASCII text format. ** Sub-directory InstallationDirectory\DOCUMENT: README.TXT - FEMWATER model system execution and general support guide. This is an ASCII text file that can be displayed on the monitor screen with the DOS TYPE command or printed using the DOS PRINT command. RELEASE.TXT - Summary of corrections and/or changes between release versions. This is an ASCII text file that can be displayed on the monitor screen with the DOS TYPE command or printed using the DOS PRINT command. ABSTRACT.TXT - Abstract document for 3DFEMWATER and 3DLEWASTE models. 3DFEMWATER.PDF - FEMWATER/LEWASTE modeling system user's manual. This file is a WordPerfect (binary) document that can only be viewed and/or printed within WordPerfect. ** Sub-directory InstallationDirectory\FEMWCODE: *.INC - FORTRAN source code "include" files containing FORTRAN COMMON block declarations for the FEMWATER model. These files are automatically included or "copied" into the appropriate FEMWATER FORTRAN source code file (*.FOR) during compilation. *.FOR - The FORTRAN source code files for the FEMWATER model, version 1.00. ** Sub-directory InstallationDirectory\LEWTCODE: *.INC - FORTRAN source code "include" files containing FORTRAN COMMON block declarations for the LEWASTE model. These files are automatically included or "copied" into the appropriate LEWASTE FORTRAN source code file (*.FOR) during compilation. *.FOR - The FORTRAN source code files for the LEWASTE model, version 1.00. ** Sub-directory InstallationDirectory\TESTOUT: *.DAT - Five (3 for FEMWATER, 2 for LEWASTE) sample output data files to test the installation and demonstrate application of the FEMWATER and LEWASTE models. Files were generated with Lahey F77-EM32 compiled versions of the models running on MS Windows 98. _________________________________________________________________ ROUTINE EXECUTION Should users recompile the provided code, the following instructions from the 1993 release are provided: . . . 2) Change the DOS default sub-directory to the sub-directory designated by the user during the installation program as the installation sub-directory (e.g., FEMWATER). Use the DOS CD (change directory) command at the DOS system prompt: C:\> CD \FEMWATER ------------ 3) To execute the FEMWATER program, type: C:\FEMWATER> FEMWATER -------- then respond to the prompts shown on the monitor screen. 4) To execute the LEWASTE program, type: C:\FEMWATER> LEWASTE ------- then respond to the prompts shown on the monitor screen. NOTE: A response entered by the user for any file name must be a unique and valid DOS file name. A file name must be a valid file name either 1) as furnished with the distribution package (refer to FILE NAME AND CONTENT section), 2) as designated and/or generated by the user text editing software, or 3) an output file that will be generated by either the FEMWATER or LEWASTE model and replace an existing file by the same name. File names used for the input data and/or output listing files (except for the test input and output cases provided) are arbitrary, but must follow the rules for DOS file names. A file name should assist the user with identifying the contents or purpose of a file (e.g., INPUT.DAT, OUTPUT.LST). Any file name can be from 1 to 8 characters and can have an optional 1 to 3 character file name extension. Any characters beyond 8 in the file name or beyond 3 in the file name extension will be truncated by the DOS operating system. Refer to the DOS Reference Manual for further information on file names and disk file input/output procedures, rules, and commands. _________________________________________________________________ MODIFICATION CEAM cannot support, maintain, and/or be responsible for modifications that change the function of any executable task image file (*.EXE) or DOS batch command file (*.BAT) supplied with this model package. _________________________________________________________________ TECHNICAL HELP CONTACT For questions and/or information concerning o installation and/or testing of the FEMWATER model system and/or support programs or files, call 706/355-8400 for assistance. To check the status of the latest release of this model system or any other CEAM software product check the CEAM web site at: http://www.epa.gov/ceampubl/ _________________________________________________________________ DISCLAIMER Mention of trade names or use of commercial products does not constitute endorsement or recommendation for use by the United States Environmental Protection Agency. Execution of the FEMWATER model system, and modification to the DOS system configuration files (i.e., \CONFIG.SYS and \AUTOEXEC.BAT) must be used and/or made at the user's own risk. Neither the U.S. EPA nor the program authors can assume responsibility for model and/or program modification, content, output, interpretation, or usage. CEAM can provide only limited scientific and/or application support for this product.