.TH d.vect.chart 1grass "" "GRASS 6.4.4" "Grass User's Manual"
.SH NAME
\fI\fBd.vect.chart\fR\fR  - Displays charts of vector data in the active frame on the graphics monitor.
.SH KEYWORDS
display, cartography
.SH SYNOPSIS
\fBd.vect.chart\fR
.br
\fBd.vect.chart help\fR
.br
\fBd.vect.chart\fR [\-\fBcl\fR] \fBmap\fR=\fIname\fR  [\fBtype\fR=\fIstring\fR[,\fIstring\fR,...]]   [\fBlayer\fR=\fIinteger\fR]   [\fBctype\fR=\fIstring\fR]  \fBcolumns\fR=\fIstring\fR[,\fIstring\fR,...]  [\fBsizecol\fR=\fIstring\fR]   [\fBsize\fR=\fIinteger\fR]   [\fBscale\fR=\fIfloat\fR]   [\fBocolor\fR=\fIstring\fR]   [\fBcolors\fR=\fIstring\fR[,\fIstring\fR,...]]   [\fBmax_ref\fR=\fIfloat\fR[,\fIfloat\fR,...]]   [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR] 
.SS Flags:
.IP "\fB\-c\fR" 4m
.br
Center the bar chart around a data point
.IP "\fB\-l\fR" 4m
.br
Create legend information and send to stdout
.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
Name of input vector map
.IP "\fBtype\fR=\fIstring[,\fIstring\fR,...]\fR" 4m
.br
Feature type
.br
Options: \fIpoint,line,boundary,centroid,area\fR
.br
Default: \fIpoint,line,boundary,centroid\fR
.IP "\fBlayer\fR=\fIinteger\fR" 4m
.br
Layer number
.br
A single vector map can be connected to multiple database tables. This number determines which table to use.
.br
Default: \fI1\fR
.IP "\fBctype\fR=\fIstring\fR" 4m
.br
Chart type
.br
Options: \fIpie,bar\fR
.br
Default: \fIpie\fR
.IP "\fBcolumns\fR=\fIstring[,\fIstring\fR,...]\fR" 4m
.br
Attribute columns containing data
.IP "\fBsizecol\fR=\fIstring\fR" 4m
.br
Column used for pie chart size
.IP "\fBsize\fR=\fIinteger\fR" 4m
.br
Size of chart (diameter for pie, total width for bar)
.br
Default: \fI40\fR
.IP "\fBscale\fR=\fIfloat\fR" 4m
.br
Scale for size (to get size in pixels)
.br
Default: \fI1\fR
.IP "\fBocolor\fR=\fIstring\fR" 4m
.br
Outline color
.br
Default: \fIblack\fR
.IP "\fBcolors\fR=\fIstring[,\fIstring\fR,...]\fR" 4m
.br
Colors used to fill charts
.IP "\fBmax_ref\fR=\fIfloat[,\fIfloat\fR,...]\fR" 4m
.br
Maximum value used for bar plot reference
.PP
.SH DESCRIPTION
\fId.vect.chart\fR displays charts for GRASS vector data in the active frame on the graphics 
monitor.
.SH NOTES
The charts are positioned as follows:
.RS
.IP
 vector points: on point position
.IP
 vector lines: on line centers
.IP
 vector areas: on area centroids
.RE
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 \fB-c\fR flag can be used to center the bar chart in both x and y directions.
.br
The 'sizecol' parameter is proportionate to the radius.
.br
The optional \fBmax_ref\fR parameter accepts a list of values that represent the maximum value for each column listed in the values for the parameter \fBcolumns\fR. These values are used to create a framed bar plot if \fBctype\fR is \fIbar\fR (See Example 2).
.SH EXAMPLES
.SS Example 1
\fC
.DS
.br
d.vect.chart map=vectmap columns=cens51,cens61,cens71,cens81
.br
.DE
\fR
.SS Example 2
Create framed bar graphs of an erodibiliy index from the SPEARFISH dataset.
\fC
.DS
.br
r.to.vect \-s \-v in=erode.index out=erode_index feature=area 
.br
v.extract in=erode_index out=erode_index_ctrds type=centroid 
.br
d.rast aspect
.br
d.vect.chart map=erode_index_ctrds ctype=bar columns=cat \(rs
.br
             size=10 max_ref=12 scale=1.5 colors=yellow 
.br
d.vect erode_index_ctrds icon=basic/circle fcol=black col=black size=5
.br
.DE
\fR
Example screenshot (zoomed):
.br
.SH SEE ALSO
\fId.erase,
d.vect,
d.vect.thematic,
d.what.vect,
d.rast\fR
.SH AUTHOR
Radim Blazek, ITC-Irst, Trento, Italy
.PP
\fILast changed: $Date: 2011-11-08 10:42:51 +0100 (Tue, 08 Nov 2011) $\fR
.PP
Full index
.PP
© 2003-2014 GRASS Development Team