|
@@ -1,14 +1,15 @@
|
|
|
-<H2>DESCRIPTION</H2>
|
|
|
+<h2>DESCRIPTION</h2>
|
|
|
|
|
|
-
|
|
|
-<EM>r.in.ascii</EM> allows a user to create a (binary) GRASS raster map
|
|
|
+<em>r.in.ascii</em> allows a user to create a (binary) GRASS raster map
|
|
|
layer from an ASCII raster input file with (optional) TITLE.
|
|
|
|
|
|
-<P>
|
|
|
-The GRASS ASCII <B>input</B> file has a header section which describes
|
|
|
+<p>
|
|
|
+
|
|
|
+The GRASS ASCII <b>input</b> file has a header section which describes
|
|
|
the location and size of the data, followed by the data itself.
|
|
|
|
|
|
-<P>
|
|
|
+<p>
|
|
|
+
|
|
|
The header has 6 lines:
|
|
|
|
|
|
<div class="code"><pre>
|
|
@@ -24,8 +25,10 @@ The north, south, east, and west field values entered
|
|
|
are the coordinates of the edges of the geographic region.
|
|
|
The rows and cols field values entered describe the dimensions
|
|
|
of the matrix of data to follow.
|
|
|
-The data which follows is <EM>r</EM> rows of <EM>c</EM> integers.
|
|
|
+The data which follows is <em>r</em> rows of <em>c</em> integers.
|
|
|
+
|
|
|
<p>
|
|
|
+
|
|
|
Optionally the following parameters can be defined in the header section:
|
|
|
|
|
|
<div class="code"><pre>
|
|
@@ -35,14 +38,47 @@ multiplier: 2.
|
|
|
</pre></div>
|
|
|
|
|
|
<p>
|
|
|
+
|
|
|
"null" defines a string or number to be converted to NULL value (no
|
|
|
data).<br>
|
|
|
"type" defines the data type (int, float double) and is not required.<br>
|
|
|
"multiplier" is an optional parameter to multiply each cell value.
|
|
|
|
|
|
-<H2>EXAMPLE</H2>
|
|
|
+<h2>NOTES</h2>
|
|
|
+
|
|
|
+The geographic coordinates north, south, east, and west
|
|
|
+describe the outer edges of the geographic region. They
|
|
|
+run along the edges of the cells at the edge of the
|
|
|
+geographic region and <em>not</em> through the center of the cells
|
|
|
+at the edges.
|
|
|
+The NW value occurs at the beginning of the first line of data, and the
|
|
|
+SW value occurs at the beginning of the last line of data.
|
|
|
+
|
|
|
+<p>
|
|
|
+
|
|
|
+The data (which follows the header section) must contain
|
|
|
+<tt>r</tt> <em>x</em> <tt>c</tt> values, but it is not necessary
|
|
|
+that all the data for a row be on one line. A row may be
|
|
|
+split over many lines.
|
|
|
+
|
|
|
+<p>
|
|
|
+
|
|
|
+<em>r.in.ascii</em> may import <i>integer</i>, <i>floating point</i>, or <i>double</i> cell
|
|
|
+types using the <b>-i</b>, <b>-f</b>, and <b>-d</b> flags, respectively.
|
|
|
+
|
|
|
+<p>
|
|
|
+
|
|
|
+The header information in ESRI Raster ASCII files differs from GRASS.
|
|
|
+To convert an Arc/Info (ArcView) ASCII grid file into GRASS, see
|
|
|
+<em><a href="r.in.arc.html">r.in.arc</a></em>.
|
|
|
|
|
|
-The following is a sample <b>input</b> file to <EM>r.in.ascii</EM>:
|
|
|
+<p>
|
|
|
+
|
|
|
+SURFER (Golden Software) ASCII files may be imported by passing the <b>-s</b> flag.
|
|
|
+
|
|
|
+<h2>EXAMPLE</h2>
|
|
|
+
|
|
|
+The following is a sample <b>input</b> file to <em>r.in.ascii</em>:
|
|
|
|
|
|
<div class="code"><pre>
|
|
|
north: 4299000.00
|
|
@@ -65,45 +101,19 @@ null: -9999
|
|
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
|
|
|
</pre></div>
|
|
|
|
|
|
-<H2>NOTES</H2>
|
|
|
+<h2>SEE ALSO</h2>
|
|
|
|
|
|
-The geographic coordinates north, south, east, and west
|
|
|
-describe the outer edges of the geographic region. They
|
|
|
-run along the edges of the cells at the edge of the
|
|
|
-geographic region and <EM>not</EM> through the center of the cells
|
|
|
-at the edges.
|
|
|
-The NW value occurs at the beginning of the first line of data, and the
|
|
|
-SW value occurs at the beginning of the last line of data.
|
|
|
-<P>
|
|
|
-The data (which follows the header section) must contain
|
|
|
-<tt>r</tt> <em>x</em> <tt>c</tt> values, but it is not necessary
|
|
|
-that all the data for a row be on one line. A row may be
|
|
|
-split over many lines.
|
|
|
-
|
|
|
-<P>
|
|
|
+<em>
|
|
|
+<a href="r.out.ascii.html">r.out.ascii</a>,
|
|
|
+<a href="r.in.arc.html">r.in.arc</a>,
|
|
|
+<a href="r.in.gdal.html">r.in.gdal</a>,
|
|
|
+<a href="r.out.arc.html">r.out.arc</a>,
|
|
|
+<a href="r.in.bin.html">r.in.bin</a>,
|
|
|
+<a href="r3.in.ascii.html">r3.in.ascii</a></em>,
|
|
|
+<a href="http://grass.itc.it/gdp/html_grass5/ascii_formats.html">GRASS ASCII formats</a>
|
|
|
+</em>
|
|
|
|
|
|
-<EM>r.in.ascii</EM> handles floating point cell values.
|
|
|
-
|
|
|
-<P>
|
|
|
-The header information in ESRI Raster ASCII files differs from GRASS.
|
|
|
-To convert an Arc/Info (ArcView) ASCII grid file into GRASS, click
|
|
|
-<A HREF="http://grass.itc.it/faq/arcgrid.header.html">here</A>.
|
|
|
-Also, see <EM><A HREF="r.in.arc.html">r.in.arc</A></EM> to import
|
|
|
-ESRI Raster ASCII files.
|
|
|
-
|
|
|
-<H2>SEE ALSO</H2>
|
|
|
-
|
|
|
-<EM>
|
|
|
-<A HREF="r.out.ascii.html">r.out.ascii</A>,
|
|
|
-<A HREF="r.in.arc.html">r.in.arc</A>,
|
|
|
-<A HREF="r.in.gdal.html">r.in.gdal</A>,
|
|
|
-<A HREF="r.out.arc.html">r.out.arc</A>,
|
|
|
-<A HREF="r.in.bin.html">r.in.bin</A>,
|
|
|
-<A HREF="r3.in.ascii.html">r3.in.ascii</A></em>,
|
|
|
-<A HREF="http://grass.itc.it/gdp/html_grass5/ascii_formats.html">GRASS ASCII formats</A>
|
|
|
-</EM>
|
|
|
-
|
|
|
-<H2>AUTHOR</H2>
|
|
|
+<h2>AUTHOR</h2>
|
|
|
|
|
|
Michael Shapiro, U.S. Army Construction Engineering Research Laboratory<br>
|
|
|
Surfer support by Roger Miller
|