README FILE

The most frequent GeoTool error reported to date, is a missing add-in or reference library in the user's Visual Basic for Application installation.  The following files are necessary for proper GeoTool execution: 

(1) Visual Basic For Applications, 
(2) Microsoft(r) Excel 9.0 Object Library, 
(3) OLE Automation, 
(4) Microsoft(r) Office 9.0 Object Library, 
(5) Microsoft(r) Forms 2.0 Object Library, and 
(6) Solver.  

The Analysis ToolPack, Analysis Toolpack-VBA, and Solver Add-Ins should be installed under the Excel --> Tools --> Add-Ins tool bar.  Additional errors may be generated during code execution if all available service packs from Microsoft(r) have not been installed for the user's version of Excel.

These files should be checked in the Visual Basic for Applications editor under the "Tools/References" menu.  If any of these files are listed as "MISSING" it will cause a run-time error in GeoTool.  To fix this error uncheck the "MISSING" close and restart the program.

There are a number of variations on SWMM programs as well as HSPF programs and, therefore, there will be circumstances for which an input file may generate an error in GeoTool.  The input conditions for these types of files are very specific to a format expected.  In this event, please contact David Raff at draff@do.usbr.gov with specific information about the version of the program used to generate the input file and send this information along with the input file to the e-mail address above.  Another option is to convert your SWMM or HSPF file into a GeoTool default file. 

In the event that an error occurs during operation of GeoTool and it is not addressed within this user's manual, please contact David Raff at draff@do.usbr.gov or Brian Bledsoe at Brian.Bledsoe@ColoState.edu.  Please include as much information as possible in your message in addition to the "log.out" file, which GeoTool creates in your base directory.  For Windows users, the base directory is most likely your "My Documents" folder unless you have changed the default settings. 
