NAME

       gmtlist - A data-extractor for <legid>.gmt files

SYNOPSIS

       gmtlist  leg-ids [ -Ccorrectionfile ] [ -Dastartdate ] [ -Dbstopdate ] [ -Fflags ] [ -G ] [ -H[i][nrec] ]
       [  -Rwest/east/south/north[r]  ]  [  -Sastartdist  ]  [  -Sbstopdist  ]  [  -V   ]   [   -Wweight   ]   [
       -bo[s|S|d|D[ncol]|c[var1/...]] ]

DESCRIPTION

       gmtlist  reads  <legid>.gmt files and produces an ASCII [or binary] table.  The <legid>.gmt files contain
       time(s), latitude(y), longitude(x), gravity(g/G), magnetics(m/M), and bathymetry(t/T), and the  user  may
       extract  any  combination  of these 6 parameters + distance(d), heading (h), velocity (v), and weight (w,
       see -W).  A sub-section can be specified by  passing  time-  or  distance-intervals  along  track  or  by
       selecting a region.

       leg-ids
              Can be one or more cruisenames. To give a list of names, use `cat list_of_legs`.

OPTIONS

       No space between the option flag and the associated arguments

       -C     Apply crossover Corrections to the data. If no correction file is given, gmtlist reads the default
              correction file. (See XSYSTEM for how to set up your own correction file).

       -Da    Do not list data collected before startdate (mm/dd/yyyy/hh:mm)  [Default is first day].

       -Db    Do not list data collected after stopdate (mm/dd/yyyy/hh:mm). [Default is last day].

       -F     Can  be  any combination of syxgmtdhv to indicate the desired output data. The data will appear in
              the order indicated by flags. If G, M, or T is substituted for g, m, t,  only  records  that  have
              that   combination   of   data   are  written  out.  If  s  is  followed  by  c  (calendar),  then
              yyyy/mm/dd/hh/mm/ss is written out, if s is followed  by  j  (julian),  then  yyyy/jd/hh/mm/ss  is
              written out.  Default is seconds from start of year.

       -G     Force Geographical longitudes (-180/+180) rather than geodetic (0-360) [Default].

       -H     Issue a header record with names for each data field.

       -R     west,  east,  south, and north 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 r if lower  left  and  upper  right  map
              coordinates  are given instead of w/e/s/n.  The two shorthands -Rg and -Rd 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 -R settings (and grid spacing, if applicable) are copied
              from the grid.

       -Sa    Do  not  list data that are less than startdist km along track from port of departure. [Default is
              0].

       -Sb    Do not list data that are more than stopdist km along track from port of  departure.  [Default  is
              length of track].

       -V     Selects verbose mode, which will send progress reports to stderr [Default runs "silently"].

       -W     Set  the  weight  for  these data.  Weight output option must be set in -F.  This is useful if the
              data are to be processed with the weighted averaging techniques offered by blockmean, blockmedian,
              and blockmode.

       -b     Selects binary output mode (in double precision) [Default is ASCII].   -H  is  ignored  if  -b  is
              selected.   Julian  and  calendar  dates  are  not supported for binary time output (i.e., you get
              seconds from start of year).

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:

       gmtlist c2104 -Da 6/3/1971/20:45 -Sb 5000 -F dhgt -C > myfile

       To make input for blockmean and surface using all the cruises listed in the file gmt.list, but  only  the
       data that are inside the specified area, and make output binary:

       gmtlist `cat gmt.list` -F xyg -R-40/-30/25/35 -b > allgrav.xyg

SEE ALSO

       GMT(1), x_system(1)

REFERENCES

       Wessel,  P., and W. H. F. Smith, 2013, The Generic Mapping Tools (GMT) version 4.5.11 Technical Reference
       & Cookbook, SOEST/NOAA.
       Wessel, P., and W. H. F. Smith, 1998, New, Improved  Version  of  Generic  Mapping  Tools  Released,  EOS
       Trans., AGU, 79 (47), p. 579.
       Wessel, P., and W. H. F. Smith, 1995, New Version of the Generic Mapping Tools Released, EOS Trans., AGU,
       76 (33), p. 329.
       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.
       Wessel, P., and W. H. F. Smith, 1991, Free Software Helps Map and Display Data, EOS Trans., AGU, 72 (41),
       p. 441.

GMT 4.5.11                                         5 Nov 2013                                      GMTLIST(1gmt)