Your company here — click to reach over 10,000 unique daily visitors

g.gui.rdigit.1grass - Man Page

Interactive editing and digitizing of raster maps.


general, GUI, raster, editing, digitizer


g.gui.rdigit --help
g.gui.rdigit  [create=name]   [base=name]   [type=string]   [edit=name]   [--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



Name of new raster map to create
Name for output raster map


Name of base raster map


Type of raster map to be created
Storage type for resultant raster map
Default: CELL
CELL: Integer
FCELL: Single precision floating point
DCELL: Double precision floating point


Name of existing raster map to edit
Name of input raster map


display, GUI, raster, editing, digitizer


Raster Digitizer is a simple tool to quickly draw lines, areas, and circles and save these features in a raster map. It is accessible from the Map Display toolbar (from the combo box on the right).

Raster Digitizer currently allows you to:

The typical workflow includes these steps:

  1. Set computational region as needed.
  2. Switch to Raster Digitizer and select a map to create. Select either a new raster or create a new raster from existing raster, also select raster type (CELL, FCELL, DCELL)
  3. Specify category value and width before drawing a feature
  4. Specify digitizing tool (area, line, point)
  5. Start digitizing and when you want to finish area or line, use right click
  6. Change color of temporary overlay depending on your needs
  7. Set different category and repeat
  8. At any point you can use Undo or Save
  9. If existing raster is used for the new raster, digitized areas will respect the color table, but you can always set different color table.


Raster Digitizer respects computational region including the currently set resolution.


In the following figures we start with elev_lid792_1m raster map in North carolina sample dataset and digitize two buildings, one rectangular and one with circular footprint. Both buildings have the roof level at 130 m. We set the width when digitizing the point to 50 meters which results in the building having 50 m in diameter. When we are done with digitizing, we save the result and explore cast shadows of the buildings with r.sun module:

g.region raster=elev_lid792_1m
# now create elev_edited raster by digitizing and save
r.slope.aspect elevation=elev_edited slope=elev_slope aspect=elev_aspect
r.sun elevation=elev_edited aspect=elev_aspect slope=elev_slope beam_rad=beam day=172 time=6

Figure: Steps to digitize new buildings on elev_lid792_1m raster map.

See Also

wxGUI components,
r.in.poly (backend of digitizer),


Anna Petrasova, NCSU GeoForALL Laboratory
Tomas Zigo (standalone module)

Source Code

Available at: wxGUI Raster Digitizer source code (history)

Accessed: Tuesday May 14 13:42:57 2024

Main index | GUI index | Topics index | Keywords index | Graphical index | Full index

© 2003-2024 GRASS Development Team, GRASS GIS 8.3.2 Reference Manual


GRASS 8.3.2 GRASS GIS User's Manual