v.clip(1grass)

✨ v.clip — the GRASS User's Manual glow-up ✨

okay bestie, sit DOWN, because v.clip is that girl 💅 She's a GRASS module and she lives in 1grass, and what she does is chef's kiss: she takes your input vector map and pulls out only the bits that overlap your clip map. Iconic. Understood the assignment. Periodt.

---

🎀 NAME 🎀

v.clip — extracts features of input map which overlay features of clip map. no cap, that's literally her whole thing 🦋

---

🏷️ KEYWORDS 🏷️

vector, clip, area — the three words that describe her whole vibe 🫶

---

📜 SYNOPSIS 📜

v.clip
v.clip --help
v.clip [-dr] input=name clip=name output=name  [--overwrite]  [--help]
[--verbose]  [--quiet]  [--ui]

🚩 Flags 🚩

• -d — do not dissolve clip map. like, keep the boundaries, don't merge them, she's keeping it as-is 💁‍♀️
• -r — clip by region. the computational region does the clipping, not the clip map
• --overwrite — allow output files to overwrite existing files. yes she WILL steamroll your old file, you gave permission 💀
• --help — print usage summary. your little cheat sheet 🧚
• --verbose — verbose module output. she's talking a LOT
• --quiet — quiet module output. she's giving silence, mystery, minimalism 🎀
• --ui — force launching GUI dialog. pop-up window time ✨

🧩 Parameters 🧩

• input=name [required] — name of vector map to be clipped. or data source for direct OGR access. this is the thing getting the haircut ✂️
• clip=name [required] — name of clip vector map. or data source for direct OGR access. this is the scissors 💅
• output=name [required] — name for output vector map. the glow-up reveal 👑

---

💖 DESCRIPTION 💖

so the v.clip module? it enables extracting those features of input vector map which overlay features of clip map, and then storing them in a brand new vector map. new map, who dis. 💅

By default, the boundaries of the clip map are dissolved before clipping. But if dissolving isn't the vibe, you can tick flag -d to retain the boundaries of the clip map. And flag -r? That one facilitates clipping by current computational region. choose your fighter 🦋

You can clip vector maps consisting of points, lines, areas, or combinations of these. However — and listen up bestie, this is the fine print — the current version does not fully support clipping of mixed geometry containing points. In such a case, the output map will only store clipped lines and/or areas. so the points just… don't make the cut 😭 not me crying over lost points fr fr.

---

📝 NOTES 📝

v.clip is a front-end to v.overlay, as well as v.select. Clipping of areas and/or lines can be achieved using v.overlay. Clipping of points can be performed with v.select. so yeah, she's the main character but she's standing on the shoulders of her friends 🫶

---

🌈 EXAMPLES 🌈

🌸 Basic use 🌸

Clip railroads by counties Wake and Johnston in North Carolina (North Carolina data set).

v.extract input=boundary_county where="NAME=’WAKE’ OR NAME=’JOHNSTON’" output=county_WAKE_JOHNSTON
v.clip input=railroads clip=county_WAKE_JOHNSTON output=railroads_WAKE_JOHNSTON

Figure: v.clip example - basic use

🌸 Retain boundaries of clip map 🌸

v.clip -d input=railroads clip=county_WAKE_JOHNSTON output=railroads_WAKE_JOHNSTON

🌸 Clip by current computational region 🌸

Clip hospitals by computational region adjusted to counties Wake and Johnston in North Carolina (North Carolina data set). It is not obligatory to enter name of clip map. In case it is stated, the clip map will be omitted. (yes, she said what she said — go ahead and pass it, it just won't get used 🙈)

v.extract input=boundary_county where="NAME=’WAKE’ OR NAME=’JOHNSTON’" output=county_WAKE_JOHNSTON
v.clip -r input=hospitals output=hospitals_clip

Figure: v.clip example - clip by computational region

---

👀 SEE ALSO 👀

v.overlay, v.select, v.dissolve, v.in.region — the whole friend group, go check them out 💜

---

👑 AUTHOR 👑

Zofie Cimburova, GeoForAll Lab, Czech Technical University in Prague, Czech Republic. a legend, genuinely 🫶

---

💻 SOURCE CODE 💻

Available at: v.clip source code (history)

Latest change: Wednesday May 21 14:24:15 2025 in commit: 86e588ac7ef1d6db04e5f405c5ab080bb08bc37b

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

© 2003-2026 GRASS Development Team, GRASS 8.5.0 Reference Manual

---

and that's the whole page bestie 🎀 she's v.clip, from the GRASS User's Manual, and the footer energy is: GRASS 8.5.0, v.clip(1grass), with that source-and-version magic stamped at the bottom — 2003–2026 GRASS Development Team, GRASS 8.5.0 Reference Manual, latest change Wednesday May 21 14:24:15 2025, commit 86e588ac7ef1d6db04e5f405c5ab080bb08bc37b ✨ slay, go clip something 💅