d.rast.edit(1grass)
NAME
d.rast.edit - Edits cell values in a raster map.
KEYWORDS
display, editing, raster
SYNOPSIS
d.rast.edit
d.rast.edit --help
d.rast.edit input=name output=name [aspect=name] [width=integer]
[height=integer] [size=integer] [rows=integer] [cols=integer]
[--overwrite] [--help] [--verbose] [--quiet] [--ui]
Flags:
--overwrite
Allow output files to overwrite existing files
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--ui
Force launching GUI dialog
Parameters:
input=name [required]
Name of input raster map
output=name [required]
Name for output raster map
aspect=name
Name of input aspect raster map
width=integer
Width of display canvas
Default: 640
height=integer
Height of display canvas
Default: 480
size=integer
Minimum size of each cell
Default: 12
rows=integer
Maximum number of rows to load
Default: 100
cols=integer
Maximum number of columns to load
Default: 100
DESCRIPTION
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.
USAGE
Note: this help page refers to the old Tcl/Tk version of this program. Parts of it may be out of date or wrong. Overview window 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. Mouse and menus 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. Selections available at the top of the edit window are Save and Exit. As the mouse travels over the cells in the edit window you are shown the current coordinates and current cell values under the cursor. 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. Arrows 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.
NOTES
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).
TODO
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:
1 edit a block of cells to a given value by drawing a box;
2 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.
SEE ALSO
d.rast.arrow, d.rast.num
AUTHOR
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) $
SOURCE CODE
Available at: d.rast.edit source code (history)
Main index | Display index | Topics index | Keywords index | Graphical
index | Full index
2003-2016 GRASS Development Team, GRASS GIS 7.2.0 Reference Manual
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
