g.gui.photo2image(1)

📦
version 8.4.2 · 10 versions
, in fedora 44

✨ g.gui.photo2image — the manual page ✨

okay bestie, welcome to the g.gui.photo2image glow-up 🎀 this is the GRASS GIS User's Manual entry, and we are about to make scanned aerial photos make sense. stay with me, it's giving cartography but make it cute 🦋

🌸 NAME 🌸

g.gui.photo2image — Corrects scanning distortions of a paper photo. 💅

🏷️ KEYWORDS 🏷️

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

🫶 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 — prints the usage summary, aka the "what does this even do" cheat sheet 📖
  • --verbose — verbose module output, so it tells you everything that's happening, main character narration energy ✨
  • --quiet — quiet module output, for when you want zero yapping 🤫
  • --ui — force launches the GUI dialog, no escape 😌

💖 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 over 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 📁

👑 DESCRIPTION 👑

This module is based on g.gui.gcp, the GCP manager of GRASS GIS. It's part of the i.ortho.photo suite. iconic family reunion 🫶

The whole point 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. 🎯

And why do we care, bestie? Because (manual) scanning introduces distortions, rotations, and also may not be limited to scan the boundary of the photo itself. So yeah, it's necessary to give to each fiducial the exact coordinates in mm as given by the aerial photographic instrument design, which is unique per camera. no cap, every camera has its own whole personality 💅

lowkey important: 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: Saturday Jan 17 05:42:35 2026 ⏰

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

© 2003-2025 GRASS Development Team, GRASS GIS 8.4.2 Reference Manual 💖

and that's the whole page bestie, you just read g.gui.photo2image(1) from GRASS 8.4.2 — slay, go fix those fiducials 🎀✨

📦 where this page comes from