i.ortho.corr

Corrects orthophoto taking part of the adjacent orthophotos using a camera angle map.

i.ortho.corr input=name [osuffix=ortho] [csuffix=ortho] tiles=name [field=name] [exclude=name] [output=name] [--verbose] [--quiet] [--qq] [--ui]

Example:

i.ortho.corr input=name tiles=name

grass.script.run_command("i.ortho.corr", input, osuffix=None, csuffix=None, tiles, field=None, exclude=None, output=None, verbose=False, quiet=False, superquiet=False)

Example:

gs.run_command("i.ortho.corr", input="name", tiles="name")

Parameters

Command linePython (grass.script)

input=name [required]
    Name of input raster map
osuffix=ortho
    Suffix of ortophoto map, default is .ortho, use None for no suffix
csuffix=ortho
    Suffix of camera angle map, default is .camera_angle, use None for no suffix
tiles=name [required]
    Name of input vector tiles map create by a list of orthophoto
field=name
    Name of location's field in the input vector tiles map
exclude=name
    Pattern to use if you want exclude some tiles
output=name
    Name of output raster map
--help
    Print usage summary
--verbose
    Verbose module output
--quiet
    Quiet module output
--qq
    Very quiet module output
--ui
    Force launching GUI dialog

input : str, required
    Name of input raster map
    Used as: , name
osuffix : str, optional
    Suffix of ortophoto map, default is .ortho, use None for no suffix
    Used as: , ortho
csuffix : str, optional
    Suffix of camera angle map, default is .camera_angle, use None for no suffix
    Used as: , ortho
tiles : str, required
    Name of input vector tiles map create by a list of orthophoto
    Used as: , name
field : str, optional
    Name of location's field in the input vector tiles map
    Used as: , name
exclude : str, optional
    Pattern to use if you want exclude some tiles
    Used as: , name
output : str, optional
    Name of output raster map
    Used as: , name
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

DESCRIPTION

i.ortho.corr allows to correct orthophotos using the camera angle map create by i.ortho.photo.

It creates a new image by searching further images adjacent to the input image. The output contains part of near images where the camera angle value is optimal.

NOTES

It requires a tile index to be created containing all the images to be processed (e.g., GDAL's gdaltindex can create that):

gdaltindex tile.shp $GRASSDATA/$LOCATION/$MAPSET/cellhd/*imagery.ortho

The field option is used for the field's name which contains the path to the file, the default is location that it is used by gdaltindex. The exclude option serves to remove some tiles, for example when having tiles from a different flight, they can be excluded by passing a string or a regular expression.

EXAMPLES

Create tile index:

gdaltindex tile.shp $GRASSDATA/$LOCATION/$MAPSET/cellhd/*imagery.ortho

Import tile index inside the mapset

v.in.ogr dns=tile.shp out=tile_images

Start i.ortho.corr with the default parameters, the output map's name will be image.ortho_corr. You can use default parameters if you didn't change the output prefix in i.ortho.photo:

i.ortho.corr input=image.ortho tiles=tile_images

Start i.ortho.corr with different parameters

i.ortho.corr input=image.photo tiles=tile_images osuffix=.photo csuffix=.camera

AUTHOR

Luca Delucchi, Fondazione E. Mach (Italy)

SOURCE CODE

Available at: i.ortho.corr source code (history)
Latest change: Thursday Feb 20 13:02:26 2025 in commit 53de819