.TH GSHHG2GRASS 1gmt "Feb 27 2014" "GMT 4.5.13 (SVN)" "Generic Mapping Tools"
.SH NAME
gshhgtograss \- Extracting GSHHS and WDBII data in GRASS-compatible ASCII format
.SH SYNOPSIS
\fBgshhgtograss\fP \fB\-i\fP gshhs_[f|h|i|l|c].b [ \fB\-x\fP\fIminx\fP ] [\fB\-X\fP\fImaxx\fP ] 
[ \fB\-y\fP\fIminy\fP ] [ \fB\-Y\fP\fImaxy\fP ]
.SH DESCRIPTION
\fBgshhgtograss\fP reads the binary coastline (GSHHS) or binary river/border (WDBII) and
and translates it into an ASCII format suitable for import into GRASS.  It automatically
handles byte-swabbing between different architectures.
.TP
\fIgshhs_[f|h|i|l|c].b\fP
One of the GSHHG binary data file as distributed with the GSHHG data supplement.  Any of the
5 standard resolutions (full, high, intermediate, low, crude) can be used.
The resulting files are called dig_[ascii|att|cats].gshhs_[f|h|i|l|c].
.SH OPTIONS
.TP
\fB\-x\fP
Specify a minimum (west) longitude.
.TP
\fB\-X\fP
Specify a maximum (east) longitude.
.TP
\fB\-y\fP
Specify a minimum (south) latitude.
.TP
\fB\-Y\fP
Specify a maximum (north) latitude.
.SH EXAMPLES
.sp
To convert the full GSHHS data set , try
.sp
\fBgshhgtograss\fP \fIgshhs_f.b\fP
.SH BUGS
Not updated to handle the WDBII line data (borders or rivers).
.SH AUTHOR
Original version by Simon Cox (simon@ned.dem.csiro.au) with
some maintenance by Paul Wessel (pwessel@hawaii.edu).
.SH "SEE ALSO"
.IR GMT (1),
.IR gshhg (1)
.IR gshhg_dp (1)