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)
Check Out this Related Man Page
X2SYS_BINLIST(1gmt) Generic Mapping Tools X2SYS_BINLIST(1gmt)NAME
x2sys_binlist - Create bin-index files from track data files
SYNOPSIS
x2sys_binlist track(s) -TTAG [ -D ] [ -E ] [ -V ]
DESCRIPTION
x2sys_binlist reads one or more track data files and produces a multi-segment ASCII track bin-index file (tbf) with the track name in the
header and one data record per bin crossed; these records contain lon, lat, index, flags[, dist], where lon, lat are the coordinates of the
center of the bin, the index is the 1-D number of the bin, and flags is a bitflag that describes which data fields were available in this
bin. The optional dist requires -D. The input files can be of any format, which must be described and passed with the -T option. The
bin-index listing is a crude representation of where the track goes and is used by the data archivist to build an x2sys track data base for
miscellaneous track queries, such as when needing to determine which tracks should be compared in a crossover analysis. You must run
x2ys_init to initialize the tag before you can run the indexing.
tracks Can be one or more ASCII, native binary, or COARDS netCDF 1-D data files. To supply the data files via a text file with a list of
tracks (one per record), specify the name of the track list after a leading equal-sign (e.g., =tracks.lis). If the names are miss-
ing their file extension we will append the suffix specified for this TAG. Track files will be searched for first in the current
directory and second in all directories listed in $X2SYS_HOME/TAG/TAG_paths.txt (if it exists). [If $X2SYS_HOME is not set it will
default to $GMT_SHAREDIR/x2sys]. (Note: MGD77 files will also be looked for via MGD77_HOME/mgd77_paths.txt and *.gmt files will be
searched for via $GMT_SHAREDIR/mgg/gmtfile_paths).
-T Specify the x2sys TAG which tracks the attributes of this data type.
OPTIONS
No space between the option flag and the associated arguments.
-D Calculate the length of trackline segments per bin [Default skips this step]. The length fragments are given as the 5th output col-
umn (after the flags). The length units are obtained via the TAB setting (see x2sys_init).
-E Convert geographic data to a cylindrical equal-area projection prior to binning. Basically, we apply the projection
-JYlon0/37:04:17.166076/360, where lon0 is the mid-longitude of the region. Requires -D, geographical data, and a global region
(e.g., -Rg or -Rd). This option is useful for statistics related to trackline density but should not be used when preparing bin-
index files for the x2sys track data bases.
-V Selects verbose mode, which will send progress reports to stderr [Default runs "silently"].
EXAMPLES
To create a bin index file from the MGD77 file 01030061.mgd77 using the settings associated with the tag MGD77, do
x2sys_binlist 01030061.mgd77 -TMGD77 > 01030061.tbf
To create a track bin index file of all MGD77+ files residing in the current directory using the settings associated with the tag MGD77+
and calculate track distances, run
x2sys_binlist *.nc -TMGD77+ -D > all.tbf
SEE ALSO x2sys_cross(1), x2sys_datalist(1), x2sys_get(1), x2sys_init(1), x2sys_put(1), x2sys_report(1), x2sys_solve(1)GMT 4.5.7 15 Jul 2011 X2SYS_BINLIST(1gmt)