Thank you for choosing to demo the OS/2 version of the Environmental
WorkBench!

I.    Overview
II.   What's The Catch
III.  Legal Stuff
IV.   System Requirements
V.    Installation Instructions
VI.   Creating Your Own Data (MeRAF)
VII.  Getting Started
VIII. Problems
IX.   How to contact SSESCO


I.    Overview

  The Environmental WorkBench is a suite of integrated applications for
  processing Environmental Data.  It was developed for scientists and
  engineers who need to analyze and visualize large datasets and communicate
  the information in a highly productive environment.  The Environmental
  WorkBench is designed to easily interface to many models and monitoring
  sources.  This allows the user to explore data concerning underground
  pollution and air dispersion activities without learning any additional
  tools.  Only one, easy to use interface is required to visualize and 
  explore any environmental data that is required or of interest.  In a 
  matter of hours, a new user can effectively be using the EWB to explore
  data, understand what the data represents and communicate to others easily
  and more effectively.

  Unique Features:  Visualization products are not a new capability for 
  computers.  Savi3D, however, brings a new dimension of capability: the 
  ability to interactively, visually and dynamically explore a large 3D 
  data set.  No more capturing single images then trying to animate them.  
  Now you can watch the images change as you move through time.  The 
  product is a C++ application employing object oriented development 
  techniques. The 3D graphics use the emerging OpenGL standard which is 
  supported on all popular PC and UNIX platforms.

  The user is able to see what has occurred over time, as well as model and
  predict what will happen in the future.  This brings new and greater 
  understanding to the discussion and remediation of pollution concerns.
  Exploration and understanding is easier and quicker to grasp and the 
  communication to regulators, management, customers and the legal 
  communities will be much more effective, precise, accurate and 
  understandable.  The environmental engineer can do a better job in less
  time.  Their customer gets a better definition and understanding of the
  problem and the remediation solution can be defined and monitored to 
  insure the solution is optimized.  Everyone will benefit since all will
  be able to really understand the problem, the solution and the progress
  being made to solve the problem. 
  
  The Primary Customer will be the environmental engineer trying to 
  understand and gain approval for a plan to remediate an existing 
  pollution problem or prevent future pollution or effectively communicate
  issues related to either a real pollution problem described by real data
  or future concerns described by modeling.  Current and future uses are : 
   - Litigation of pollution cases have already been shown to benefit
     from the use of the product and will generate additional usage by
     environmental engineers as well as specific industrial customers. 
   - Federal and University researchers studying and predicting 
     environmental trends or working on remediation technologies 
     represent a significant customer base. 
   - Regulatory agencies, interested public or private entities and 
     individuals will also purchase the product to better understand 
     the issue of interest, and more effectively communicate their 
     position or proposed solution.  


II.   What's The Catch

  Q.  What am I not getting in this demo version?
  
  A1. Support, of course.  Purchasing the full version gives you
      access to telephone and e-mail support.  We will consider
      creating an e-mail mailing-list for demo customers if interest
      is significant.
      
      Demo customers are welcome to provide us with bug reports and
      feedback.
  
  A2. This version of EWB can only read data files that SSESCO decides
      should be readable by the demo.  Naturally, the tutorial files
      are readable by the demo version.  We plan to distribute other
      data files that are of more interest and make them readable by
      the demo version.  Basically, you can't create your own data
      files and read them using this version of savi3D.  
      
  A3. Documentation.  This version only contains documentation for
      the tutorial.  Purchasers of the full program will receive
      full documentation.
      
  To purchase the full version of the Evironmental WorkBench, contact
  Kent Steiner at 612-481-0804.  We'd appreciate it.
      
     
III.  Legal Stuff

  Copyright (c) 1996 Supercomputer Systems Engineering and Services 
  Company.  All rights reserved.
  
  SOFTWARE LICENSE NOTICE
  The software described on this web page is furnished under a license
  agreement and may be used only in accordance with the terms of that
  agreement.  Any unauthorized duplication or use of savi3D, in whole 
  or in part, in print, or in any other storage and retrieval system is 
  prohibited.
  
  LICENSES AND TRADEMARKS
  The names savi3D, EWB, SSESCO, and the Environmental WorkBench are
  trademarks of Supercomputer Systems Engineering and Services Company.
  ShowME, ToolME, and dlg_extract are copyrights of Supercomputer Systems
  Engineering and Services Company.  Other trademark names used in this
  document are the property of their respective owners and SSESCO makes
  no claim to them.

  GOVERNMENT RESTRICTED RIGHTS
  The EWB program and documentation are provided with RESTRICTED RIGHTS.
  Use, duplication, or disclosure by the Government is subject to
  restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in
  Technical Data and Computer Software clause at DFARS 252.227-7013 or
  in subparagraphs (c)(1) and (2) of the commercial Computer Software --
  Restricted Rights at 48 CFR 52.227-19, as applicable.
  
  LIMITED WARRANTY
  Supercomputer Systems Engineering and Services Company makes no
  warranties, express or implied, including without limitation the 
  implied warranties of merchantability and fitness for any particular
  purpose, regarding the software.  SSESCO does not warrant, guarantee 
  or make any representations regarding the use or the results of the 
  use of the software in terms of its correctness, accuracy, reliability,
  or otherwise.  The entire risk as to the results and performance of
  the software is assumed by you. Because the exclusion of implied 
  warranties is not permitted by some states the above exclusion may not 
  apply to you.
  
  In no event will SSESCO and their directors, officers, employees or
  agents be liable to you for any consequential, incidental or indirect
  damages (including damages for loss of business profits, business
  interruption, loss of business information and the like) arising out
  of the use or inability to use the software even if SSESCO has been
  advised of the possibility of such damages.  Because some jurisdictions
  do not allow the exclusion or limitation of liability for consequential
  or incidental damages, the above limitations may not apply to you.  

  NOTE:  EWB is packaged using Info-ZIP's compression utility.  The
  installation program uses UnZip to read zip files.  Info-ZIP's software
  (Zip, UnZip and related utilities) is free and can be obtained as
  source code or executables from various anonymous-ftp sites, including
  ftp.uu.net:/pub/archiving/zip/*.
  
  Whew!


IV.   System Requirements

  A minimum system for running the Environmental WorkBench would be:
      Processor: 486DX
      Memory:    16MB RAM
      OS:        OS/2 2.1
      Video:     1024x768x256
    
  The Environmental WorkBench is a very processor intensive program.
  It will run fine on a 486DX, but will improve dramatically when
  making use of faster processors.

  Due to limitations in the OpenGL drivers, the screen resolution
  must be set to exactly 1024x768.  The color depth must be either
  256 color or 16 million color.  IBM has provided us with more
  up-to-date drivers that eliminate these restrictions.  We expect
  to eliminate these restrictions in our next release.

  A VESA or PCI local bus for the video card is highly recommended.


V.    Installation Instructions

  It is assumed that you have either received this distribution on
  floppy disks or as a zipfile archive.  Please choose the method
  appropriate with your distribution.

  FLOPPY INSTALL:
  - Insert disk1 into the drive.
  - Go to the floppy drive by typing A: (or B: if that's where your
    floppy drive is).
  - Type INSTALL
  - Read the readme file displayed.
  - Select Install Product from the Action menu
  - Choose the destination directory and Continue
  - It is highly recommended that you allow the install program to
    update your config.sys for you.  A backup will be made automatically.
  - As you are prompted for diskettes, place the appropriate diskette
    into the floppy drive.
  - Remove the floppy from the floppy drive.
  - Shutdown and reboot your computer

  HARD DISK INSTALL
  - Unzip the archive
  - Change into the disk1 directory
  - Type INSTALL
  - Read the readme file displayed.
  - Select Install Product from the Action menu
  - Choose the destination directory and Continue
  - It is highly recommended that you allow the install program to
    update your config.sys for you.  A backup will be made automatically.
  - As you are prompted for diskettes, enter the correct directory name.
  - Shutdown and reboot your computer
  
  Config.sys:
  If you choose not to have the install program modify your config.sys
  for you, you will need to make the following changes:
  
  The CONFIG.SYS file is located in the root directory of your boot
  drive.  You can use E.EXE as an editor to edit the config.sys
  file.  For the sake of explanation, we will assume that you 
  installed the product into C:\EWB.

  - It's required that C:\EWB\DLL be added to your LIBPATH line
  - It's required that you set the SAVI_PATH environment variable
    to C:\EWB\SAVI3D_2.0
  - It's recommended that C:\EWB\SAVI3D_2.0 be added to your PATH line


VI.   Creating Your Own Data (MeRAF)

  The Environmental WorkBench makes use of the NetCDF based MeRAF file
  system for data storage.  The MeRAF package is available, at no charge,
  from the SSESCO FTP site (ftp.ssesco.com).  If you do not have FTP
  access, please contact SSESCO for alternate means of obtaining the
  package.
  
  The MeRAF package includes a full set of C, Fortran and C++ libraries 
  for managing your data.  Structures supported include 2D grids, 3D 
  grids, moving grids, particles, set-of-points, and soon to support 
  TIN grids.
  
  The package also includes tools designed to convert your ASCII 
  data into the MeRAF format.  If the tools supplies are not able
  to do the conversion, contact SSESCO for assistance.
  

VII.  Getting Started

  The online documentation is implemented using the popular HTML
  format.  It can be read using any graphicsl HTML compliant browser
  (tested with WebExplorer, Mosaic, Internet Explorer and Navigator).
  For you OS/2 users, that's likely to be WebExplorer.  WebExplorer
  comes with OS/2 Warp.  We recommend you update to the latest
  version.  Updates can be found at hobbes.nmsu.edu.
  
  Use your browser to open the HELP.HTM file in the EWB\tutorial
  directory. This document will guide you through the tutorial.  
  The tutorial demonstrates some of the more basic features of
  savi3D.  After finishing the tutorial, start experimenting with
  more advanced features (hit that Option button).  Before
  long, you'll be no less than an expert.


VIII. Problems

  Make sure of the following:

  - You must have a DEVICE statement in your CONFIG.SYS file set to
    either SSMDD.SYS (OS/2 3.0 Warp) or SMVDD.SYS (OS/2 2.1).  If
    this does not exist, the best way to handle it is to install
    multimedia support.
 
  - Your video is running at exactly 1024x768 with 256 (8 bit) colors
    or 16 million colors (24 bit).  You may want to check the following
    Internet sites for more recent video drivers for your video card:
      http://www.europe.ibm.com/getdoc/psmemea/progserv/device (All)
      ftp://ftp.software.ibm.com/ps/products/os2/drivers (All)
      ftp://ftp.nine.com (Number Nine)
      ftp://ftp.atitech.com (ATI)
      ftp://ftp.diamondmm.com (Diamond Multimedia)
     
  - Make sure that the EWB DLL directory is set in your LIBPATH in your
    CONFIG.SYS.  See the "Installation Instructions" section for more
    detailed information.
    
  - Make sure that the SAVI_PATH environment variable is properly set
    in your CONFIG.SYS. See the "Installation Instructions" section
    for more detailed information.
   
  It should be noted that there are two log files located in the SAVI3D_2.0
  directory (savi3D.log and saviWIN.log).  These files contain information
  that may make it easier to debug any problems with running the program.


IX.   How to contact SSESCO

  The person you want to speak to is our Sales Manager, Kent Steiner.
  He can be reached via the following methods.

  Mail:  3490 Lexington Avenue North, Suite 110, Shoreview, MN 55126
  Phone: (612) 481-0804
  Fax:   (612) 481-0053
  Email: info@SSESCO.com
  Web:   http://www.SSESCO.com
