------------------------------------------------------------
          GMTMAP help file
----------------------------------- 10 May 2000 - LO -------

------------------------------------------------------------
Introduction
------------------------------------------------------------

GMTMAP is a script to produce epicenter maps using GMT. 
The main features are:

- automatically scale the map to fit a selected region on a 
  seleceted media size
- plot epicenters from input file (Seisan Nordic format or 
  finger quake@... input)
- magnitude and depth scaling
- topography maps
- projection supported: Mercator
- convert output files to: GIF, JPG
- display map image

This is the first version of GMTMAP, so dont get frustrated. Comments
are very welcome.

The script is written by:

Lars Ottemoeller
Inst. of Solid Earth Physics
University of Bergen
Norway
email: larso@ifjf.uib.no


------------------------------------------------------------
Installation
------------------------------------------------------------

GMTMAP only works on Unix. You need to have Expect and GMT 
installed on your system. For conversion, the ImageMagick
software package is needed. For viewing, you need some tool
like ghostview or ghostscript.

The distribution archive (gmtmap_X.Y.tar.Z) contains the 
following files:

gmtmap.exp        - main script
gmtmap            - link to gmtmap.exp
gmtmap.par        - parameter file 
gmtmap.help       - this file
gmtset.exp        - set GMT defaults
gmtmedia.d        - GMT file
topo.cpt          - gmt cpt file

To install gmtmap, create a directory e.g. ~/GMTMAP and copy 
the distribution file there. Uncompress and untar, using 
commands

uncompress gmtmap_X.Y.tar.Z
tar xvf gmtmap_X.Y.tar

Edit the file gmtmap.exp and change the first line to point
to the expect command on your system (check with 'which expect').

Edit the parameter file gmtmap.par, instructions are given inside
the file.

Modify the file gmtset.exp to your preferences.

Add the ~/GMTMAP directory to your path, and set the environmental
variable GMTMAPHOME to the same directory.

The file gmtmedia.d, which is located in the gmt/share or 
gmt/lib directory allows you to define your own media sizes.
You may copy the file that comes with GMTMAP to the gmt directories,
or modify the existing file to the media sizes you would like to
have. When converting from Postscript to image formats, 
the image size in pixels will be equal to the defined PS media size.
This is particular useful if you want the map to fill a certain
number of pixels and not use one of the standard formats.
The user defined formats should be given names like ux300y300, which
means user defined, 300 units in x and y direction.

Apply the new settings, and you should be ready to run gmtmap
interactively, by starting the command 'gmtmap'.

Grid files are not part of GMTMAP, you have to provide them.


------------------------------------------------------------
Interactive use
------------------------------------------------------------

After starting GMTMAP, you can modify the settings. The parameters 
should be easy enough to understand. Once you have done the
parameters, you go back to the main menu and generate the map.
This may take a little while before you can show the iamge.  

Your settings are saved to the file gmtmap.inp in your current 
diretory. The next time you start GMTMAP, you will be asked 
if you want to delete this file. Normally you will keep it
and change the settings.

Check your gmtmedia.d file to see which media size you can use, 
all standard GMT media sizes are supported, check 'man gmtdefaults'.
If you select a user defined media size, GMTMAP will reduce the 
y size of the media to what is needed.


------------------------------------------------------------
Non-interactive use
------------------------------------------------------------

GMTMAP can be run by giving parameters as command line arguments,
see 'gmtmap -help' for the options that are supported.


------------------------------------------------------------
Known problems
------------------------------------------------------------

The automatic scaling does not work very well for high latitudes.