bandtab Documentation

bandtab - Create a TABLE file of BAND_BIN information from a cube file
"bandtab" reads some of the information from the BAND_BIN keyword group
of a cube file and produces a TABLE file that contains the information.
One of the main uses of the output TABLE file is to supply lists of
wavelengths, orignal band numbers and full width at half maximum (FWHM)
values to programs that translate "foreign" spectral library data into
ISIS Instrument Spectral Library (ISL) files, e.g., "specpr2isl" and
"spam2isl".

The input cube file must contain the original band numbers and the
wavelengths for each band.  The full width at half maximum information
is optional but the instrument must be NIMS or AVIRIS in order for the
values to be automatically generated by "bandtab".  Cubes for other
instruments must supply the full width at half maximum values in the
BAND_BIN_WIDTH keyword in the label.  If FWHM values of 0 are found at
the end of the list, the 0-values are replaced with the last positive
value found in the file.

The following are the column names, data types, default text formats
and descriptions for the columns in the output table data object:
    BAND (INTEGER*4, I5) - Original band number (obtained from
	BAND_BIN_ORIGINAL_BAND keyword)
    WAVELN (REAL*4, F7.4) - Wavelength (obtained from BAND_BIN_CENTER
	keyword)
    FWHM (REAL*4, F6.4) - Full width at half maximum (obtained from
	BAND_BIN_WIDTH keyword if present; if missing, automatically
	generated for NIMS or AVIRIS instruments)

By default, the INSTRUMENT_ID and INSTRUMENT_MODE_ID keyword values
are copied from the input cube file to the TABLE file.  (Programs
such as "specpr2isl" and "spam2isl" will then copy these values to
the ISL files they produce.)  The INSTID and INSTMODE parameters
allow the user to override the cube file keyword values or to supply
values if these keywords are not present in the cube file.

Programmer: Kris Becker - U.S.G.S., Flagstaff, Arizona

Input cube file name
 (Default extension is .cub)

NONE

Input subcube specifier

--

Output Table file name
 (Default extension is .tbl)

NONE

Name of output TABLE file object

"TABLE"

Instrument ID

--

Instrument mode

--

User comment

" "

ADDITIONAL NOTES:

Parm	Description
FROM	Input cube file name. If the file extension is omitted, then ".cub" will be assumed.
TBLTO	Output TABLE file name. If the file extension is omitted, then ".tbl" will be assumed.
OBJNAM	Name of TABLE object that will contain the BAND information. If a blank string or the TAE Null parameter value is specified, then the default name "TABLE" will be used.
INSTID	Specifies the value of the INSTRUMENT_ID keyword in the output TABLE file. If this is not specified, then the value of the INSTRUMENT_ID keyword in the input cube file is used. If no value is available, then INTRUMENT_ID is set to UNKNOWN.
INSTMODE	Specifies the value of the INSTRUMENT_MODE_ID keyword in the output TABLE file. If this is not specified, then the value of the INSTRUMENT_MODE_ID keyword in the input cube file is used. If no value is available, then INSTRUMENT_MODE_ID is set to UNKNOWN.
USERNOTE	Comment from the user. This will be recorded in the ISIS session log file and also in the History entry that is put into the History object of the output file.