i.signatures(1grass)

💖 i.signatures — the GRASS User's Manual glow-up 💖

okay so bestie, welcome to i.signatures from the GRASS manual. she's the one who manages your imagery classification signature files and honestly? she's lowkey the backbone of your whole classification era. let's get into it 🦋

✨ KEYWORDS ✨

imagery, classification, signatures — that's the vibe check, periodt.

---

🌸 SYNOPSIS 🌸

i.signatures
i.signatures --help
i.signatures [-p]  [type=name]  format=name  [mapset=name[,name,...]]
[remove=name[,name,...]]   [rename=from,to[,from,to,...]]
[copy=from,to[,from,to,...]]   [--help]  [--verbose]  [--quiet]  [--ui]

🎀 Flags

• -p — Print signature files. she's showing off 💅
• --help — Print usage summary. the "help me bestie" button.
• --verbose — Verbose module output. she tells you everything.
• --quiet — Quiet module output. she says nothing, just does the thing. mysterious. iconic.
• --ui — Force launching GUI dialog. windows girlies rise up 🪟✨

🍓 Parameters

• type=name — Type of signature file. Options: sig, sigset, libsvm
• format=name [required] — Output format. Options: plain, json. Default: plain.
  • plain: Plain text output
  • json: JSON (JavaScript Object Notation)
• mapset=name[,name,...] — Name of mapset to list. Default: current search path.
• remove=name[,name,...] — Name of file(s) to remove. bye boo 👋
• rename=from,to[,from,to,...] — Name of file to rename. glow-up, but for filenames.
• copy=from,to[,from,to,...] — Name of file to copy. the way she twins 💕

---

👑 DESCRIPTION 👑

so i.signatures is literally the manager babe for signature files. she handles these two:

• "sig" – generated by i.gensig for i.maxlik
• "sigset" – generated by i.gensigset for i.smap

and the best part? she can do multiple actions per run, like a girl who's juggling three group chats at once. the order of execution is "copy", then "remove", then "rename" — no cap, that's the lineup.

also: when you pass the print flag without specifying any type of signature files, she prints all signatures, grouped by type. she's thorough like that 🫶

---

💅 NOTES 💅

by default the module lists signature files from all mapsets in the current search path. want to narrow it down? pass the mapset option and limit the listing to a single mapset. the mapset can also be one that's not listed in the current search path — she's flexible, we love that.

now here's the important bit, so listen up 🚨:

Actions remove and rename operate only on the current mapset (although they do accept fully qualified names). The copy action, meanwhile, will accept a signature file name from any mapset as its first argument — that's the source file to copy.

---

🔥 EXAMPLES 🔥

Print names of all signature files:

i.signatures -p

Print only signature files of a certain type as a JSON:

i.signatures -p type=sigset format=json

Delete a signature file called "foo" of type "sig" (that's the i.gensig / i.maxlik family):

i.signatures remove=foo type=sig

Copy signature file "bar" from mapset "baz" to the current mapset:

i.signatures copy=bar@baz,best_version type=sigset

---

🌈 SEE ALSO 🌈

• i.gensig
• i.gensigset

the whole friend group 💖

---

💜 AUTHOR 💜

Maris Nartiss — absolute legend, no notes 👑

---

🌟 SOURCE CODE 🌟

Available at: i.signatures source code (history)

Latest change: Tuesday Nov 11 15:17:03 2025 in commit: 59f1608a354cb5e6c1a7a5cc477633b8632d1774

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

---

aaaand that's the whole page, bestie 🎀 this was GRASS 8.5.0, from the GRASS 8.5.0 Reference Manual, © 2003-2026 GRASS Development Team — slay, mwah 💋✨