d.rast.edit.1grass man page
d.rast.edit — Edits cell values in a raster map.
display, editing, raster
d.rast.edit input=name output=name [aspect=name] [width=integer] [height=integer] [size=integer] [rows=integer] [cols=integer] [--overwrite] [--help] [--verbose] [--quiet] [--ui]
Allow output files to overwrite existing files
Print usage summary
Verbose module output
Quiet module output
Force launching GUI dialog
- input=name [required]
Name of input raster map
- output=name [required]
Name for output raster map
Name of input aspect raster map
Width of display canvas
Height of display canvas
Minimum size of each cell
Maximum number of rows to load
Maximum number of columns to load
The d.rast.edit program allows users to interactively edit cell category values in a raster map layer displayed to the graphics monitor using a mouse cursor.
Note: this help page refers to the old Tcl/Tk version of this program. Parts of it may be out of date or wrong.
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.
This function is available for users editing aspect maps. The d.rast.arrow program is called, which draws arrows over the displayed cells to indicate the downslope direction of the cell. You can set the aspect map to use on the command line. Aspect maps are expected to be in regular "GRASS" format, as produced by r.slope.aspect; i.e. degrees counter-clockwise from east.
There is no "undo" command or way to exit edit mode without saving changes.
Any MASK in place will be respected when writing the new raster map layer, including any edits to the MASKed areas.
Geographic Region Concerns
d.rast.edit 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 dimensions.
The primary bane of the d.rast.edit program involves large map layers with lots of rows and columns) and/or slow computers, since the program must read and write raster map layers row by row for the full size of the map layer as dictated by its region size and resolution. (The current region settings of north, south, east, and west will not limit the size of the edited copy of the map layer, since by use of the overview selection these values may change several times during the editing session).
It would be nice to incorporate a scrollable version of d.legend (such that one could see a label legend for files with many categories on a standard size sub-frame). It would be even nicer to be able to select the category values from a graphical legend when editing cell values (thereby saving a trip to the text frame to type in the new value).
Perhaps method(s) for multiple or mass cell edits would be useful. This could be done by providing modes in which the user may:
edit a block of cells to a given value by drawing a box;
be able to choose a given value which is automatically used as the new value on each cell chosen until a different value is desired.
There is no 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 by means other than using exit on the Main Menu.
Tcl/Tk and wxPython versions: Glynn Clements
Replaces Xdriver version in C by Chris Rewerts, Agricultural Engineering, Purdue University
Last changed: $Date: 2012-08-13 08:31:56 -0700 (Mon, 13 Aug 2012) $
Available at: d.rast.edit source code (history)
Main index | Display index | Topics index | Keywords index | Graphical index | Full index
© 2003-2017 GRASS Development Team, GRASS GIS 7.2.1 Reference Manual