premoc(1) U.S. Geological Survey (wrdapp) premoc(1) NAME premoc - A preprocessor for the two-dimensional method of characteristics (MOC) solute-transport model ABSTRACT PREMOC assists a user in creating or modifying an input data file in the format required by the MOC model. It incorporates a text- oriented editor to create, read, edit, and write a data set to/from an existing or new file. Features include automatic backup, on-line help, input-parameter information messages, interactive error messages, and the ability to customize the limits and constraints of PREMOC. METHOD PREMOC provides an easily-used, interactive, screen-oriented, textual interface to create or modify an input data file for MOC. The program queries the user for input data in a logical progression. It checks entered data for consistency with values specified previously for related parameters, with constraints of MOC, and with selected hydrologic principles. HISTORY Version 4.1.3 1997/06/12 - Updated to work on DOS-based computers by replacing Fortran PRINT commands with WRITE (* commands and including a blank in column one of screen output. Version 4.1.2 1995/09/08 - Updated to provide consistency with MOC (Version 3.2). Version 4.1 1994/07/07 - WRDAPP tape 2.1 update release. First UNIX release, code cleaned up and is compatible with MOC version 3.1, which is documented in USGS Water-Resources Investigations Report 94-4115. Modifications allowing PREMOC to run on Data General workstations were made by G.Z. Hornberger and R.S. Regan. Version 4.0 1993 - Modified and updated in 1993 by G.E. Granato and L.F. Konikow (USGS). 1986 - Developed by P. Srinivasan for the International Ground Water Modeling Center in cooperation with the USGS. DATA REQUIREMENTS Initial conditions, boundary conditions, aquifer properties at every node, and grid descriptors. OUTPUT OPTIONS The output of PREMOC is the input data set for MOC. SYSTEM REQUIREMENTS PREMOC is written in Fortran 77 with the following extension: use of include files. PREMOC uses ANSI escape sequence to position text and for use of color on the screen and thus requires terminal emulation that supports these escape sequences (for example, VT100 on UNIX-based systems and ANSY.SYS loaded for DOS-based systems). 7 Jul 1998 1 premoc(1) U.S. Geological Survey (wrdapp) premoc(1) Generally, the program is easily installed on most computer systems. The code has been used on UNIX-based computers and DOS-based 386 or greater computers having a math coprocessor and 1 mb of memory. APPLICATIONS Numerous applications worldwide. DOCUMENTATION Text file of documentation contained in premoc41.2/doc directory. REFERENCES Goode, D.J., and Konikow, L.F., 1989, Modification of a method-of- characteristics solute-transport model to incorporate decay and equilibrium-controlled sorption or ion exchange: U.S. Geological Survey Water-Resources Investigations Report 89-4030, 65 p. Granato, G.E., Konikow, L.F., and Srinivasan, P., 1993, A preprocessor for the two-dimensional method of characteristics (MOC) solute-transport model: IGWMC Report FOS-23, Golden, CO, 22 p. Konikow, L.F., and Bredehoeft, J.D., 1978, Computer model of two- dimensional solute transport and dispersion in ground water: U.S. Geological Survey Techniques of Water-Resources Investigations, book 7, chap. C2, 90 p. Konikow, L.F., Granato, G.E., and Hornberger, G.Z., 1994, User's guide to revised method-of-characteristics solute-transport model (MOC--Version 3.1): U.S. Geological Survey Water-Resources Investigations Report 94-4115. TRAINING Modeling Transport of Ground-Water Solutes (GW2080TC), offered annually at the USGS National Training Center. CONTACTS Operation and Distribution: U.S. Geological Survey Hydrologic Analysis Software Support Program 437 National Center Reston, VA 20192 h2osoft@usgs.gov Official versions of U.S. Geological Survey water-resources analysis software are available for electronic retrieval via the World Wide Web (WWW) at: http://hassrvares.er.usgs.gov/software/ and via anonymous File Transfer Protocol (FTP) from: hassrvares.er.usgs.gov (path: /pub/software). 7 Jul 1998 2 premoc(1) U.S. Geological Survey (wrdapp) premoc(1) The WWW page and anonymous FTP directory from which the PREMOC software can be retrieved are, respectively: http://hassrvares.er.usgs.gov/software/premoc.html --and-- /pub/software/ground_water/premoc SEE ALSO direct(1) - MOC utility program for producing direct-access file required by PREMOC moc(1) - Two-dimensional method-of-characteristics ground-water flow and transport model 7 Jul 1998 3