README                                                    Mar. 6, 2014


                    Utility PIE - Version: 1.10.1.0 2014/3/6
     Programs for Simplifying the Analysis of Geographic Information in 
     U.S. Geological Survey Ground-Water Models for use within Argus Open 
     Numerical Environments (Argus ONE)


For assistance, enhancement requests, or bug reports contact the
Richard B. Winston via e-mail sent to
rbwinst@usgs.gov.  See the file Utility\doc\Utilities.pdf for descriptions,
references, and additional contacts for this software.  Instructions for
installation and execution of this software are provided
below.

The Utility PIEs are implemented as plug-in extensions (PIEs) for use with
Argus ONE version 4.2, revision w or later. Although Argus ONE runs on a
variety of computing platforms, the PIEs are only available for systems 
running Microsoft Windows 9x, NT, ME, 2000, XP, Vistas, 7, or 8.


                         TABLE OF CONTENTS
                         
                         A. DISTRIBUTION FILES
                         B. INSTALLING
                         C. USING THE UTILITY PIES
                         D. COMPILING


A. DISTRIBUTION FILES

The following distribution files (containing the software and information
files) are currently available.

   Utility.zip       - Compiled using Borland Delphi 2006.
   Utility_All.zip   - Compiled using Borland Delphi 2006 (includes PIEs not 
     normally used directly by most users.
   UtilitySource.zip - Source code only

The above zip files must be unzipped using a utility that preserves long
filenames, such as PKZIP for Windows.  A shareware version of PKZIP for
Windows is available from PKWARE at this World Wide Web site:
      http://www.pkware.com/

and by File Transfer Protocol (FTP) from the following site:
      ftp.pkware.com 

Included in directory Utility\doc is a Portable Document Format (PDF)
version of the Utility PIEs documentation (Utilities.pdf).

PDF files are readable and printable on various computer platforms using
Acrobat Reader from Adobe.  The Acrobat Reader is freely available from
the following World Wide Web sites:
      http://www.adobe.com/
      http://www.shareware.com/
      
and by File Transfer Protocol (FTP) from the following site:
      ftp.adobe.com (path: /pub/adobe/acrobat)


B. INSTALLING

All the PIEs described in this report may be installed by placing the dynamic 
link libraries (dll's) in the Argus Interware\ArgusPIE directory or a subdirectory 
of it.  In cases where the PIE has a help system, the help system files (with the 
extensions.hlp and.cnt) must be placed in the same directory as the dll.  Normal 
practice is to create a subdirectory in the ArgusPIE directory with the same name 
as the dll except without the dll extension and place the files there.  For 
example, the Utility PIE would normally be installed as 
"Argus Interware/ArgusPIE/Utility/Utility.dll".  Some of the commands or functions 
described in this report are now implemented in the Utility.dll whereas previously 
they were implemented in several different dll's.  The new versions replace and 
often improve upon the previous versions so the dll's containing the previous 
versions must be removed when installing the new versions.  The dll's that have 
been replaced are EditContoursPie.dll, EditDataLayer.dll, GriddedImport.dll, 
JoinContoursPie.dll, MoreConversions.dll, EvalAtXY.dll, and RotateCells.dll.  If 
the conflicting dll's are not removed, the Utility.dll can not be used.  Two of 
these PIEs (JoinContoursPie.dll and MoreConversions.dll) were written by the author 
prior to joining the USGS.  Two of them (EditContoursPie.dll, RotateCells.dll) were 
documented as part of version 3 of the MODFLOW GUI (Winston, 1999).  Three more 
(GriddedImport.dll, EvalAtXY.dll, and EditDataLayer.dll) were documented as part of 
version 4 of the MODFLOW GUI (Winston, 2000).  

C. USING THE UTILITY PIES

After Utility PIEs are properly installed (see INSTALLING, above), the
plug-in extensions will be automatically loaded when Argus ONE is
launched.

Commands may be selected from the PIEs menu.
Functions may be selected from the Expression Editor.
Interpolation methods may be selected in the Layers dialog box.

D. COMPILING

The Utility PIEs may be compiled with Borland Delphi Professional 2006 
However, it uses a number of freeware components that are not distributed with 
Borland Delphi 2006. These include

TArgusDataEntry by Richard B. Winston,
TRBWZoomBox by Richard B. Winston,
TRBWDataGrid3d by Richard B. Winston,
TRbwDynamicCursor by Richard B. Winston,
TRbwQuadTree by Richard B. Winston,
TRbwOctTree by Richard B. Winston,
TRbw95Button by Richard B. Winston,
TASLink copyright Andrey Abakumov, 
TDataGrid 2.0 copyright EC Software, and
TCheckBox95, TRadioButton95 Copyright PA van Lonkhuyzen http://home.global.co.za/~peterv/index.htm
TVirtualStringTree by Mike Lischke http://www.lischke-online.de
Windows XP Theme Manager by Mike Lischke http://www.lischke-online.de
Various files from the Jedi-Jvcl components: http://jvcl.delphi-jedi.org/

Except for the Jedi-Jvcl components, TVirtualStringTree and the Windows XP Theme Manager components, 
the source code for these components is distributed along with the source 
code for the Utility PIEs. These components must be installed before 
attempting to open or compile the Utility PIEs. In some cases, the components 
have been modified to work better with the Utility PIEs.

The source code for these components is distributed, with permission of 
the copyright owners, along with the source code for the Utility PIEs. 

The help files for the Utility PIE was compiled with Help Scribble.
http://www.jgsoft.com/