v.report(1grass)

💖 v.report — the manual page, bestie edition 💖

okay so you found <bold>v.report</bold> in the GRASS User's Manual and honestly? slay. it's the 1grass manual page, and it's about to tell you everything about the geometry stats of your vector maps. let's get into it 🫶

---

✨ NAME ✨

v.report — reports geometry statistics for vector maps. it's giving geometry gossip, fr fr 💅

---

🌸 KEYWORDS 🌸

vector, geometry, statistics. the holy trinity of "what even is my map" energy 👑

---

🦋 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]

literally the whole vibe in one block. keep reading, i got you 💜

🎀 Flags 🎀

• -c — do not include column names in the output. just the raw numbers, no labels, no chit-chat 🙈
• -d — report for geometries with no database records. the forgotten ones. the ones with no category. we see them 😭
• --help — print usage summary. your lil cheat sheet ✨
• --verbose — verbose module output. more words, more lore 🗣️
• --quiet — quiet module output. shhh. not a peep 🤫
• --ui — force launching GUI dialog. for when you want buttons instead of typing, no judgement 🖱️

🍓 Parameters 🍓

• map=name [required] — name of vector map. or, plot twist, a data source for direct OGR access. either way we move 🌈
• layer=string — layer number or name. here's the tea: vector features can have category values in different layers, and this number determines which layer to use. when used with direct OGR access, this is the layer name. default: 1 💫
• option=string [required] — the value to calculate. options: area, length, coor. pick your fighter 👑
• 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 💫

so v.report generates a table showing the area present in each of the categories of a user-selected data layer. cute, right? 🥰

area is given in hectares, square meters, and square kilometers. and if you use the units option, area is given in acres, square feet, and square miles instead. glow-up complete ✨

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 it is 💅

⚠️ important bestie: 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. do not skip this step, i'm begging 😭

---

🌟 EXAMPLE 🌟

North Carolina sample dataset, iconic behavior:

v.report zipcodes_wake option=area units=hectares

in the output, there is an extra column added containing the results. simple as that 🎀

---

🔥 SEE ALSO 🔥

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

go read those too, iykyk 🫶

---

👑 AUTHOR 👑

Markus Neteler, GDF Hannover. king shit, honestly 💜

---

🧚 SOURCE CODE 🧚

available at: v.report source code (history)

latest change: Saturday Oct 11 04:38:40 2025 in commit: 3dd71f5fab83b72a2db2da959fe075c5b3b52200

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

© 2003-2026 GRASS Development Team, GRASS 8.5.0 Reference Manual

---

and that's the whole page, bestie 🫶 it's GRASS 8.5.0, the v.report(1grass) manual, and the last touch was Saturday Oct 11 04:38:40 2025. go forth and report some geometry 💖✨🌸