Welcome to the Harris Geospatial product documentation center. Here you will find reference guides, help documents, and product libraries.


Harris Geospatial / Docs Center / IDL Reference / I/O - EOS / EOS_PT_READLEVEL

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



© 2017 Exelis Visual Information Solutions, Inc. |  Legal
My Account    |    Buy    |    Contact Us