Scientific Data Formats: HDF-EOS

EOS_GD_GETPIXVALUES

This function reads data from a data field for the specified pixels. It is the pixel subsetting equivalent of EOS_GD_EXTRACTREGION. All entries along the non-geographic dimensions (i.e., NOT XDim and YDim) are returned.

Syntax

Result = EOS_GD_GETPIXVALUES(gridID, nPixels, pixCol, pixRow, fieldname, buffer)

Return Value

Returns size of data buffer if successful and FAIL(–1) otherwise.

Arguments

gridID

Grid id (long) returned by EOS_GD_CREATE or EOS_GD_ATTACH

nPixels

Number of pixels (long).

pixCol

Pixel Columns (long array).

pixRow

Pixel Rows (long array).

fieldname

Field (string) from which to extract data values.

buffer

A named variable that will contain data values.

Keywords

None

Examples

To read values from the Spectra field with dimensions, Bands, YDim, and XDim:

bufsiz = EOS_GD_GETPIXVALUES(gridID, 2, rowArr, colArr, $  
   "Spectra", buffer)