NAME

       x2sys_put - Update track index database from track bin file

SYNOPSIS

       x2sys_put [ info.tbf ] TAG [  ] [  ] [ [level] ]

       Note: No space is allowed between the option flag and the associated arguments.

DESCRIPTION

       x2sys_put  accepts  a  track  bin-index  file  created  by  x2sys_binlist  and  adds  this
       information about the data tracks to the relevant data base. You may  chose  to  overwrite
       existing  data  with  new  information  for  older  tracks (-F) and even completely remove
       information for certain tracks (-D). The x2sys TAG must  match  the  tag  encoded  in  the
       info.tbf file. To inquire about tracks in the data base, use x2sys_get.

REQUIRED ARGUMENTS

       info.tbf
              Name of a single track bin file. If not given, stdin will be read.

       -TTAG  Specify the x2sys TAG which tracks the attributes of this data type.

OPTIONAL ARGUMENTS

       -D     Delete  all tracks found in the track bin file [Default will try to add them as new
              track entries].

       -F     Replace any existing database information for these tracks with the new information
              in the track bin file [Default refuses to process tracks already in the database].

       -V[level] (more ...)
              Select verbosity level [c].

       -^ or just -
              Print a short message about the syntax of the command, then exits (NOTE: on Windows
              use just -).

       -+ 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 options, then
              exits.

       --version
              Print GMT version and exit.

       --show-datadir
              Print full path to GMT share directory and exit.

EXAMPLES

       To add the information stored in the track bin-index file latest.tbf  to  the  track  data
       bases associated with the tag MGD77, and replace any exiting information for these tracks,
       try

              gmt x2sys_put latest.tbf -F -V -TMGD77

X2SYS DATABASES

       The x2sys_put utility adds new information to the x2sys data bases.  These consists of two
       files:  The  first  file  contains a listing of all the tracks that have been added to the
       system; it is named TAG_tracks.d and  is  in  ASCII  format.  The  second  file  is  named
       TAG_index.b  and is in native binary format. It contains information on which tracks cross
       each of the bins, and what data sets were observed while crossing the bin.  The  bins  are
       defined  by  the  and options passed to x2sys_init when the TAG was first initiated.  Both
       data base files are stored in the $X2SYS_HOME/TAG directory.  Do not attempt to edit these
       files by hand.

SEE ALSO

       x2sys_binlist, x2sys_get

COPYRIGHT

       2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe