[GRASS-SVN] r68277 - grass/branches/releasebranch_6_4/raster/r.mapcalc

svn_grass at osgeo.org svn_grass at osgeo.org
Sun Apr 17 15:16:03 PDT 2016


Author: neteler
Date: 2016-04-17 15:16:03 -0700 (Sun, 17 Apr 2016)
New Revision: 68277

Modified:
   grass/branches/releasebranch_6_4/raster/r.mapcalc/r.mapcalc.html
   grass/branches/releasebranch_6_4/raster/r.mapcalc/r3.mapcalc.html
Log:
r.mapcalc/r3.mapcalc manual: partial sync of KNOWN ISSUES section to trunk

Modified: grass/branches/releasebranch_6_4/raster/r.mapcalc/r.mapcalc.html
===================================================================
--- grass/branches/releasebranch_6_4/raster/r.mapcalc/r.mapcalc.html	2016-04-17 22:00:57 UTC (rev 68276)
+++ grass/branches/releasebranch_6_4/raster/r.mapcalc/r.mapcalc.html	2016-04-17 22:16:03 UTC (rev 68277)
@@ -610,14 +610,31 @@
 </pre></div>
 
 
+<h2>KNOWN ISSUES</h2>
 
+The <em>result</em> variable on the left hand side of the equation should not
+appear in the <em>expression</em> on the right hand side.
 
-<h2>BUGS</h2>
-Continuation lines must end with a \ and have NO trailing white space
-(blanks or tabs).  If the user does leave white space at the end of
+<div class="code"><pre>
+<s>mymap = if( mymap > 0, mymap, 0)</s>
+</pre></div>
+
+<p>Any maps generated by a <em>r.mapcalc</em> command only exist after the entire
+command has completed. All maps are generated concurrently, row-by-row
+(i.e. there is an implicit "for row in rows {...}" around the entire expression).
+Thus the <tt>#</tt>, <tt>@</tt>, and <tt>[ ]</tt> operators cannot be used on a map
+generated within same <em>r.mapcalc</em> command run.
+
+<div class="code"><pre>
+newmap = oldmap * 3.14
+<s>othermap = newmap[-1, 0] / newmap[1, 0]</s>
+</pre></div>
+
+<p>Continuation lines must end with a <tt>\</tt> and have <em>no</em> trailing
+white space (blanks or tabs). If the user does leave white space at the end of
 continuation lines, the error messages produced by <em>r.mapcalc</em> will
 be meaningless and the equation will not work as the user intended.
-This is important for the eval() function.
+This is particularly important for the <tt>eval()</tt> function.
 <p>
 Error messages produced by <em>r.mapcalc</em> are almost useless.
 In future, <em>r.mapcalc</em> should make some attempt
@@ -636,8 +653,8 @@
 of simply a blank line. This would make separation of multiple scripts
 separable by white space.
 <p>
-r.mapcalc does not print a warning in case of operations on NULL cells.
-It is left to the user to utilize the isnull() function.
+<em>r.mapcalc</em> does not print a warning in case of operations on NULL cells.
+It is left to the user to utilize the <tt>isnull()</tt> function.
 
 
 <h2>SEE ALSO</h2>

Modified: grass/branches/releasebranch_6_4/raster/r.mapcalc/r3.mapcalc.html
===================================================================
--- grass/branches/releasebranch_6_4/raster/r.mapcalc/r3.mapcalc.html	2016-04-17 22:00:57 UTC (rev 68276)
+++ grass/branches/releasebranch_6_4/raster/r.mapcalc/r3.mapcalc.html	2016-04-17 22:16:03 UTC (rev 68277)
@@ -478,12 +478,30 @@
 
 <h2>KNOWN ISSUES</h2>
 
-Continuation lines must end with a <tt>\</tt> and have <em>no</em> trailing
+The <em>result</em> variable on the left hand side of the equation should not
+appear in the <em>expression</em> on the right hand side.
+
+<div class="code"><pre>
+<s>mymap = if( mymap > 0, mymap, 0)</s>
+</pre></div>
+
+<p>Any maps generated by a <em>r3.mapcalc</em> command only exist after the entire
+command has completed. All maps are generated concurrently, row-by-row
+(i.e. there is an implicit "for row in rows {...}" around the entire expression).
+Thus the <tt>#</tt>, <tt>@</tt>, and <tt>[ ]</tt> operators cannot be used on a map
+generated within same <em>r3.mapcalc</em> command run.
+
+<div class="code"><pre>
+newmap = oldmap * 3.14
+<s>othermap = newmap[-1, 0] / newmap[1, 0]</s>
+</pre></div>
+
+<p>Continuation lines must end with a <tt>\</tt> and have <em>no</em> trailing
 white space (blanks or tabs). If the user does leave white space at the end of
 continuation lines, the error messages produced by <em>r3.mapcalc</em> will
 be meaningless and the equation will not work as the user intended.
 This is particularly important for the <tt>eval()</tt> function.
-<p><!-- STILL TRUE ??-->
+<p>
 Currently, there is no comment mechanism in <em>r3.mapcalc</em>.
 Perhaps adding a capability that would cause the entire line to be
 ignored when the user inserted a # at the start of a line



More information about the grass-commit mailing list