1X2SYS_GET(1)                 Generic Mapping Tools                X2SYS_GET(1)
2
3
4

NAME

6       x2sys_get - Get track listing from track index databases
7

SYNOPSIS

9       x2sys_get  -TTAG  [  -C  ]  [  -Fflags  ]  [  -L[list]  [  -Nflags  ] [
10       -Rwest/east/south/north[r] ] [ -V ] ]
11

DESCRIPTION

13       x2sys_get will return the names of the track data files that match  the
14       given  requirements.  You may choose a geographic region and optionally
15       ask only for tracks that meet certain data criteria.  Finally, you  may
16       select  an  option  to  list  all  possible  pairs  that might generate
17       crossovers.
18
19       TAG    The unique tag name of this data type system.
20

OPTIONS

22       No space between the option flag and the associated arguments.
23
24       -C     Instead of reporting the track names, just  output  the  coordi‐
25              nates of the center of each bin that has at least one track with
26              the specified data.
27
28       -F     Give a comma-separated list of column names (as described in the
29              definition  file)  that  should be present. [Default selects all
30              data columns].
31
32       -L     Crossover mode.  Return a list of track  pairs  that  should  be
33              checked  for  possible  crossovers.  The list is determined from
34              the bin-index data base on the assumption that tracks  occupying
35              the same bin are very likely to intersect.  By default we return
36              all possible pairs in the data base.  Append the name of a  file
37              with  a  list of tracks if you want to limit the output to those
38              pairs that involve at least one of the track names in your list.
39              The output is suitable for the -K option in x2sys_cross.
40
41       -N     Give a comma-separated list of column names (as described in the
42              definition file) that must be absent.
43
44       -R     west, east, south, and north specify the Region of interest, and
45              you    may    specify    them   in   decimal   degrees   or   in
46              [+-]dd:mm[:ss.xxx][W|E|S|N] format.  Append r if lower left  and
47              upper  right  map coordinates are given instead of w/e/s/n.  The
48              two shorthands -Rg and -Rd stand for global  domain  (0/360  and
49              -180/+180 in longitude respectively, with -90/+90 in latitude).
50
51       -V     Selects verbose mode, which will send progress reports to stderr
52              [Default runs "silently"].
53

EXAMPLES

55       To find all the tracks associated with the  tag  mgd77,  restricted  to
56       occupy  a  certain  region in the south Pacific, and have at least free
57       air anomalies and bathymetry, try
58
59       x2sys_get -V -Tmgd77 -R180/240/-60/-30 -Ffaa,depth
60
61       To find all the tracks associated with the tag mgd77  that  have  depth
62       but not twt, try
63
64       x2sys_get -V -Tmgd77 -Fdepth -Ntwt
65
66       To  find  all the pairs associated with the tag mgd77 that might inter‐
67       sect each other, but only those pairs which  involves  tracks  in  your
68       list new.lis, try
69
70       x2sys_get -V -Tmgd77 -Lnew.lis > xpairs.lis
71

SEE ALSO

73       x2sys_binlist(1)    x2sys_cross(1)    x2sys_datalist(1)   x2sys_init(1)
74       x2sys_put(1)
75
76
77
78GMT 4.3.1                         15 May 2008                     X2SYS_GET(1)