sutra-gui(1)     U.S. Geological Survey (wrdapp)     sutra-gui(1)


NAME
       sutra-gui - Preprocessor and postprocessor graphical-user interface
                   for preparing SUTRA input data and for viewing model
                   output for use within Argus Open Numerical Environments
                   (Argus ONE)

ABSTRACT
       SUTRA-GUI is a graphical preprocessor and postprocessor for the U.S.
       Geological Survey's SUTRA code (for saturated and (or) unsaturated,
       constant or variable-density fluid flow, and solute or energy
       transport modeling).  SUTRA-GUI is implemented as a plug-in
       extension (PIE) code for use with Argus ONE version 4.0, or later.
       This USGS PIE code is freely available to the public.

       Argus ONE is a commercially-available package for numerical model
       mesh generation that has GIS-like (Geographic Information Systems)
       functionality.

       Although the Argus ONE package runs on a variety of computing
       platforms, the SUTRA-GUI PIE, developed by USGS, is only available
       for systems running Microsoft Windows 9x or NT.

       Note: The SUTRA-GUI only works with Version V09972D of the SUTRA
             code and not with earlier versions of SUTRA.

             References to commercial vendors of software products or
             services are provided solely for the convenience of users when
             obtaining or using U.S. Geological Survey software. Such
             references do not imply any endorsement by the U.S.
             Government.

HISTORY
       Version 1.02 1999/01/17 - Fixed bugs in export of TSTART, DELT,
          NREG, and LREG.  Workaround was added for the export of the PVEC
          array which Argus ONE exported incorrectly if the number of
          members in the array was a multiple of four.  Added keyboard
          shortcut for selecting "Run SUTRA" from the PIEs menu.

       Version 1.01 1997/10/24 - Initial release.

DATA REQUIREMENTS
       The data required in the main two SUTRA data files must be entered
       into the SUTRA-GUI in an interactive manner.  See the SUTRA code
       documentation for a detailed description of input data.  Data may be
       entered interactively in a graphical manner, or may be imported from
       text, DXF, or ArcView-Shape files.  A Fortran compiler and
       reprogramming of subroutines BCTIME and UNSAT are required to
       implement time-dependent boundary conditions and unsaturated flow
       functions, respectively.

OUTPUT OPTIONS
       Output produced by the SUTRA-GUI is a complete set of files for use
       as input files for SUTRA.  Both irregular and regular "fishnet"
       finite-element mesh types may be generated.  Additionally, the



                           21 Jan 1999                          1





sutra-gui(1)     U.S. Geological Survey (wrdapp)     sutra-gui(1)


       graphical postprocessor provides contour and vector plots of the
       SUTRA simulation results.

SYSTEM REQUIREMENTS
       SUTRA-GUI is compiled for use with Argus ONE version 4.0, or later,
       on personal computers running Microsoft Windows 9x or NT.

DOCUMENTATION
       Voss, C.I., Boldt, David, and Shapiro, A.M., 1997, A graphical-user
          interface for the U.S. Geological Survey's SUTRA code using Argus
          ONE (for simulation of variable-density saturated-unsaturated
          ground-water flow with solute or energy transport): U.S.
          Geological Survey Open-File Report 97-421, 106 p.

RELATED DOCUMENTATION
       Voss, C.I., 1984, A finite-element simulation model for saturated-
          unsaturated, fluid-density-dependent ground-water flow with
          energy transport or chemically-reactive single-species solute
          transport: U.S. Geological Survey Water-Resources Investigations
          Report 84-4369, 409 p.

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://water.usgs.gov/software/

       and via anonymous File Transfer Protocol (FTP) from:

                   water.usgs.gov (path: /pub/software).

       The WWW page and anonymous FTP directory from which the SUTRA-GUI
       software can be retrieved are, respectively:

                   http://water.usgs.gov/software/sutra-gui.html
                                 --and--
                   /pub/software/ground_water/sutra-gui

       If you would like to obtain the price of and (or) order paper copies
       of USGS reports, contact the USGS Branch of Information Services at:

                  USGS Information Services
                  Box 25286
                  Denver Federal Center
                  Denver, CO 80225



                           21 Jan 1999                          2





sutra-gui(1)     U.S. Geological Survey (wrdapp)     sutra-gui(1)


       To inquire about Open-File Reports or Water-Resources Investigations
       Reports:
                  Tel: 303-202-4200; Fax 303-202-4695

       To inquire about other USGS reports:
                  Tel: 303-202-4700; Fax 303-202-4693

SEE ALSO
       sutra(1) - Saturated and (or) unsaturated, constant or variable-
                  density fluid flow, and solute or energy transport
                  (2-dimensional finite-element code)

       Related software:
       modflow-gui(1) - Preprocessor and postprocessor graphical-user
                        interfaces for preparing MODFLOW-96 input data and
                        viewing model output for use within Argus Open
                        Numerical Environments (Argus ONE)








































                           21 Jan 1999                          3