Scroll to navigation GRASS GIS User's Manual

NAME - Reports geometry statistics for vector maps.


vector, geometry, statistics

SYNOPSIS --help [-cd] map=name [layer=string] option=string [units=string] [sort=string] [--help] [--verbose] [--quiet] [--ui]


Do not include column names in output

Report for geometries with no database records

Print usage summary

Verbose module output

Quiet module output

Force launching GUI dialog


Name of vector map
Or data source for direct OGR access

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

Value to calculate
Options: area, length, coor

Options: miles, feet, meters, kilometers, acres, hectares, percent

Sort the result
Options: asc, desc
asc: Sort in ascending order
desc: Sort in descending order

DESCRIPTION generates a table showing the area present in each of the categories of a user-selected data layer.

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.

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 location’s standard map unit is the US Survey foot. 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 and v.overlay, and then run on the new map.


North Carolina sample dataset: zipcodes_wake option=area units=hectares

In the output, there is an extra column added containing the results.

SEE ALSO,, v.overlay


Markus Neteler, GDF Hannover


Available at: source code (history)

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

© 2003-2020 GRASS Development Team, GRASS GIS 7.8.5 Reference Manual

GRASS 7.8.5