dform Documentation

dform - Convert ISIS cube to different format and bit-type
This procedure will convert an ISIS cube to a different
format, tif, gif, jpg, or raw.  The user can change the output
to 8 or 16 bit (Gif, Jpeg, and Tif require 8 bit output).  The
default for output bit type is 8.  The user can output an
ISIS cube, a common application would be to change the
bit type of a 32-bit input cube.  The min/max values can
by specified by the user or default to the valid min/max
values that are reported from the 'avg_sd' program. You
can also have the program generate GIS header and/or world
files. If GIS files are created and the user outputs raw
or an ISIS file then the image file will be named bil or bsq.


Output files:  from_8b.cub  or  from_16b.cub
               from.raw
               from.gif
               from.tif
               from.jpg

***PROGRAM DETAILS***

Perl Scripts included:
   dform.pl [-bit=8|16] [-c|-r|-g|-t|-j(=quality 2 - 100)] input.cub [min] [max]
   isis2world.pl [-bit=8|16] [-c|-r|-g|-t|-j] input.cub

ISIS Programs excuted:
   isis2raw - Convert ISIS cube to raw file format
   isis2tif - Convert ISIS cube to tif format
To convert to gif, jpeg:
   Uses the the UNIX utility alchemy(Sun)/convert(Linux)...generates a tif and
then convert to gif or jpeg.

   **WARNING: 1) HAVE HAD PROBLEMS ON SUN/SOLARIS AND ALPHA**

Programmer:  Tammy Becker, U.S.G.S., Flagstaff, 19 May 2000

Input filename
  (.cub extension required)

NONE

Output bit type
   1 = 8  bit
   2 = 16 bit
8-bit required for tif,
   jpg, or gif

1

Output stretch MIN
Output stretch MAX

--

   (C)UBE (ISIS)
   (R)AW	
   (G)IF
   (J)PEG
   (T)IF

C

Jpeg output quality
1 to 100, 100 = best
Setting 1 uses the external
   program's defaults

70

Create gis files
    YES, NO
 Setting YES will create Cubes &
 Raw files with the extension
    .bil (single band) or
    .bsq (multi-band images)

NO

ADDITIONAL NOTES:

Parm	Description
FROM	Input file to convert bit type and image format. Single band is required for gif output.
OTYPE	Output bit type - Keep in mind that to convert to raw or ISIS cube, the user can convert to 8 or 16 bit. 8-bit is required for gif, tif, or jpeg.
OSTR	Output Stretch....Min and Max values used to convert bit type. The default is to apply the valid min/max values that are reported in 'avg_sd'. The option is to use this parameter to enter selected min/max values.
OFORM	Output format options include a standard ISIS cube, raw format, gif, jpg, tif format.
JQUALITY	Jpeg output quality valid options 1 to 100, 100 = best If the value 1 is set, then the quality defaults for the external programs 'alchemy' and 'convert' will be used.
GISWORLD	Create gis file header and/or world files. If output is a cub or raw, then the image will be have the extension .BIL or .BSQ and a GIS header (.hdr) and world file (blw, bqw) Will be created. For all other formats just a world file is created.