| 1 |
<h2>DESCRIPTION</h2> |
| 2 |
|
| 3 |
<em>d.histogram</em> displays the category-value distribution for a |
| 4 |
user-specified raster map layer, in the form of a bar chart or a pie chart. |
| 5 |
The display will be displayed in the active display frame on the graphics |
| 6 |
monitor, using the colors in the raster map layer's color table. The |
| 7 |
program determines the raster map's category value distribution by counting |
| 8 |
cells. |
| 9 |
|
| 10 |
<h2>NOTES</h2> |
| 11 |
|
| 12 |
<em>d.histogram</em> respects the current geographic region settings |
| 13 |
and the current raster mask (if mask is active). |
| 14 |
|
| 15 |
<p><em>d.histogram</em> uses the colors in the map's color look-up table |
| 16 |
(i.e., the map's <em>colr</em> or <em>colr2</em> file). |
| 17 |
|
| 18 |
<h2>EXAMPLES</h2> |
| 19 |
|
| 20 |
Running the command below will generate the bar graph shown in the figure: |
| 21 |
|
| 22 |
<div class="code"><pre> |
| 23 |
g.region raster=elevation -p |
| 24 |
d.mon wx0 |
| 25 |
d.histogram map=elevation |
| 26 |
</pre></div> |
| 27 |
|
| 28 |
<div align="center" style="margin: 10px"> |
| 29 |
<img src="d_histogram_bar.png" alt="d.histogram bar graph example" border="0"> |
| 30 |
<br> |
| 31 |
<i>Figure: Bar graph histogram for elevation map</i> |
| 32 |
</div> |
| 33 |
|
| 34 |
<p> |
| 35 |
Running the command below will generate the pie graph shown in the figure: |
| 36 |
|
| 37 |
<div class="code"><pre> |
| 38 |
g.region raster=landuse96_28m -p |
| 39 |
d.histogram map=landuse96_28m style=pie |
| 40 |
</pre></div> |
| 41 |
|
| 42 |
<div align="center" style="margin: 10px"> |
| 43 |
<img src="d_histogram_pie.png" alt="d.histogram pie graph example" border="0"> |
| 44 |
<br> |
| 45 |
<i>Figure: Pie graph histogram for landuse map</i> |
| 46 |
</div> |
| 47 |
|
| 48 |
<h2>SEE ALSO</h2> |
| 49 |
|
| 50 |
<em> |
| 51 |
<a href="d.colortable.html">d.colortable</a>, |
| 52 |
<a href="d.frame.html">d.frame</a>, |
| 53 |
<a href="d.graph.html">d.graph</a>, |
| 54 |
<a href="d.linegraph.html">d.linegraph</a>, |
| 55 |
<a href="d.mon.html">d.mon</a>, |
| 56 |
<a href="d.polar.html">d.polar</a>, |
| 57 |
<a href="g.region.html">g.region</a>, |
| 58 |
<a href="r.stats.html">r.stats</a> |
| 59 |
</em> |
| 60 |
|
| 61 |
<h2>AUTHOR</h2> |
| 62 |
|
| 63 |
Dave Johnson |
| 64 |
<br> DBA Systems, Inc. |
| 65 |
<br> 10560 Arrowhead Drive |
| 66 |
<br> Fairfax, Virginia 22030 |