1X2SYS_GET(1) GMT X2SYS_GET(1)
2
6 x2sys_get - Get track listing from the x2sys track index databases
7
9 x2sys_get -TTAG [ -C ] [ -Fflags ] [ -G ] [ -L[+][list] ] [
10 -Nflags ] [ [ -Rregion ] [ -V[level] ]
11 Note: No space is allowed between the option flag and the associated
13 arguments.
14
16 x2sys_get will return the names of the track data files in the x2sys
17 data base for this TAG that match the given requirements. You may
18 choose a specific region and optionally ask only for tracks that meet
19 certain data criteria. Finally, you may select an option to list all
20 possible pairs that might generate crossovers.
21
23 -TTAG Specify the x2sys TAG which tracks the attributes of this data
24 type.
25
27 -C Instead of reporting the track names, just output the coordi‐
28 nates of the center of each bin that has at least one track with
29 the specified data.
30 -D Only report the track names [Default adds the availability of
32 data for each field].
33 -Fflags
35 Give a comma-separated list of column names (as described in the
36 definition file) that should be present. [Default selects all
37 data columns].
38 -G Report data flags (Y or N) for the entire track rather than just
40 for the portion that is inside the region set by -R [Default].
41 -L[+][list]
43 Crossover mode. Return a list of track pairs that should be
44 checked for possible crossovers. The list is determined from the
45 bin-index data base on the assumption that tracks occupying the
46 same bin are very likely to intersect. By default we return all
47 possible pairs in the data base. Append the name of a file with
48 a list of tracks if you want to limit the output to those pairs
49 that involve at least one of the track names in your list. The
50 output is suitable for the -A option in x2sys_cross. By default,
51 only external crossover pairs are listed. Use -L+ to include
52 internal pairs in the list.
53 -Nflags
55 Give a comma-separated list of column names (as described in the
56 definition file) that must be absent.
57 -Rwest/east/south/north[/zmin/zmax][+r][+uunit]
59 west, east, south, and north specify the region of interest, and
60 you may specify them in decimal degrees or in
61 [±]dd:mm[:ss.xxx][W|E|S|N] format Append +r if lower left and
62 upper right map coordinates are given instead of w/e/s/n. The
63 two shorthands -Rg and -Rd stand for global domain (0/360 and
64 -180/+180 in longitude respectively, with -90/+90 in latitude).
65 Alternatively for grid creation, give Rcodelon/lat/nx/ny, where
66 code is a 2-character combination of L, C, R (for left, center,
67 or right) and T, M, B for top, middle, or bottom. e.g., BL for
68 lower left. This indicates which point on a rectangular region
69 the lon/lat coordinate refers to, and the grid dimensions nx and
70 ny with grid spacings via -I is used to create the corresponding
71 region. Alternatively, specify the name of an existing grid
72 file and the -R settings (and grid spacing, if applicable) are
73 copied from the grid. Appending +uunit expects projected (Carte‐
74 sian) coordinates compatible with chosen -J and we inversely
75 project to determine actual rectangular geographic region. For
76 perspective view (-p), optionally append /zmin/zmax. In case of
77 perspective view (-p), a z-range (zmin, zmax) can be appended to
78 indicate the third dimension. This needs to be done only when
79 using the -Jz option, not when using only the -p option. In the
80 latter case a perspective view of the plane is plotted, with no
81 third dimension. For Cartesian data just give
82 xmin/xmax/ymin/ymax. This option limits the tracks to those that
83 fall at least partly inside the specified domain.
84 -V[level] (more ...)
86 Select verbosity level [c].
87 -^ or just -
89 Print a short message about the syntax of the command, then
90 exits (NOTE: on Windows just use -).
91 -+ or just +
93 Print an extensive usage (help) message, including the explana‐
94 tion of any module-specific option (but not the GMT common
95 options), then exits.
96 -? or no arguments
98 Print a complete usage (help) message, including the explanation
99 of all options, then exits.
100
102 To find all the tracks associated with the tag MGD77, restricted to
103 occupy a certain region in the south Pacific, and have at least free
104 air anomalies and bathymetry, try
105 gmt x2sys_get -V -TMGD77 -R180/240/-60/-30 -Ffaa,depth
107 To find all the tracks associated with the tag MGD77 that have depth
109 but not twt, try
110 gmt x2sys_get -V -TMGD77 -Fdepth -Nwt
112 To find all the pairs associated with the tag MGD77 that might inter‐
114 sect each other, but only those pairs which involves tracks in your
115 list new.lis, try
116 gmt x2sys_get -V -TMGD77 -Lnew.lis > xpairs.lis
118
120 The tracks that are returned all have the requested data (-F) within
121 the specified region (-R). Furthermore, the columns of Y and N for
122 other data types also reflect the content of the track portion within
123 the selected region, unless -G is set.
124
126 x2sys_binlist, x2sys_cross x2sys_datalist, x2sys_init, x2sys_list,
127 x2sys_put, x2sys_report, x2sys_solve
128
130 2019, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe
1315.4.5 Feb 24, 2019 X2SYS_GET(1)