Routines (alphabetical) > Routines: H > HDF-EOS Routines > EOS_GD_GETPIXELS

# EOS_GD_GETPIXELS

This function returns the pixel rows and columns for specified longitude/latitude pairs. This function converts longitude/latitude pairs into (0-based) pixel rows and columns. The origin is the upper left-hand corner of the grid. This routine is the pixel subsetting equivalent of EOS_GD_DEFBOXREGION.

## Examples

This example converts two pairs of longitude/latitude values to rows and columns. The rows and columns of the two pairs will be returned in the rowArr and colArr arrays:

lonArr[0] = 134.2d

latArr[0] = -20.8d

lonArr[1] = 15.8d

latArr[1] = 84.6d

status = EOS_GD_GETPIXELS(gridID, 2, lonArr, latArr, rowArr, $

colArr)

## Syntax

Result = EOS_GD_GETPIXELS(gridID, nLonLat, lonVal, latVal, pixRow, pixCol)

## Return Value

Returns SUCCEED(0) if successful and FAIL(–1) otherwise.

## Arguments

### gridID

Grid id (long) returned by EOS_GD_CREATE or EOS_GD_ATTACH.

### nLonLat

Number of longitude/latitude pairs (long).

### lonVal

Longitude values in degrees (double, 1D array).

### latVal

Latitude values in degrees (double, 1D array).

### pixRow

A named variable that will contain the pixel Rows (long array).

### pixCol

A named variable that will contain the pixel Columns (long array).

## Keywords

None

## Version History

5.2 | Introduced