gmtlist(1)

1GMTLIST(1)                   Generic Mapping Tools                  GMTLIST(1)
2
3
4

NAME

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

SYNOPSIS

9       gmtlist leg-ids [ -Ccorrectionfile ] [ -Dastartdate ] [ -Dbstopdate ] [
10       -Fflags ] [ -G ] [ -H[i][nrec] ] [ -Rwest/east/south/north[r] ] [ -Sas‐
11       tartdist    ]   [   -Sbstopdist   ]   [   -V   ]   [   -Wweight   ]   [
12       -bo[s|S|d|D[ncol]|c[var1/...]] ]
13

DESCRIPTION

15       gmtlist reads <legid>.gmt files and produces an ASCII [or  binary]  ta‐
16       ble.  The <legid>.gmt files contain time(s), latitude(y), longitude(x),
17       gravity(g/G), magnetics(m/M), and bathymetry(t/T),  and  the  user  may
18       extract  any  combination  of these 6 parameters + distance(d), heading
19       (h), velocity (v), and weight (w, see -W).  A sub-section can be speci‐
20       fied by passing time- or distance-intervals along track or by selecting
21       a region.
22
23       leg-ids
24              Can be one or more cruisenames. To give a  list  of  names,  use
25              `cat list_of_legs`.
26

OPTIONS

28       No space between the option flag and the associated arguments
29
30       -C     Apply  crossover  Corrections to the data. If no correction file
31              is given, gmtlist reads the default correction file. (See  XSYS‐
32              TEM for how to set up your own correction file).
33
34       -Da    Do  not  list data collected before startdate (mm/dd/yyyy/hh:mm)
35              [Default is first day].
36
37       -Db    Do not list data collected  after  stopdate  (mm/dd/yyyy/hh:mm).
38              [Default is last day].
39
40       -F     Can be any combination of syxgmtdhv to indicate the desired out‐
41              put data. The data will appear in the order indicated by  flags.
42              If G, M, or T is substituted for g, m, t, only records that have
43              that combination of data are written out. If s is followed by  c
44              (calendar),  then  yyyy/mm/dd/hh/mm/ss  is  written out, if s is
45              followed by j (julian), then yyyy/jd/hh/mm/ss  is  written  out.
46              Default is seconds from start of year.
47
48       -G     Force  Geographical  longitudes (-180/+180) rather than geodetic
49              (0-360) [Default].
50
51       -H     Issue a header record with names for each data field.
52
53       -R     west, east, south, and north specify the Region of interest, and
54              you    may    specify    them   in   decimal   degrees   or   in
55              [+-]dd:mm[:ss.xxx][W|E|S|N] format.  Append r if lower left  and
56              upper  right  map coordinates are given instead of w/e/s/n.  The
57              two shorthands -Rg and -Rd stand for global  domain  (0/360  and
58              -180/+180 in longitude respectively, with -90/+90 in latitude).
59
60       -Sa    Do  not  list  data  that are less than startdist km along track
61              from port of departure. [Default is 0].
62
63       -Sb    Do not list data that are more than stopdist km along track from
64              port of departure. [Default is length of track].
65
66       -V     Selects verbose mode, which will send progress reports to stderr
67              [Default runs "silently"].
68
69       -W     Set the weight for these data.  Weight output option must be set
70              in  -F.  This is useful if the data are to be processed with the
71              weighted averaging techniques offered by blockmean, blockmedian,
72              and blockmode.
73
74       -b     Selects  binary  output  mode  (in double precision) [Default is
75              ASCII].  -H is ignored if -b is selected.  Julian  and  calendar
76              dates  are  not  supported for binary time output (i.e., you get
77              seconds from start of year).
78

EXAMPLES

80       To get a (distance, heading, crossover-corrected  gravity,  bathymetry)
81       listing  from  c2104.gmt,  starting  at June 3 1971 20:45 and ending at
82       distance = 5000 km, use the following command:
83
84       gmtlist c2104 -Da6/3/1971/20:45 -Sb5000 -Fdhgt -C > myfile
85
86       To make input for blockmean and surface using all the cruises listed in
87       the  file  gmt.list,  but  only  the data that are inside the specified
88       area, and make output binary:
89
90       gmtlist `cat gmt.list` -Fxyg -R-40/-30/25/35 -b > allgrav.xyg
91

REFERENCES

96       Wessel, P., and W. H. F. Smith, 2005, The Generic Mapping  Tools  (GMT)
97       version 4.1 Technical Reference & Cookbook, SOEST/NOAA.
98       Wessel,  P., and W. H. F. Smith, 1998, New, Improved Version of Generic
99       Mapping Tools Released, EOS Trans., AGU, 79 (47), p. 579.
100       Wessel, P., and W. H. F. Smith, 1995, New Version of the  Generic  Map‐
101       ping Tools Released, EOS Trans., AGU, 76 (33), p. 329.
102       Wessel,  P.,  and W. H. F. Smith, 1995, New Version of the Generic Map‐
103       ping Tools Released, http://www.agu.org/eos_elec/95154e.html, Copyright
104       1995 by the American Geophysical Union.
105       Wessel,  P., and W. H. F. Smith, 1991, Free Software Helps Map and Dis‐
106       play Data, EOS Trans., AGU, 72 (41), p. 441.
107
108
109
110GMT 4.3.1                         15 May 2008                       GMTLIST(1)

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

EXAMPLES

SEE ALSO

REFERENCES