manpagez: man pages & more
man x2sys_get(1)
Home | html | info | man
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
© manpagez.com 2000-2021
Individual documents may contain additional copyright information.