NAME¶
x2sys_put - Update track index database from track bin file
SYNOPSIS¶
x2sys_put [
info.tbf ]
-TTAG [
-D ] [
-F ] [
-V[
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.
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
-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,
x2sys_get
COPYRIGHT¶
2016, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe