.TH d.vect.chart 1grass "" "GRASS 7.8.5" "GRASS GIS 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, chart maps
.SH SYNOPSIS
\fBd.vect.chart\fR
.br
\fBd.vect.chart \-\-help\fR
.br
\fBd.vect.chart\fR [\-\fBcl3\fR] \fBmap\fR=\fIname\fR  [\fBtype\fR=\fIstring\fR[,\fIstring\fR,...]]   [\fBlayer\fR=\fIstring\fR]   [\fBchart_type\fR=\fIstring\fR]  \fBcolumns\fR=\fIname\fR[,\fIname\fR,...]  [\fBsize_column\fR=\fIname\fR]   [\fBsize\fR=\fIinteger\fR]   [\fBscale\fR=\fIfloat\fR]   [\fBoutline_color\fR=\fIname\fR]   [\fBcolors\fR=\fIname\fR[,\fIname\fR,...]]   [\fBmax_ref\fR=\fIfloat\fR[,\fIfloat\fR,...]]   [\-\-\fBhelp\fR]  [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR]  [\-\-\fBui\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\-3\fR" 4m
.br
Create 3D charts
.IP "\fB\-\-help\fR" 4m
.br
Print usage summary
.IP "\fB\-\-verbose\fR" 4m
.br
Verbose module output
.IP "\fB\-\-quiet\fR" 4m
.br
Quiet module output
.IP "\fB\-\-ui\fR" 4m
.br
Force launching GUI dialog
.SS Parameters:
.IP "\fBmap\fR=\fIname\fR \fB[required]\fR" 4m
.br
Name of vector map
.br
Or data source for direct OGR access
.IP "\fBtype\fR=\fIstring[,\fIstring\fR,...]\fR" 4m
.br
Input feature type
.br
Options: \fIpoint, line, boundary, centroid, area\fR
.br
Default: \fIpoint,line,boundary,centroid\fR
.IP "\fBlayer\fR=\fIstring\fR" 4m
.br
Layer number or name
.br
Vector features can have category values in different layers. This number determines which layer to use. When used with direct OGR access this is the layer name.
.br
Default: \fI1\fR
.IP "\fBchart_type\fR=\fIstring\fR" 4m
.br
Chart type
.br
Options: \fIpie, bar\fR
.br
Default: \fIpie\fR
.IP "\fBcolumns\fR=\fIname[,\fIname\fR,...]\fR \fB[required]\fR" 4m
.br
Attribute columns containing data
.IP "\fBsize_column\fR=\fIname\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 "\fBoutline_color\fR=\fIname\fR" 4m
.br
Outline color
.br
Either a standard color name or R:G:B triplet
.br
Default: \fIblack\fR
.IP "\fBcolors\fR=\fIname[,\fIname\fR,...]\fR" 4m
.br
Colors used to fill charts
.br
Either a standard color name or R:G:B triplet
.br
Default: \fIblack\fR
.IP "\fBmax_ref\fR=\fIfloat[,\fIfloat\fR,...]\fR" 4m
.br
Maximum value used for bar plot reference
.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 4n
.IP \(bu 4n
vector points: on point position,
.IP \(bu 4n
vector lines: on line centers,
.IP \(bu 4n
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.
.PP
The \(cqsizecol\(cq parameter is proportionate to the radius.
.PP
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 \fBchart_type\fR is \fIbar\fR (See Example 2).
.SH EXAMPLES
.SS Example 1
Pie\-charts of monthly winter precipitation (North Carolina sample dataset):
.br
.nf
\fC
g.region vector=nc_state \-p
d.vect nc_state
d.vect.chart precip_30ynormals chart_type=pie columns=nov,dec,jan,feb \-l
# show pie chart as 3D
d.erase
d.vect nc_state
d.vect.chart precip_30ynormals chart_type=pie columns=nov,dec,jan,feb \-l \-3
\fR
.fi
.br
2D pie\-chart of monthly winter precipitation in North Carolina
.PP
.br
3D pie\-chart of monthly winter precipitation in North Carolina
.SS Example 2
Bar\-chart of different census map values:
.br
.nf
\fC
d.vect.chart map=vectmap columns=cens51,cens61,cens71,cens81 chart_type=bar
\fR
.fi
.SS Example 3
Creation of framed bar charts of an erodibiliy index from the Spearfish
sample dataset:
.br
.nf
\fC
g.region raster=erode.index \-p
r.to.vect \-s input=erode.index output=erode_index type=area
v.extract input=erode_index output=erode_index_ctrds type=centroid
d.rast aspect
d.vect.chart map=erode_index_ctrds chart_type=bar columns=cat \(rs
             size=10 max_ref=12 scale=0.05 colors=yellow
d.vect erode_index_ctrds icon=basic/circle fcol=black col=black size=5
\fR
.fi
.br
Bar charts of an erodibiliy index (spatial subset)
.SH SEE ALSO
\fI
d.erase,
d.vect,
d.vect.thematic,
d.what.vect,
d.rast
\fR
.SH AUTHOR
Radim Blazek, ITC\-Irst, Trento, Italy
.SH SOURCE CODE
.PP
Available at: d.vect.chart source code (history)
.PP
Main index |
Display index |
Topics index |
Keywords index |
Graphical index |
Full index
.PP
© 2003\-2020
GRASS Development Team,
GRASS GIS 7.8.5 Reference Manual