ISIS 3 Application Documentation
Exports a cube to fits format
Description
This program will export an Isis cube to fits format. It is recommended
that the image be output in 32-bit per pixel format. The user may also
choose to output into an 8-bit, 16-bit unsigned, or 16-bit signed image but
in order to ensure that the range of pixels is not truncated when going to
a less precise format, it is recommended that the output file be stretched
using a linear stretch. Special pixels are mapped in the following manner;
Low Saturation values and Null are made black and High Saturation values
are made white.
Categories
Applications
History
Drew Davidson | 2005-06-01 |
Original version
|
Drew Davidson | 2005-06-15 |
Added code to export multiple bands
|
Jeff Anderson | 2006-05-15 |
Added minpercent and maxpercent options
|
Steven Lambright | 2007-06-15 |
Updated documentation to follow current standards
|
Steven Lambright | 2008-05-12 |
Removed references to CubeInfo
|
Mackenzie Boyd | 2009-10-29 |
Made SkyMap and All options work, added more keywords to ALL option,
removed unsigned 16 bit option, made file total come out to a sum evenly
divisible by 2880 as specified in the standard.
|
|
Parameter Groups
Files
Name
|
Description
|
FROM |
Input cube to export
|
TO |
Output fits file
|
Output Data Type
Name
|
Description
|
BITTYPE | Bit type of output file |
Stretch Options
Header Information
Name
|
Description
|
INFO | Level of information in the header (nominal, projection) |
|
Files:
FROM
Description
Use this parameter to select the filename and band to export. For
example, file.cub+5 will select band 5
Type
| cube |
File Mode
| input |
Filter
|
*.cub
|
Files:
TO
Description
Use this parameter to specify the name of the output fits file. If you
do not include an extension of ".fits" it will be added automatically.
Type
| filename |
File Mode
| output |
Output Data Type:
BITTYPE
Description
Bit type of output:
8 bit (0=black, 255=white)
16 bit unsigned (0=black, 65535=white)
16 bit signed (-32767=black, 32768=white)
32 bit (1.17549435e-38=black, 3.40282347e+38=white)
Type
| string |
Default
|
32BIT
|
Option List:
|
Option |
Brief |
Description |
8BIT | 8 bit data |
Pixels are in 8-bit data range (0 to 255).
|
16BIT | 16 bit data |
Pixels are in 16 bit signed data range (-32768 to 32767)
|
32BIT | 32 bit data |
Pixels are in the 32 bit floating point data range
(-3.40282347e+38 to 3.40282347e+38)
Exclusions
- STRETCH
- MINPERCENT
- MAXPERCENT
|
|
Stretch Options:
STRETCH
Description
This parameter is used to select one of four ways to stretch
(or map) output pixels. They are NONE, LINEAR, or MANUAL. It is
recommended that output data that is less precise than the input data
from whence it came (i.e. 32-bit data being output as 8-bit data) be
stretched.
Type
| string |
Default
|
LINEAR
|
Option List:
|
Option |
Brief |
Description |
NONE | No stretch |
No stretch is performed.
Exclusions
- MINIMUM
- MAXIMUM
- MINPERCENT
- MAXPERCENT
|
LINEAR | Linear stretch |
A minimum and maximum are automatically computed based on
the statistics of the selected band. A histogram of the band
is used to pick the minimum at 0.5% of the data and the maximum
at 99.5% of the data. Input pixels less than or equal to the
minimum are stretched to black while pixels greater than the or
equal to the maximum are stretched to white. A linear mapping
occurs between the minimum and maximum.
Exclusions
Inclusions
|
MANUAL | Manual stretch |
This option allows you to pick your own stretch. You must
enter a value for MINIMUM and MAXIMUM;
Exclusions
Inclusions
|
|
Stretch Options:
MINIMUM
Description
The minimum input pixel value which will be mapped to black.
Type
| double |
Less Than
| MAXIMUM
|
Stretch Options:
MAXIMUM
Description
The maximum input pixel value which will be mapped to white.
Type
| double |
Greater Than
| MINIMUM
|
Stretch Options:
MINPERCENT
Description
The percentage of data in the histogram used to compute the minimum pixel value in the stretch.
Type
| double |
Default
| 0.5 |
Less Than
| MAXPERCENT
|
Stretch Options:
MAXPERCENT
Description
The percentage of data in the histogram used to compute the maximum pixel value in the stretch.
Type
| double |
Default
| 99.5 |
Greater Than
| MINPERCENT
|