kaufcals - Get the calibration coefficients for the AVHRR visual channels from a degradation table

SYNTAX

FUNCTION kaufcals(hostbl, satnum, ayear, aday, Kval, ocoeffs)

    char	 *hostbl;
    long	 satnum;
    long	 ayear;
    long  	 aday;
    float	 Kval[];
    long	 ocoeffs[];

PARAMETERS

hostbl (char *, input)

The host file name of the calibration degradation table.

satnum (long, input)

The number of the satellite acquiring the pass (for example, 11 for NOAA-11).

ayear (long, input)

The acquisition year of the pass (ie. 94 for 1994).

aday (long, input)

The acquisition julian day of the pass.

Kval (float [], output)

The K value for AVHRR channels 1 and 2 of this satellite. These values are used to convert radiance to albedo.

ocoeffs (long[], output)

The calibration coefficients of the AVHRR visual channels (channels 1 and 2).

DESCRIPTION

kaufcals() returns calibration coefficients for AVHRR channels 1 and 2 based on Kaufman & Holbens values which use a linear degradation over time. If the satellite is NOAA-06, return prelaunch calibration values (since NOAA-06 maintained nearly constant calibration over its lifespan). For all other satellites, calculate visual coefficients using a degradation table.

RETURN VALUE

kaufcals() returns

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