i.group(1grass)

✨ i.group — the imagery group glow-up ✨

okay bestie, this is i.group from the GRASS User's Manual (1grass, imagery section, iykyk). She makes groups, edits groups, and lists groups of imagery data. That's the whole job and she does it flawlessly. 💅

---

🌸 NAME 🌸

i.group — Creates, edits, and lists groups of imagery data.

🎀 KEYWORDS 🎀

imagery, map management

---

🦋 SYNOPSIS 🦋

i.group
i.group --help
i.group [-rlsg] group=name  [subgroup=name]   [input=name[,name,...]]
[file=name]  format=name  [--help]  [--verbose]  [--quiet]  [--ui]

✨ Flags ✨

• -r — Remove selected files from specified group or subgroup. bye bye files 👋
• -l — List files from specified (sub)group. show me the roster bestie 📋
• -s — List subgroups from specified group.
• -g — Print in shell script style [deprecated]. This flag is deprecated and will be removed in a future release. Use format=shell instead. 🫠 (she's on her way out, don't get attached)
• --help — Print usage summary.
• --verbose — Verbose module output. she will NOT stop talking and honestly? we love that 💖
• --quiet — Quiet module output. shhh 🤫
• --ui — Force launching GUI dialog.

💜 Parameters 💜

• group=name [required] — Name of imagery group. mandatory bestie, no skipping 💅
• subgroup=name — Name of imagery subgroup.
• input=name[,name,...] — Name of raster map(s) to include in group. comma-separated roster, slay.
• file=name — Input file with one raster map name per line.
• format=name [required] — Output format.
  • Options: plain, shell, json
  • Default: plain
  • plain: Human readable text output
  • shell: shell script style text output
  • json: JSON (JavaScript Object Notation)

---

🧚 DESCRIPTION 🧚

So here's the vibe: i.group lets you collect raster map layers into an imagery group, and you get to assign them into user-named subgroups or other groups. Which means you can then run analyses on literally any combination of the raster map layers sitting in a group. You're the one who creates the groups and subgroups, and you're the one who picks which raster map layers get to live in them. main character energy fr fr 👑

Some imagery analysis programs — like g.gui.gcp, i.rectify, i.ortho.photo and friends — will ask you for the name of an imagery group whose data are to be analyzed. And other imagery analysis programs, like i.cluster and i.maxlik, will ask you for both the imagery group and the imagery subgroup whose data are to be analyzed. So yeah. She's popular. Everybody wants her. 💅

---

🔥 NOTES 🔥

The i.group options are only available for imagery map layers in the current LOCATION_NAME. Like, current-location-only. no cap.

Subgroup names may not contain more than 12 characters. twelve!! that's the limit bestie, keep it cute and short 🎀

🌈 EXAMPLE 🌈

This example runs in the "landsat" mapset of the North Carolina sample dataset. The following command creates a group and subgroup containing only the visible light bands of Landsat-7:

i.group group=vis_bands subgroup=vis_bands input=lsat7_2000_10,lsat7_2000_20,lsat7_2000_30

ate that. no crumbs. 🍓

---

👑 SEE ALSO 👑

• The GRASS 4 Image Processing manual
• g.gui.gcp, i.cluster, i.maxlik, i.rectify, i.ortho.photo

---

💖 AUTHORS 💖

• Michael Shapiro, U.S.Army Construction Engineering Research Laboratory
• Parser support: Bob Covill (Tekmap, Canada)

the icons who built her 🫶

---

⭐ SOURCE CODE ⭐

Available at: i.group source code (history)

Latest change: Thursday Oct 02 14:39:13 2025 in commit: 1850489bf42c72d8dcfe2e4db1738441b4a7dc43

Main index | Imagery index | Topics index | Keywords index | Graphical index | Full index

---

okay that's the whole page, every flag, every param, every note, we left NOTHING out. 💀✨

---

© 2003-2026 GRASS Development Team, GRASS 8.5.0 Reference Manual — and that's the tea, bestie. this was i.group from GRASS 8.5.0, the manual page that lives at the bottom of every readme like a signature perfume. go make some groups, you absolute icon 💅🌸🦋