v.info(1)

πŸ’– v.info(1) β€” GRASS GIS User's Manual πŸ’–

okay bestie, pull up a chair πŸŽ€ because we're about to meet v.info from the GRASS GIS crew β€” the lil' icon that just tells you stuff about your vector map. no drama, no edits, just receipts. ✨


🌸 NAME 🌸

v.info β€” outputs basic information about a vector map.


πŸ¦‹ KEYWORDS πŸ¦‹

vector, metadata, topology, extent, history, attribute columns, level1


✨ SYNOPSIS ✨

v.info
v.info --help
v.info [-hcget] map=name  [layer=string]   [--help]  [--verbose]
[--quiet]  [--ui]

πŸŽ€ Flags:

  • -h β€” print history instead of info and exit
  • -c β€” print types/names of table columns for specified layer instead of info and exit
  • -g β€” print region info in shell script style
  • -e β€” print extended metadata info in shell script style
  • -t β€” print topology info in shell script style
  • --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, like, a data source for direct OGR access πŸ‘€
  • layer=string β€” layer number or name. here's the tea: vector features can have category values in different layers, and this number decides which layer we're looking at. when you're using direct OGR access, this is the layer name instead. Default: 1

πŸ’… DESCRIPTION πŸ’…

so v.info reports some basic info (metadata, bestie, the ✨vibe check✨ of your map) about a vector map you specify, plus its topology status.

if topology info isn't available β€” meaning the vector map can't be opened on level 2 β€” then the vector map extends and the number of features have to be counted on the fly, which may take some time. 😭 lowkey painful but we survive.

heads up: the flag -c only works when the vector map is connected to one or several attribute table(s). that connection can be shown or set with v.db.connect.

πŸ”₯ EXAMPLE πŸ”₯

⭐ Basic metadata information

v.info map=geology
 +----------------------------------------------------------------------------+
 | Name:            geology                                                   |
 | Mapset:          PERMANENT                                                 |
 | Project:         nc_spm_08                                                 |
 | Database:        /home/martin/grassdata                                    |
 | Title:           North Carolina geology map (polygon map)                  |
 | Map scale:       1:1                                                       |
 | Map format:      native                                                    |
 | Name of creator: helena                                                    |
 | Organization:    NC OneMap                                                 |
 | Source date:     Mon Nov  6 15:48:53 2006                                  |
 |----------------------------------------------------------------------------|
 |   Type of map: vector (level: 2)                                           |
 |                                                                            |
 |   Number of points:       0               Number of centroids:  1832       |
 |   Number of lines:        0               Number of boundaries: 3649       |
 |   Number of areas:        1832            Number of islands:    907        |
 |                                                                            |
 |   Map is 3D:              No                                               |
 |   Number of dblinks:      1                                                |
 |                                                                            |
 |   Projection: Lambert Conformal Conic                                      |
 |                                                                            |
 |               N:   318117.43741634    S:    10875.82723209                 |
 |               E:   930172.31282271    W:   123971.19498978                 |
 |                                                                            |
 |   Digitization threshold: 0                                                |
 |   Comment:                                                                 |
 |                                                                            |
 +----------------------------------------------------------------------------+

look at her. a whole box of facts. πŸ’–

🧚 Map history

v.info -h map=geology
COMMAND: v.in.ogr input="geol.shp" output="geology" min_area=0.0001 snap=-1
GISDBASE: /bigdata/grassdata05
LOCATION: ncfromfile MAPSET: PERMANENT USER: helena DATE: Mon Nov  6 15:48:53 2006
---------------------------------------------------------------------------------
1832 input polygons
total area: 1.276093e+11 (1832 areas)
overlapping area: 0.000000e+00 (0 areas)
area without category: 0.000000e+00 (0 areas)
---------------------------------------------------------------------------------
psst β€” note that while "project" is used by v.info elsewhere, the history output uses the legacy term "location", because LOCATION is currently a part of the native vector format. iykyk 🫢

🌸 Attribute columns for given layer

v.info -c map=geology
Displaying column types/names for database connection of layer <1>:
INTEGER|cat
DOUBLE PRECISION|onemap_pro
DOUBLE PRECISION|PERIMETER
INTEGER|GEOL250_
INTEGER|GEOL250_ID
CHARACTER|GEO_NAME
DOUBLE PRECISION|SHAPE_area
DOUBLE PRECISION|SHAPE_len

πŸ’œ Basic metadata information in shell script style

v.info -get map=geology
name=geology
mapset=PERMANENT
project=nc_spm_08
database=/home/martin/grassdata
title=North Carolina geology map (polygon map)
scale=1:1
format=native
creator=helena
organization=NC OneMap
source_date=Mon Nov  6 15:48:53 2006
level=2
map3d=0
num_dblinks=1
projection=Lambert Conformal Conic
digitization_threshold=0.000000
comment=
north=318117.43741634
south=10875.82723209
east=930172.31282271
west=123971.19498978
top=0.000000
bottom=0.000000
nodes=4556
points=0
lines=0
boundaries=3649
centroids=1832
areas=1832
islands=907
primitives=5481
v.info -g map=geology
north=318117.43741634
south=10875.82723209
east=930172.31282271
west=123971.19498978
top=0.000000
bottom=0.000000

🐍 PYTHON 🐍

check the Python Scripting Library for more info, bestie.

Note: the Python tab in the wxGUI can be used for entering the following code:
import grass.script as gcore
gcore.vector_columns(’geology’)   # for `v.info -c`
gcore.vector_info_topo(’geology’) # for `v.info shell=topo`

πŸ‘‘ SEE ALSO πŸ‘‘

r.info, r3.info, t.info, v.db.connect


πŸ’€ AUTHORS πŸ’€

  • Original author CERL
  • Updated to GRASS 6 by Radim Blazek, ITC-Irst, Trento, Italy
  • Level 1 support by Markus Metz
  • Updated to GRASS 7 by Martin Landa, CTU in Prague, Czech Republic

🌈 SOURCE CODE 🌈

Available at: v.info source code (history)

Accessed: Saturday Jan 17 05:41:21 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 page, babe 🫢 this was GRASS 8.4.2, and the manual got accessed on Saturday Jan 17 05:41:21 2026 β€” go forth and v.info your little heart out. periodt. πŸ’…βœ¨

πŸ“¦ where this page comes from