Skip to content

g.gui.rdigit

Interactive editing and digitizing of raster maps.

g.gui.rdigit [create=name] [base=name] [type=string] [edit=name] [--overwrite] [--verbose] [--quiet] [--qq] [--ui]

Example:

g.gui.rdigit create=name

grass.script.run_command("g.gui.rdigit", create=None, base=None, type="CELL", edit=None, overwrite=False, verbose=False, quiet=False, superquiet=False)

Example:

gs.run_command("g.gui.rdigit", create="name")

Parameters

create=name
    Name of new raster map to create
    Name for output raster map
base=name
    Name of base raster map
type=string
    Type of raster map to be created
    Storage type for resultant raster map
    Allowed values: CELL, FCELL, DCELL
    Default: CELL
    CELL: Integer
    FCELL: Single precision floating point
    DCELL: Double precision floating point
edit=name
    Name of existing raster map to edit
    Name of input raster map
--overwrite
    Allow output files to overwrite existing files
--help
    Print usage summary
--verbose
    Verbose module output
--quiet
    Quiet module output
--qq
    Very quiet module output
--ui
    Force launching GUI dialog

create : str, optional
    Name of new raster map to create
    Name for output raster map
    Used as: output, raster, name
base : str, optional
    Name of base raster map
    Used as: input, raster, name
type : str, optional
    Type of raster map to be created
    Storage type for resultant raster map
    Allowed values: CELL, FCELL, DCELL
    CELL: Integer
    FCELL: Single precision floating point
    DCELL: Double precision floating point
    Default: CELL
edit : str, optional
    Name of existing raster map to edit
    Name of input raster map
    Used as: input, raster, name
overwrite: bool, optional
    Allow output files to overwrite existing files
    Default: False
verbose: bool, optional
    Verbose module output
    Default: False
quiet: bool, optional
    Quiet module output
    Default: False
superquiet: bool, optional
    Very quiet module output
    Default: False

wxGUI Raster Digitizer

DESCRIPTION

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:

  • draw polygons, lines and points
  • set category value of the feature you are drawing
  • set feature width (width of currently digitized line or diameter of a digitized point in map units)
  • create a new raster from scratch or from an already existing raster
  • undo edits and save edits before leaving the digitizer

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.

NOTES

Raster Digitizer respects computational region including the currently set resolution.

EXAMPLES

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=slope aspect=aspect
r.sun elevation=elev_edited aspect=aspect slope=slope beam_rad=beam day=172 time=6

Raster digitizer example step 1 Raster digitizer example step 2 Raster digitizer example step 3 Raster digitizer example step 4 Raster digitizer example step 5
Figure: Steps to digitize new buildings on elev_lid792_1m raster map.

SEE ALSO

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

AUTHORS

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

SOURCE CODE

Available at: g.gui.rdigit source code (history)
Latest change: Wednesday Mar 26 21:44:22 2025 in commit 74d41f0