Usage:    topomap -r larger_region {-o outfile} {-f gridfilenameroot}  {-s style}

Purpose:  (1) make a postscript topographic map with shading
                       (2) make a grid file for swemap. To use the map as a background,
             call swemap -t gridfilenameroot ...

Options:
 -r larger_region    - Region bounds for retrieval of topo data.
                       Ought to fully enclose the rectangular area
                       of the projected map. See footnote.

                       Example: 0/54/39/72r
                       (Must be r-style !  (<lon>/<lat>/<lon>/<lat>r) )
 
                       Specify larger_region = u to use $REGION
                       which will work with equatorial cylindrical
                       projections. (The REGION environment variable is
                       used by swemap).
 
 -o outfile          - Postscript file, example topo.ps
                       This file is mostly for monitoring that things
                       will come out right when running the swemap job.

 -f gridfilenameroot - Let ${g} = gridfilenameroot. First, topomap samples
                       the global topographic file and retains an ascii-
                       version in the X Y Z form. That file is called
                         ${MYTMP}/${g}.xyz,
                       In the next phase, topomap makes
                         ${MYTMP}/${g}t.grd (projected topo grid),
                         ${MYTMP}/${g}i.grd (slope shading grid), and
                         ${MYTMP}/${g}.grd  (unprojected), but only
                       if they don't already exist.
                       ${MYTMP} is an environment variable. Default is
                       current directory.
 
 -s style            - swemap creates a script file  STYLE_style.csh  with
                       appropriate environment settings for REGION and PRJCT
                       associated with the named  style [default: fnosk].
                       If you have not explicitly defined REGION and PRJCT
                       in the environment, then you can use this option
                       and topomap will apply this neat little script.
 
In order to consistently include the topographic map in a swemap job
as regards then region and projection setup, you need to run both jobs
in the same environment.
 
Footnote regarding "larger region":
In conical projections the critical points that define the larger region are
the following:
 lower longitude - the longitude at the top left corner of the map
 lower latitude  - the smaller of the latitudes at the lower left and lower
                   right corners.
 upper longitude - the longitude at the top right corner of the map
 upper latitude  - the latitude at the intersection of the central meridian
                   with the upper edge; the central meridian has the longitude
                   of the projection pole.