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