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 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).

       -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 column (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 -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

SEE ALSO

       x2sys_cross(1),     x2sys_datalist(1),    x2sys_get(1),    x2sys_init(1),    x2sys_put(1),
       x2sys_report(1), x2sys_solve(1)