1d.histogram(1)              GRASS GIS User's Manual             d.histogram(1)
2
3
4

NAME

6       d.histogram   -  Displays a histogram in the form of a pie or bar chart
7       for a user-specified raster map.
8

KEYWORDS

10       display, histogram, statistics
11

SYNOPSIS

13       d.histogram
14       d.histogram --help
15       d.histogram  [-nc]  map=name   [style=string]     [color=name]     [bg‐
16       color=name]     [nsteps=integer]     [--help]   [--verbose]   [--quiet]
17       [--ui]
18
19   Flags:
20       -n
21           Display information for null cells
22
23       -c
24           Report for ranges defined in cats file (fp maps only)
25
26       --help
27           Print usage summary
28
29       --verbose
30           Verbose module output
31
32       --quiet
33           Quiet module output
34
35       --ui
36           Force launching GUI dialog
37
38   Parameters:
39       map=name [required]
40           Raster map for which histogram will be displayed
41
42       style=string
43           Indicate if a pie or bar chart is desired
44           Options: pie, bar
45           Default: bar
46
47       color=name
48           Color for text and axes
49           Either a standard color name or R:G:B triplet
50           Default: black
51
52       bgcolor=name
53           Background color
54           Either a standard color name, R:G:B triplet, or "none"
55           Default: white
56
57       nsteps=integer
58           Number of steps to divide the data range into (fp maps only)
59           Default: 255
60

DESCRIPTION

62       d.histogram displays the category-value distribution for a  user-speci‐
63       fied  raster map layer, in the form of a bar chart or a pie chart.  The
64       display will be displayed in the active display frame on  the  graphics
65       monitor,  using  the colors in the raster map layer’s color table.  The
66       program determines the raster  map’s  category  value  distribution  by
67       counting cells.
68

NOTES

70       d.histogram  respects  the  current  geographic region settings and the
71       current MASK (if one exists).
72
73       d.histogram uses the colors in the map’s color look-up table (i.e., the
74       map’s colr or colr2 file).
75

EXAMPLES

77       Running the command below will generate the bar graph shown in the fig‐
78       ure:
79       g.region raster=elevation -p
80       d.mon wx0
81       d.histogram map=elevation
82       Figure: Bar graph histogram for elevation map
83
84       Running the command below will generate the pie graph shown in the fig‐
85       ure:
86       g.region raster=landuse96_28m -p
87       d.histogram map=landuse96_28m style=pie
88       Figure: Pie graph histogram for landuse map
89

SEE ALSO

91        d.colortable, d.frame, d.graph, d.linegraph, d.mon, d.polar, g.region,
92       r.stats
93

AUTHOR

95       Dave Johnson
96       DBA Systems, Inc.
97       10560 Arrowhead Drive
98       Fairfax, Virginia 22030
99

SOURCE CODE

101       Available at: d.histogram source code (history)
102
103       Accessed: Saturday Jan 21 21:14:09 2023
104
105       Main index | Display index | Topics index | Keywords index |  Graphical
106       index | Full index
107
108       © 2003-2023 GRASS Development Team, GRASS GIS 8.2.1 Reference Manual
109
110
111
112GRASS 8.2.1                                                     d.histogram(1)