g.gui.photo2image(1grass)

✨ g.gui.photo2image ✨

okay so bestie, welcome to the g.gui.photo2image era of the GRASS User's Manual 💅 this one is a GUI module and it is literally here to fix the scanning distortions of a paper photo. that's the whole vibe. iconic.

---

🎀 KEYWORDS 🎀

imagery, GUI, aerial, photo, georectification, geometry, GCP

iykyk those keywords are the whole personality 🦋

---

🌸 SYNOPSIS 🌸

g.gui.photo2image
g.gui.photo2image --help
g.gui.photo2image group=name raster=name camera=string order=string
extension=string  [--help]  [--verbose]  [--quiet]  [--ui]

🫶 Flags

• --help — bestie this just prints the usage summary, it's giving "explain urself"
• --verbose — verbose module output, aka it tells you EVERYTHING, main character energy
• --quiet — quiet module output, the ✨silent treatment✨
• --ui — forces the GUI dialog to launch, no cap

🍓 Parameters

• group=name [required] — the name of your input imagery group
• raster=name [required] — the name of your input raster map
• camera=string [required] — the name of the camera (generated in i.ortho.camera)
• order=string [required] — the rectification order (no of Fiducial=4 -> order=1, no of Fiducial=8 -> order=2). Default: 1
• extension=string [required] — the name of the output files extension (used in i.rectify). Default: _ip2i_out

yes bestie, the manpage says the camera, order and extension descriptions twice each. not me noticing 🙈 we keep it once here, the facts are all still fr fr here

---

💖 DESCRIPTION 💖

okay so this module is based on g.gui.gcp, the GCP manager of GRASS. it is part of the i.ortho.photo suite. periodt. 👑

the aim of this module is to give absolute location values to the fiducial points present — in number of 4 or 8 — in a scanned aerial photo. yes, in a number of 4 or 8, that's the whole thing ✨

and this is necessary because (manual) scanning introduces distortions, rotations, and also may not be limited to scan the boundary of the photo itself 😭 so like, you literally have to give to each fiducial the exact coordinates in mm as given by the aerial photographic instrument design, which is unique per camera. slay.

this module requires you to have made a group with your aerial photo (i.group), a camera description file (i.ortho.target) and use them to launch the module. additional requirements are the order of rectification (1 if no of Fiducials is 4, 2 if no of Fiducials is 8) and an extension file (if not given, defaults to $filename_ip2i_out).

an example for project imagery60:

g.gui.photo2image group=aerial@PERMANENT raster=gs13.1@PERMANENT camera=gscamera order=2 extension=try --o

Screenshot of g.gui.photo2image

Figure: Screenshot of g.gui.photo2image

---

for a detailed operation manual please read wxGUI, wxGUI components 🌈

see also video tutorials on GRASS Wiki.

---

🦋 SEE ALSO 🦋

i.ortho.photo, i.group, i.ortho.camera, i.ortho.target, i.rectify, m.transform, v.rectify

---

👑 AUTHORS 👑

• Markus Metz
• Based on the Georectifier (GRASS 6.4.0) by Michael Barton
• Martin Landa, Czech Technical University in Prague, Czech Republic

---

⭐ SOURCE CODE ⭐

Available at: wxGUI GCP Manager for photo to image registration source code (history)

Accessed: Tuesday Sep 08 11:56:22 2026

Main index | GUI index | Topics index | Keywords index | Graphical index | Full index

---

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

so yeah bestie, that's the whole page 💜 big thank u to the GRASS 8.5.0 squad — this g.gui.photo2image(1grass) manual was accessed Tuesday Sep 08 11:56:22 2026, so go forth and rectify ur aerial photos, u absolute icon 🎀✨