d.vect.chart - GRASS manual
Author: GRASS Development Team
Description: d.vect.chart: Displays charts of vector data in the active frame on the graphics monitor.
Keywords: display, cartography, chart maps

## 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 [-clns3] map=name [type=string[,string,...]] [layer=string] [chart_type=string] columns=name[,name,...] [size_column=name] [size=integer] [scale=float] [outline_color=name] [colors=name[,name,...]] [max_ref=float[,float,...]] [legend_title=string] [legend_symbol_size=integer] [--help] [--verbose] [--quiet] [--ui]

### Flags:

-c
  Center the bar chart around a data point
-l
  Create legend information and send to stdout
-n
  Do not draw map, only output the legend information
-s
  Do not show this layer in vector legend
-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 access 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
legend_title=string
  Legend title
legend_symbol_size=integer
  Legend symbol size
  Default: 20

## 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-coordinate 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 parameter 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)

Latest change: Friday Jan 30 10:35:22 2026 in commit: ad41fefc6cca34964bc4d1057a72aa32b91780bc

Main index | Display index | Topics index | Keywords index | Graphical index | Full index

© 2003-2026 GRASS Development Team, GRASS 8.5.1dev Reference Manual