v.report(1)

📦
version 8.4.2 · 8 versions
, in fedora 44

💖 v.report — the GRASS GIS User's Manual glow-up 💖

okay bestie, welcome to v.report(1) from the GRASS GIS User's Manual. this little icon reports geometry statistics for vector maps and honestly? she ate. let's get into it 🦋

✨ NAME ✨

v.report — Reports geometry statistics for vector maps.

🌸 KEYWORDS 🌸

vector, geometry, statistics

👑 SYNOPSIS 👑

v.report
v.report --help
v.report [-cd] map=name  [layer=string]  option=string  [units=string]
[sort=string]   [separator=character]   [--help]  [--verbose]  [--quiet]
[--ui]

🎀 Flags 🎀

  • -c — Do not include column names in output. shy output energy, no header row 💅
  • -d — Report for geometries with no database records. yes bestie we're counting the ones with no records too 🙈
  • --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.
  • 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
  • option=string [required] — Value to calculate. Options: area, length, coor
  • units=string — Units. Options: miles, feet, meters, kilometers, acres, hectares, percent
  • sort=string — Sort the result. Options: asc, desc
    • asc: Sort in ascending order
    • desc: Sort in descending order
  • separator=character — Field separator. Special characters: pipe, comma, space, tab, newline. Default: pipe

💜 DESCRIPTION 💜

okay so v.report generates a table showing the area present in each of the categories of a user-selected data layer. very "here's your data, organized, you're welcome" of her 🫶

Area is given in hectares, square meters, and square kilometers. If the units option is used, area is given in acres, square feet, and square miles. so many units, so little time 😭

Feet and acre units are always reported in their common versions (i.e. the International Foot, exactly 5280 feet in a mile), even when the coordinate reference system's standard map unit is the US Survey foot. no cap, that's just how she rolls ⭐

v.report works on the full map data; therefore, the current region is ignored. If you wish to spatially limit the statistics, a map subset must be created with v.in.region and v.overlay, and then run v.report on the new map. so if you're out here expecting your region setting to do something... bestie, she does not see it 💀

🌈 EXAMPLE 🌈

North Carolina sample dataset:

v.report zipcodes_wake option=area units=hectares

In the output, there is an extra column added containing the results. slay, extra column, we love a bonus ✨

🔥 SEE ALSO 🔥

v.in.region, v.to.db, v.overlay

🎀 AUTHOR 🎀

Markus Neteler, GDF Hannover

🦋 SOURCE CODE 🦋

Available at: v.report source code (history)

Accessed: Saturday Jan 17 05:41:53 2026

Main index | Vector index | Topics index | Keywords index | Graphical index | Full index

© 2003-2025 GRASS Development Team, GRASS GIS 8.4.2 Reference Manual

and that's the whole vibe, bestie — this was v.report(1) from the GRASS GIS User's Manual, brought to you by GRASS 8.4.2, running it back one more time on the footer tip: v.report(1). go forth and report your geometry, you gorgeous main character 👑💖

📦 where this page comes from