c_getkvals - Return the desired K values for the specified NOAA AVHRR satellite. These K values are typically used to transpose between calibrated radiance and percent reflectance.

SYNTAX

FUNCTION c_getkvals ( satnum, ocalmeth, kvals )

    long satnum;
    char ocalmeth[];
    double kvals[];

PARAMETERS

satnum (long, input)

The NOAA satellite number being processed (Ex: 15 for NOAA-15).

ocalmeth (char[], input)

The calibration method to employ (kaufman, prelaunch, teillet, vermote, or rao).

kvals (double[], output)

The K value for each optical band of the specified satellite.

DESCRIPTION

The appropriate table is opened with read permission, the K values for the specified satellite are read. If no values are found, or if all K values are "0", a error status is returned. The calibration table is closed.


This K value is of the form:

	100 * PI * W
    K = ------------
              F

where

    F = Integrated solar spectral irradiance, weighted by the
        spectral response function of the channel in watts/m*m
    W = Equivalent width of the spectral response function in
        micro-meters

RETURN VALUE

c_getkvals() returns

    E_SUCC --> Successful completion
    E_FAIL --> Operation failed