[GRASS-SVN] r44521 - grass/branches/develbranch_6/imagery/i.ortho.photo/i.photo.rectify

[svn_grass at osgeo.org]

Author: mmetz
Date: 2010-12-02 06:20:26 -0800 (Thu, 02 Dec 2010)
New Revision: 44521

Modified:
   grass/branches/develbranch_6/imagery/i.ortho.photo/i.photo.rectify/description.html
Log:
update manual

Modified: grass/branches/develbranch_6/imagery/i.ortho.photo/i.photo.rectify/description.html
===================================================================
--- grass/branches/develbranch_6/imagery/i.ortho.photo/i.photo.rectify/description.html	2010-12-02 14:08:04 UTC (rev 44520)
+++ grass/branches/develbranch_6/imagery/i.ortho.photo/i.photo.rectify/description.html	2010-12-02 14:20:26 UTC (rev 44521)
@@ -13,24 +13,38 @@
 compensated for relief distortions and photographic tilt. Upon completion of
 the program the rectified image is deposited in a previously targeted GRASS
 LOCATION.
-<P> You are asked to select the file(s) within the imagery group
-to be rectified:
-<P> Please select the file(s) to rectify by naming an
-output file <P> <PRE>
+<P>
+Images can be resampled with various different interpolation methods: 
+nearest neighbor assignment, bilinear and bicubic interpolation. The 
+bilinear and bicubic interpolation methods are also available with a
+fallback option. These methods "fall back" to simpler interpolation 
+methods along NULL borders. That is, from bicubic to bilinear to nearest.
+<P>
+The process may take an hour or more depending on the size of the image,
+the speed of the computer, the number files, and the size and resolution
+of the selected window.
+<P>
+The rectified image will be located in the target LOCATION when the program
+is completed. The original unrectified files are not modified or removed.
+<P>
+<EM>i.photo.rectify</EM> can be run directly, specifying options in the 
+command line or the GUI, or it can be invoked as OPTION 8 through 
+<A HREF="i.ortho.photo.html">i.ortho.photo</A>. If invoked though 
+<A HREF="i.ortho.photo.html">i.ortho.photo</A>, an interactive terminal 
+is used to determine the options.
 
-                    gs13.1 in PERMANENT   gs13.orect...
-                    gs14.1 in PERMANENT   .............
-
-     (enter list by any name to get a list of existing raster maps)
-
-	    AFTER COMPLETING ALL ANSWERS, HIT &lt;ESC&gt; TO CONTINUE
-	               (OR &lt;Ctrl-C&gt; TO CANCEL)
-</PRE>
+<H4>Interactive mode</H4>
+<P> You are first asked if all images within the imagery group should 
+be rectified. If this option is not chosen, you are asked to specify for 
+each image within the imagery group whether it should be rectified or not.
 <P>
-<P>
 More than one file may be rectified at a time.  Each file
-should have a unique output file name.
+should have a unique output file name. The next prompt asks you for an 
+extension to be appended to the rectified images.
 <P>
+After that you are asked if overwriting existing maps in the target 
+location and mapset should be allowed.
+<P>
 The next prompt asks you to select one of two windows:
 <P>
 <PRE>
@@ -40,17 +54,26 @@
       &gt;
 </PRE>
 <P>
+If you choose option 2, you can also specify a desired target resolution.
+<P>
 <EM>i.photo.rectify</EM> will only rectify that portion of the
 image that occurs within the chosen window.  Only that portion will be
 relocated in the target database. It is therefore important to check the
 current window in the target LOCATION if choice number one is selected.
 <P>
-The process may take an hour or more depending on the size of the image,
-the speed of the computer, the number files, and the size and resolution
-of the selected window.
+Next you are asked to select an interpolation method.
+<PRE>
+      Please select one of the following interpolation methods
+      1. nearest neighbor
+      2. bilinear
+      3. bicubic
+      4. bilinear with fallback
+      5. bicubic with fallback
+      &gt;
+</PRE>
 <P>
-The rectified image will be located in the target LOCATION when the program
-is completed. The original unrectified files are not modified or removed.
+The last prompt will ask you about the amount of memory to be used by
+<EM>i.photo.rectify</EM>.
 
 <H2>SEE ALSO</H2>
 
@@ -59,14 +82,15 @@
 <A HREF="i.photo.camera.html">i.photo.camera</A><br>
 <A HREF="i.photo.2image.html">i.photo.2image</A><br>
 <A HREF="i.photo.2target.html">i.photo.2target</A><br>
-<A HREF="i.photo.init.html">i.photo.init</A>
+<A HREF="i.photo.init.html">i.photo.init</A><br>
+<A HREF="i.rectify.html">i.rectify</A><br>
 </EM>
 
 
-
 <H2>AUTHOR</H2>
 Mike Baba,  DBA Systems, Inc.<br>
-Updated rectification and elevation map to FP 1/2002 Markus Neteler
+Updated rectification and elevation map to FP 1/2002 Markus Neteler<br>
+Bugfixes and enhancements 12/2010 Markus Metz
 
 <p>
 <i>Last changed: $Date$</i>