BASINS 3.0 June 2001 Installation Notes The BASINS 3.0 system installation package contains the new BASINS Version 3.0 system and tutorial data set. The installation package is available on CDs or can be downloaded from http://www.epa.gov/ost/ftp/basins/system/BASINS3. Although BASINS 3.0 remains ArcView-based, the BASINS system architecture has been completely reengineered. Unlike its predecessor, all customized components of BASINS 3.0, such as model interfaces, data management utilities, and watershed assessment tools, are developed as BASINS extensions, thereby providing users the capability to load only the extensions needed for their BASINS project. The new architecture also allows the system to support several levels of hardware and software sophistication. For example, users might not need to acquire Arcview's Spatial Analyst extension if they do not intend to use BASINS components that require Spatial Analyst. For the developers, it will be easier to maintain and provide updates of the individual extensions rather than issuing a new version of the entire system. This makes it also easier for the users to upgrade their system. What's New in BASINS 3.0. The following components are new in BASINS 3.0 - An automatic delineation tool that allows users to automatically delineate watersheds based on Digital Elevation Model (DEM) data layer. This component requires Spatial Analyst. - A significantly enhanced manual delineation tool that provides users additional flexibility in editing shapes and attributes of the manually delineated watersheds. - A new interface for the HSPF model which fully supports the MASS-LINK, SCHEMATIC and SPECIAL ACTIONS block of the UCI File. This interface also directly reads HSPF UCI files. - A watershed model called Soil Water Assessment Tool (SWAT), developed by the U.S. Department of Agriculture's ARS. The SWAT model can be used to simulate transport of nutrients, pesticides and sediments in the watershed, along the channels and through reservoirs. The SWAT interface is completely developed in ArcView and requires Spatial Analyst. - An HSPF postprocessor and scenario generator called GenScn originally developed for the U.S. Geological Survey. GenScn allows users to manage, visualize, analyze, and compare the results of several HSPF simulations. GenScn also allows visualization of SWAT output and observed Water Quality data. - A time series data management utility called WDMUtil, developed by U.S. Environmental Protection Agency. This utility can be used to create WDM files for the HSPF model. - A model called PLOAD, developed by CH2M-Hill which uses Export Coefficients to estimate watershed loading. - A theme manager that allows users to easily add or delete auxiliary data from the BASINS project. For BASINS 3.0, the BASINS database was split into two groups of data, core and auxiliary data. Auxiliary data are not directly used by any of the BASINS components. - A grid projector that extends ArcView projection tool to also project grid data. This component requires Spatial Analyst. - Improved versions of the report and data import tools. - A completely redesigned PCS database in which loading data are now grouped not by year but by cataloguing units (similar to the water quality observation data). The PCS database is also completely refreshed to include most recent set of active and inactive stations, more accurate locational data, and annual load data until 1999. - DEM (grid format) data included in the distribution CD. - An NHD download tool that allows users to download NHD data layers from the USGS web site and import them to the BASINS project using the correct projection. - Capability of using the new MultiResolution Land Cover (MRLC) data (grid format) with the watershed models. The BASINS extensions are managed through the BASINS Extension Manager. The Extension Manager is accessed through the 'BASINS Extensions' choice under the 'File' menu, or by pressing Ctrl-B. System Requirements: BASINS Version 3.0 is a customized ArcView GIS application that integrates environmental data, analysis tools, and modeling systems. Therefore, BASINS' hardware and software requirements are, at a minimum, similar to those of the PC-based ArcView 3.1 or 3.2 system. BASINS can be installed and operated on IBM-compatible personal computers (PCs) equipped with the software, random access memory (RAM), virtual memory, and hard disk space presented in the table below. Because the performance (response time) under the minimum requirements option might be too slow for some users especially when dealing with large data sets, a preferred set of requirements is also included in the table. In BASINS 3.0, the ArcView Spatial Analyst software is required if the user intends to use the automatic delineation tool and/or SWAT. This software is not included with ArcView and must be obtained separately. Minimum Hardware and Software Requirements Processor: 166-MHz Pentium processor Available hard disk space: For a single 8-digit watershed (cataloging unit), allow for 300 MB (50 MB for BASINS system, 150 Mb for BASINS Environmental Data, and 100 Mb of free operating space for storage of generated themes and tables). Random access memory (RAM): 64 MB of RAM plus 128 MB of permanent virtual memory swap space Compact disc reader: Quad speed reader (one-time use) Color monitor: Configured for 16 colors, Resolution 1024x768 Operating system: Windows 95, Windows 98, NT, 2000, or Me (Note: QUAL2E not compatible with NT/2000/Me) ArcView: ArcView Version 3.1 or ArcView version 3.2 and/or Spatial Analyst Version 1.1 (Spatial Analyst required by some BASINS extensions) Microsoft Excel 97/2000 is recommended for use with the PLoad extension. Internet Explorer 5.0 or newer to view help files Preferred Hardware and Software Requirements Processor: 300-MHz Pentium processor Available hard disk space: 2.0 GB (50 MB for BASINS system, 750 MB for BASINS environmental data for approximately 1 state, and 1.2 GB of free operating space for storage of generated themes and tables). Random access memory (RAM): 128 MB of RAM plus 256 MB of permanent virtual memory swap space Compact disc reader: 24X reader (one-time use) Color monitor: Configured for 256 colors, Resolution 1024x768 Operating system: Windows 95, Windows 98, NT, 2000 or Me (Note: QUAL2E not compatible with NT/2000/Me) ArcView: ArcView Version 3.1 or ArcView version 3.2 and/or Spatial Analyst Version 1.1 (Spatial Analyst required by some BASINS extensions) Microsoft Excel 97/2000 is recommended for use with the PLoad extension. Internet Explorer 5.0 or newer to view help files Prior to Installation: BASINS 3.0 installation will OVERWRITE previously installed versions of BASINS located on the destination drive. To save an existing version of BASINS, rename the BASINS directory (e.g. BASINS_old) prior to running the new installation program. If you have already installed earlier versions of GenScn, WDMUtil or HSPFParm, uninstall all of them before running the BASINS 3.0 installation. When the uninstaller asks whether to remove shared system files, the following system files should be removed and will be reinstalled with the new distribution: AT*.ocx, HASS*.dll (there may be one or more files following these patterns) After uninstalling previous versions of GenScn, WDMUtil or HSPFParm and before installing new ones, it is a good idea to look in your windows system directory (c:\windows\system for Win95 or Win98, c:\winnt\system32 for WinNT) and verify that files AT*.ocx and HASS*.dll are deleted. BASINS 3.0 Installation The BASINS 3.0 installation has been revised to install all components at once, including the BASINS System and tutorial data set, GenScn, WinHSPF, and WDMUtil. On a Windows NT machine, be sure you have administrator privileges before starting the installation. 1. To install BASINS 3.0 from the CD, insert the BASINS 3.0 Installation CD. The previous auto run function has been removed. To start the BASINS installation, run the setupwizard.exe file from the root directory of the CD. 2. If you are downloading the installation package from the web site, you will have to download all the zipped files and unzip them into a single directory (e.g. do not name the directory BASINS). Run the setupwizard.exe file to start installing BASINS. 3. The setup wizard installation window provides three options (1) Install BASINS 3.0 System, (2) "View Installation Notes", and (3) Exit. Select the "Install BASINS 3.0 system" to install the BASINS GIS system and tutorial data set. GenScn, WinHSPF, and WDMUtil will automatically be installed also. 4. The next dialog will have check boxes to select components to install, Program Files and Tutorial. It is recommended that you install both components. The Data Extraction program can be used later to install the specific data sets you need to work with. 5. The next dialog will prompt you to select a hard drive where BASINS will be installed. After you select a drive, setup will create a BASINS directory containing the completed BASINS 3.0 system and Tutorial data set. 6. For the remaining dialogs, use the default values provided. 7. Once the BASINS System installation is complete, the Installation of GenScn, WinHSPF, and WDMUtil will start automatically. It is recommended that you use the default values in each of the dialogs in the installation procedure. In the "Select Components" dialog, you may choose not to create desktop icons for these programs. GenScn is required to analyze model output from SWAT and HSPF. WDMUtil is also provided but it is not required to be able to use the full functionality of BASINS 3.0. You may need to restart Windows after some files have been updated before continuing with the installation. Note: WinHSPF is included with the GenScn installation. The help files in this package require Internet Explorer 5.0 or newer. If you get a message about needing a newer version of hhctrl.ocx or if help is not working, you also need to download and run: http://hspf.com/pub/misc/hhupd.exe Occasionally, instead of starting to install the intended program, another program's installation will be started or a previous version of this program's installation will be started. We have been unable to experiment with this phenomenon, but we suggest moving the new installation program into an empty directory and deleting old setup programs from your temporary directory before trying again. Since some new system files are included in this release, you may need to restart Windows after some files have been updated before continuing with the installation. On the other hand, you may have some newer files already installed than are included here, so when it says "The file you are about to install is not newer" you should answer "Yes" you want to keep the file. If you have already installed an earlier version of GenScn, uninstall it before installing this new version. If you have installed a version of WDMUtil or HSPFParm before 1.0b5, uninstall the earlier version before installing this version. If you need to run one of these other programs on the same machine, contact the person who gave you the other program for a new version. When un-installing, you may be asked whether to remove shared system files. The following system files should be removed and will be reinstalled with the new distribution: AT*.ocx, AT*.dll, HASS*.dll, MOLT*, Shape.dll (there may be several files following these patterns) It should be safe to answer "Remove All" and let the system figure out which files are safe to remove. If you are using MapObjects LT in a development environment, you will need to reinstall it after installing this program because of a quirky licensing scheme used by ESRI. BASINS Project Builder (Build.exe): Once BASINS has been installed, you will have to create a BASINS project using the Project Builder (build.exe in the BASINS/ETC folder). You may run the Project Builder by selecting "Project Builder" from the BASINS Start Menu. In the File Dialog that appears, select the \BASINS\Data\Tutorial data folder for the "Dataset to be used" entry field. Enter any name for the "ArcView Project File Name" entry field. Click the "Create" button to create the new BASINS project. Opening and Running the BASINS Project 1. Open the new BASINS project by selecting BASINS from the BASINS Start menu and selecting the new "project name.apr" file. 2. Initially, the customized extension to load BASINS-specific themes is turned on. These themes include (watersheds, Landuse, RF3, NHD Reach files, and DEM shape files. You will need to use the 'BASINS Extensions' choice under the 'File' Menu (or press Ctrl-B) to load other BASINS extensions. System Documentation The documentation (DOCS) directory on the CD contains the HTML Help and PDF versions of the BASINS 3.0 User manual, GenScn help files, and HSPF, QUAL2E and SWAT user manuals. In addition, a MISC folder under the DOCS folder contains useful information for downloading and using USGS Flow and MRLC Data. Known Issues/Bugs 1. You cannot use the Save As... command in BASINS. BASINS projects include some hidden files that track progress. Using the Save As... command causes the new project to lose its connection to these hidden files. The Save As... menu choice has been hidden on all GUIs. 2. While the project builder allows you to overwrite an existing project, always build a new project (e.g. select a new project name). 3. A Segmentation Violation may occur when using the Data Mining tool with PCS data. The Segmentation Violation does not appear to affect the success of the data mining procedure or to corrupt the project. 4. QUAL2e does not work on NT systems. 5. A Segmentation Violation may occur when using the Land Use and Soil Definition tool, when loading the Landuse or Soil grid using the Shape format option. Violation does not appear to affect the success of the procedure or corrupt the project." 6. A Segmentation Violation may occur when running the Data Mining Tool for PCS. However, it appears that the performance of the feature is not affected. GenScn, WinHSPF, WDMUtil Readme/FAQS Q: I started GenScn (or WinHSPF, WDMUtil) from BASINS but nothing happened. A: GenScn is probably hiding behind BASINS, minimize the BASINS windows. If you still don't see GenScn, open the Windows Task Manager and Switch To GenScn. Q: I exited from GenScn (or WinHSPF, WDMUtil) and the following Status Monitor Message Box appeared: Error Terminating Process, Use Task Monitor to End Process, x:y:zzz. A: Close any GenScn windows still open. Then, open the Windows Task Manager, check to see if GenScn is still running. If so, please report the circumstances to jlkittle@aquaterra.com. Q. Where is HSPFParm? A. HSPFParm program can be copied from the HSPFParm folder of BASINS CD#1. This program provides HSPF modelers access to an interactive database which contains HSPF parameter values from previous HSPF applications across North America. Modelers can use these values as a possible starting point for parameterizing HSPF model for new watershed applications. BASINS Team Key Contact Information: Russell Kinerson, EPA OST kinerson.russell@epa.gov David Wells, EPA OST wells.david@epa,gov Henry B. Manguerra, Tetra Tech, Inc. manguhe@tetratech-ffx.com Jack Kittle, Aqua Terra, Inc. jlkittle@aquaterra.com Mauro Di Luzio, Texas A&M Univ. diluzio@brc.tamus.edu