Scientific Data Formats: HDF-EOS

EOS_PT_READLEVEL

This function reads data from the specified fields and records of a single level in a point.

Syntax

Result = EOS_PT_READLEVEL(pointID, level, fieldlist, nrec, recs, buffer)

Return Value

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

Arguments

pointID

Point id (long) returned by EOS_PT_CREATE or EOS_PT_ATTACH.

level

Level to read (0-based long).

fieldlist

List of fields (string) to read.

nrec

Number of records (long) to read.

recs

Record number of records to read (0-based long).

buffer

A named variable that will contain the buffer to store data. This buffer is in packed format. Use HDF_UNPACKDATA to convert it into IDL variables.

Keywords

None

Examples

In this example, we read records 0, 2, and 3 from the Temperature and Mode fields in the first level of the point referred to by point ID, pointID. Temperature is a 32-bit float field and Mode is a 4 character field (HDF types 5 and 4 respectively):

recs = [ 0, 2, 3 ]  
status = EOS_PT_READLEVEL( pointID, 0, "Temperature,Mode", $  
   3, recs, buffer)  
IF (status EQ 0) THEN BEGIN  
   HDF_UNPACKDATA, buffer, dataTemperature, dataMode, $  
      HDF_TYPE=[5,4], HDF_ORDER = [4,4]  
ENDIF