<!-- Creator : groff version 1.19.2 -->
<!-- CreationDate: Wed Jul 14 08:43:29 2010 -->
<!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>GRDINFO</title>
</head>
<body bgcolor="#ffffff">
<h1 align=center>GRDINFO</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="#GRID FILE FORMATS">GRID FILE FORMATS</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">grdinfo −
Get information about the contents of a 2-D grid file</p>
<a name="SYNOPSIS"></a>
<h2>SYNOPSIS</h2>
<p style="margin-left:11%; margin-top: 1em"><b>grdinfo</b>
<i>grdfiles</i> [ <b>−C</b> ] [ <b>−F</b> ] [
<b>−I</b>[<i>dx</i>[/<i>dy</i>]] ][
<b>−L</b>[<b>0</b>|<b>1</b>|<b>2</b>] ] [
<b>−M</b> ] [ <b>−T</b><i>dz</i> ] [
<b>−V</b> ] [
<b>−f</b>[<b>i</b>|<b>o</b>]<i>colinfo</i> ]</p>
<a name="DESCRIPTION"></a>
<h2>DESCRIPTION</h2>
<p style="margin-left:11%; margin-top: 1em"><b>grdinfo</b>
reads a 2-D binary grid file and reports various statistics
for the (<i>x,y,z</i>) data in the grid file(s). The output
information contains the minimum/maximum values for
<i>x</i>, <i>y</i>, and <i>z</i>, where the min/max of
<i>z</i> occur, the <i>x</i>- and <i>y</i>-increments, and
the number of <i>x</i> and <i>y</i> nodes, and [optionally]
the mean, standard deviation, and/or the median, L1 scale of
<i>z</i>, and number of nodes set to NaN. <i><br>
grdfile</i></p>
<p style="margin-left:22%;">The name of one or several 2-D
grid files. (See GRID FILE FORMATS below.)</p>
<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="4%">
<p style="margin-top: 1em" valign="top"><b>−C</b></p> </td>
<td width="7%"></td>
<td width="78%">
<p style="margin-top: 1em" valign="top">Formats the report
using tab-separated fields on a single line. The output is
<i>w e s n z0 z1 dx dy nx ny</i> [ <i>x0 y0 x1 y1</i> ] [
<i>med scale</i> ] [ <i>mean std rms</i>] [<i>n_nan</i>].
The data in brackets are output only if the corresponding
options <b>−M</b>, <b>−L1</b>, <b>−L2</b>,
and <b>−M</b> are used, respectively. If the
<b>−I</b> option is used, the output format is instead
<i>NF w e s n z0 z1</i>, where <i>NF</i> is the total number
of grids read and <i>w e s n</i> are rounded off (see
<b>−I</b>).</p> </td>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="4%">
<p style="margin-top: 1em" valign="top"><b>−F</b></p> </td>
<td width="7%"></td>
<td width="78%">
<p style="margin-top: 1em" valign="top">Report grid domain
and x/y-increments in world mapping format [Default is
generic]. Does not apply to the <b>−C</b> option.</p></td>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="4%">
<p style="margin-top: 1em" valign="top"><b>−I</b></p> </td>
<td width="7%"></td>
<td width="78%">
<p style="margin-top: 1em" valign="top">Report the min/max
of the region to the nearest multiple of <i>dx</i> and
<i>dy</i>, and output this in the form
<b>−R</b><i>w/e/s/n</i> (unless <b>−C</b> is
set). To report the actual grid region, select
<b>−I-</b>. If no argument is given then we report the
grid increment in the form
<b>−I</b><i>xinc/yinc</i>.</p> </td>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="4%">
<p style="margin-top: 1em" valign="top"><b>−L0</b></p> </td>
<td width="7%"></td>
<td width="78%">
<p style="margin-top: 1em" valign="top">Report range of z
after actually scanning the data, not just reporting what
the header says.</p></td>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="4%">
<p style="margin-top: 1em" valign="top"><b>−L1</b></p> </td>
<td width="7%"></td>
<td width="78%">
<p style="margin-top: 1em" valign="top">Report median and
L1 scale of z (L1 scale = 1.4826 * Median Absolute Deviation
(MAD)).</p> </td>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="4%">
<p style="margin-top: 1em" valign="top"><b>−L2</b></p> </td>
<td width="7%"></td>
<td width="78%">
<p style="margin-top: 1em" valign="top">Report mean,
standard deviation, and rms of z.</p></td>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="4%">
<p style="margin-top: 1em" valign="top"><b>−M</b></p> </td>
<td width="7%"></td>
<td width="78%">
<p style="margin-top: 1em" valign="top">Find and report the
location of min/max z-values, and count and report the
number of nodes set to NaN, if any.</p></td>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="4%">
<p style="margin-top: 1em" valign="top"><b>−T</b></p> </td>
<td width="7%"></td>
<td width="78%">
<p style="margin-top: 1em" valign="top">Determine min and
max z-value, round off to multiples of <i>dz</i>, and report
as the text string <b>−T</b><i>zmin/zmax/dz</i> for
use by <b><A HREF="makecpt.html">makecpt</A></b>.</p></td>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="4%">
<p style="margin-top: 1em" valign="top"><b>−V</b></p> </td>
<td width="7%"></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>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="4%">
<p style="margin-top: 1em" valign="top"><b>−f</b></p> </td>
<td width="7%"></td>
<td width="78%">
<p style="margin-top: 1em" valign="top">Special formatting
of input and/or output columns (time or geographical data).
Specify <b>i</b> or <b>o</b> to make this apply only to
input or output [Default applies to both]. Give one or more
columns (or column ranges) separated by commas. Append
<b>T</b> (absolute calendar time), <b>t</b> (relative time
in chosen <b><A HREF="gmtdefaults.html#TIME_UNIT">TIME_UNIT</A></b> since <b><A HREF="gmtdefaults.html#TIME_EPOCH">TIME_EPOCH</A></b>),
<b>x</b> (longitude), <b>y</b> (latitude), or <b>f</b>
(floating point) to each column or column range item.
Shorthand <b>−f</b>[<b>i</b>|<b>o</b>]<b>g</b> means
<b>−f</b>[<b>i</b>|<b>o</b>]0<b>x</b>,1<b>y</b>
(geographic coordinates).</p></td>
</table>
<a name="GRID FILE FORMATS"></a>
<h2>GRID FILE FORMATS</h2>
<p style="margin-left:11%; margin-top: 1em"><b><A HREF="GMT.html">GMT</A></b> is
able to recognize many of the commonly used grid file
formats, as well as the precision, scale and offset of the
values contained in the grid file. When <b><A HREF="GMT.html">GMT</A></b> needs a
little help with that, you can add the suffix
<b>=</b><i>id</i>[<b>/</b><i>scale</i><b>/</b><i>offset</i>[<b>/</b><i>nan</i>]],
where <i>id</i> is a two-letter identifier of the grid type
and precision, and <i>scale</i> and <i>offset</i> are
optional scale factor and offset to be applied to all grid
values, and <i>nan</i> is the value used to indicate missing
data. See <b><A HREF="grdreformat.html">grdreformat</A></b>(1) and Section 4.17 of the GMT
Technical Reference and Cookbook for more information.</p>
<p style="margin-left:11%; margin-top: 1em">When reading a
netCDF file that contains multiple grids, <b><A HREF="GMT.html">GMT</A></b> will
read, by default, the first 2-dimensional grid that can find
in that file. To coax <b><A HREF="GMT.html">GMT</A></b> into reading another
multi-dimensional variable in the grid file, append
<b>?</b><i>varname</i> to the file name, where
<i>varname</i> is the name of the variable. Note that you
may need to escape the special meaning of <b>?</b> in your
shell program by putting a backslash in front of it, or by
placing the filename and suffix between quotes or double
quotes. See <b><A HREF="grdreformat.html">grdreformat</A></b>(1) and Section 4.18 of the
GMT Technical Reference and Cookbook for more information,
particularly on how to read splices of 3-, 4-, or
5-dimensional grids.</p>
<a name="EXAMPLES"></a>
<h2>EXAMPLES</h2>
<p style="margin-left:11%; margin-top: 1em">To obtain all
the information about the data set in file
hawaii_topo.grd:</p>
<p style="margin-left:11%; margin-top: 1em"><b>grdinfo
−L1 −L2 −M</b> hawaii_topo.grd</p>
<a name="SEE ALSO"></a>
<h2>SEE ALSO</h2>
<p style="margin-left:11%; margin-top: 1em"><i><A HREF="GMT.html">GMT</A></i>(1),
<i><A HREF="grd2cpt.html">grd2cpt</A></i>(1), <i><A HREF="grd2xyz.html">grd2xyz</A></i>(1), <i><A HREF="grdedit.html">grdedit</A></i>(1)</p>
<hr>
</body>
</html>
distrib
>
Fedora
>
14
>
x86_64
>
media
>
os
>
by-pkgid
>
4b194777eaf705e440bb2ce282d32772
>
files
>
945
