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)