Scientific Data Formats: HDF-EOS

EOS_PT_EXTRACTREGION

This function reads data from the designated level fields into the data buffer from the subsetted area of interest.

Syntax

Result = EOS_PT_EXTRACTREGION( pointID, regionID, level, fieldlist, buffer)

Return Value

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

Arguments

pointID

Point id (long).

regionID

Period id (long) returned by EOS_PT_DEFBOXREGION.

level

Point level (0-based long).

fieldlist

List of fields (string) to extract.

buffer

A named variable that will contain the data buffer.

Keywords

None

Examples

In this example, we read data within the subsetted area of interest defined by EOS_PT_DEFBOXREGION from the Longitude and Latitude fields:

regionID = EOS_PT_DEFBOXREGION(pointID, [-145.,-135.], [-15.,-8.])  
IF (regionID NE -1) THEN BEGIN  
   status = EOS_PT_EXTRACTREGION(pointID, regionID, 0, $   
      "Longitude,Latitude", buffer)  
   HDF_UNPACKDATA, buffer, dataLong,dataLat,HDF_TYPE=[6,6]  
ENDIF