GRASS logo


g.gui.photo2image - Corrects scanning distortions of a paper photo.


imagery, aerial, photo, GUI


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


Print usage summary
Verbose module output
Quiet module output
Force launching GUI dialog


group=name [required]
Name of input imagery group
raster=name [required]
Name of input raster map
camera=string [required]
The name of the camera (generated in
The name of the camera (generated in
order=string [required]
The rectification order (no of Fiducial=4 -> order=1, no of Fiducial=8 -> order=2)
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)
The name of the output files extension (used in i.rectify)
Default: _ip2i_out

Table of contents


This module is based on g.gui.gcp, the GCP manager of GRASS GIS. It is part of suite.

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.

This is necessary as (manual) scanning introduces distortions, rotations and also may not be limited to scan the boundary of the photo itself. It is thus necessary to give to each fiducial the exact coordinates in mm as given by the aerial photographic instrument design, which is unique per camera.

This module requires you to have made a group with your aerial photo (, a camera description file ( 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 Location imagery60:

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

Screenshot of g.gui.iphoto2image

Screenshot of g.gui.iphoto2image
Figure: Screenshot of g.gui.iphoto2image

For a detailed operation manual please read

wxGUI components

See also video tutorials on GRASS Wiki.

SEE ALSO,,,, i.rectify, m.transform, v.rectify


Markus Metz

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

$Date: 2017-11-11 03:27:38 -0800 (Sat, 11 Nov 2017) $


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

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

© 2003-2017 GRASS Development Team, GRASS GIS 7.5.svn Reference Manual