Help for TIMSCAL2OLD

PURPOSE:

   TIMSCAL2OLD is the version of TIMSCAL2 if use prior to January 19, 1996.
It differs from the subsequent version of TIMSCAL2 in that it uses MODTRAN1,
rather than MODTRAN3.
   TIMSCAL2OLD is a program which calibrates TIMS data to ground radiance, 
ground temperature, or emittance. The input is TIMS data which have already 
been calibrated to instrument radiance (in watts/...) with the program TIMSCAL.
The output is a band interleaved by line (BIL) data set of all six bands in two 
byte integer.

EXECUTION:

   The following is the execution statement format for TIMSCAL2OLD:

	TIMSCAL2OLD INP=PIX OUT=CALPIX PARAMS

   where INP, OUT, and PARAMS are parameters discussed in their res-
pective parameter sections. 



OPERATION:

   TIMSCAL2OLD takes as input the output dataset of TIMSCAL (IRAD mode, WATTS
units). It uses LOWTRAN7 or MODTRAN (user selectable) to compute the 
atmospheric path radiance, transmittance, and ground reflected atmospheric 
radiance. These values are convolved with the TIMS instrument functions and 
the instrument perceived radiances to obtain either ground radiance, ground 
temperature, or emittance.  The formula used to compute ground radiance is:

        IRAD = [GRAD + (1.0-e)*L   ]*Trans + L
                                sky           path

To compute emittance, one channel is assumed to have a constant (user specified)
emittance. The temperature of each pixel is computed, based upon this 
assupmtion. For this temperature, the blackbody radiance in each TIMS bandpass 
is computed. The emittance is the ratio of the computed ground radiance to the
blackbody radiance of that band.
   The units output for radiance images are in milliwatts/m**2/um/sr. The units 
output for temperature images are in hundredths of degrees Centigrade. Units 
output for emissivity are dimensionless, but scaled by 10,000. Output is in 
halfword (two byte signed integer) format. 


WRITTEN BY:  J. H. REIMER    1982

COGNIZANT PROGRAMMER:  Ron Alley

REVISION: 4,  January 22, 1996

PARAMETERS:

INP

TIMS calibrated image (IRAD)

OUT

Output data set of all six bands of calibrated TIMS data.

SIZE

The standard VICAR2 output size field.

SL

Starting line

SS

Starting sample

NL

Number of lines

NS

Number of samples

ORG

Organization of output dataset

CALMODE

This keyword selects the type of decalibatrion to be performed Valid: GRAD, GTEM, BTEM, EMIS

AMODEL

Selects the model for which the atmospheric corrections will be performed via LOWTRAN/MODTRAN

ATEMP

Selects atmospheric temperature and pressure profiles, if different form that defaulted with AMODEL.

AHUMID

Selects the atmospheric water vapor model, if different from that defaulted with AMODEL.

AOZONE

Selects the ozone model, if different from that defaulted with AMODEL.

HEIGHT

Aircraft altitude (km above MSL)

DATUM

Surface elevation (km above MSL)

NLAYERS

The number of atmospheric lay- ers in the radiosonde data (if used).

ALTITUDE

The altitudes of each of the atmospheric layers given in the radiosonde data. (km.)

PRESSURE

The atmospheric pressures of each of the atmospheric lay- ers given in the radiosonde data. (mb.)

TEMP

The temperatures of the at- mospheric layers given in the radiosonde data. (deg C)

WATER

The water profile in terms of the parameter WTYPE, for each layer in the radiosonde data.

WTYPE

The units in which H2OS are given. The three types are relative humidity (RH), dew- point (DP), and density (DE)

WATERFAC

Varies the moisture profile by the factor specified

O3FAC

Varies the ozone profile by the factor specified

CO2FAC

Varies the carbon dioxide profile by the factor specified

SO2FAC

Varies the sulfur dioxide profile by the factor specified

CH4FAC

Varies the methane profile by the factor specified

O2FAC

Varies the oxygen profile by the factor specified

E

The emissivity assumed for each band. (Only the REFCHAN band is used in the EMIS mode)

REFCHAN

(For EMIS only) The channel to be used as the reference channel. Valid: (1:6)

DATE

Date of data acquisition. Used to override the date in the VICAR label (yymmdd)

LOWFILE

Dataset name for LOWTRAN/MODTRAN output report file.

LOWTAB

Dataset name for LOWTRAN/MODTRAN output tabular file.

ATMODEL

Atmospheric model to be used (LOWTRAN or MODTRAN)

SHIFT

Spectral shift of filter functions (Nanometers)