/usr/share/doc/gmt/html/man/x2sys_binlist.html is in gmt-doc 4.5.12-1.
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 | <!-- Creator : groff version 1.22.2 -->
<!-- CreationDate: Thu Feb 27 18:15:37 2014 -->
<!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; vertical-align: top }
pre { margin-top: 0; margin-bottom: 0; vertical-align: top }
table { margin-top: 0; margin-bottom: 0; vertical-align: top }
h1 { text-align: center }
</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>
<h2>NAME
<a name="NAME"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">x2sys_binlist
− Create bin-index files from track data files</p>
<h2>SYNOPSIS
<a name="SYNOPSIS"></a>
</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>
<h2>DESCRIPTION
<a name="DESCRIPTION"></a>
</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><i>tracks</i></p></td>
<td width="2%"></td>
<td width="78%">
<p>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>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="9%">
<p><b>−T</b></p></td>
<td width="2%"></td>
<td width="78%">
<p>Specify the x2sys <i>TAG</i> which tracks the attributes
of this data type.</p></td></tr>
</table>
<h2>OPTIONS
<a name="OPTIONS"></a>
</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"><b>−D</b></p></td>
<td width="8%"></td>
<td width="78%">
<p style="margin-top: 1em">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>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p><b>−E</b></p></td>
<td width="8%"></td>
<td width="78%">
<p>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>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p><b>−V</b></p></td>
<td width="8%"></td>
<td width="78%">
<p>Selects verbose mode, which will send progress reports
to stderr [Default runs "silently"].</p></td></tr>
</table>
<h2>EXAMPLES
<a name="EXAMPLES"></a>
</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>
<h2>SEE ALSO
<a name="SEE ALSO"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><b><i><A HREF="x2sys_cross.html">x2sys_cross</A></i></b>(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>
|