writeisis Documentation

writeisis - Write IDL array out to the core of a new cube file

This is a routine that can be called from an IDL program and thus can
be used for writing IDL programs that perform specialized processing
of ISIS cube files.  (See also the READISIS routine.)


PRO WRITEISIS, FILE, DATA, SPECIAL=special

;	---------------------------
;	|    W R I T E I S I S    |
;	---------------------------
;
;  This procedure creates a new ISIS cube file with the name specified
;  by the string parameter FILE.  The 2D or 3D data array supplied in
;  the DATA parameter is written into the core of the new cube file.
;  DATA must be a floating point array.  The output file will contain
;  32-bit floating point pixels and will be in BSQ physical storage
;  order.
;
;  The optional keyword parameter SPECIAL allows translating one or five
;  pixel values into ISIS special pixel values in the output file.  If
;  SPECIAL is not specified, then no translation is performed.  If a
;  single value is specified, then any pixel values in the DATA array
;  that match the value are translated into ISIS NULL pixel values before
;  being written to the file.  If needed, the supplied value is converted
;  to floating point format.  (Note that the values in the input DATA 
;  array are changed by this operation.)  If five SPECIAL values are
;  specified, then the five values are translated into the five ISIS
;  special pixel values.  The order of the values is: NULL,
;  LOW_REPR_SATURATION, LOW_INSTR_SATURATION, HIGH_INSTR_SATURATION, and
;  HIGH_REPR_SATURATION.

;
;  Written by Jim Torson, U.S. Geological Survey, Flagstaff, AZ
;