1d.rast.edit(1) GRASS GIS User's Manual d.rast.edit(1)
2
3
4
6 d.rast.edit - Edits cell values in a raster map.
7
9 display, editing, raster
10
12 d.rast.edit
13 d.rast.edit --help
14 d.rast.edit input=name output=name [aspect=name] [width=integer]
15 [height=integer] [size=integer] [rows=integer] [cols=integer]
16 [--overwrite] [--help] [--verbose] [--quiet] [--ui]
17
18 Flags:
19 --overwrite
20 Allow output files to overwrite existing files
21
22 --help
23 Print usage summary
24
25 --verbose
26 Verbose module output
27
28 --quiet
29 Quiet module output
30
31 --ui
32 Force launching GUI dialog
33
34 Parameters:
35 input=name [required]
36 Name of input raster map
37
38 output=name [required]
39 Name for output raster map
40
41 aspect=name
42 Name of input aspect raster map
43
44 width=integer
45 Width of display canvas
46 Default: 640
47
48 height=integer
49 Height of display canvas
50 Default: 480
51
52 size=integer
53 Minimum size of each cell
54 Default: 12
55
56 rows=integer
57 Maximum number of rows to load
58 Default: 100
59
60 cols=integer
61 Maximum number of columns to load
62 Default: 100
63
65 The d.rast.edit program allows users to interactively edit cell cate‐
66 gory values in a raster map layer displayed to the graphics monitor us‐
67 ing a mouse cursor.
68
69 Overview window
70 An overview window shows the entire map with a red box showing the cur‐
71 rent editing region. The edit window shows the cells within the se‐
72 lected area. Click on a new spot on the overview window to move the
73 editing area.
74
75 Raster cell editing
76 Cell editing is done using the mouse cursor to indicate the cell(s) on
77 the displayed raster map that are to be edited.
78
79 To change the value of a cell put the new value to use in the "New
80 value" box at the bottom left of the edit window. A value of "*" indi‐
81 cates a NULL value should be used.
82
83 Important: the new value in the "New value" box must be confirmed with
84 ENTER, otherwise it is not yet active.
85
86 Saving the edited map
87 To save the edited map, the "File" menu contains the entry Save. To
88 leave d.rast.edit, use Exit in the menu.
89
90 Map pan with arrow keys
91 The map can be shifted using the arrow keys on the keyboard.
92
94 There is no "undo" command nor way to exit edit mode without saving
95 changes to the output map.
96
97 Any MASK in place will be respected when writing the new raster map
98 layer, including any edits to the MASKed areas.
99
100 Geographic Region Concerns
101 d.rast.edit reads the region definition for the raster map layer being
102 edited from its internal cell header file. The new, edited copy of the
103 raster layer will be created with the same resolution and region dimen‐
104 sions.
105
106 The primary bane of the d.rast.edit program involves large map layers
107 with lots of rows and columns) and/or slow computers, since the program
108 must read and write raster map layers row by row for the full size of
109 the map layer as dictated by its region size and resolution. (The cur‐
110 rent region settings of north, south, east, and west will not limit the
111 size of the edited copy of the map layer, since by use of the overview
112 selection these values may change several times during the editing ses‐
113 sion).
114
116 Editing raster values in a LiDAR DEM, North Carolina sample data:
117 g.region raster=elev_lid792_1m -p
118 # pan to area of interest and edit raster cells (I used "102" as value to modifiy cells
119 # Use: File > Save to save
120 # then: File > Exit
121 d.rast.edit input=elev_lid792_1m output=elev_lid792_1m_modified
122 # comparison of raster statistics
123 # original stats, note the min value
124 r.univar -g elev_lid792_1m
125 # modified map stats, note the min value
126 r.univar -g elev_lid792_1m_modified
127 Figure: Editing of pixels in an elevation raster map using d.rast.edit
128
130 d.rast.edit should not create a new raster map layer if the user makes
131 no cell edits while running the program and leaving it without saving.
132
133 It would be nice to incorporate a scrollable version of d.legend (such
134 that one could see a label legend for files with many categories on a
135 standard size sub-frame). It would be even nicer to be able to select
136 the category values from a graphical legend when editing cell values
137 (thereby saving a trip to the text frame to type in the new value).
138
139 Perhaps method(s) for multiple or mass cell edits would be useful.
140 This could be done by providing modes in which the user may:
141
142 1 edit a block of cells to a given value by drawing a box;
143
144 2 be able to choose a given value which is automatically used as
145 the new value on each cell chosen until a different value is de‐
146 sired.
147
148 There is no user-interrupt handling. This could leave files in .tmp or
149 (rarely) result in half-baked raster maps. The original file would
150 survive unscathed by an interrupt at most any point in execution. Be‐
151 ware of exiting the program by means other than using exit on the Main
152 Menu.
153
155 d.rast.arrow, d.rast.num, wxGUI.rdigit
156
158 Tcl/Tk (2007) and wxPython versions (2008): Glynn Clements
159 Replaces Xdriver version in C by Chris Rewerts, April 1991, Agricul‐
160 tural Engineering, Purdue University
161
163 Available at: d.rast.edit source code (history)
164
165 Accessed: Saturday Jan 21 21:17:00 2023
166
167 Main index | Display index | Topics index | Keywords index | Graphical
168 index | Full index
169
170 © 2003-2023 GRASS Development Team, GRASS GIS 8.2.1 Reference Manual
171
172
173
174GRASS 8.2.1 d.rast.edit(1)