File: README.TXT PRZM2 Pesticide Root Zone Model - 2 Version 1.00 October 1992 Center for Exposure Assessment Modeling (CEAM) National Exposure Research Lab - Ecosystems Research Division Office of Research and Development (ORD) U.S. Environmental Protection Agency (U.S. EPA) 960 College Station Road Athens, Georgia 30605-2700 706/355-8400 _________________________________________________________________ CONTENTS Introduction Documentation Installation File Name and Content Development System Routine Execution Run Time and Performance Minimum File Configuration Modification Technical Help Contact Disclaimer _________________________________________________________________ INTRODUCTION The PRZM2 model system provides state-of-the-art deterministic simulation of the fate and transport of pesticides, applied for agricultural purposes, in the crop root zone and the vadose zone. This model system is capable of simulating multiple pesticides or parent/daughter relationships. PRZM2 is also capable of estimating probabilities of concentrations or fluxes in or from these various media for the purpose of performing exposure assessments. _________________________________________________________________ DOCUMENTATION Copies of the following documents are included in the distribution set. Refer to FILE NAME AND CONTENT and MINIMUM FILE CONFIGURATION sections for further information. Document Name File Name(s) _____________ ____________ PRZM2 model system general execution and README.TXT user support guide PRZM2 User's Manual *.WP CEAM Software Product User Response Form RESPONSE.TXT These documents are applicable to the microcomputer, VAX, and other mainframe/minicomputer installations of the U.S. EPA release of the PRZM2 model system. These documents should be retained by the requester for future reference. The files README.TXT and RESPONSE.TXT are ASCII (non-binary) text files that can be displayed on the monitor screen by using the DOS TYPE command (e.g., TYPE README.TXT) or printed using the DOS PRINT command (e.g., PRINT README.TXT). File names with a file name extension of ".WP" are WordPerfect (binary) document files that can only be viewed and/or printed within WordPerfect. _________________________________________________________________ INSTALLATION The PRZM-2 installation file, Install_PRZM100.EXE, may be acquired either from the Internet or CD-ROM. Save the installation file to a local disk before running the installation program. To install PRZM-2: Close all applications and click on the installation program "Install_PRZM100.EXE". Follow the instructions presented by the installation program. This model system is designed for the IBM PC family of microcomputers or compatible systems running under version 3.30 or higher of the PC Disk Operating System (PC DOS--refer to DEVELOPMENT SYSTEM section). Properly configured, this model system and its support files and programs can be executed under PC DOS or MS DOS 3.30 and later versions, DOS 4.0 or DOS 5.0. _________________________________________________________________ FILE NAME AND CONTENT The self-extracting, interactive executable program file exists in a compressed format to save disk space and file transfer time. This section contains a description of each file that can be decompressed from the compressed distribution file. NOTE: Execution of the Install_PRZM100.EXE command will extract all PRZM2 model system files. These files are automatically stored into DOS sub-directories on the hard disk. The sub-directory structure, under which the sub-directories shown below are stored, is selected by the user. The string "InstallationDirectory" will be used to denote the highest level default installation directory structure chosen by the user during installation. The files are listed by DOS sub-directory name. ** Sub-directory InstallationDirectory: README.TXT - PRZM2 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. RESPONSE.TXT - CEAM Software Product User Response Form. 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. PRZM2.RUN - Run time supervisor (command) file for PRZM2. This file contains file name(s) and other run time information, parameter values, and/or setting(s) used during the execution of the PRZM2 model. To use the run time supervisor file, edit the file with a text editor that saves a file to disk in ASCII (non-binary) text format. This file is read automatically by the PRZM2 model and 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. PRZM2.EXE - Executable task image file for the PRZM2 model. To execute, type PRZM2 at the DOS system prompt then press the key. ** Sub-directory InstallationDirectory\DOC: *.WP - PRZM2 User's Manual including tables. These 16 files are WordPerfect (binary) documents that can only be viewed and/or printed within WordPerfect. ** Sub-directory InstallationDirectory\INPUT: *.INP - Sample input data files (10) to test the installation and demonstrate application of the PRZM2 model. These files have also been furnished to provide instruction by example. To test the installation, execute the PRZM2 model using the PRZM2.RUN run time supervisor file included in the distribution set. This supervisor file is configured to use the input files PRZM3.INP, VADF3.INP, and MET.INP and produce the output files PRZM.OUT, VADF.OUT, and TIMES.OUT. NOTE: A file name path specification and/or file name, as typed by the user in the PRZM2.RUN run time supervisor file, must be a unique and valid DOS path and/or file name. An input file name must also be a valid PRZM2 model input data file name -- either furnished with the distribution package (refer to FILE NAME AND CONTENT section) or created, designated, and named by the user. A file name used in the PRZM2 run time supervisor file will be processed and executed in the run of the model. Remember, a DOS file name can be from 1 to 8 characters and can have an optional 1 to 3 character file name extension. NOTE: Refer to the explanation of the *.OOO files for a procedure to compare the contents of an output file produced on the users system (*.OUT) to an output file provided in the distribution set (*.OOO). The user can specify input and output file name(s) in the run time supervisor file PRZM2.RUN (refer to explanation of PRZM2.RUN file). ** Sub-directory InstallationDirectory\OUTPUT: *.OOO - Output listing files (3) produced by the PRZM2 model using test input data files PRZM3.INP, VADF3.INP, and MET.INP provided in the distribution set. The run time supervisor file, as distributed by CEAM, is configured to process these input files and produce the output listing files PRZM.OUT, VADF.OUT, and TIMES.OUT. After executing the PRZM2 model with the default supervisor file, compare the contents of the output files produced (e.g., PRZM.OUT) with the corresponding *.OOO output file provided (e.g., PRZM.OOO). To compare file contents, use either the DOS COMP or FC file compare command. ** Sub-directory InstallationDirectory\PRZMCODE: CLPRZM2.BAT - DOS batch command file that can be used to compile and link edit the PRZM2 model FORTRAN source code files (*.INC, *.FOR) to incorporate changes made in the source code files by the user. Refer to the program listing for in-code documentation. The execution of this command produces a new executable task image file (PRZM2.EXE) for the PRZM2 model. This command file only needs to be executed if changes have been made in the FORTRAN source code, not input data files. To execute, type CLPRZM2 at the DOS system prompt, then press the key. PRZM2.LNK - Lahey FORTRAN 386LINK link edit command file called and executed automatically by the compile and link edit DOS batch command file CLPRZM2.BAT. *.INC - FORTRAN source code "include" files containing FORTRAN COMMON block declarations for the PRZM2 model. These files are automatically included or "copied" into the appropriate FORTRAN source code file (*.FOR) during compilation. *.FOR - The FORTRAN source code files for the PRZM2 model, release 2, version 1.00. _________________________________________________________________ DEVELOPMENT SYSTEM The following list describes the language and program development tools used by the Center for Exposure Assessment Modeling to build version 1.00 of the microcomputer implementation of the PRZM2 model system. Also shown are the recommended minimum hardware and software configuration and the recommended \CONFIG.SYS configuration/environment file statements for the implementation and execution of these models and programs and all related support files and programs. Make sure that the IBM PC or compatible system has these statements in the \CONFIG.SYS file, and re-boot the system to implement these changes before attempting to install or use the PRZM2 model system. Development System: Hardware System: Fully IBM compatible 80386 or 80486 Language: FORTRAN 77 Operating System: DOS version 3.30 or higher. Properly configured, the PRZM2 model system should also work on systems with PC DOS or MS-DOS versions 4.0x and 5.0x DOS Extender: Phar Lap 386/DOS-extender; bound into application EXE file with automatic virtual memory management; distributed royalty free Memory Manager: Compatible with VDISK.SYS, QEMM386, HIMEM.SYS, RAMDRIVE.SYS, EMM386, CEMM, 386Max; compatible with DPMI, VCPI, and XMS standards Compiler: Lahey FORTRAN, F77L-EM/32 version 5.01 Link Editor: Phar Lap 386LINK version 4.1L Overlay Structure: None - linked as flat memory model Storage Requirements: (k=1,024; m=1,048,576) Random Access Memory: (approximate minimum free bytes needed to execute PRZM2 model) 640k base (low end) memory, and 4mb of free extended (XMS) memory or 4.5mb free disk space Hard Disk Drive: 20m byte drive recommended (minimum) with 4.5mb free (minimum) Installation Size: Run Time: Approx. 1.00m bytes max. FOR Code: Approx. 1.00m bytes max. _____ Total 2.00m bytes (Total does not include *.OBJ and if all all source code files are compiled and linked.) Run time size: Up to approximately 4.5m bytes plus space for user input data files, output, and temporary files produced by the model (refer to MINIMUM FILE CONFIGURATION section). Numerical Coprocessor: Required. \CONFIG.SYS Statements: BREAK=ON BUFFERS=20 FILES=30 DEVICE=C:\ANSI.SYS DEVICE=extended memory manager - and - SHELL=C:\COMMAND.COM C:\ /E:512 /P _________________________________________________________________ ROUTINE EXECUTION NOTE: The symbol "" represents pressing the or carriage return key. Responses and key strokes that can be typed by the user are underlined. Complete the installation process to make the PRZM2 model system and related files resident on the hard disk drive (usually designated as "C:"). Then modify the \CONFIG.SYS system environment file and restart the microcomputer system. This needs to be completed only once for a given installation of the PRZM2 model system. 1) Set the default drive to the hard disk containing the PRZM2 model system sub-directory: A:\> C: -- 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., PRZM2). Use the DOS CD (change directory) command at the DOS system prompt: C:\> CD \PRZM2 --------- 3) To execute the PRZM2 model, type: C:\PRZM2> PRZM2 ----- The response entered by the user for any file name in the PRZM2.RUN supervisor file must be a unique and valid DOS file name. A PRZM2 model system input file name must be a valid file name either 1) as furnished with the distribution package (refer to FILE NAME AND CONTENT section) or 2) as designated and/or generated by the user text editing software. This data file will be processed during the execution of the model. 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 in 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. This implementation of the PRZM2 model system has the same function and will follow the same execution sequence as the current VAX/VMS implementation for the same release version. _________________________________________________________________ RUN TIME AND PERFORMANCE The following run times (approximate) were observed using the test data files furnished with the distribution version of the PRZM2 model. Remember that these times were obtained using test data files that may not be representative of a "real world" problem and/or data. The test data files have been furnished for testing the installation of the PRZM2 model and for instruction by example. In general, these input test data files are not intended to be representative of full scale model simulations. They were developed to test the installation of significant sections of model code. The run times listed in the table below were produced on the following microcomputer systems. (1) IBM PS/2 Model 80 80386 microcomputer running under PC DOS 3.30 and using 640k bytes of random access (low end) memory, 8 megabytes of extended memory, a 70 megabyte hard disk, a 4 megabyte virtual disk (RAM) drive, a memory cache, a 16 megahertz clock, and an 80387 math numerical coprocessor (2) Micro Express 80486 microcomputer running under MS DOS 5.0 and using 640k bytes of random access (low end) memory, 8 megabytes of extended memory, a 300 megabyte hard disk, a memory cache, a 25 megahertz clock, and a math numerical coprocessor; improved run times could be observed on other 486 class machines ** Test Data Files for PRZM2 Test Runs Approx. Run Times (min:sec) Input File Name(s) 80386 80486 ____________________ ____________________________ PRZM.INP, VADF.INP 5:22 1:19 PRZM1.INP, VADF1.INP 8:32 2:00 PRZM2.INP, VADF2.INP 9:00 2:04 PRZM3.INP, VADF3.INP 8:18 1:55 Note that program run time and performance can be affected by many microcomputer system and program parameters such as o available disk space o available memory o CONFIG.SYS file options and parameter values o disk and/or file storage and/or fragmentation _________________________________________________________________ MINIMUM FILE CONFIGURATION The following list describes the absolute minimum file configuration needed within the application sub-directory to execute the PRZM2 model and all support DOS batch command files. This list assumes that o the PRZM2 model system and all support files and programs have been successfully installed o the user has defined and stored all application specific run time files NOTE: Files other than those listed below can be deleted if the user needs to recover disk space. - README.TXT - PRZM2 model system general execution/user support guide. - *.WP - PRZM2 User's Manual including tables. - PRZM2.RUN - Run time supervisor (command) file for PRZM2. - PRZM2.EXE - Executable task image file for the PRZM2 model. - *.INP - Input data files as provided and named by the user for the PRZM2 model system. _________________________________________________________________ MODIFICATION Included in the distribution set are o executable task image file for the PRZM2 model o FORTRAN source code files for IBM PC and compatible microcomputer systems (refer to DEVELOPMENT SYSTEM section) o batch command files to compile and link FORTRAN source code The Lahey FORTRAN compiler and Phar Lap 386LINK link editor are NOT required to execute any portion of the PRZM2 model system. If the user wishes to modify the PRZM2 model, it will be up to the user to supply and/or obtain o an appropriate text editor that saves files in ASCII text (non-binary) format o FORTRAN program development tools to recompile and link edit the model 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 or information concerning the distribution or installation of PRZM-2 software, documentation, or data please contact CEAM at: Phone: 706-355-8400 Fax: 706-355-8104 E-mail: ceam@epamail.epa.gov Mail: Center for Exposure Assessment Modeling (CEAM) National Exposure Research Laboratory - Ecosystems Research Division U.S. Environmental Protection Agency (U.S. EPA) 960 College Station Road Athens, Georgia 30605-2700 CEAM operates and maintains a listserver system named CEAM-USERS. The CEAM-USERS listserver is an automated mailing list system which broadcasts up-to-date information concerning CEAM software product updates and releases as well as hints on software installation and use. Subscribers may broadcast messages to other list subscribers to ask and answer questions about exposure assessment modeling topics. Instructions for subscribing, posting messages, and managing membership setting are available on the CEAM Web site at the URL: http://www.epa.gov/ceampubl/listserv.htm _________________________________________________________________ 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 PRZM-3 model system, and modifications to the DOS system configuration files 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. The PRZM-3 program and files have been extensively tested and verified. However, as for all complex software products, the programs herein may not be completely free of errors and may not be applicable for all cases. In no event will the U.S. EPA be liable for direct, indirect, special, incidental, or consequential damages arising out of the use of the programs and/or associated documentation. ######################### DWD/dwd - October 1992 - E:\PRZM2\READ.DOC Revised - April 2004