1d.rast.edit(1)                Grass User's Manual               d.rast.edit(1)
2
3
4

NAME

6       d.rast.edit  - Edits cell values in a raster map.
7

KEYWORDS

9       display, editing, raster
10

SYNOPSIS

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

DESCRIPTION

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
67       using 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
72       selected  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

NOTES

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

EXAMPLE

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

TODO

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
146              desired.
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.
151       Beware of exiting the program by means other than  using  exit  on  the
152       Main Menu.
153

SEE ALSO

155        d.rast.arrow, d.rast.num, wxGUI.rdigit
156

AUTHOR

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
162       Last changed: $Date: 2018-12-15 12:16:30 +0100 (Sat, 15 Dec 2018) $
163

SOURCE CODE

165       Available at: d.rast.edit source code (history)
166
167       Main index | Display index | Topics index | Keywords index |  Graphical
168       index | Full index
169
170       © 2003-2019 GRASS Development Team, GRASS GIS 7.6.0 Reference Manual
171
172
173
174GRASS 7.6.0                                                     d.rast.edit(1)
Impressum