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

       -d
           Report for geometries with no database records

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

       v.report  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 coordinate reference system’s standard map  unit  is  the  US  Survey
       foot.

       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.

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.

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: Friday Apr 04 01:21:13 2025

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

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

GRASS 8.4.1                                                                                     v.report(1grass)