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 [ -D ] [ -E ] [ -V ]
10
12 x2sys_binlist reads one or more track data files and produces a multi-
13 segment ASCII track bin-index file (tbf) with the track name in the
14 header and one data record per bin crossed; these records contain lon,
15 lat, index, flags[, dist], where lon, lat are the coordinates of the
16 center of the bin, the index is the 1-D number of the bin, and flags is
17 a bitflag that describes which data fields were available in this bin.
18 The optional dist requires -D. The input files can be of any format,
19 which must be described and passed with the -T option. The bin-index
20 listing is a crude representation of where the track goes and is used
21 by the data archivist to build an x2sys track data base for miscella‐
22 neous track queries, such as when needing to determine which tracks
23 should be compared in a crossover analysis. You must run x2ys_init to
24 initialize the tag before you can run the indexing.
25 tracks Can be one or more ASCII, native binary, or COARDS netCDF 1-D
27 data files. To supply the data files via a text file with a
28 list of tracks (one per record), specify the name of the track
29 list after a leading equal-sign (e.g., =tracks.lis). If the
30 names are missing their file extension we will append the suffix
31 specified for this TAG. Track files will be searched for first
32 in the current directory and second in all directories listed in
33 $X2SYS_HOME/TAG/TAG_paths.txt (if it exists). [If $X2SYS_HOME is
34 not set it will default to $GMT_SHAREDIR/x2sys]. (Note: MGD77
35 files will also be looked for via MGD77_HOME/mgd77_paths.txt and
36 *.gmt files will be searched for via $GMT_SHAREDIR/mgg/gmt‐
37 file_paths).
38 -T Specify the x2sys TAG which tracks the attributes of this data
40 type.
41
43 No space between the option flag and the associated arguments.
44 -D Calculate the length of trackline segments per bin [Default
46 skips this step]. The length fragments are given as the 5th
47 output column (after the flags). The length units are obtained
48 via the TAB setting (see x2sys_init).
49 -E Convert geographic data to a cylindrical equal-area projection
51 prior to binning. Basically, we apply the projection
52 -JYlon0/37:04:17.166076/360, where lon0 is the mid-longitude of
53 the region. Requires -D, geographical data, and a global region
54 (e.g., -Rg or -Rd). This option is useful for statistics
55 related to trackline density but should not be used when prepar‐
56 ing bin-index files for the x2sys track data bases.
57 -V Selects verbose mode, which will send progress reports to stderr
59 [Default runs "silently"].
60
62 To create a bin index file from the MGD77 file 01030061.mgd77 using the
63 settings associated with the tag MGD77, do
64 x2sys_binlist 01030061.mgd77 -TMGD77 > 01030061.tbf
66 To create a track bin index file of all MGD77+ files residing in the
68 current directory using the settings associated with the tag MGD77+ and
69 calculate track distances, run
70 x2sys_binlist *.nc -TMGD77+ -D > all.tbf
72
74 x2sys_cross(1), x2sys_datalist(1), x2sys_get(1), x2sys_init(1),
75 x2sys_put(1), x2sys_report(1), x2sys_solve(1)
76GMT 4.5.6 10 Mar 2011 X2SYS_BINLIST(1)