v.in.region(1grass)

💖 v.in.region — the manual page, but make it make sense 💖

okay bestie, welcome to v.in.region(1grass), straight outta the GRASS User's Manual. this is the page where you learn how to ✨manifest✨ a whole vector polygon out of literally nothing but your current region extent. no cap.

---

🎀 NAME 🎀

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

🌈 KEYWORDS 🌈

vector, geometry

---

✨ SYNOPSIS ✨

lowkey the whole vibe in one block, here you go:

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. this one's the main character when reprojection is involved, remember her.
• --overwrite — Allow output files to overwrite existing files. yes queen, go ahead and bulldoze.
• --help — Print usage summary. when you're lost, she's your girl.
• --verbose — Verbose module output. she talks a LOT. obsessed.
• --quiet — Quiet module output. the introvert setting. we respect it.
• --ui — Force launching GUI dialog. for when clicking > typing, no judgement here.

🌸 Parameters:

• output=name [required] — Name for output vector map. you HAVE to name your baby, there's no skipping this one.
• 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. that's it, that's the whole job. she takes the box you're currently working in and turns it into an actual vector map. iconic behaviour honestly.

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. so like — set the region first, THEN hit her with the -d. the way this matters for reprojection... iykyk. 🫶

---

🌟 EXAMPLE 🌟

this one's based on the North Carolina sample data, and it's such a cute little demo fr fr.

so the goal: make a bounding box vector map based on a raster map. to do that, you first set the computational region to the raster map. then you create a vector bounding box based on the actual computational region — and in this case it precisely reflects the pixel geometry of the raster map. result? a brand new vector polygon. slay.

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

go read those too, they're part of the friend group.

---

👑 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

---

and that's the whole page bestie — this was GRASS 8.5.0, the v.in.region(1grass) manual, © 2003-2026 GRASS Development Team, from the GRASS 8.5.0 Reference Manual. 💖✨🎀 thank you for coming to my ted talk, now go densify something. 💅🦋🌸