X2SYS_PUT(1gmt) Generic Mapping Tools X2SYS_PUT(1gmt)
NAME
x2sys_put - Update x2sys track data bases
SYNOPSIS
x2sys_put [ info.tbf ] -TTAG [ -D ] [ -F ] [ -V ]
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 cer-
tain 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.
-T Specify the x2sys TAG which tracks the attributes of this data type.
OPTIONS
No space between the option flag and the associated arguments.
info.tbf
Name of a single track bin file. If not given, stdin will be read.
-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 Selects verbose mode, which will send progress reports to stderr [Default runs "silently"].
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
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 cross-
ing the bin. The bins are defined by the -R and -I 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(1), x2sys_get(1)
GMT 4.5.7 15 Jul 2011 X2SYS_PUT(1gmt)
