HTgnu(1) U.S. Geological Survey (wrdapp) HTgnu(1) NAME HTgnu - Visualization program for displaying the results of HYDROTHERM simulations ABSTRACT HTgnu is a menu-driven visualization program for use with HYDROTHERM (a.k.a. HT), the high-temperature, multiphase ground-water flow and heat transport modeling program. HTgnu reads in a plotout file created by HYDROTHERM and then uses the public-domain program Gnuplot to graphically display the results. There are four different types of plots available: (1) cross sections with flow vectors (for both steam and water) and contouring for up to three different variables; (2) variable versus time plots; (3) variable versus depth plot; and (4) variable versus lateral distance plot. Output is available to the screen, printer, as a postscript file, or as a file in a format compatible for importing into DOS- or Mac- based drawing programs. METHOD HTgnu provides a menu-driven interface between HYDROTHERM and Gnuplot, a public-domain graphing program. Gnuplot must be installed for HTgnu to work. Gnuplot will run on almost all types of platforms and is freely-available via ftp (see instructions in the file 'doc/get_gnu'). HTgnu is designed to quickly display the results from a HYDROTHERM simulation in any of four possible types of displays: (1) cross-sections with flow vectors (for both steam and water) and contouring for up to three different variables; (2) variable versus time plots; (3) variable versus depth plots; and (4) variable versus lateral distance plots. The parameters used to generate a plot can be saved so that a plot can be quickly redisplayed or used to examine subsequent HYDROTHERM simulations. It is also possible to save the Gnuplot instructions generated by HTgnu. HISTORY Version 2.2 1997/06/27 - HTgnu will now run with the latest beta version (3.6 beta 322) of Gnuplot. Other improvements include the capability to generate variable versus lateral distance plots and the ability to display 'cross-section' plots showing flow vectors and contouring for one-dimensional problems. See the "Whatsnew" file included with this distribution for a more detailed description of the modifications. The version numbers for HTgnu and HYDROTHERM parallel each other. Because HTgnu was first released with HYDROTHERM version 2.1, that is the first version number for HTgnu. INPUT REQUIREMENTS HTgnu requires an input file, named HTgnuplt_suffix, that was created specifically for HTgnu by HYDROTHERM. This file may be in either binary or ascii format (see the documentation for HYDROTHERM in either doc/doc.txt or doc/doc.ps). 7 Jul 1998 1 HTgnu(1) U.S. Geological Survey (wrdapp) HTgnu(1) OUTPUT OPTIONS Output is available to the screen, printer, as a postscript file, or as a file in a format compatible for importing into DOS- or Mac- based drawing programs. SYSTEM REQUIREMENTS HYDROTHERM is written in Fortran 77 with the following extensions: use of include files, use of 'D' in column one to designate debug statements, DO WHILE and ENDDO statements, greater than 19 continuation lines, intrinsic functions GETARG, DFLOAT, and SYSTEM, reference to compiler-dependent system date and time routines, and variable names longer than 6 characters. Most of the development and testing was done on a Silicon Graphics Iris Indigo and Indigo2 workstations. Generally, the program is easily installed on most UNIX computer systems. DOCUMENTATION HTgnu was used to create the plots published in the following paper: Hayba, D.O., and Ingebritsen, S.E., 1997, Multiphase groundwater flow near cooling plutons: Journal of Geophysical Research, v. 102, no. B6, p. 12,235-12,252. TRAINING Ground Water in Geologic Processes (GW3003TC), offered annually at the USGS National Training Center. CONTACTS Operation: U.S. Geological Survey Dan Hayba 956 National Center Reston, VA 20192 dhayba@usgs.gov 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). 7 Jul 1998 2 HTgnu(1) U.S. Geological Survey (wrdapp) HTgnu(1) The WWW page and anonymous FTP directory from which the HYDROTHERM software can be retrieved are, respectively: http://water.usgs.gov/software/hydrotherm.html --and-- /pub/software/ground_water/hydrotherm 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: U.S. Geological Survey Branch of Information Services Denver Federal Center, Box 25286 Denver CO 80225-0286 To inquire about Open-File Reports or Water-Resources Investigations Reports: Tel: 303-202-4210; Fax 303-202-4695 To inquire about other USGS reports: Tel: 303-202-4700; Fax 303-202-4693 7 Jul 1998 3