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.

Examples


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

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

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

Version History


5.2

Introduced