g.gui.photo2image
Corrects scanning distortions of a paper photo.
g.gui.photo2image group=name raster=name camera=string order=string extension=string [--verbose] [--quiet] [--qq] [--ui]
Example:
g.gui.photo2image group=name raster=name camera=string order=1 extension=_ip2i_out
grass.script.run_command("g.gui.photo2image", group, raster, camera, order="1", extension="_ip2i_out", verbose=False, quiet=False, superquiet=False)
Example:
gs.run_command("g.gui.photo2image", group="name", raster="name", camera="string", order="1", extension="_ip2i_out")
Parameters
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 i.ortho.camera)
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)
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
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--qq
Very quiet module output
--ui
Force launching GUI dialog
group : str, required
Name of input imagery group
Used as: input, group, name
raster : str, required
Name of input raster map
Used as: input, raster, name
camera : str, required
The name of the camera (generated in i.ortho.camera)
The name of the camera (generated in i.ortho.camera)
order : str, 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 : str, 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
verbose: bool, optional
Verbose module output
Default: False
quiet: bool, optional
Quiet module output
Default: False
superquiet: bool, optional
Very quiet module output
Default: False
wxGUI GCP Manager for photo to image registration
DESCRIPTION
This module is based on g.gui.gcp, the GCP manager of GRASS GIS. It is part of i.ortho.photo 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 (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
Figure: Screenshot of g.gui.photo2image
SEE ALSO
i.ortho.photo, i.group, i.ortho.camera, i.ortho.target, i.rectify, m.transform, v.rectify
See also video tutorials on GRASS Wiki.
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: g.gui.photo2image source code
(history)
Latest change: Monday Mar 31 21:12:45 2025 in commit 584455a