1X2SYS_BINLIST(1) Generic Mapping Tools X2SYS_BINLIST(1)
2
6 x2sys_binlist - Create bin-index files from track data files
7
9 x2sys_binlist track(s) [ -TTAG ] [ -Cc|f|g|e ] [ -D ] [ -E ] [ -Nunit ]
10 [ -V ]
11
13 x2sys_binlist reads one or more track data files and produces a multi-
14 segment ASCII track bin-index file (tbf) with the track id in the
15 header and one data record per bin crossed; these records contain lon,
16 lat, index, flags[, dist], where lon, lat is the coordinates of the
17 center of the bin, the index is the 1-D number of the bin, and flags is
18 a bitflag that describes which data fields were available in each bin.
19 The optional dist requires -D. The input files can be of any format,
20 which must be described and passed with the -T option. The bin-index
21 listing is a crude representation of where the track goes and is used
22 by the data archivist to build a track data base for track queries such
23 as to determine which tracks need to be compared for crossover analy‐
24 sis. You must run x2ys_init to initialize the tag before you can run
25 the indexing.
26 tracks Can be one or more binary or ASCII data files. To give a list of
28 names, use `cat tracks.lis` or give the name of the track list
29 after a colon (e.g., :tracks.lis). If the names are missing the
30 suffix we will append the suffix that goes with this TAG. Track
31 files will be looked for first in the current directory and sec‐
32 ond in all directories listed in $X2SYS_HOME/TAG_paths.txt (if
33 it exists). [If $X2SYS_HOME is not set it will default to
34 $GMT_SHAREDIR/x2sys].
35
37 No space between the option flag and the associated arguments.
38 -C Append a one-letter code to select the procedure for along-track
40 distance calculation selected with -D (see -N for selecting
41 units):
42 c Cartesian distances in user units [Default].
43 f Flat Earth distances.
44 g Great circle distances.
45 e Geodesic distances on current GMT ellipsoid.
46 -D Calculate the length of trackline segments per bin [Default
48 skips this step]. See -C for method and -N for units. The
49 length fragments are given as the 5th output column (after the
50 flags).
51 E Convert data to a cylindrical equal-area projection prior to
53 binning. Basically, we apply the projection
54 -JYlon0/37:04:17.166076/360, where lon0 is the mid-longitude of
55 the region. Requires -D, geographical data, and a global region
56 (e.g., -Rg or -Rd).
57 -N Append the desired distance unit as e (meter), k (km), m
59 (miles), or n (nautical miles). [Default is -Nk (km)].
60 Requires -D.
61 -T Sets the data set TAG which among other things sets the defini‐
63 tion file.
64 -V Selects verbose mode, which will send progress reports to stderr
66 [Default runs "silently"].
67
69 To create a bin index table from the MGD77 file 01030061.mgd77 using a
70 global, 1x1 degree bin system, do
71 x2sys_binlist 01030061.mgd77 -TMGD77 > 01030061.tbf
73 To create a track bin index file of all MGD77+ files residing in the
75 current directory at a bin resolution of 30 x 30 minutes, calculating
76 the geodesic distance lengths for each bin in km, run
77 x2sys_binlist *.nc -TMGD77+ -Ce -D > all.tbf
79
81 gmtdefaults(1) x2sys_init(1)
82GMT 4.3.1 15 May 2008 X2SYS_BINLIST(1)