g.gui.rdigit(1)

📦
version 8.4.2 · 10 versions
, in fedora 44

💖 g.gui.rdigit 💖

okay bestie, welcome to the GRASS GIS User's Manual page for g.gui.rdigit — the raster digitizer, aka the little tool that lets you literally draw on your rasters. sit down, hydrate, and let's get into it 🎀

✨ NAME ✨

g.gui.rdigit — interactive editing and digitizing of raster maps. yes, you read that right. you get to poke at rasters with your mouse. iconic behavior. 💅

🌈 KEYWORDS 🌈

general, GUI, raster, editing, digitizer

🦋 SYNOPSIS 🦋

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

🌸 Flags 🌸

  • --overwrite — allow output files to overwrite existing files. it said what it said, no take-backs 🫶
  • --help — print usage summary. when you're lost, she's there.
  • --verbose — verbose module output. she talks more. love that for her.
  • --quiet — quiet module output. she talks less. also valid.
  • --ui — force launching GUI dialog. no escape, we're opening the window 💀

🍓 Parameters 🍓

  • create=name — name of new raster map to create. this is the Name for output raster map. your brand new baby raster.
  • base=name — name of base raster map. the starting point you build on top of.
  • type=string — type of raster map to be created. aka Storage type for resultant raster map. the options are CELL, FCELL, DCELL, and the default is CELL.
    • CELL — Integer. whole numbers only, no decimals, she's simple like that.
    • FCELL — Single precision floating point.
    • DCELL — Double precision floating point. extra precision, extra slay.
  • edit=name — name of existing raster map to edit. this one is the Name of input raster map — the map you're gonna mess with (lovingly).

🌟 KEYWORDS 🌟

display, GUI, raster, editing, digitizer

👑 DESCRIPTION 👑

Raster Digitizer is a simple tool to quickly draw lines, areas, and circles and save these features in a raster map. you can get to it from the Map Display toolbar — it's in the combo box on the right. iykyk. ✨

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. she stays in her lane and her lane is your region. periodt. 🎀

🔥 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=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, 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: wxGUI Raster Digitizer source code (history)

Accessed: Saturday Jan 17 05:42:35 2026

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

and that's the whole page, bestie!! 💖 this was GRASS GIS 8.4.2 (the version, the moment, the vibe) and the manual was accessed Saturday Jan 17 05:42:35 2026 — © 2003-2025 GRASS Development Team, GRASS GIS 8.4.2 Reference Manual. go digitize something cute, and remember: right click to finish your line 🦋✨💅

📦 where this page comes from