/usr/share/doc/gmt/html/man/x2sys_binlist.html is in gmt-doc 4.5.11-1build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 | <!-- Creator : groff version 1.19.2 -->
<!-- CreationDate: Tue Nov 5 09:45:51 2013 -->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta name="generator" content="groff -Thtml, see www.gnu.org">
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="Content-Style" content="text/css">
<style type="text/css">
p { margin-top: 0; margin-bottom: 0; }
pre { margin-top: 0; margin-bottom: 0; }
table { margin-top: 0; margin-bottom: 0; }
</style>
<title>X2SYS_BINLIST</title>
</head>
<body bgcolor="#ffffff">
<h1 align=center>X2SYS_BINLIST</h1>
<a href="#NAME">NAME</a><br>
<a href="#SYNOPSIS">SYNOPSIS</a><br>
<a href="#DESCRIPTION">DESCRIPTION</a><br>
<a href="#OPTIONS">OPTIONS</a><br>
<a href="#EXAMPLES">EXAMPLES</a><br>
<a href="#SEE ALSO">SEE ALSO</a><br>
<hr>
<a name="NAME"></a>
<h2>NAME</h2>
<p style="margin-left:11%; margin-top: 1em">x2sys_binlist
− Create bin-index files from track data files</p>
<a name="SYNOPSIS"></a>
<h2>SYNOPSIS</h2>
<p style="margin-left:11%; margin-top: 1em"><b>x2sys_binlist</b>
<i>track(s)</i> <b>−T</b><i>TAG</i> [ <b>−D</b>
] [ <b>−E</b> ] [ <b>−V</b> ]</p>
<a name="DESCRIPTION"></a>
<h2>DESCRIPTION</h2>
<p style="margin-left:11%; margin-top: 1em"><b>x2sys_binlist</b>
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 <i>lon, lat, index,
flags</i>[, <i>dist</i>], where <i>lon, lat</i> are the
coordinates of the center of the bin, the <i>index</i> is
the 1-D number of the bin, and <i>flags</i> is a bitflag
that describes which data fields were available in this bin.
The optional <i>dist</i> requires <b>−D</b>. The input
files can be of any format, which must be described and
passed with the <b>−T</b> 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 <b>x2ys_init</b> to
initialize the tag before you can run the indexing.</p>
<table width="100%" border=0 rules="none" frame="void"
cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="9%">
<p style="margin-top: 1em" valign="top"><i>tracks</i></p></td>
<td width="2%"></td>
<td width="78%">
<p style="margin-top: 1em" valign="top">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 <i>TAG</i>. Track files will be searched
for first in the current directory and second in all
directories listed in
<b>$X2SYS_HOME</b>/<i>TAG</i>/<i>TAG</i>_paths.txt (if it
exists). [If <b>$X2SYS_HOME</b> is not set it will default
to <b>$GMT_SHAREDIR</b>/x2sys]. (Note: MGD77 files will also
be looked for via <b>MGD77_HOME</b>/mgd77_paths.txt and
*.gmt files will be searched for via
<b>$GMT_SHAREDIR</b>/mgg/gmtfile_paths).</p> </td>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="9%">
<p style="margin-top: 1em" valign="top"><b>−T</b></p> </td>
<td width="2%"></td>
<td width="78%">
<p style="margin-top: 1em" valign="top">Specify the x2sys
<i>TAG</i> which tracks the attributes of this data
type.</p> </td>
</table>
<a name="OPTIONS"></a>
<h2>OPTIONS</h2>
<p style="margin-left:11%; margin-top: 1em">No space
between the option flag and the associated arguments.</p>
<table width="100%" border=0 rules="none" frame="void"
cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p style="margin-top: 1em" valign="top"><b>−D</b></p> </td>
<td width="8%"></td>
<td width="78%">
<p style="margin-top: 1em" valign="top">Calculate the
length of trackline segments per bin [Default skips this
step]. The length fragments are given as the 5th output
column (after the <i>flags</i>). The length units are
obtained via the TAB setting (see <b><A HREF="x2sys_init.html">x2sys_init</A></b>).</p></td>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p style="margin-top: 1em" valign="top"><b>−E</b></p> </td>
<td width="8%"></td>
<td width="78%">
<p style="margin-top: 1em" valign="top">Convert geographic
data to a cylindrical equal-area projection prior to
binning. Basically, we apply the projection
<b>−JY</b><i>lon0</i>/37:04:17.166076/360, where
<i>lon0</i> is the mid-longitude of the region. Requires
<b>−D</b>, geographical data, and a global region
(e.g., <b>−Rg</b> or <b>−Rd</b>). 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.</p></td>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p style="margin-top: 1em" valign="top"><b>−V</b></p> </td>
<td width="8%"></td>
<td width="78%">
<p style="margin-top: 1em" valign="top">Selects verbose
mode, which will send progress reports to stderr [Default
runs "silently"].</p></td>
</table>
<a name="EXAMPLES"></a>
<h2>EXAMPLES</h2>
<p style="margin-left:11%; margin-top: 1em">To create a bin
index file from the MGD77 file 01030061.mgd77 using the
settings associated with the tag MGD77, do</p>
<p style="margin-left:11%; margin-top: 1em"><b>x2sys_binlist</b>
01030061.mgd77 <b>−T</b> MGD77 > 01030061.tbf</p>
<p style="margin-left:11%; margin-top: 1em">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</p>
<p style="margin-left:11%; margin-top: 1em"><b>x2sys_binlist</b>
*.nc <b>−T</b> MGD77+ −D <b>> all.tbf</b></p>
<a name="SEE ALSO"></a>
<h2>SEE ALSO</h2>
<p style="margin-left:11%; margin-top: 1em"><i><A HREF="x2sys_cross.html">x2sys_cross</A></i>(1),
<i><A HREF="x2sys_datalist.html">x2sys_datalist</A></i>(1), <i><A HREF="x2sys_get.html">x2sys_get</A></i>(1),
<i><A HREF="x2sys_init.html">x2sys_init</A></i>(1), <i><A HREF="x2sys_put.html">x2sys_put</A></i>(1),
<i><A HREF="x2sys_report.html">x2sys_report</A></i>(1), <i><A HREF="x2sys_solve.html">x2sys_solve</A></i>(1)</p>
<hr>
</body>
</html>
|