Help for TIMSCAL2RE

PURPOSE:

   TIMSCAL2RE is a program which calibrates TIMS data to ground radiance.  It
is similar to TIMSCAL2, except that it uses an input spectral emissivity
image, rather than a single emissivity spectrum, and that the only output
option is ground radiance.  The input is TIMS data which have already been 
calibrated to instrument radiance (in watts/...) with the program TIMSCAL,
plus a six channel emissivity image in the format produced by the TIMS suite
of programs.  The output is a data set of all six bands in two byte integer.

EXECUTION:

   The following is the execution statement format for TIMSCAL2RE:

	TIMSCAL2RE INP=(PIX,EMIS) OUT=CALPIX PARAMS

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



OPERATION:

   TIMSCAL2RE takes as input the output dataset of TIMSCAL (IRAD mode, WATTS
units), plus an emissivity image in the format produced by TIMSEMIS or TIMSCAL2.
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 ground radiance.  The formula 
used to compute ground radiance is:

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

   The units output for radiance images are in milliwatts/m**2/um/sr.
Output is in halfword (two byte signed integer) format. 


WRITTEN BY:  Ron Alley   July, 1995
             (based upon TIMSCAL2, origially written by  J. H. REIMER 1982)

COGNIZANT PROGRAMMER:  Ron Alley

REVISION: 1  1/18/96  rea  - Update to use MODTRAN3


PARAMETERS:


INP

(1) TIMS calibrated image (IRAD) (2) TIMS emissivity image

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

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

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)

See Examples:


Cognizant Programmer: