.TH d.histogram 1grass "" "GRASS 6.4.4" "Grass User's Manual"
.SH NAME
\fI\fBd.histogram\fR\fR  - Displays a histogram in the form of a pie or bar chart for a user-specified raster map.
.SH KEYWORDS
display, histogram, statistics
.SH SYNOPSIS
\fBd.histogram\fR
.br
\fBd.histogram help\fR
.br
\fBd.histogram\fR [\-\fBnqC\fR] \fBmap\fR=\fIname\fR  [\fBstyle\fR=\fIstring\fR]   [\fBcolor\fR=\fIname\fR]   [\fBbgcolor\fR=\fIname\fR]   [\fBnsteps\fR=\fIinteger\fR]   [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR] 
.SS Flags:
.IP "\fB\-n\fR" 4m
.br
Display information for null cells
.IP "\fB\-q\fR" 4m
.br
Gather the histogram quietly
.IP "\fB\-C\fR" 4m
.br
Report for ranges defined in cats file (fp maps only)
.IP "\fB\-\-verbose\fR" 4m
.br
Verbose module output
.IP "\fB\-\-quiet\fR" 4m
.br
Quiet module output
.PP
.SS Parameters:
.IP "\fBmap\fR=\fIname\fR" 4m
.br
Raster map for which histogram will be displayed
.IP "\fBstyle\fR=\fIstring\fR" 4m
.br
Indicate if a pie or bar chart is desired
.br
Options: \fIpie,bar\fR
.br
Default: \fIbar\fR
.IP "\fBcolor\fR=\fIname\fR" 4m
.br
Color for text and axes
.br
Either a standard color name or R:G:B triplet
.br
Default: \fIblack\fR
.IP "\fBbgcolor\fR=\fIname\fR" 4m
.br
Background color
.br
Either a standard GRASS color, R:G:B triplet, or "none"
.br
Default: \fIwhite\fR
.IP "\fBnsteps\fR=\fIinteger\fR" 4m
.br
Number of steps to divide the data range into (fp maps only)
.br
Default: \fI255\fR
.PP
.SH DESCRIPTION
\fId.histogram\fR displays the category-value distribution for a
user-specified raster map layer, in the form of a bar chart or a pie chart. 
The display will be displayed in the active display frame on the graphics
monitor, using the colors in the raster map layer's color table.  The
program determines the raster map's category value distribution by counting
cells.
.SH NOTES
\fId.histogram\fR respects the current geographic region settings 
and the current MASK (if one exists). 
.PP
\fId.histogram\fR uses the colors in the map's color look-up table
(i.e., the map's \fIcolr\fR or \fIcolr2\fR file).
.SH SEE ALSO
\fI
d.colors,
d.colortable,
d.frame,
d.graph,
d.linegraph,
d.polar,
g.region,
r.stats
\fR
.SH AUTHOR
Dave Johnson
.br
 DBA Systems, Inc. 
.br
 10560 Arrowhead Drive 
.br
 Fairfax, Virginia 22030
.PP
\fILast changed: $Date: 2011-11-08 12:29:50 +0100 (Tue, 08 Nov 2011) $\fR
.PP
Full index
.PP
© 2003-2014 GRASS Development Team