v.in.region(1)

💖 v.in.region 💖

okay bestie, welcome to the GRASS GIS User's Manual page for v.in.region — she's a lil vector queen and she's about to make your life so much easier 🎀

---

✨ NAME ✨

v.in.region — Creates a vector polygon from the current region extent. that's it. that's the whole vibe. a polygon, from your region. slay 💅

---

🌸 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. lowkey important, more on that in a sec 👀
• --overwrite — Allow output files to overwrite existing files. yes queen, go ahead and replace that old map, no shame
• --help — Print usage summary
• --verbose — Verbose module output. she will tell you EVERYTHING
• --quiet — Quiet module output. she will tell you nothing. mysterious.
• --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. fr fr, that's the whole thing — it looks at wherever your computational region is chillin' right now and goes "okay bestie, imma turn that rectangle into a vector map" 🎀

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. don't skip that step, it's giving necessary 💀

---

🌈 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

look at her go. bbox queen. bbox icon. no cap ✨

---

🔥 SEE ALSO 🔥

g.region, r.proj, v.info

---

💅 AUTHOR 💅

Radim Blazek — the actual legend who wrote this. we stan 🫶

---

🧚 SOURCE CODE 🧚

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

Accessed: Saturday Jan 17 05:41:22 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

---

periodt. that's the whole page. go make your polygons, bestie 💖

okay so that's a wrap on the v.in.region manual page, coming to you straight from GRASS 8.4.2 — take care of her, she's iconic ⭐