This function reads data from the specified fields and records of a single level in a point.
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
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
Version History