[GRASS-SVN] r72894 - grass/branches/releasebranch_7_2/scripts/d.rast.edit

[svn_grass at osgeo.org]

Author: neteler
Date: 2018-06-24 03:15:29 -0700 (Sun, 24 Jun 2018)
New Revision: 72894

Added:
   grass/branches/releasebranch_7_2/scripts/d.rast.edit/d_rast_edit.png
Modified:
   grass/branches/releasebranch_7_2/scripts/d.rast.edit/d.rast.edit.html
Log:
d.rast.edit manual: updated to current version; example added

Modified: grass/branches/releasebranch_7_2/scripts/d.rast.edit/d.rast.edit.html
===================================================================
--- grass/branches/releasebranch_7_2/scripts/d.rast.edit/d.rast.edit.html	2018-06-24 10:15:04 UTC (rev 72893)
+++ grass/branches/releasebranch_7_2/scripts/d.rast.edit/d.rast.edit.html	2018-06-24 10:15:29 UTC (rev 72894)
@@ -4,35 +4,35 @@
 edit cell category values in a raster map layer displayed to the
 graphics monitor using a mouse cursor.
 
+<h3>Overview window</h3>
 
-<h2>USAGE</h2>
+An overview window shows the entire map with a red box showing the current
+editing region. The edit window shows the cells within the selected area.
+Click on a new spot on the overview window to move the editing area.
 
-<b><I>Note: this help page refers to the old Tcl/Tk version of this
-program. Parts of it may be out of date or wrong.</I></b>
+<h3>Raster cell editing</h3>
 
+Cell editing is done using the mouse cursor to indicate the cell(s) on
+the displayed raster map that are to be edited.
+<p>
+To change the value of a cell put the new value to use in the "New value"
+box at the bottom left of the edit window. A value of "*" indicates a
+NULL value should be used.
+<p>
+<b>Important:</b> the new value in the "New value" box must be confirmed
+with ENTER, otherwise it is not yet active.
 
-<h3>Overview window</h3>
+<h3>Saving the edited map</h3>
 
-An overview window shows the entire map with a box showing the current
-editing region. The edit window shows the cells within the selected area.
-Click on a new spot on the overview window to move the editing area.
-Moving the editing view can take a while.
+To save the edited map, the "File" menu contains the entry <b>Save</b>.
+To leave <em>d.rast.edit</em>, use <b>Exit</b> in the menu.
 
-<h3>Mouse and menus</h3>
 
-Cell editing is done using a mouse cursor to choose menu selections
-and indicate areas on the displayed raster map that are to be edited.
+<h3>Map pan with arrow keys</h3>
 
-<p>Selections available at the top of the edit window are <b>Save</b> and
-<b>Exit</b>.
-<p>
-As the mouse travels over the cells in the edit window you are shown the
-current coordinates and current cell values under the cursor.
-<p>To change the value of a cell put the new value to use in the "New value"
-box at the bottom left of the edit window under the coordinate information
-bar. A value of "*" indicates a NULL value should be used.
+The map can be shifted using the arrow keys on the keyboard.
 
-
+<!-- currently broken, see #
 <h3>Arrows</h3>
 
 This function is available for users editing aspect maps.  The
@@ -43,17 +43,20 @@
 Aspect maps are expected to be in regular "GRASS" format, as produced by
 <em><a href="r.slope.aspect.html">r.slope.aspect</a></em>; i.e. degrees
 counter-clockwise from east.
+-->
 
-
 <h2>NOTES</h2>
 
-There is no "undo" command or way to exit edit mode without saving
-changes.
-<p>Any MASK in place will be respected when writing the new raster map layer,
+There is no "undo" command nor way to exit edit mode without saving
+changes to the output map.
+<p>
+<!-- MASK behaviour to be verified -->
+Any MASK in place will be respected when writing the new raster map layer,
 including any edits to the MASKed areas.
 
 <h3>Geographic Region Concerns</h3>
 
+<!-- region behaviour to be verified -->
 <em>d.rast.edit</em> reads the region definition for the raster map layer
 being edited from its internal cell header file. The new, edited copy of
 the raster layer will be created with the same resolution and region
@@ -67,13 +70,39 @@
 since by use of the overview selection these values may change several
 times during the editing session).
 
+<h2>EXAMPLE</h2>
 
+Editing raster values in a LiDAR DEM, North Carolina sample data:
+
+<div class="code"><pre>
+g.region raster=elev_lid792_1m -p
+
+# pan to area of interest and edit raster cells (I used "102" as value to modifiy cells
+# Use:  File > Save to save
+# then: File > Exit
+d.rast.edit input=elev_lid792_1m output=elev_lid792_1m_modified
+
+# comparison of raster statistics
+# original stats, note the min value
+r.univar -g elev_lid792_1m
+
+# modified map stats, note the min value
+r.univar -g elev_lid792_1m_modified
+</pre></div>
+
+<div align="center" style="margin: 10px">
+<a href="d_rast_edit.png">
+<img src="d_rast_edit.png" width="600" height="281" alt="d.rast.edit example" border="0">
+</a><br>
+<i>Figure: Editing of pixels in an elevation raster map using d.rast.edit</i>
+</div>
+
 <h2>TODO</h2>
 
-<!-- not true, but it would be nice
-<em>d.rast.edit</em> will not create a new raster map layer if
-the user makes no cell edits while running the program.
-<p>-->
+<em>d.rast.edit</em> should not create a new raster map layer if
+the user makes no cell edits while running the program and leaving it
+without saving.
+<p>
 
 It would be nice to incorporate a scrollable version of <em>
 <a href="d.legend.html">d.legend</a>
@@ -92,7 +121,7 @@
 the new value on each cell chosen until a different value is desired.</li>
 </ol>
 
-<p>There is no interrupt handling. <!-- ?? --> This could leave files in .tmp
+<p>There is no user-interrupt handling. This could leave files in .tmp
 or (rarely) result in half-baked raster maps.  The original file
 would survive unscathed by an interrupt at most any point in execution.
 Beware of exiting the program
@@ -108,10 +137,9 @@
 
 <h2>AUTHOR</h2>
 
-Tcl/Tk and wxPython versions: Glynn Clements<br>
+Tcl/Tk (2007) and wxPython versions (2008): Glynn Clements<br>
 <br>
-Replaces Xdriver version in C by Chris Rewerts,
-Agricultural Engineering,
-Purdue University
+Replaces Xdriver version in C by Chris Rewerts, April 1991,
+Agricultural Engineering, Purdue University
 
 <p><i>Last changed: $Date$</i>

Copied: grass/branches/releasebranch_7_2/scripts/d.rast.edit/d_rast_edit.png (from rev 72892, grass/trunk/scripts/d.rast.edit/d_rast_edit.png)
===================================================================
(Binary files differ)