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.