i.points or i.vpoints must be run before i.rectify, and both programs are required to rectify an image. An image must be rectified before it can reside in a standard coordinate LOCATION, and therefore be analyzed with the other map layers in the standard coordinate LOCATION. Upon completion of i.rectify, the rectified image is deposited in the target standard coordinate LOCATION. This LOCATION is selected using i.target.
Enter the group containing files to be rectified Enter 'list' for a list of existing imagery groups Enter 'list -f' for a verbose listing Hit RETURN to cancel request >This is the same imagery group that was selected in i.points or i.vpoints and the group that contains the cell files with the marked points and their associated map coordinates. You are then asked to select the cell file(s) within the group to be rectified:
Please select the file(s) to rectify by naming an output file spot1.1 in mapsetname ............. spot1.2 in mapsetname ............. spot1.3 in mapsetname ............. spotclass1 in mapsetname spotrectify1. spotreject1 in mapsetname ............. (enter list by any name to get a list of existing cell files) AFTER COMPLETING ALL ANSWERS, HIT <ESC> TO CONTINUE (OR<Ctrl-C> TO CANCEL)More than one cell file may be rectified at a time. Each cell file should be given a unique output file name.
Next, you are asked to select one of two windows regions:
Please select one of the following options 1. Use the current window in the target location 2. Determine the smallest window which covers the image >The i.rectify program will only rectify that portion of the image or cell file that occurs within the chosen window region, and only that portion of the cell file will be relocated in the target database. It is important therefore, to check the current mapset window in the target LOCATION if choice number one is selected.
If you are rectifying a file with plans to patch it to another file using the GRASS program r.patch, choose option number one, the current window in the target location. This window, however, must be the default window for the target LOCATION. When a file being rectified is smaller than the default window in which it is being rectified, zeros are added to the rectified file. Patching files of the same size that contain 0/non-zero data, eliminates the possibility of a no-data line the patched result. This is because, when the images are patched, the zeros in the image are "covered" with non-zero pixel values. When rectifying files that are going to be patched, rectify all of the files using the same default window.
By selecting the 1st ORDER option, the user may select the order of transformation desired:
Select order of transformation --> 1st Order 2nd Order 3rd OrderThe program will immediately recalculate the RMSE and the number of points required.
Note: The rectified image or rectified cell files will be located in the target LOCATION when the program is completed. The original unrectified files are not modified or removed.
Note: In interactive mode it is possible to define a new file name for the target images. This is (currently) not provided in command line mode.
In case i.rectify starts normal and after some time a mail with following
text is sent:
GIS ERROR: error while writing to temp file
the user may try the flag -c (or the module needs more free space on the hard drive).
m.proj, s.proj, s.proj, v.proj, i.group, i.points, i.points3, i.vpoints, i.rectify3, i.target
Modified for GRASS 5.0 by:
Luca Palmeri (email@example.com)
Pierre de Mouveaux (firstname.lastname@example.org)
CMD mode by Bob Covill
Last changed: $Date: 2002/05/28 10:55:26 $