v.in.region - GRASS manual
Author: GRASS Development Team
Description: v.in.region: Creates a vector polygon from the current region extent.
Keywords: vector, geometry

## NAME

v.in.region - Creates a vector polygon from the current region extent.

## KEYWORDS

vector, geometry

## SYNOPSIS

v.in.region
v.in.region --help
v.in.region [-d] output=name [type=string] [cat=integer] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

### Flags:

-d
  Densify lines using region resolution
--overwrite
  Allow output files to overwrite existing files
--help
  Print usage summary
--verbose
  Verbose module output
--quiet
  Quiet module output
--ui
  Force launching GUI dialog

### Parameters:

output=name [required]
  Name for output vector map
type=string
  Select type: line or area
  Options: line, area
  Default: area
cat=integer
  Category value
  Default: 1

## DESCRIPTION

v.in.region creates a new vector map from current region extent.

If the output of v.in.region is to be used for raster reprojection, the -d flag should be used after setting the region to the raster map to be reprojected with r.proj.

## EXAMPLE

The example is based on the North Carolina sample data. To create a bounding box vector map based on a raster map, the computational region is first set to the raster map. Then a vector bounding box is created based on the actual computational region (in this case precisely reflecting the pixel geometry of the raster map), resulting in a new vector polygon:

    g.region raster=soils_Kfactor -p
    v.in.region output=soils_Kfactor_bbox
    v.info map=soils_Kfactor_bbox

## SEE ALSO

g.region, r.proj, v.info

## AUTHOR

Radim Blazek

## SOURCE CODE

Available at: v.in.region source code (history)

Latest change: Friday Feb 07 19:16:09 2025 in commit: a82a39f673b97fafcfce1604dc3e6015cb96487a

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

© 2003-2026 GRASS Development Team, GRASS 8.6.0dev Reference Manual