x2sys_get(1) GMT x2sys_get(1)
NAME
x2sys_get - Get track listing from the x2sys track index databases
SYNOPSIS
x2sys_get -TTAG [ -C ] [ -Fflags ] [ -G ] [ -L[+][list] ] [
-Nflags ] [ [ -Rregion ] [ -V[level] ]
Note: No space is allowed between the option flag and the associated
arguments.
DESCRIPTION
x2sys_get will return the names of the track data files in the x2sys
data base for this TAG that match the given requirements. You may
choose a specific region and optionally ask only for tracks that meet
certain data criteria. Finally, you may select an option to list all
possible pairs that might generate crossovers.
REQUIRED ARGUMENTS
-TTAG Specify the x2sys TAG which tracks the attributes of this data
type.
OPTIONAL ARGUMENTS
-C Instead of reporting the track names, just output the coordi-
nates of the center of each bin that has at least one track with
the specified data.
-D Only report the track names [Default adds the availability of
data for each field].
-Fflags
Give a comma-separated list of column names (as described in the
definition file) that should be present. [Default selects all
data columns].
-G Report data flags (Y or N) for the entire track rather than just
for the portion that is inside the region set by -R [Default].
-L[+][list]
Crossover mode. Return a list of track pairs that should be
checked for possible crossovers. The list is determined from the
bin-index data base on the assumption that tracks occupying the
same bin are very likely to intersect. By default we return all
possible pairs in the data base. Append the name of a file with
a list of tracks if you want to limit the output to those pairs
that involve at least one of the track names in your list. The
output is suitable for the -A option in x2sys_cross. By default,
only external crossover pairs are listed. Use -L+ to include
internal pairs in the list.
-Nflags
Give a comma-separated list of column names (as described in the
definition file) that must be absent.
-Rwest/east/south/north[/zmin/zmax][+r][+uunit]
west, east, south, and north specify the region of interest, and
you may specify them in decimal degrees or in
[A+-]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 for grid creation, give Rcodelon/lat/nx/ny, where
code is a 2-character combination of L, C, R (for left, center,
or right) and T, M, B for top, middle, or bottom. e.g., BL for
lower left. This indicates which point on a rectangular region
the lon/lat coordinate refers to, and the grid dimensions nx and
ny with grid spacings via -I is used to create the corresponding
region. Alternatively, specify the name of an existing grid
file and the -R settings (and grid spacing, if applicable) are
copied from the grid. Appending +uunit expects projected (Carte-
sian) coordinates compatible with chosen -J and we inversely
project to determine actual rectangular geographic region. For
perspective view (-p), optionally append /zmin/zmax. In case of
perspective view (-p), a z-range (zmin, zmax) can be appended to
indicate the third dimension. This needs to be done only when
using the -Jz option, not when using only the -p option. In the
latter case a perspective view of the plane is plotted, with no
third dimension. For Cartesian data just give
xmin/xmax/ymin/ymax. This option limits the tracks to those that
fall at least partly inside the specified domain.
-V[level] (more a|)
Select verbosity level [c].
-^ or just -
Print a short message about the syntax of the command, then
exits (NOTE: on Windows just use -).
-+ or just +
Print an extensive usage (help) message, including the explana-
tion of any module-specific option (but not the GMT common
options), then exits.
-? or no arguments
Print a complete usage (help) message, including the explanation
of all options, then exits.
EXAMPLES
To find all the tracks associated with the tag MGD77, restricted to
occupy a certain region in the south Pacific, and have at least free
air anomalies and bathymetry, try
gmt x2sys_get -V -TMGD77 -R180/240/-60/-30 -Ffaa,depth
To find all the tracks associated with the tag MGD77 that have depth
but not twt, try
gmt x2sys_get -V -TMGD77 -Fdepth -Nwt
To find all the pairs associated with the tag MGD77 that might inter-
sect each other, but only those pairs which involves tracks in your
list new.lis, try
gmt x2sys_get -V -TMGD77 -Lnew.lis > xpairs.lis
NOTE
The tracks that are returned all have the requested data (-F) within
the specified region (-R). Furthermore, the columns of Y and N for
other data types also reflect the content of the track portion within
the selected region, unless -G is set.
SEE ALSO
x2sys_binlist(1), x2sys_cross(1), x2sys_datalist(1), x2sys_init(1),
x2sys_list(1), x2sys_put(1), x2sys_report(1), x2sys_solve(1)
COPYRIGHT
2017, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe
5.4.2 Jun 24, 2017 x2sys_get(1)
gmt5 5.4.2 - Generated Thu Jun 29 18:06:54 CDT 2017