Sophie

Sophie

distrib > Fedora > 13 > i386 > by-pkgid > 413e0bdb3c48563b2d8d9038d07d5533 > files > 1507

grass-6.3.0-15.fc13.i686.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>GRASS GIS: d.histogram</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="grassdocs.css" type="text/css">
</head>
<body bgcolor="white">

<img src="grass_logo.png" alt="GRASS logo"><hr align=center size=6 noshade>

<h2>NAME</h2>
<em><b>d.histogram</b></em>  - Displays a histogram in the form of a pie or bar chart for a user-specified raster map.
<h2>KEYWORDS</h2>
display
<h2>SYNOPSIS</h2>
<b>d.histogram</b><br>
<b>d.histogram help</b><br>
<b>d.histogram</b> [-<b>nqC</b>] <b>map</b>=<em>name</em>  [<b>style</b>=<em>string</em>]   [<b>color</b>=<em>name</em>]   [<b>bgcolor</b>=<em>name</em>]   [<b>nsteps</b>=<em>integer</em>]   [--<b>verbose</b>]  [--<b>quiet</b>] 

<h3>Flags:</h3>
<DL>
<DT><b>-n</b></DT>
<DD>Display information for null cells</DD>

<DT><b>-q</b></DT>
<DD>Gather the histogram quietly</DD>

<DT><b>-C</b></DT>
<DD>Report for ranges defined in cats file (fp maps only)</DD>

<DT><b>--verbose</b></DT>
<DD>Verbose module output</DD>
<DT><b>--quiet</b></DT>
<DD>Quiet module output</DD>
</DL>

<h3>Parameters:</h3>
<DL>
<DT><b>map</b>=<em>name</em></DT>
<DD>Raster map for which histogram will be displayed</DD>

<DT><b>style</b>=<em>string</em></DT>
<DD>Indicate if a pie or bar chart is desired</DD>
<DD>Options: <em>pie,bar</em></DD>
<DD>Default: <em>bar</em></DD>

<DT><b>color</b>=<em>name</em></DT>
<DD>Color for text and axes</DD>
<DD>Either a standard color name or R:G:B triplet</DD>
<DD>Default: <em>black</em></DD>

<DT><b>bgcolor</b>=<em>name</em></DT>
<DD>Background color</DD>
<DD>Either a standard GRASS color, R:G:B triplet, or "none"</DD>
<DD>Default: <em>white</em></DD>

<DT><b>nsteps</b>=<em>integer</em></DT>
<DD>Number of steps to divide the data range into (fp maps only)</DD>
<DD>Default: <em>255</em></DD>

</DL>
<H2>DESCRIPTION</H2>

<EM>d.histogram</EM> 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.

<H2>NOTES</H2>

<EM>d.histogram</EM> respects the current geographic region settings 
and the current MASK (if one exists). 

<P>
<EM>d.histogram</EM> uses the colors in the map's color look-up table
(i.e., the map's <EM>colr</EM> or <EM>colr2</EM> file).

<H2>SEE ALSO</H2>

<em>
<a href="d.colors.html">d.colors</a>,
<a href="d.colortable.html">d.colortable</a>,
<a href="d.frame.html">d.frame</a>,
<a href="d.graph.html">d.graph</a>,
<a href="d.linegraph.html">d.linegraph</a>,
<a href="d.polar.html">d.polar</a>,
<a href="g.region.html">g.region</a>,
<a href="r.stats.html">r.stats</a>
</em>

<H2>AUTHOR</H2>

Dave Johnson
<BR> DBA Systems, Inc. 
<BR> 10560 Arrowhead Drive 
<BR> Fairfax, Virginia 22030

<p>
<i>Last changed: $Date: 2007-05-17 10:13:14 +0200 (Thu, 17 May 2007) $</i>
<HR>
<P><a href="index.html">Main index</a> - <a href="display.html">display index</a> - <a href="full_index.html">Full index</a></P>
<P>&copy; 2003-2008 <a href="http://grass.osgeo.org">GRASS Development Team</a></p>
</body>
</html>