.TH i.oif 1grass "" "GRASS 6.4.2" "Grass User's Manual"
.SH NAME
\fI\fBi.oif\fR\fR  - Calculates Optimum-Index-Factor table for LANDSAT TM bands 1-5, & 7
.SH KEYWORDS
raster, imagery, statistics
.SH SYNOPSIS
\fBi.oif\fR
.br
\fBi.oif help\fR
.br
\fBi.oif\fR [-\fBg\fR] \fBimage1\fR=\fIstring\fR \fBimage2\fR=\fIstring\fR \fBimage3\fR=\fIstring\fR \fBimage4\fR=\fIstring\fR \fBimage5\fR=\fIstring\fR \fBimage7\fR=\fIstring\fR  [--\fBverbose\fR]  [--\fBquiet\fR] 
.SS Flags:
.IP "\fB-g\fR" 4m
.br
Print in shell script style
.IP "\fB--verbose\fR" 4m
.br
Verbose module output
.IP "\fB--quiet\fR" 4m
.br
Quiet module output
.PP
.SS Parameters:
.IP "\fBimage1\fR=\fIstring\fR" 4m
.br
LANDSAT TM band 1.
.IP "\fBimage2\fR=\fIstring\fR" 4m
.br
LANDSAT TM band 2.
.IP "\fBimage3\fR=\fIstring\fR" 4m
.br
LANDSAT TM band 3.
.IP "\fBimage4\fR=\fIstring\fR" 4m
.br
LANDSAT TM band 4.
.IP "\fBimage5\fR=\fIstring\fR" 4m
.br
LANDSAT TM band 5.
.IP "\fBimage7\fR=\fIstring\fR" 4m
.br
LANDSAT TM band 7.
.PP
.SH DESCRIPTION
\fIi.oif\fR calculates the Optimum Index Factor for LANDSAT TM bands 1,2,3,4,5 and 7.
.PP
The Optimum Index Factor is calculated to determine the band combination which
shows the maximum information when combined into a composite image. The bands
comprising the highest scoring combination from \fIi.oif\fR are used as the 
three color channels required for \fId.rgb\fR or \fIr.composite\fR.
.PP
The analysis is saved to a file in the current directory called "i.oif.result".
.SH NOTES
Colour Composites in BGR order: important band combinations (example: 
234 in BGR order means: B=2, G=3, R=4):
.RS
.IP
 123: near natural ("true") colour; however, because of correlation of
the 3 bands in visible spectrum, this combination contains not much more
info than is contained in single band.
.IP
 234: sensitive to green vegetation (portrayed as red), coniferous as
distinctly darker red than deciduous forests. Roads and water bodies are clear.
.IP
 243: green vegetation is green but coniferous forests aren't as clear as
the 234 combination.
.IP
 247: one of the best for info pertaining to forestry. Good for operation
scale mapping of recent harvest areas and road construction.
.IP
 345: contains one band from each of the main reflective units (vis, nir,
shortwave infra). Green vegetation is green and the shortwave band shows
vegetational stress and mortality. Roads are less evident as band 3 is blue.
.IP
 347: similar to 345 but depicts burned areas better.
.IP
 354: appears more like a colour infrared photo.
.IP
 374: similar to 354.
.IP
 457: shows soil texture classes (clay, loam, sandy).
.RE
.SH EXAMPLE
North Carolina sample dataset:
\fC
.DS
.br
g.region rast=lsat7_2002_10 -p
.br
i.oif image1=lsat7_2002_10 image2=lsat7_2002_20 image3=lsat7_2002_30 \(rs
.br
      image4=lsat7_2002_40 image5=lsat7_2002_50 image7=lsat7_2002_70
.br
.DE
\fR
.SH REFERENCE
Jensen, 1996. Introductory digital image processing. Prentice Hall, p.98. ISBN 0-13-205840-5
.SH SEE ALSO
\fI
d.rgb,
r.composite,
r.covar,
r.univar
\fR
.SH AUTHOR
Markus Neteler, ITC-Irst, Trento, Italy
.br
Updated to GRASS 5.7 by Michael Barton, Arizona State University
.PP
\fILast changed: $Date: 2011-09-04 15:23:30 +0200 (Sun, 04 Sep 2011) $\fR
.PP
Full index
.PP
© 2003-2011 GRASS Development Team