[GRASS-SVN] r39249 -
grass/branches/releasebranch_6_4/raster/r.reclass
svn_grass at osgeo.org
svn_grass at osgeo.org
Sat Sep 19 11:10:59 EDT 2009
Author: hamish
Date: 2009-09-19 11:10:59 -0400 (Sat, 19 Sep 2009)
New Revision: 39249
Modified:
grass/branches/releasebranch_6_4/raster/r.reclass/description.html
Log:
remove references to grass 5 interactive mode; document *=*; cleanup (merge from devbr6)
Modified: grass/branches/releasebranch_6_4/raster/r.reclass/description.html
===================================================================
--- grass/branches/releasebranch_6_4/raster/r.reclass/description.html 2009-09-19 15:09:30 UTC (rev 39248)
+++ grass/branches/releasebranch_6_4/raster/r.reclass/description.html 2009-09-19 15:10:59 UTC (rev 39249)
@@ -51,15 +51,16 @@
<p>
To convert a reclass map to a regular raster map layer, set your
geographic region settings to match the settings in the header for the
-reclass map (an ASCII file found under the <em>cellhd</em> directory, or
-viewable by running <em><a href="r.support.html">r.support</a></em>) and then run <em><a href="r.resample.html">r.resample</a></em>.
+reclass map (with "<tt>g.region rast=reclass_map</tt>", or
+viewable by running <em><a href="r.info.html">r.info</a></em>)
+and then run <em><a href="r.resample.html">r.resample</a></em>.
<p>
<em><a href="r.mapcalc.html">r.mapcalc</a></em> can be used to convert
-a reclass map to a regular raster map layer:
+a reclass map to a regular raster map layer as well:
<div class="code"><pre>
- r.mapcalc raster_map=reclass_map
+ r.mapcalc "raster_map = reclass_map"
</pre></div>
@@ -81,104 +82,12 @@
from which they were generated. Alternatively r.recode can be used.
<p>
-Category values which are not explicitly reclassified to a new value.
+Category values which are not explicitly reclassified to a new value
+by the user will be reclassified to NULL.
-<h2>EXAMPLES</h2>
-<h3>Interactive Program Use</h3>
+<h3>Reclass Rules</h3>
-Suppose we want to reclassify the raster map layer
-<em>roads</em>, consisting of five categories, into the
-three new categories: paved roads, unpaved roads, and
-railroad tracks. The user is asked whether the reclass
-table is to be established with each category value
-initially set to 0, or with each category value initially
-set to its own value. A screen like that shown below then
-appears, listing the categories of the <em>roads</em>
-raster map layer to be reclassified and prompting the user
-for the new category values to be assigned them.
-<p>
-<pre>
- ENTER NEW CATEGORY NUMBERS FOR THESE CATEGORIES
-
- OLD CATEGORY NAME OLD NEW
- NUM NUM
- no data 0 0___
- Hard Surface, 2 lanes 1 0___
- Loose Surface, 1 lane 2 0___
- Improved Dirt 3 0___
- Unimproved Dirt Trail 4 0___
- Railroad, single track 5 0___
-
- AFTER COMPLETING ALL ANSWERS, HIT <ESC> TO CONTINUE
- (OR <Ctrl-C> TO CANCEL)
-</pre>
-
-In the following screen the new category values have been
-entered beside the appropriate old category names. Cells
-assigned category values 2, 3, and 4 in the old raster map
-layer are now assigned the new category value 2 in the
-reclassed map; cell data formerly assigned to category
-value 5 in the old raster map map are now assigned the new
-category value 3 in the reclassed map.
-<pre>
- ENTER NEW CATEGORY NUMBERS FOR THESE CATEGORIES
-
-
- OLD CATEGORY NAME OLD NEW
- NUM NUM
- no data 0 0___
- Hard Surface, 2 lanes 1 1___
- Loose Surface, 1 lane 2 2___
- Improved Dirt 3 2___
- Unimproved Dirt Trail 4 2___
- Railroad, single track 5 3___
-
- AFTER COMPLETING ALL ANSWERS, HIT <ESC> TO CONTINUE
- (OR <Ctrl-C> TO CANCEL)
-</pre>
-
-Hitting the escape key <ESC> will bring up the
-following screen, which prompts the user to enter a new
-TITLE and category label for the newly <b>reclassed</b>
-categories.
-<pre>
- ENTER NEW CATEGORY NAMES FOR THESE CATEGORIES
-
- TITLE: Roads Reclassified
- CAT NEW CATEGORY NAME
- NUM
- 0 no data
- 1 Paved Roads
- 2 Unpaved Roads
- 3 Railroad, single track
-
- AFTER COMPLETING ALL ANSWERS, HIT <ESC> TO CONTINUE
- (OR <Ctrl-C> TO CANCEL)
-</pre>
-Based upon the information supplied by the user in the above sample screens,
-the new output map, supporting category, color, history, and header files
-are created.
-
-<h3>Non-Interactive Program Use: Reclass Rules</h3>
-
-In non-interactive program use, the names of an input map, output map,
-and output map TITLE are given on the command line.
-However, the reclass rules are still read from standard input
-(i.e., from the keyboard, redirected
-from a file, or piped through another program).
-
-<p>
-
-Once the user has specified an input raster map layer,
-output map layer name, and (optionally) output map layer
-TITLE by typing
-
-<dl>
-<dd>
-<b>r.reclass input=</b><em>name </em><b>output=</b><em>name </em>[<b>TITLE=</b><em>name</em>]
-</dl>
-
Each line of input must have the following format:
<dl>
@@ -186,7 +95,7 @@
</dl>
<p>
-where the input lines specify the category values in the
+where each line of input specifies the category values in the
input raster map layer to be reclassified to the new
<em>output_category</em> category value. Specification of
a <em>label</em> to be associated with the new output map
@@ -199,16 +108,20 @@
<p>
To include all (remaining) values the asterix "*" can be used. This
rule has to be set as last rule. No further rules are accepted after
-setting this rule.
+setting this rule. The special rule "<tt>* = *</tt>" specifies
+that all categories not expicitly set by one of the above rules
+should be passed through unaltered instead of being set to NULL.
<p>
-No data have to be spcified with NULL.
+Categories to become no data are specified by setting the output
+category value to "<tt>NULL</tt>".
<p>
A line containing only the word <b>end</b> terminates the
input.
-<h3>Non-Interactive Program Use</h3>
+<h2>EXAMPLES</h2>
+
The following examples may help clarify the reclass rules.
<p>
<dl>
@@ -222,8 +135,22 @@
1 2 3 = 1 good quality
4 5 = 2 poor quality
</pre>
+
+
<p>
-<dd>2. This example reclassifies input raster map layer categories 1 thru 10 to output
+<dd>2. This example reclassifies categories 1, 3 and 5 in the input raster
+map layer to category 1 with category label "poor quality" in the output
+map layer, and reclassifies input raster map layer categories 2, 4, and 6
+to category 2 with the label "good quality" in the output map layer.
+All other values are reclassified to NULL.
+<pre>
+ 1 3 5 = 1 poor quality
+ 2 4 6 = 2 good quality
+ * = NULL
+</pre>
+
+<p>
+<dd>3. This example reclassifies input raster map layer categories 1 thru 10 to output
map layer category 1, input map layer categories 11 thru 20 to output map layer
category 2, and input map layer categories 21 thru 30 to output map layer
category 3, all without labels. The range from 30 to 40 is reclassified as
@@ -235,7 +162,8 @@
30 thru 40 = NULL
</pre>
-<dd>3. Subsequent rules override previous rules. Therefore, the below example
+<p>
+<dd>4. Subsequent rules override previous rules. Therefore, the below example
reclassifies input raster map layer categories 1 thru 19 and 51 thru 100
to category 1 in the output map layer,
input raster map layer categories 20 thru 24 and 26 thru 50 to
@@ -247,17 +175,7 @@
25 = 3 good quality
</pre>
-<dd>4. This example reclassifies categories 1, 3 and 5 in the input raster map layer to category 1 with category label "poor quality" in the output map layer,
-and reclassifies input raster map layer categories 2, 4, and 6
-to category 2 with the label "good quality" in the output map layer.
-All other values are reclassified to NULL.
-<pre>
- 1 3 5 = 1 poor quality
- 2 4 6 = 2 good quality
- * = NULL
-</pre>
<p>
-
<dd>5. The previous example could also have been entered as:
<pre>
1 thru 19 51 thru 100 = 1 poor quality
@@ -282,7 +200,6 @@
the last label which was specified becomes the label for that category.
In this case the labels are assigned exactly as in the two previous examples.
-by the user will be reclassified to NULL.
<h2>SEE ALSO</h2>
@@ -290,13 +207,11 @@
<em><a href="r.rescale.html">r.rescale</a></em>,
<em><a href="r.recode.html">r.recode</a></em>
+
<h2>AUTHORS</h2>
-James Westervelt,
-<br>
-
-Michael Shapiro,
-<br>
+James Westervelt,<br>
+Michael Shapiro<br>
U.S.Army Construction Engineering Research Laboratory
<p>
More information about the grass-commit
mailing list