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

# EOS_PT_READLEVEL

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

5.2 | Introduced