1X2SYS_DATALIST(1) Generic Mapping Tools X2SYS_DATALIST(1)
2
6 x2sys_datalist - A generic data-extractor for ASCII or binary files
7
9 x2sys_datalist track(s) -TTAG [ -Fname1,name2,... ] [ -H[i][nrec] ] [
10 -Rwest/east/south/north[r] ] [ -S ] [ -V ] [
11 -bo[s|S|d|D[ncol]|c[var1/...]] ]
12
14 x2sys_datalist reads one or more files and produces a single ASCII [or
15 binary] table. The files can be of any format, which must be descriped
16 and passed with the -T option. You may limit the output to a geo‐
17 graphic region, and insist that the output from several files be sepa‐
18 rated by a multiple segment header. Only the named data fields will be
19 output [Default selects all columns].
20 tracks Can be one or more binary or ASCII data files. To give a list of
22 names, use `cat tracks.lis` or give the name of the track list
23 after a colon (e.g., :tracks.lis). If the names are missing the
24 suffix we will append the suffix that goes with this TAG. Track
25 files will be looked for first in the current directory and sec‐
26 ond in all directories listed in $X2SYS_HOME/TAG_paths.txt (if
27 it exists). [If $X2SYS_HOME is not set it will default to
28 $GMT_SHAREDIR/x2sys].
29 -T Sets the data set TAG which among other things sets the defini‐
31 tion file.
32
34 No space between the option flag and the associated arguments.
35 -F Give a comma-separated sub-set list of column names defined in
37 the definition file. [Default selects all data columns].
38 -H Input file(s) has Header record(s). Number of header records
40 can be changed by editing your .gmtdefaults4 file. If used, GMT
41 default is 1 header record. Use -Hi if only input data should
42 have header records [Default will write out header records if
43 the input data have them]. Blank lines and lines starting with #
44 are always skipped.
45 -M Output a multisegment header between data from each track. Note
47 this option does not imply anything about the input file; that
48 information is conveyed via the system tag (-T).
49 -S Suppress output records where all the data columns are NaN
51 [Default will output all records].
52 -V Selects verbose mode, which will send progress reports to stderr
54 [Default runs "silently"].
55 -bo Selects binary output. Append s for single precision [Default
57 is d (double)]. Uppercase S or D will force byte-swapping.
58 Optionally, append ncol, the number of desired columns in your
59 binary output file.
60
62 To extract all data from the old-style MGG supplement file c2104.gmt,
63 recognized by the tag MGG:
64 x2sys_datalist c2104.gmt -Tmgg > myfile
66 To make lon,lat, and depth input for blockmean and surface using all
68 the files listed in the file tracks.lis and define by the tag TRK, but
69 only the data that are inside the specified area, and make output
70 binary, run
71 x2sys_datalist `cat tracks.lis` -TTRK -Flon,lat,depth -R-40/-30/25/35
73 -bo > alltopo.xyz
74
76 blockmean(1), GMT(1), surface(1), x2sys_cross(1)
77GMT 4.3.1 15 May 2008 X2SYS_DATALIST(1)