Manual Reference Pages - X2SYS_BINLIST (1)
x2sys_binlist - Create bin-index files from track data files
x2sys_binlist track(s) -TTAG
[ -D ] [ -E ] [ -V ]
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.
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 missing 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).
Specify the x2sys TAG which tracks the attributes of this data type.
No space between the option flag and the associated arguments.
Calculate the length of trackline segments per bin [Default skips this step].
The length fragments are given as the 5th output column (after the flags).
The length units are obtained via the TAB setting (see x2sys_init).
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.
Selects verbose mode, which will send progress reports to stderr [Default runs "silently"].
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 -T MGD77 > 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 -T MGD77+ -D > all.tbf
|GMT 4.5.14 ||X2SYS_BINLIST (1) ||1 Nov 2015 |
Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.