d.vect.chart(1)

📦
version 8.4.2 · 8 versions
, in fedora 44

💖 d.vect.chart — GRASS GIS User's Manual 💖

okay bestie, gather round, because this one is literally the chart-making icon of the display world. This is d.vect.chart(1), and it's giving display, cartography, chart maps energy. 🎀

✨ NAME ✨

d.vect.chart — draws charts of your vector data right there in the active frame on the graphics monitor. no cap, it's that simple and it's that good. 🦋

🌸 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]
[outline_color=name]   [colors=name[,name,...]]
[max_ref=float[,float,...]]   [--help]  [--verbose]  [--quiet]  [--ui]

🎀 Flags 🎀

  • -c — centers that bar chart around a data point. symmetric queen behavior. ✨
  • -l — creates legend information and sends it to stdout. info for the people. 📢
  • -3 — creates 3D charts. we're going dimensional, bestie. 🔥
  • --help — prints the usage summary, in case you forgot how to girlboss.
  • --verbose — verbose module output. it will talk.
  • --quiet — quiet module output. it will not talk.
  • --ui — forces launching the GUI dialog. clicky mode activated. 💅

🌈 Parameters 🌈

  • map=name [required] — Name of the vector map. Or, plot twist, a 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, and this number decides which layer we're using. When you're on that direct OGR access vibe, this is the layer name instead. Default: 1
  • chart_type=string — Chart type. Options: pie, bar Default: pie
  • columns=name[,name,...] [required] — The attribute columns that contain the data. this is the actual tea being plotted. 🍓
  • size_column=name — The column used for pie chart size.
  • size=integer — Size of the 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 an R:G:B triplet. Default: black
  • colors=name[,name,...] — Colors used to fill the charts. Either a standard color name or an R:G:B triplet. Default: black
  • max_ref=float[,float,...] — Maximum value used for the bar plot reference.

🦋 DESCRIPTION 🦋

d.vect.chart displays charts for GRASS vector data in the active frame on the graphics monitor. that's the whole assignment and it ate. 💜

👑 NOTES 👑

so here's where your charts get placed, and the way that this works is lowkey important:

  • vector points: on the point position,
  • vector lines: on the line centers,
  • vector areas: on the 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. centering is self-care. 🫶

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). framed = fancy, fr fr. 🖼️

✨ 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: Saturday Jan 17 05:40:38 2026

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

okay that's the whole page bestie, and yes, we made it to the end — shoutout to © 2003-2025 GRASS Development Team, GRASS GIS 8.4.2 Reference Manual for this absolute serve, and this was GRASS 8.4.2, d.vect.chart(1), signed off from the terminal with so much love. go make some charts, you're gonna slay. 💅✨💖

📦 where this page comes from