Provided by: grass-doc_6.4.3-3_all bug

NAME

       i.ortho.photo  - Menu driver for the photo imagery programs.

KEYWORDS

       imagery, orthorectify

SYNOPSIS

       i.ortho.photo
       i.ortho.photo help
       i.ortho.photo group=name  [--verbose]  [--quiet]

   Parameters:
       group=name
           Name of imagery group for ortho-rectification

DESCRIPTION

       i.ortho.photo allows the user to ortho-rectify imagery group files.  An imagery group consists of several
       scanned  aerial  photographs  (raster  maps) of a common area.  Imagery groups can be created or modified
       using the GRASS Image Processing Program i.group,  or  using  the  first  menu  option  described  below.
       i.ortho.photo  guides  the  user  through the steps required to ortho-rectify the raster maps in a single
       imagery group.

       The first menu in i.ortho.photo provides the user with the following options:

       Initialization Options:
              1) Select/Modify imagery group
              2) Select/Modify imagery group target
              3) Select/Modify target elevation model
              4) Select/Modify imagery group camera

       Transformation Parameter Computation:
              5) Compute image-to-photo transformation parameters
              6) Initialize exposure station parameters
              7) Compute photo-to-target transformation parameters

       Ortho-rectification Option:
              8) Ortho-rectify imagery group raster maps

       RETURN to exit
              >

       To ortho-rectify aerial images the user has to follow the menu options step by step. Generally  the  user
       builds  a  target  location  containing  a  projected  DEM and a map reference (topo sheet or other map).
       Another xy-location will contain the aerial photo. The entire rectification process is started within the
       xy-location. First the target to the projected  location  has  to  be  set  (i.target),  then  the  image
       references  (fiducial  points)  will be defined. After describing the camera parameters, reference points
       from aerial image to the topo sheet from the target location will be set. The  local  elevation  will  be
       taken from the target DEM. Finally the aerial image will be rectified.

       The options to follow are described as follows:

       1. Select/Modify imagery group
              The current imagery group is display at the top of the previous menu.  You may select another (new
              or  existing)  imagery group for the ortho-rectification program using option (1).  After choosing
              option (1) you will be prompted for the name of a new or existing imagery group.  Option (1) using
              the GRASS Image Processing Program i.group, for creation or modification of imagery  groups.   For
              more  information  on  imagery group creation or modification please the the GRASS manual page for
              i.group.

       2. Select/Modify imagery group target
              The target location and mapset may be selected or  modified  using  option  (2).   After  choosing
              option  (2) you will be prompted for the names of the target location and mapset, where the ortho-
              rectified raster maps will reside.  The target location  is  also  the  location  from  which  the
              elevation  model (raster map) will be selected -- see option (3).  Option (2) uses the GRASS Image
              Processing Program i.target, for selection or modification of the imagery  group  target  location
              and  mapset.  For more information on imagery group selection or modification please the the GRASS
              manual page for i.target.

       3. Select/Modify target elevation model
              Option (3) allows you to select the raster map  from  the  target  location  to  be  used  as  the
              elevation  model.   The  elevation  model  is required for both the computation of photo-to-target
              parameters (option 6) and for the ortho-rectification of the imagery group files (option 8).   The
              raster  map  select  for the elevation model should cover the entire area of the image group to be
              ortho-rectified.  Currently, the elevation model raster map is expected to be in units of  meters.
              DTED and DEM files are suitable for use as the elevation model in the ortho-rectification program.
              After  selection  option  (3)  you  will  be prompted for the name of the raster map in the target
              location that you want to use as the elevation model.

       4. Select/Modify imagery group camera
              Using option (4) you may select or create an camera reference file that  will  be  used  with  the
              current   imagery   group.    A  camera  reference  file  contains  information  on  the  internal
              characteristics of the aerial camera, as well as the geometry of the  fiducial  or  reseau  marks.
              The  most  important  characteristic  of the camera is its focal length.  Fiducial or reseau marks
              locations are required to compute the scanned image to photo-coordinate  transformation  parameter
              (option  5).   For  a more detailed description of option (4) please see the GRASS manual page for
              i.photo.camera.

       5. Compute image-to-photo transformation parameters
              The scanned image to photo-coordinate transformation parameters are computed using option (5).  In
              this interactive option you associate scanned reference points  (fiducials,  reseau  marks,  etc.)
              with  their  known  photo  coordinates from the camera reference file.  Complete documentation for
              this option is available under the manual entry i.photo.2image.

       6. Initialize exposure station parameters
              If option (6) is selected, initial camera exposure station parameters and initial variances may be
              selected or modified.  Complete documentation for this option is available under the manual  entry
              i.photo.init.

       7. Compute photo-to-target transformation parameters
              The  photo  to target transformation parameters are compute using option (7).  Here control points
              are marked on one or more imagery group files and associated with there known standard (e.g.  UTM)
              and  elevation  coordinates.  Complete documentation for this option is available under the manual
              entry i.photo.2target.

       8. Ortho-photo imagery group files
              Option (8) is used to perform the actual image ortho-rectification after all of the transformation
              parameters have been computed.  Ortho-rectified  raster  files  will  be  created  in  the  target
              location  for  each  selected imagery group file.  You may select either the current window in the
              target  location  or  the  minimal  bounding  window  for  the  ortho-rectified  image.   Complete
              documentation for this option is available under the manual entry i.photo.rectify.

NOTES

       i.ortho.photo  currently  requires  the  elevation model to be in meters, and the target location to be a
       standard (e.g. UTM) coordinate system.

REFERENCES

                      Wolf, P.R. (1983): Elements of Photogrammetry, With Air Photo  Interpretation  and  Remote
                     Sensing. 2nd ed. McGraw Hill, 562 pages

                      Rocchini,  D.,  Metz,  M., Frigeri, A., Delucchi, L., Marcantonio, M., Neteler, M. (2012).
                     Robust rectification of aerial photographs in  an  open  source  environment.  Computers  &
                     Geosciences 39 (2): 145-151.

SEE ALSO

       i.photo.camera, i.photo.2image, i.photo.2target, i.photo.init, i.photo.rectify

AUTHOR

       Mike Baba,  DBA Systems, Inc.

       Updated rectification and elevation map to FP 1/2002 Markus Neteler

       Last changed: $Date: 2012-01-08 13:48:21 -0800 (Sun, 08 Jan 2012) $

       Full index

       © 2003-2013 GRASS Development Team

GRASS 6.4.3                                                                                i.ortho.photo(1grass)