File: README.TXT PRZM3 Pesticide Root Zone Model - Release 3 (Pre-Review) Version 3.12 Beta U.S. EPA Release, February 1998 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 _________________________________________________________________ IMPORTANT NOTE: The PRZM3 model system is intended to be installed and applied as a stand alone software product. It is not intended to mix with, update, replace, or modify any files associated with an existing installation of any release version of the PRZM2 model system as distributed through the U.S. EPA CEAM (i.e., do not use PRZM3 to update an existing installation of PRZM2). PRZM3 model system input data files are not compatible with the PRZM2 model system and visa versa. CONTENTS Introduction Documentation Installation File Name and Content Installation Verification Development System Routine Execution Run Time and Performance Minimum File Configuration Modification Technical Help Contact Disclaimer _________________________________________________________________ INTRODUCTION PRZM is a one-dimensional, finite-difference model that accounts for pesticide and nitrogen fate in the crop root zone. PRZM3 is the most recent version of the PRZM modeling system that links two subordinate models--PRZM and VADOFT--in order to predict pesticide transport and transformation down through the crop root and unsaturated zones. Enhancements to this pre-review release (version 3.12 Beta) include algorithms that enable modeling of nitrogen cycle soil kinetic processes with the ability to track nitrogen discharges from a septic tank into the soil environment and movement to groundwater. Additional enhancements enable better simulation of physicochemical processes, increased flexibility in representing agronomic practices, and improved post-processing and data interpretation aids. For a list of modifications to the PRZM model system since the release of version 1.00 (October 1992), refer to the contents of files RELEASE.TXT and UPDATE.TXT (refer to FILE NAME AND CONTENT section). NOTE: For convenience, the terms "PRZM3 model system" or "PRZM3" will be used in this document to refer to the PRZM3 model and all associated support files and programs as a single unit. Therefore, the terms "PRZM3" and "PRZM3 Model System" are synonymous for purposes of this document. _________________________________________________________________ DOCUMENTATION It is recommended that the user obtain and reference the documents listed below to operate and apply the PRZM3 model system. Copies of the following documents are included within the Internet distribution file Install_PRZM312b.EXE. Refer to FILE NAME AND CONTENT and MINIMUM FILE CONFIGURATION sections for further information. Document Name(s) File Name(s) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~ PRZM3 model system general execution and README.TXT user support guide PRZM3 Model System Release Notes RELEASE.TXT PRZM3 Model System Update Notes UPDATE.TXT (Enhancements/updates/additions not covered in user manual file) PRZM3 Model System Abstract ABSTRACT.TXT CEAM Software Product User Response Form RESPONSE.TXT PRZM3 Documentation and User's Manual *.PDF "PRZM-3, A Model for Predicting (12 Files) Pesticide and Nitrogen Fate in the Crop Root and Unsaturated Soil Zones: Draft Users Manual for Test Release 3.12B" Files with a file name extension of .PDF are in Adobe Acrobat format and require Adobe Acrobat Reader software available at no charge from http://www.adobe.com/. _________________________________________________________________ INSTALLATION Installation Requirements: CD-ROM drive (if installed from CD-ROM) Approximately 6 MB available hard disk storage Windows 9x/NT/2K/XP operating system. Run Time Requirements: DOS or operating system capable of emulating a DOS console (e.g., Win9x/NT/2K/XP) Approximately 6 MB available hard disk storage. The PRZM-3 installation file, Install_PRZM312b.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-3: Close all applications and click on the installation program "Install_PRZM312b.EXE". Follow the instructions presented by the installation program. _________________________________________________________________ FILE NAME AND CONTENT The self-extracting, interactive, installation executable program file exists in a compressed format to save disk space and file transfer time. This document contains a description of each file that can be decompressed from the compressed distribution diskettes and/or file. Follow the instructions shown on the interactive installation program screens and menus to install, decompress (extract), and restore file(s) to their original name and size in order to place the PRZM3 model system in a usable format on a hard or virtual disk. For comparison purposes, the original date and time of creation are also restored with each file. NOTE: Execution of the INSTALL or INSTALP3 command can extract one or more PRZM3 model system files. These files are automatically stored into DOS sub-directories on the hard disk. The hard disk and sub-directory structure, under which the sub-directories shown below are stored, is selected by the user (e.g., C:\PRZM3) during execution of the INSTALL or INSTALP3 program. The string "InstallationDirectory" will be used to denote the highest level default installation directory structure chosen by the user during execution of INSTALL or INSTALP3. Below the installation directory, all files are grouped and listed by the appropriate DOS sub-directory name into which they will be automatically stored. ** Sub-directory InstallationDirectory\README: NOTE: The following files are ASCII text (non-binary) files that can be displayed on the monitor screen with the DOS TYPE command or printed using the DOS PRINT command. README.TXT - PRZM3 model system execution and general support guide. RELEASE.TXT - Summary of corrections and/or changes between release versions. UPDATE.TXT - Summary of enhancements, updates, and additions not covered in the current user's manual. ABSTRACT.TXT - PRZM3 Model System Abstract. RESPONSE.TXT - CEAM Software Product User Response Form. ** Sub-directory InstallationDirectory\DOCUMENT NOTE: The files described within this section are NOT required to execute and/or test any model, program, or associated run time support file as provided on the distribution diskettes or the Internet installation file. For further information, refer to the MINIMUM FILE CONFIGURATION section. *.PDF - PRZM3 Documentation and User's Manual "PRZM-3, A Model for Predicting Pesticide and Nitrogen Fate in the Crop Root and Unsaturated Soil Zones: Draft Users Manual for Test Release 3.12B". ** Sub-directory InstallationDirectory: F77L3.EER - Run time error message library file for Lahey FORTRAN (F77L3) (refer to DEVELOPMENT SYSTEM section). This file is read automatically during execution of the PRZM3 model system executable task image file (*.EXE) if an error is detected during execution. NOTE: To execute a DOS batch command file (*.BAT)--and hence a model or program spawned (i.e., executed) buy a given batch command file--from any sub-directory located on a hard or virtual disk drive, try adding the PRZM3 installation sub-directory (e.g., C:\PRZM3) to the DOS search PATH and copy the file PRZM3.RUN and other appropriate run time support files to the current default sub-directory. One way to accomplish this is to add or modify the PATH statement in the system start-up file, AUTOEXEC.BAT (located in the root directory on the start-up or boot drive). For example PATH C:\;C:\DOS;C:\UTIL;C:\WP51;C:\PRZM3; Refer to the DOS Reference Manual for PATH command and AUTOEXEC.BAT file application and use. PRZM3.EXE - Executable task image file for the PRZM3 model. NOTE: All PRZM3 model input data and output listing files 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 (non-binary) format. NOTE: An input or output file name path specification and/or file name, as typed at a run time prompt or specified within the run time supervisor file PRZM3.RUN by the user, must be a unique and valid DOS path and/or file name. An input data file name must also be a valid PRZM3 file name -- either furnished with the distribution package or created, designated, and named by the user. A file name specified within the PRZM3 run time supervisor file as input data for the PRZM3 model 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 OUT_TEST\*.OUT files for a procedure to compare the contents of an output file produced by the PRZM3 model on the users system (OUTPUT\*.OUT) to an output file provided within the distribution package (OUT_TEST\*.OUT). To execute the PRZM3 model, the user must first create and enter the necessary input data into input data files. The files names of these input data files must be specified within the PRZM3 run-time supervisor file (PRZM3.RUN). These files should only be created and/or modified using an editor program that can read and save a file to disk in ASCII text (non-binary) format. NOTE: For further explanation, information, and listings of example input and output data files, refer to the User's Manual. PRZM3.RUN - Run time supervisor (command) file for PRZM3. This file contains file name(s) and other run time information, parameter values, input/output file storage path(s) and name(s), and/or setting(s) used during the execution of the PRZM3 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 PRZM3 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. PRZM3.EXE - Executable task image file for the PRZM3 model. ** Sub-directory InstallationDirectory\TESTDATA *.INP - Three example input data files to test the installation and demonstrate application of the PRZM3 model. These data files are also furnished to provide instruction by example and can be used as templates for the preparation of a new or modified input file. To test the installation, execute the PRZM3 model using the PRZM3.RUN run time supervisor file provided within the distribution package. This supervisor file is configured and contains comments to assist the user with modifying this file to use input files P31EXMP1.INP, P31EXMP2.INP, and P31EXMP3.INP stored within the TESTDATA sub-directory, and to produce the output files P31EXMP1.OUT, P31EXMP2.OUT, and P31EXMP3.OUT within the sub-directory ..\OUTPUT. These sample input files provide examples of input for most sections and capabilities of the PRZM3 model. ** Sub-directory InstallationDirectory\MET_DATA W*.MET - National Oceanographic and Atmospheric Administration (NOAA) first order meteorologic station data files. These data files contain recorded meteorological data for NOAA first order meteorologic stations. These files are specified as input data for the PRZM3 model within the run time supervisor file (PRZM3.RUN), and are read automatically by the PRZM3 model. They can be used with the U.S. EPA release of the PRZM3 model system. These are ASCII text (non-binary) files. NOAA_MET.TXT - NOAA met data file general support guide. This file is an ASCII text (non-binary) file that can be displayed on the monitor screen with the DOS TYPE command or printed using the DOS PRINT command. ** Sub-directory InstallationDirectory\OUT_TEST: NOTE: The symbol "" represents pressing the or carriage return key. Responses and key strokes that can be typed by the user are underlined with the hyphen character (-) and/or enclosed by the angle bracket characters (<>). *.OUT - Output listing files produced by execution of the PRZM3 model using the test input data files provided. The run time supervisor file PRZM3.RUN, as distributed within the PRZM3 distribution package, is configured and contains comments to assist the user with (1) modifying the run time supervisor file to allow the PRZM3 model to process and read input files P31EXMP1.INP, P31EXMP2.INP, and P31EXMP3.INP stored within the ..\TESTDATA sub- directory, and (2) to produce the output files P31EXMP1.OUT, P31EXMP2.OUT, and P31EXMP3.OUT within the sub-directory ..\OUTPUT. ** Sub-directory InstallationDirectory\INC_CODE: *.INC - FORTRAN source code "include" files containing FORTRAN COMMON block declarations for the PRZM3 model source code. ** Sub-directory InstallationDirectory\PRZMCODE: NOTE: All FORTRAN source code files (*.INC, *.FOR) are NOT required to document, execute and/or test any model, program, or associated run time support file as provided on the distribution diskettes or the Internet installation file. For further information, refer to the MINIMUM FILE CONFIGURATION section. *.FOR - FORTRAN source code files for the PRZM3 model, version 3.12, Beta, pre-review release. Special Run Time Files ** Sub-directory InstallationDirectory: NOTE: In addition to standard output files, the PRZM3 model system also generates a special run time file that does not store scientific results. This file, as noted below listed by file name, can be cleaned up (i.e., deleted) at any time by the user. PRZM3RUN.LOG - Run time log file that contains a beginning and ending date and time stamp for each execution of the PRZM3 model. Refer to the ROUTINE EXECUTION section for further information. This file can be cleaned up (i.e., deleted) at any time by the user. NOTE: The following file(s) are not distributed with the distribution release. They are either created and/or updated (appended to) automatically when the user executes the PRZM3 model system. These files will be stored in the sub-directory (e.g., \PRZM3) selected by the user during the installation of the PRZM3 model system. KECHO.PRN - For further information on these files, refer to RESTART.PRZ the user's manual (refer to DOCUMENTATION P2E-C*.D56 section). These files are created during the P2E-C*.D57 execution of the PRZM3 model. ** Sub-directory InstallationDirectory:\OUTPUT P31EXMP1.ZTS - For further information on this file, refer to the user's manual (refer to DOCUMENTATION section). This file is created during the execution of the PRZM3 model. _________________________________________________________________ INSTALLATION VERIFICATION Therefore to test the installation, execute the PRZM3 model using the PRZM3.RUN run time supervisor file provided within the distribution package. After executing the PRZM3 model using each test input data file (refer to explanation of PRZM3.RUN and *.INP files above), compare the contents of the file produced in the PRZM3 OUTPUT sub- directory (e.g., ..\OUTPUT\P31EXMP1.OUT) with the corresponding output file provided and stored within the sub-directory OUT_TEST (e.g., P31EXMP1.OUT). To compare file contents, use the COMP (PC DOS) or FC (MS DOS) file compare command, or print both files then compare contents by hand. Example PRZM3 execution and file comparison sequence: Step Description/Action ~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 1) Set the default drive to the disk containing the PRZM3 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., PRZM3). Use the DOS CD (change directory) command at the DOS system prompt: C:\> CD \PRZM3 3) Modify (and save) the PRZM3.RUN run time supervisor file to process one of the three example input data files (..\TESTDATA\*.INP) provided as required by the PRZM3 model: C:\PRZM3> EDIT PRZM3.RUN 4) Execute the PRZM3 model with the input data file as selected in step 3 above: C:\PRZM3> PRZM3 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ (Initial PRZM3 banner/registration screen displayed here...press key to clear screen and continue model execution...) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ (Next, the following screen is displayed while the PRZM3 program is loaded into memory...) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ # #----------------------------------------------------------------------# ## Executing PRZM3 DOS command file. #----------------------------------------------------------------------# # # ## Loading PRZM3 model task image file...wait. # #-------------------------# ## PRZM3 run beginning. #-------------------------# # ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ» º 32-bit Power for Lahey Computer Systems º º Phar Lap's 386|DOS-Extender(tm) Version 4.1L º º Copyright (C) 1986-92 Phar Lap Software, Inc. º º Available Memory = xxxxx Kb º ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ (Where xxxxx is a number that represents the available RAM memory on the host system expressed in K bytes (K=1,024). This value is filled in automatically by the PRZM3 executable task image file.) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ (Screen cleared. The PRZM-3 Version 3.12 Beta Execution Supervisor run time diagnostic and information status screen and messages displayed here while the model executes.) (Once execution is complete the following messages are displayed on the monitor screen.) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ # ## PRZM3 program execution complete. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ (Compare the output file supplied to that produced. For example:) C:\PRZM3> COMP OUT_TEST\P31EXMP1.OUT OUTPUT\P31EXMP1.OUT ---------------------------------------------- or, C:\PRZM3> FC OUT_TEST\P31EXMP1.OUT OUTPUT\P31EXMP1.OUT -------------------------------------------- _________________________________________________________________ DEVELOPMENT SYSTEM The following list describes the language and program development tools used by the U.S. EPA Center for Exposure Assessment Modeling to build version 3.12 Beta (pre-review release) of the microcomputer implementation of the PRZM3 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 this model system 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 PRZM3 model system. Development System: Hardware System: Fully IBM compatible 80386, 80486, or 80586 Language: FORTRAN 77 Operating System: DOS version 3.30 or higher. Properly configured, this model system should also work on hardware platforms with PC DOS or MS DOS versions 4.0x, 5.0x, or 6.x., to include a DOS window or box or boot under Windows 3.x, Windows 95, and NT. 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 and program Storage Requirements: (k=1,024; m=1,048,576) Random Access Memory: (approximate minimum free bytes needed to execute EXE file for optimum performance within extended, not expanded, memory (i.e., XMS)) 640k base (low end) memory, plus 4.62m bytes of free extended (XMS) memory and 6.34m bytes of free disk space; or, 1m byte of free extended (XMS) memory and 9.96m bytes disk space (non-optimized). Diskette Drive: Required for installation only. Hard Disk Drive: 50m byte drive recommended (minimum) with 10m bytes free (minimum) Installation Size: Run Time: Approx. 6.34m bytes max. Run time size: After installation, up to approximately 1m bytes plus space for user input data or command files, output, and temporary files produced by model system (refer to MINIMUM FILE CONFIGURATION section). Numerical Coprocessor: Required. \CONFIG.SYS Statements: BREAK=ON BUFFERS=20 or BUFFERS=32 FILES=20 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 with the hyphen character (-) and/or enclosed by the angle bracket characters (<>). NOTE: It is possible that the PRZM3 model system could be incompatible with MS DOS and Windows software cache files SMARTDRV.SYS or SMARTDRV.EXE loaded from the system configuration files \CONFIG.SYS and/or \AUTOEXEC.BAT on the boot drive. If any portion of the PRZM3 model system prematurely halts, produces unusual results, and/or causes the host system to halt or hang, remove any SMARTDRV statements on the boot drive \CONFIG.SYS and/or \AUTOEXEC.BAT files, then re-boot the system to implement these changes before attempting to reuse any portion the PRZM3 model system. Introduction ~~~~~~~~~~~~ Complete the installation process to make the full or any portion of the PRZM3 model system and related files resident on a hard (usually designated as "C:") or virtual disk drive. Then modify the \CONFIG.SYS system environment file and restart the microcomputer system. This needs to be completed only once for a given installation and/or execution of the PRZM3 model system. DOS Storage Path ~~~~~~~~~~~~~~~~ Verify that the PRZM3 model system executable task image file (PRZM3.EXE), other run time support files, PRZM3 run time supervisor file, and user defined input data and/or command file(s) are in the current default DOS sub-directory. It is convenient but not required to have these files in the same sub-directory. NOTE: To execute a DOS batch command file (*.BAT)--and hence a model or program spawned (i.e., executed) buy a given batch command file--from any sub-directory located on a hard or virtual disk drive, add the PRZM3 installation sub-directory (e.g., C:\PRZM3) to the DOS search PATH and copy other appropriate run time support files to the current default sub-directory. One way to accomplish this is to add or modify the PATH statement in the system start-up file, AUTOEXEC.BAT (located in the root directory on the start-up or boot drive). For example PATH C:\;C:\DOS;C:\UTIL;C:\WP51;C:\PRZM3 If any portion of the PRZM3 model system prematurely halts, produces unusual results, and/or causes the host system to halt or hang, copy all DOS batch and other run time support files from the PRZM3 model system installation sub-directory to the current default sub- directory from where the PRZM3 model system will be executed via the DOS search PATH statement. Refer to the DOS Reference Manual for PATH command and AUTOEXEC.BAT file application and use. Routine Execution Steps ~~~~~~~~~~~~~~~~~~~~~~~ Step Description/Action ~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 1) Set the default drive to the disk containing the PRZM3 model system sub-directory. For example: 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., PRZM3). Use the DOS CD (change directory) command at the DOS system prompt: C:\> CD \PRZM3 --------- NOTE: A common problem is for a DOS executable or batch command file (*.EXE, *.BAT) to be unable to locate a file because it assumes the file is on the default drive and/or sub-directory when it is not. If input and/or other run time support file(s) are not on the default drive and sub-directory, the user can type a drive and/or path name ahead of the file name. For further information refer to the "File Name and Path Specifications" sub-section later in this document or the DOS Reference Manual. 3) To execute the PRZM3 model, type: C:\PRZM3> PRZM3 ----- After an opening banner/registration screen is displayed on the monitor, press the key to clear the screen and begin model execution. NOTE: The PRZM3 model system is a DOS, not Windows, application and should be executed from a DOS command line prompt. NOTE: To execute the PRZM3 model, the user must first create and enter the necessary input data into input data files. These files should only be created and/or modified using an editor program that can read and save a file to disk in ASCII text (non-binary) format. Viewing Output Results ~~~~~~~~~~~~~~~~~~~~~~ After executing a PRZM3 model system executable task image file, exiting PRZM3, and returning to the DOS prompt, the user can view an output file (e.g., *.OUT), if any, produced by the execution of a program or model if and only if that file is in ASCII text (non-binary) format. Results can be viewed by scrolling through the output file that was (1) a result of model or program execution and/or (2) named by the user at a run time prompt. A word processor or text editor is convenient for this purpose, or the command TYPE filename | MORE can be used where "filename" is the name of the output file. However, the TYPE command is awkward for a file that exceeds the 80-column screen width. Alternatively, the output file can be printed. A compressed print mode (132 column) should be used to avoid awkward--wrapped around--output from lines that exceed 80 columns. The DOS MODE command can be used for this purpose. For a parallel printer assigned to LPT1, the DOS command MODE LPT1: 132 will cause most printers to print in compressed mode. For further information, refer to the DOS Reference Manual. File Name and Path Specifications ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ A file name, path specification, and/or the parameter file name argument "filename" must be a unique and valid DOS path and/or file name. The user response "filename" must also be a valid PRZM3 model system command, input, or output 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 as input data for a program or model in the PRZM3 model system will be processed and executed in that run of the program or model. In general, file names used for input data, command, and/or output listing files (except for the test input and example 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). However the PRZM3 model uses specific file names for input and output data (refer to explanation of files within the installation and OUTPUT sub-directories) and a specific file name extension for all input and output files (e.g., *.OUT). Any DOS file name can be from 1 to 8 characters and can have an optional 0 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 and ignored 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. _________________________________________________________________ RUN TIME AND PERFORMANCE The following run times (approximate) were observed using the test input data file sets furnished with the distribution version of the PRZM3 model system. Remember that these times were obtained using input 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 PRZM3 model system 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 a Microway 80486 B2T EISA class microcomputer running under MS DOS 6.0 and using 640k bytes of random access (low end) memory (RAM), 32 megabytes of extended memory, a 32 megabyte virtual (RAM) disk, Microp 1624-15 SCSI 765 megabyte DPT EISA hard disk with a 12K byte cache SCSI controller, a 256K byte memory cache, a 66 megahertz clock, a Number Smasher-860 40 megahertz, 32 megabyte math numerical coprocessor, and an ATI Ultra Graphics 1 megabyte video card. ** PRZM3 Model System Test Runs Input Data File Name Approx. Run Time (min:sec) ~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~ P31EXMP1.INP 01:43 P31EXMP2.INP 00:51 P31EXMP3.INP 01:15 Program run time and performance can be affected by many microcomputer system and program parameters including o available disk space o available memory o processor/CPU classification o CONFIG.SYS and AUTOEXEC.BAT 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 and/or test--not document--the PRZM3 model and all support command files and programs. This list assumes that o the PRZM3 model system and all support files and programs have been successfully installed from the distribution release 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. ** Sub-directory InstallationDirectory\README: NOTE: The following files are ASCII text (non-binary) files that can be displayed on the monitor screen with the DOS TYPE command or printed using the DOS PRINT command. README.TXT - PRZM3 model system execution and general support guide. RELEASE.TXT - Summary of corrections and/or changes between release versions. UPDATE.TXT - Summary of enhancements, updates, and additions not covered in the current user's manual. ABSTRACT.TXT - PRZM3 Model System Abstract. RESPONSE.TXT - CEAM Software Product User Response Form. ** Sub-directory InstallationDirectory: F77L3.EER - Run time error message library file. PRZM3.RUN - PRZM3 run time supervisor file. PRZM3.EXE - Executable task image file for the PRZM3 model. ** Sub-directory InstallationDirectory\TESTDATA *.INP - Example input data files (3). ** Sub-directory InstallationDirectory\MET_DATA NOAA_MET.TXT - NOAA met data file general support guide. W*.MET - National Oceanographic and Atmospheric Administration (NOAA) first order meteorologic station data files. ** Sub-directory InstallationDirectory\OUT_TEST: *.OUT - Output listing files produced by execution of the PRZM3 model using the test input data files provided. _________________________________________________________________ MODIFICATION Included with the distribution release are o executable task image file for the PRZM3 model system o PRZM3 model FORTRAN source code files for IBM PC and compatible microcomputer systems (refer to DEVELOPMENT SYSTEM section). A FORTRAN compiler and link editor are NOT required to execute any portion of the PRZM3 model system. If the user wishes to modify any portion of the PRZM3 model system, 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 PRZM3 model The U.S. EPA 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-3 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 - March 1998 - E:\PRZM3\README\README.TXT Revised - April 2004 Revised - October 2004