<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>GRASS GIS: d.vect.chart</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.vect.chart</b></em> - Displays charts of GRASS vector data in the active frame on the graphics monitor
<h2>KEYWORDS</h2>
display
<h2>SYNOPSIS</h2>
<b>d.vect.chart</b><br>
<b>d.vect.chart help</b><br>
<b>d.vect.chart</b> [-<b>cl</b>] <b>map</b>=<em>name</em> [<b>type</b>=<em>string</em>[,<i>string</i>,...]] [<b>layer</b>=<em>integer</em>] [<b>ctype</b>=<em>string</em>] <b>columns</b>=<em>string</em>[,<i>string</i>,...] [<b>sizecol</b>=<em>string</em>] [<b>size</b>=<em>integer</em>] [<b>scale</b>=<em>float</em>] [<b>ocolor</b>=<em>string</em>] [<b>colors</b>=<em>string</em>[,<i>string</i>,...]] [<b>max_ref</b>=<em>float</em>[,<i>float</i>,...]] [--<b>verbose</b>] [--<b>quiet</b>]
<h3>Flags:</h3>
<DL>
<DT><b>-c</b></DT>
<DD>Center the bar chart around a data point</DD>
<DT><b>-l</b></DT>
<DD>Create legend information and send to stdout</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>Name of input vector map</DD>
<DT><b>type</b>=<em>string[,<i>string</i>,...]</em></DT>
<DD>Type</DD>
<DD>Feature type(s)</DD>
<DD>Options: <em>point,line,boundary,centroid,area</em></DD>
<DD>Default: <em>point,line,boundary,centroid</em></DD>
<DT><b>layer</b>=<em>integer</em></DT>
<DD>Layer number</DD>
<DD>A single vector map can be connected to multiple database tables. This number determines which table to use.</DD>
<DD>Default: <em>1</em></DD>
<DT><b>ctype</b>=<em>string</em></DT>
<DD>Chart type</DD>
<DD>Options: <em>pie,bar</em></DD>
<DD>Default: <em>pie</em></DD>
<DT><b>columns</b>=<em>string[,<i>string</i>,...]</em></DT>
<DD>Attribute columns containing data</DD>
<DT><b>sizecol</b>=<em>string</em></DT>
<DD>Column used for pie chart size</DD>
<DT><b>size</b>=<em>integer</em></DT>
<DD>Size of chart (diameter for pie, total width for bar)</DD>
<DD>Default: <em>40</em></DD>
<DT><b>scale</b>=<em>float</em></DT>
<DD>Scale for size (to get size in pixels)</DD>
<DD>Default: <em>1</em></DD>
<DT><b>ocolor</b>=<em>string</em></DT>
<DD>Outline color</DD>
<DD>Default: <em>black</em></DD>
<DT><b>colors</b>=<em>string[,<i>string</i>,...]</em></DT>
<DD>Colors used to fill charts</DD>
<DT><b>max_ref</b>=<em>float[,<i>float</i>,...]</em></DT>
<DD>Maximum value used for bar plot reference</DD>
</DL>
<h2>DESCRIPTION</h2>
<em>d.vect.chart</em> displays charts for GRASS vector data in the active frame on the graphics
monitor.
<h2>NOTES</h2>
The charts are positioned as follows:
<ul>
<li> vector points: on point position
<li> vector lines: on line centers
<li> vector areas: on area centroids
</ul>
Bar charts are placed with their lower edge starting from the y-coordinate of the feature being symbolized, and centered with respect to the x-coordinate. The <b>-c</b> flag can be used to center the bar chart in both x and y directions.
<br><br>
The 'sizecol' parameter is proportionate to the radius.
<br><br>
The optional <b>max_ref</b> parameter accepts a list of values that represent the maximum value for each column listed in the values for the parameter <b>columns</b>. These values are used to create a framed bar plot if <b>ctype</b> is <em>bar</em> (See Example 2).
<h2>EXAMPLES</h2>
<h3>Example 1</h3>
<div class="code"><pre>
d.vect.chart map=vectmap columns=cens51,cens61,cens71,cens81
</pre></div>
<h3>Example 2</h3>
Create framed bar graphs of an erodibiliy index from the SPEARFISH dataset.
<div class="code"><pre>
r.to.vect -s -v in=erode.index out=erode_index feature=area
v.extract in=erode_index out=erode_index_ctrds type=centroid
d.rast aspect
d.vect.chart map=erode_index_ctrds ctype=bar columns=cat \
size=10 max_ref=12 scale=1.5 colors=yellow
d.vect erode_index_ctrds icon=basic/circle fcol=black col=black size=5
</pre></div>
Example screenshot (zoomed):<br>
<img src="d.vect.chart_example.jpg" alt="d.vect.chart example">
<h2>SEE ALSO</h2>
<em><a HREF="d.erase.html">d.erase</a>,
<a HREF="d.vect.html">d.vect</a>,
<a href="d.vect.thematic.html">d.vect.thematic</a>,
<a HREF="d.what.vect.html">d.what.vect</a>,
<a HREF="d.rast.html">d.rast</a></em>
<h2>AUTHOR</h2>
Radim Blazek, ITC-Irst, Trento, Italy
<p><i>Last changed: $Date: 2007-06-02 22:46:58 +0200 (Sat, 02 Jun 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>© 2003-2008 <a href="http://grass.osgeo.org">GRASS Development Team</a></p>
</body>
</html>
