dwww Home | Manual pages | Find package

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 Fri Jan 24 09:42:00 CET 2025.