.TH GMTLIST 1gmt "Feb 27 2014" "GMT 4.5.13 (SVN)" "Generic Mapping Tools"
.SH NAME
gmtlist \- A data-extractor for <legid>.gmt files
.SH SYNOPSIS
\fBgmtlist\fP \fIleg-ids\fP [ \fB\-C\fP\fIcorrectionfile\fP ] [ \fB\-Da\fP\fIstartdate\fP ] 
[ \fB\-Db\fP\fIstopdate\fP ] [ \fB\-F\fP\fIflags\fP ] [ \fB\-G\fP ] [ \fB\-H\fP[\fBi\fP][\fInrec\fP] ] [ \fB\-R\fP\fIwest\fP/\fIeast\fP/\fIsouth\fP/\fInorth\fP[\fBr\fP] ] 
[ \fB\-Sa\fP\fIstartdist\fP ] [ \fB\-Sb\fP\fIstopdist\fP ] [ \fB\-V\fP ] [ \fB\-W\fP\fIweight\fP ] [ \fB\-bo\fP[\fBs\fP|\fBS\fP|\fBd\fP|\fBD\fP[\fIncol\fP]|\fBc\fP[\fIvar1\fP\fB/\fP\fI...\fP]] ]
.SH DESCRIPTION
\fBgmtlist\fP reads <legid>.gmt files and produces an ASCII [or binary] table.  The <legid>.gmt files
contain time(\fBs\fP), latitude(\fBy\fP), longitude(\fBx\fP), gravity(\fBg/G\fP),
magnetics(\fBm/M\fP), and bathymetry(\fBt/T\fP),
and the user may extract any combination of these 6 parameters + distance(\fBd\fP),
heading (\fBh\fP), velocity (\fBv\fP), and weight (\fBw\fP, see \fB\-W\fP).  A sub-section can be
specified by passing time- or distance-intervals along track or by selecting a region.
.TP
\fIleg-ids\fP
Can be one or more cruisenames. To give a list of names, use `cat list_of_legs`.
.SH OPTIONS
No space between the option flag and the associated arguments
.TP
\fB\-C\fP
Apply crossover Corrections to the data. If no correction file is given, gmtlist reads the
default correction file. (See \fBXSYSTEM\fP for how to set up your own correction file).
.TP
\fB\-Da\fP
Do not list data collected before \fIstartdate\fP (mm/dd/yyyy/hh:mm)  [Default is first day].
.TP
\fB\-Db\fP
Do not list data collected after \fIstopdate\fP (mm/dd/yyyy/hh:mm). [Default is last day].
.TP
\fB\-F\fP
Can be any combination of \fBsyxgmtdhv\fP to indicate the desired output data. The data will
appear in the order indicated by flags. If \fBG\fP, \fBM\fP, or \fBT\fP is substituted for \fBg\fP, \fBm\fP, \fBt\fP, only records that
have that combination of data are written out. If \fBs\fP is followed by \fBc\fP (calendar),
then yyyy/mm/dd/hh/mm/ss is written out, if \fBs\fP is
followed by \fBj\fP (julian), then yyyy/jd/hh/mm/ss is written out.  Default is seconds from start
of year.
.TP
\fB\-G\fP
Force Geographical longitudes (-180/+180) rather than geodetic (0-360) [Default].
.TP
\fB\-H\fP
Issue a header record with names for each data field.
.TP
\fB\-R\fP
\fIwest, east, south,\fP and \fInorth\fP specify the Region of interest, and you may specify them
in decimal degrees or in [+-]dd:mm[:ss.xxx][W|E|S|N] format.  Append \fBr\fP if lower left and upper right
map coordinates are given instead of w/e/s/n.  The two shorthands \fB\-Rg\fP and \fB\-Rd\fP stand for global domain
(0/360 and -180/+180 in longitude respectively, with -90/+90 in latitude). Alternatively, specify the name
of an existing grid file and the \fB\-R\fP settings (and grid spacing, if applicable) are copied from the grid.
.TP
\fB\-Sa\fP
Do not list data that are less than \fIstartdist\fP km along track from port of departure. [Default is 0].
.TP
\fB\-Sb\fP
Do not list data that are more than \fIstopdist\fP km along track from port of departure. [Default is length of track].
.TP
\fB\-V\fP
Selects verbose mode, which will send progress reports to stderr [Default runs "silently"].
.TP
\fB\-W\fP
Set the weight for these data.  Weight output option must be set in \fB\-F\fP.  This is
useful if the data are to be processed with the weighted averaging techniques offered by
\fBblockmean\fP, \fBblockmedian\fP, and \fBblockmode\fP.
.TP
\fB\-b\fP
Selects binary output mode (in double precision) [Default is ASCII].  \fB\-H\fP is ignored if \fB\-b\fP is selected.
Julian and calendar dates are not supported for binary time output (i.e., you get seconds from start of year).
.SH EXAMPLES
To get a (distance, heading, crossover-corrected gravity, bathymetry) listing from c2104.gmt,
starting at June 3 1971 20:45 and ending at distance = 5000 km, use the following command:
.br
.sp
\fBgmtlist\fP c2104 \fB\-Da\fP 6/3/1971/20:45 \fB\-Sb\fP 5000 \fB\-F\fP dhgt \fB\-C\fP > myfile
.br
.sp
To make input for \fBblockmean\fP and \fBsurface\fP using all the cruises listed in the file gmt.list,
but only the data that are inside the specified area, and make output binary:
.br
.sp
\fBgmtlist\fP `cat gmt.list` \fB\-F\fP xyg \fB\-R\fP-40/-30/25/35 \fB\-b\fP > allgrav.xyg
.SH "SEE ALSO"
.IR GMT (1),
.IR x_system (1)
.SH REFERENCES
Wessel, P., and W. H. F. Smith, 2014, The Generic Mapping Tools (GMT) version
4.5.12 Technical Reference & Cookbook, SOEST/NOAA.
.br
Wessel, P., and W. H. F. Smith, 1998, New, Improved Version of Generic Mapping
Tools Released, EOS Trans., AGU, 79 (47), p. 579.
.br
Wessel, P., and W. H. F. Smith, 1995, New Version of the Generic Mapping Tools
Released, EOS Trans., AGU, 76 (33), p. 329.
.br
Wessel, P., and W. H. F. Smith, 1995, New Version of the Generic Mapping Tools
Released, http://www.agu.org/eos_elec/95154e.html, Copyright 1995 by the
American Geophysical Union.
.br
Wessel, P., and W. H. F. Smith, 1991, Free Software Helps Map and Display Data,
EOS Trans., AGU, 72 (41), p. 441.
.br