|
|
CDfs 2.6.27 (Default branch)
12-23-2008
|
|
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)