x2sys_get - Get track listing from the x2sys track index
databases
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.
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.
- -TTAG
- Specify the x2sys TAG which tracks the attributes of this data
type.
- -C
- Instead of reporting the track names, just output the coordinates 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
[±]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
(Cartesian) 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.
- -^ 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 explanation 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.
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
intersect each other, but only those pairs which involves tracks in your
list new.lis, try
gmt x2sys_get -V -TMGD77 -Lnew.lis > xpairs.lis
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.
x2sys_binlist, x2sys_cross x2sys_datalist, x2sys_init, x2sys_list,
x2sys_put, x2sys_report, x2sys_solve
2019, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F.
Wobbe