isis2tif Documentation

isis2tif - Convert an ISIS cube file to a Tagged Image File Format
ISIS2TIF   Converts a standard ISIS qube file to a
            Tagged Image File Format (TIF) file.

Input ISIS images can be 8, 16, or 32 bit.

Output images are 8 bit TIFF format.


Programmer: Glenn Bennett, USGS, Flagstaff, AZ     15 May 2001

Input cube file name
  (default extension is .cub)

NONE

Output tif file name
  (default extension is .tif)

NONE

Tif Format: STRIP or TILE
 STRIP = read by more readers
 TILE  = possibly faster
         for some tiff readers

"STRIP"

Specify 3 bands in any order for
RGB or any 1 band for monochrome
Default:1,2,3 if 3 or more bands
in cube, otherwise band 1.

--

Subcube specifier: Main reason
included in this program is for
line & sample selection. If used
with BAND parm,see extended help

--

Output min/max data range
 if input file is 16 or 32 bit,
 probably want to set this value

--

ADDITIONAL NOTES:

Parm	Description
FROM	Input cube file name. If the file extension is omitted, then ".cub" will be assumed.
TO	Output tif file name. If the file extension is omitted, then ".tif" will be assumed.
FORMAT	Tif Format: STRIP or TILE STRIP = is older and better for some tif readers TILE = is newer and usually better for cubes with more than 127 lines and 127 samples
BAND	ISIS2TIF Default is first three bands or if less than three bands in cube, then creates monochrome from first band. ------------------------------------------------------------ Tricky if used with SFROM parameter. See SFROM for more. ------------------------------------------------------------ Select 3 bands for RGB or 1 band for monochrome image. Allows selection in any order, unlike SFROM which requires bands be in asending order. default: -band 1 for cubes with 2 or less bands -bands 1,2,3 for cubes with 3 or more bands example: monochrome band 8 8 0 0 example: color r=7, g=4, b=3 7 4 3 In command line syntax: BAND='(8,0,0)' ---> monochrome image created from band 8 BAND='(7,4,3)' ---> color image red=7, green=4, blue=3
SFROM	ISIS2TIF Default is first three bands or if less than three bands in cube, then creates monochrome from first band. ------------------------------------------------------------ Subcube specifier: Tricky if used with BAND parameter. -if bands are specified in SFROM, the BAND parameter refers to subcube. ex: SFROM="::3,4,7" BAND=(3,2,1) the resulting tif image is r=7,g=4,b=3 SFROM returns bands 3,4,7 as bands 1,2,3 to calling program. BAND (3,2,1) refers to the subcube's bands 1,2,3; and infact in this case asks for them in reverse order 3,2,1. Result=7,4,3. ------------------------------------------------------------ SFROM specifies the subcube using a single string for all three dimensions of the cube. The order of the three dimensions is always "samples:lines:bands". If a dimension is left blank, all the data for that dimension is selected. The default value of NULL for SFROM selects the entire cube. Any application below can be used for any dimension. To select specific data from any dimension: "10-100(3):11,12,15-20:1-10(2)" = This example will select every third sample starting with sample 10 thru 100. It selects lines 11 and 12, and 15-20. It selects every other band, starting with band 1 thru 10. There are special characters that can be used for selecting a subcube efficiently, such as "*","#", and "~". For examples type "help sfrom" in TAE. **NOTE** For more examples and explanation of the many features of the SFROM parameter, tutor the sfrom.pdf or refer to Introduction To ISIS, Section 6, of the ISIS User's Manual **
ORANGE	Output pixel data range. If ORANGE is NULL, then the CORE_BASE and CORE_MULTIPLIER in the output file will be set to represent the same range of data as the input file.