1GMTLIST(1) Generic Mapping Tools GMTLIST(1)
2
6 gmtlist - A data-extractor for <legid>.gmt files
7
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
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 leg-ids
24 Can be one or more cruisenames. To give a list of names, use
25 `cat list_of_legs`.
26
28 No space between the option flag and the associated arguments
29 -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 -Da Do not list data collected before startdate (mm/dd/yyyy/hh:mm)
35 [Default is first day].
36 -Db Do not list data collected after stopdate (mm/dd/yyyy/hh:mm).
38 [Default is last day].
39 -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 -G Force Geographical longitudes (-180/+180) rather than geodetic
49 (0-360) [Default].
50 -H Issue a header record with names for each data field.
52 -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 Alternatively, specify the name of an existing grid file and the
60 -R settings (and grid spacing, if applicable) are copied from
61 the grid.
62 -Sa Do not list data that are less than startdist km along track
64 from port of departure. [Default is 0].
65 -Sb Do not list data that are more than stopdist km along track from
67 port of departure. [Default is length of track].
68 -V Selects verbose mode, which will send progress reports to stderr
70 [Default runs "silently"].
71 -W Set the weight for these data. Weight output option must be set
73 in -F. This is useful if the data are to be processed with the
74 weighted averaging techniques offered by blockmean, blockmedian,
75 and blockmode.
76 -b Selects binary output mode (in double precision) [Default is
78 ASCII]. -H is ignored if -b is selected. Julian and calendar
79 dates are not supported for binary time output (i.e., you get
80 seconds from start of year).
81
83 To get a (distance, heading, crossover-corrected gravity, bathymetry)
84 listing from c2104.gmt, starting at June 3 1971 20:45 and ending at
85 distance = 5000 km, use the following command:
86 gmtlist c2104 -Da6/3/1971/20:45 -Sb5000 -Fdhgt -C > myfile
88 To make input for blockmean and surface using all the cruises listed in
90 the file gmt.list, but only the data that are inside the specified
91 area, and make output binary:
92 gmtlist `cat gmt.list` -Fxyg -R-40/-30/25/35 -b > allgrav.xyg
94
96 GMT(1), x_system(1)
97
99 Wessel, P., and W. H. F. Smith, 2009, The Generic Mapping Tools (GMT)
100 version 4.5.0 Technical Reference & Cookbook, SOEST/NOAA.
101 Wessel, P., and W. H. F. Smith, 1998, New, Improved Version of Generic
102 Mapping Tools Released, EOS Trans., AGU, 79 (47), p. 579.
103 Wessel, P., and W. H. F. Smith, 1995, New Version of the Generic Map‐
104 ping Tools Released, EOS Trans., AGU, 76 (33), p. 329.
105 Wessel, P., and W. H. F. Smith, 1995, New Version of the Generic Map‐
106 ping Tools Released, http://www.agu.org/eos_elec/95154e.html, Copyright
107 1995 by the American Geophysical Union.
108 Wessel, P., and W. H. F. Smith, 1991, Free Software Helps Map and Dis‐
109 play Data, EOS Trans., AGU, 72 (41), p. 441.
110GMT 4.5.6 10 Mar 2011 GMTLIST(1)