d.vect.chart(1grass) GRASS GIS User's Manual d.vect.chart(1grass)
NAME
d.vect.chart - Displays charts of vector data in the active frame on
the graphics monitor.
KEYWORDS
display, cartography, chart maps
SYNOPSIS
d.vect.chart
d.vect.chart --help
d.vect.chart [-cl3] map=name [type=string[,string,...]]
[layer=string] [chart_type=string] columns=name[,name,...]
[size_column=name] [size=integer] [scale=float] [out-
line_color=name] [colors=name[,name,...]]
[max_ref=float[,float,...]] [--help] [--verbose] [--quiet] [--ui]
Flags:
-c
Center the bar chart around a data point
-l
Create legend information and send to stdout
-3
Create 3D charts
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--ui
Force launching GUI dialog
Parameters:
map=name [required]
Name of vector map
Or data source for direct OGR access
type=string[,string,...]
Input feature type
Options: point, line, boundary, centroid, area
Default: point,line,boundary,centroid
layer=string
Layer number or name
Vector features can have category values in different layers. This
number determines which layer to use. When used with direct OGR ac-
cess this is the layer name.
Default: 1
chart_type=string
Chart type
Options: pie, bar
Default: pie
columns=name[,name,...] [required]
Attribute columns containing data
size_column=name
Column used for pie chart size
size=integer
Size of chart (diameter for pie, total width for bar)
Default: 40
scale=float
Scale for size (to get size in pixels)
Default: 1
outline_color=name
Outline color
Either a standard color name or R:G:B triplet
Default: black
colors=name[,name,...]
Colors used to fill charts
Either a standard color name or R:G:B triplet
Default: black
max_ref=float[,float,...]
Maximum value used for bar plot reference
DESCRIPTION
d.vect.chart displays charts for GRASS vector data in the active frame
on the graphics monitor.
NOTES
The charts are positioned as follows:
• vector points: on point position,
• vector lines: on line centers,
• vector areas: on area centroids.
Bar charts are placed with their lower edge starting from the y-coordi-
nate of the feature being symbolized, and centered with respect to the
x-coordinate. The -c flag can be used to center the bar chart in both
x and y directions.
The ’sizecol’ parameter is proportionate to the radius.
The optional max_ref parameter accepts a list of values that represent
the maximum value for each column listed in the values for the parame-
ter columns. These values are used to create a framed bar plot if
chart_type is bar (See Example 2).
EXAMPLES
Example 1
Pie-charts of monthly winter precipitation (North Carolina sample
dataset):
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
2D pie-chart of monthly winter precipitation in North Carolina
3D pie-chart of monthly winter precipitation in North Carolina
Example 2
Bar-chart of different census map values:
d.vect.chart map=vectmap columns=cens51,cens61,cens71,cens81 chart_type=bar
Example 3
Creation of framed bar charts of an erodibiliy index from the Spearfish
sample dataset:
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 \
size=10 max_ref=12 scale=0.05 colors=yellow
d.vect erode_index_ctrds icon=basic/circle fcol=black col=black size=5
Bar charts of an erodibiliy index (spatial subset)
SEE ALSO
d.erase, d.vect, d.vect.thematic, d.what.vect, d.rast
AUTHOR
Radim Blazek, ITC-Irst, Trento, Italy
SOURCE CODE
Available at: d.vect.chart source code (history)
Accessed: unknown
Main index | Display index | Topics index | Keywords index | Graphical
index | Full index
© 2003-2022 GRASS Development Team, GRASS GIS 7.8.7 Reference Manual
GRASS 7.8.7 d.vect.chart(1grass)
Generated by dwww version 1.14 on Sat Jun 13 12:08:14 CEST 2026.