d.rast.num(1grass) GRASS GIS User's Manual d.rast.num(1grass)
NAME
d.rast.num - Overlays cell category values on a raster map displayed
in the active graphics frame.
KEYWORDS
display, map annotations, raster
SYNOPSIS
d.rast.num
d.rast.num --help
d.rast.num [-af] map=name [text_color=name] [grid_color=name]
[precision=integer] [font=string] [path=name] [charset=string]
[--help] [--verbose] [--quiet] [--ui]
Flags:
-a
Align grids with raster cells
-f
Get text color from cell color value
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--ui
Force launching GUI dialog
Parameters:
map=name [required]
Name of raster map
text_color=name
Text color
Either a standard color name or R:G:B triplet
Default: black
grid_color=name
Grid color
Either a standard color name, R:G:B triplet, or "none"
Default: gray
precision=integer
Number of significant digits (floating point only)
Options: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9
Default: 1
font=string
Font name
path=name
Path to font file
charset=string
Text encoding (only applicable to TrueType fonts)
DESCRIPTION
d.rast.num overlays cell category values onto a raster map layer dis-
played on the user’s graphics monitor. Category values will be dis-
played in the text color given and scaled to fit within a single cell.
A grid outlining each map cell will also be overlain in a user-speci-
fied color, unless it has been set to "none".
If no grid color is given the default will be used. If no map layer is
specified, the program will use whatever raster map layer is currently
displayed in the active frame on the graphics monitor.
If the -f flag is given the displayed number will take on the color of
the base map in that cell.
NOTES
The user is advised to set the current region to a relatively small
area (i.e., less than 100 rows by 100 columns); otherwise, the individ-
ual cells being displayed will be small and the category value associ-
ated with each will be difficult to see. No data cells are indicated
with "Null".
EXAMPLE
A) Distance from the streams network (North Carolina sample dataset):
g.region raster=streams_derived -p
r.grow.distance input=streams_derived distance=dist_from_streams
d.rast.num dist_from_streams -a
Euclidean distance from the streams network in meters (detail, numbers
shown with d.rast.num)
SEE ALSO
d.frame, d.grid, d.rast, d.rast.arrow, d.rast.edit, g.region,
r.slope.aspect
AUTHORS
Raghavan Srinivasan, and Chris Rewerts,
Agricultural Engineering, Purdue University
SOURCE CODE
Available at: d.rast.num source code (history)
Accessed: unknown
Main index | Display index | Topics index | Keywords index | Graphical
index | Full index
© 2003-2022 GRASS Development Team, GRASS GIS 7.8.7 Reference Manual
GRASS 7.8.7 d.rast.num(1grass)
Generated by dwww version 1.14 on Sat Jun 13 12:38:25 CEST 2026.