c_acqhead - Read and extract the information contained in the header of an AVHRR acquisition image.

SYNTAX

#include "acqio.h"

FUNCTION c_acqhead (fdesc, year, station, dtype, pass)

     long *fdesc;
     long *year;
     long *dtype;	
     char *station;
     struct SATPASS *pass;

PARAMETERS

fdesc (long *, input)

File descriptor for an AVHRR acquisition image returned from c_acqopen().

year (long *, input)

Two-digit year in which the image was acquired.

dtype (long *, input)

Data type of the image (GAC, HRPT, LAC).

station (char *, input)

Three character CEOS ID of the receiving station that acquired the image. See ceos;ids in ADAPSTABLES for a list of valid IDs.

pass (struct SATPASS *, output)

A structure describing the image at the start of the pass. This includes the satellite number, data type, CEOS ID, date, time, clock error, and number of lines and samples.

DESCRIPTION

c_acqhead() reads and extracts the information contained in the header of an AVHRR acquisition image. For those receiving stations that do not create a header record, default information will be stored in the SATPASS structure. c_acqhead() also sets the file pointer to the first line of data in the acquisition file.

RETURN VALUE

c_acqhead() returns

    E_SUCC (0)  --> Successful completion.
    E_FAIL (-1) --> Operation failed.