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

NAME

6       x2sys_get - Get track listing from the x2sys track index databases
7

SYNOPSIS

9       BD(x2sys_get)  -TIT(TAG)  [  -C  ]  [  -D  ]  [  -E ] [ -FIT(flags) ] [
10       -L[IT(list)]    ]    [    -NIT(flags)    ]    [    -Qe|BD(i)    ]     [
11       -Rwest/east/south/north[r] ] [ -V ] ]
12

DESCRIPTION

14       BD(x2sys_get)  will  return  the  names  of the track data files in the
15       x2sys data base for this TAG that match the  given  requirements.   You
16       may  choose  a  specific region and optionally ask only for tracks that
17       meet certain data criteria.  Finally, you may select an option to  list
18       all possible pairs that might generate crossovers.
19
20       -T     Specify  the  x2sys TAG which tracks the attributes of this data
21              type.
22

OPTIONS

24       No space between the option flag and the associated arguments.
25
26       -C     Instead of reporting the track names, just  output  the  coordi‐
27              nates of the center of each bin that has at least one track with
28              the specified data.
29
30       -D     Only report the track names [Default adds  the  availability  of
31              data for each field].
32
33       -E     Append the file extension to all reported tracks [no extension].
34
35       -F     Give a comma-separated list of column names (as described in the
36              definition file) that should all be present within the  selected
37              region.  [Default  selects  all  data columns].  A track will be
38              included in the returned list if at least one bin  reports  that
39              the track has all of the listed columns.
40
41       -L     Crossover  mode.   Return  a  list of track pairs that should be
42              checked for possible crossovers.  The list  is  determined  from
43              the  bin-index data base on the assumption that tracks occupying
44              the same bin are very likely to intersect.  By default we return
45              all  possible pairs in the data base.  Append the name of a file
46              with a list of tracks if you want to limit the output  to  those
47              pairs that involve at least one of the track names in your list.
48              The output is suitable for the -K option in x2sys_cross.
49
50       -N     Give a comma-separated list of column names (as described in the
51              definition  file)  that  all  must  be  absent.  A track will be
52              excluded from the returned list if at least one bin reports that
53              the track some all of the listed columns.
54
55       -Q     Append  e  for  external COEs only, and i for internal COEs only
56              [Default is all COEs].  This applies to the crossover setup only
57              and requires -L.
58
59       -R     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, specify the name of an existing grid file and the
66              -R settings (and grid spacing, if applicable)  are  copied  from
67              the  grid.   For  Cartesian  data just give xmin/xmax/ymin/ymax.
68              This option limits the tracks to those that fall at least partly
69              inside the specified domain.
70
71       -V     Selects verbose mode, which will send progress reports to stderr
72              [Default runs "silently"].
73

EXAMPLES

75       To find all the tracks associated with the  tag  MGD77,  restricted  to
76       occupy  a  certain  region in the south Pacific, and have at least free
77       air anomalies and bathymetry, try
78
79       BD(x2sys_get) -V -TMGD77 -R180/240/-60/-30 -Ffaa,depth
80
81       To find all the tracks associated with the tag MGD77  that  have  depth
82       but not twt, try
83
84       BD(x2sys_get) -V -TMGD77 -Fdepth -Ntwt
85
86       To  find  all the pairs associated with the tag MGD77 that might inter‐
87       sect each other, but only those pairs which  involves  tracks  in  your
88       list new.lis, try
89
90       BD(x2sys_get) -V -TMGD77 -Lnew.lis > xpairs.lis
91

NOTE

93       The  tracks  that  are returned all have the requested data (-F) within
94       the specified region (-R).  Furthermore, the columns of  Y  and  N  for
95       other  data  types also reflect the content of the track portion within
96       the selected region.
97

SEE ALSO

99       x2sys_binlist(1),  x2sys_cross(1),  x2sys_datalist(1),   x2sys_init(1),
100       x2sys_list(1), x2sys_put(1), x2sys_report(1), x2sys_solve(1)
101
102
103
104GMT 4.5.6                         10 Mar 2011                     X2SYS_GET(1)
Impressum