GEODAS Version 4.1.16 for Xwindows   5/16/2003

GEODAS Software is used to access the data on your CD product.

This describes installing and running the UNIX XWindows version of GEODAS

NOTE: Users of GEODAS Custom Data CD:
      This install is for Linux-PC Xwindows users. You will be able to
      use GEODAS programs Hydro-Plot and Coastline Extractor with your
      GEODAS Custom Data CD.
      
NOTE: GEODAS uses the Tool Command Language Tcl/Tk 8.x
      You must have Tcl/Tk 8.0 or better installed on your computer. (It may
      already be installed.)  To find out how you can put Tcl/Tk on your
      computer visit these web sites:

      dev.scriptics.com/ (Tcl Developer Xchange)
      tcltk.com/sourceforge/ (Tcl/Tk at Sourceforge)

***********************************
Installing GEODAS Onto Your System:
***********************************

1. Obtain GEODAS for XWindows Install software:
   On the GEODAS SETUP cd in subdirectory /your-cdrom-path/setup/xwindows/gd_4116.tgz
   Or NGDC ftp site: ftp.ngdc.noaa.gov/MGG/geodas/software/xwindows/gd_4116.tgz
   note: users downloading from the ftp site who do not have any version 4.1 GEODAS
   CD sets (only version 4.0 sets) must also download the newest coastlines files at:
   ftp.ngdc.noaa.gov/MGG/geodas/coastlines/coast41.tgz
   (see readme_c.txt for instructions)

2. Copy or ftp the file to your hard drive.

3. Unzip and Untar the file (this will create dir geodas_install)
   > tar -zxvf gd_4116.tgz
   (some systems may need 2 steps i.e. >gunzip gd_4116.tgz and >tar -xvf gd_4116.tar)

4. Change to the geodas_install subdirectory.

5. Run the install program
   > ./geodas-install

   Respond to the program queries. Users will need read/execute permissions to
   the "GEODAS Executables" and "GEODAS Support" directories.

   Running GEODAS causes various data files to be created. These are written to the  
   user's "work" directory. The default is ~/geodas/work but you can choose a  
   different directory during installation. This can be changed later by running 
   program geodas-setup (see Configuring GEODAS below).

   For some installations you do not have to install various inventory files. These 
   include the GEODAS Coastlines (41.9 MB), Marine Trackline Geophysics Inventory
   (30.2 MB) and NOS Hydrographic Surveys Inventory (13.2 MB). This will save some 
   disk space, but the software will run slower and you will need to mount the 
   appropriate GEODAS SETUP CD when running GEODAS Data Search and Retrieval.

7. Delete the install directory (geodas_install) and file gd_4116.tgz.

8. If you do not have one of the operating systems with pre-compiled binaries (Solaris
   and Linux-x86 at this time) you must build the binaries from source. See file
   [geodas-support-path]/source/readme.txt for details.

9. For GEODAS Gridded Databases only, you must set your Browser MIME type as follows:
   (open Netscape Navigator)
   Edit -> Preferences
   Category: Navigator -> Applications -> New ->
     Description: GEODAS Grid Data
     MIMEType: application/x-geodasgrid
     Suffixes: g03,g15,g30,g98
     Application -> (check): [geodas-executable-path]/geodas-gridtran
   OK -> OK

Note that GEODAS install must be run for each GEODAS SETUP cd which you have.
At this time available cds include:
   Marine Trackline Geophysics
   NOS Hydrographic Surveys
   NGDC Coastal Relief Model Vol. 01
   NGDC Coastal Relief Model Vol. 02
   NGDC Coastal Relief Model Vol. 03
   NGDC Coastal Relief Model Vol. 04
   NGDC Coastal Relief Model Vol. 05
   NGDC Coastal Relief Model Vol. 06
   NGDC Coastal Relief Model Vol. 07
   NGDC Coastal Relief Model Vol. 08
   Great Lakes Bathymetry Vol. G1 (Lake Erie and Lake St. Clair)
   Great Lakes Bathymetry Vol. G2  (Lake Ontario)
   ETOPO2 Global Gridded Elevations Vol. E1

Note especially that for the Coastal Relief Model and Great Lakes Bathymetry datasets,
each volume must be installed seperately.

NOTE: Once installed, you may configure or change some aspects of the GEODAS software 
      by running program geodas-setup from the command prompt (see Configuring GEODAS).




   
***************
Running GEODAS:
***************

Start the GEODAS Launch Pad by typing geodas at the command prompt of your xterm
window.

  >geodas (or ./geodas from [geodas-executable-path]/ if not in your PATH)

Click the GEODAS icon you wish to run. These icons represent various GEODAS
Applications/Databases.  Note that only those programs and databases which you
have installed will be visible.
The GEODAS Applications are:
   GEODAS Data Search and Retrieval
   NGDC Coastal Relief Model
   Great Lakes Bathymetry
   ETOPO2 Global Gridded Elevations
   GEODAS Grid Translator
   GEODAS Coastline Extractor
   GEODAS Help System


******************
Configuring GEODAS
******************

After installing GEODAS you can configure the software by running program 
geodas-setup from the command prompt.

> geodas-setup

This will bring up the GEODAS Install/Setup program, the same program used for 
Installation, but with some options changed. This can be used to change your CD
location, Browser Command, Print Command and the user work directory, and also
to add additional GEODAS Databases. If you are the original "installer" this
will change the main configuration file(s). If you are a user in a multi-user
GEODAS setup, and have your own configuration file(s) in your HOME/geodas
directory, this will change your "user" geodas.cfg file (see Note 2 below).

Note 1: You cannot use geodas-setup to update the GEODAS software.

Note 2: In a multiple-user GEODAS setup, if a user wants to have their own  
        configuration file(s), they can copy geodas.cfg (and geodas.ini for
        Linux users) from the [geodas-executable-path]/ path to their
        HOME/geodas/ subdirectory. This configuration file will be used when
        that user runs GEODAS. But remember that New Databases added to the
        GEODAS System by the administrator will not be automatically added to
        this "user" configuration file(s). The administrator should install any
        new GEODAS Databases and then the "user" can re-copy geodas.cfg (and
        geodas.ini) to HOME/geodas/ subdirectory.


*******************
Additional Programs
*******************

There are 2 utility programs installed by GEODAS. Simply type the program name
at the command prompt.

geodas-gridlist will list the contents of a NGDC Binary Formatted Coastal Relief Model Grid.

geodas-hdrecs77 will combine separate MGD77 Headers and MGD77 Data files into a single file.



********************
Technical Assistance
********************

Dan.R.Metzger@noaa.gov (303-497-6542)

John.G.Campagnoli@noaa.gov (303-497-3158)

