1X2SYS_PUT(1)                          GMT                         X2SYS_PUT(1)
2
3
4

NAME

6       x2sys_put - Update track index database from track bin file
7

SYNOPSIS

9       x2sys_put [ info.tbf ]  -TTAG [  -D ] [  -F ] [  -V[level] ]
10
11       Note:  No  space  is allowed between the option flag and the associated
12       arguments.
13

DESCRIPTION

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

REQUIRED ARGUMENTS

23       info.tbf
24              Name  of  a  single  track bin file. If not given, stdin will be
25              read.
26
27       -TTAG  Specify the x2sys TAG which tracks the attributes of  this  data
28              type.
29

OPTIONAL ARGUMENTS

31       -D     Delete  all tracks found in the track bin file [Default will try
32              to add them as new track entries].
33
34       -F     Replace any existing database information for these tracks  with
35              the  new  information  in the track bin file [Default refuses to
36              process tracks already in the database].
37
38       -V[level] (more ...)
39              Select verbosity level [c].
40
41       -^ or just -
42              Print a short message about the  syntax  of  the  command,  then
43              exits (NOTE: on Windows just use -).
44
45       -+ or just +
46              Print  an extensive usage (help) message, including the explana‐
47              tion of any module-specific  option  (but  not  the  GMT  common
48              options), then exits.
49
50       -? or no arguments
51              Print a complete usage (help) message, including the explanation
52              of all options, then exits.
53

EXAMPLES

55       To add the information stored in the track bin-index file latest.tbf to
56       the  track  data  bases  associated with the tag MGD77, and replace any
57       exiting information for these tracks, try
58
59              gmt x2sys_put latest.tbf -F -V -TMGD77
60

X2SYS DATABASES

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

SEE ALSO

74       x2sys_binlist, x2sys_get
75

77       2019, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe
78
79
80
81
825.4.5                            Feb 24, 2019                     X2SYS_PUT(1)
Impressum