Index (zero-based) of the desired level. Fieldlist is a string

containing a comma-separated list of the fields to be read.

RECORDS is a vector containing the indices (zero-based) of the

records to be read. DATA is a P-by-1 cell array where P is the

number of requested fields. Each cell of DATA contains an

M(k)-by-N matrix of data where M(k) is the order of the k-th field

and N is the number of records, or LENGTH(RECORDS).

PTupdatelevel

STATUS = HDFPT('updatelevel',POINT_ID,LEVEL,...

FIELDLIST,RECORDS,DATA)

Updates (corrects) data in a particular level of a point data set.

LEVEL is the index (zero-based) of the desired level. FIELDLIST is

a string containing a comma-separated list of fieldnames to be

updated. RECORDS is a vector containing the indices (zero-based) of

the records to be updated. DATA is a P-by-1 cell array where P is

the number of specified fields. Each cell of DATA must contain an

M(k)-by-N matrix of data where M(k) is the order of the k-th field

(the number of scalar values in the field) and N is the number of

records, or LENGTH(RECORD). The MATLAB class of the cells must

match the HDF data type defined for the corresponding fields. A

MATLAB string will be automatically converted to match any of the

HDF char types; other data types must match exactly.

PTwriteattr

STATUS = HDFPT('writeattr',POINT_ID,ATTRNAME,DATA)

Writes or updates the point data set attribute with the specified

name. If the attribute does not already exist, it is created.

PTreadattr

[DATA,STATUS] = HDFPT('readattr',POINT_ID,ATTRNAME)

Reads the attribute data from the specified attribute.

Inquiry routines

----------------

PTnlevels

NLEVELS = HDFPT('nlevels',POINT_ID)

Returns the number of levels in a point data set. NLEVELS is -1 if

the operation fails.

PTnrecs

NRECS = HDFPT('nrecs',POINT_ID,LEVEL)

Returns the number of records in the specified level. NRECS is -1

if the operation fails.

PNnfields

[NUMFIELDS,STRBUFSIZE] = HDFPT('nfields',POINT_ID,LEVEL)

Returns the number of fields in the specified level. STRBUFSIZE is

the length of the comma-separated fieldname string. NUMFIELDS is

-1 and STRBUFSIZE is [] if the operation fails.

PTlevelinfo

[NUMFIELDS,FIELDLIST,FIELDTYPE,FIELDORDER] = ...

HDFPT('levelinfo',POINT_ID,LEVEL)

Returns information on fields for a specified level. FIELDLIST is a

string containing a comma-separated list of field names. FIELDTYPE

is a cell array of strings that defined the data type for each

field. FIELDORDER is a vector containing the order (number of

scalar values) associated with each field. If the operation fails,

NUMFIELDS is -1 and the other outputs are empty.

PTlevelindx

LEVEL = HDFPT('levelindx',POINT_ID,LEVELNAME)

Returns the level index (zero-based) of the level with the

specified name. LEVEL is -1 if the operation fails.

PTbcklinkinfo

[LINKFIELD,STATUS] = HDFPT('bcklinkinfo',POINT_ID,LEVEL)

Returns the linkfield to the previous level. STATUS is -1 and

LINKFIELD is [] if the operation fails.

PTfwdlinkinfo

[LINKFIELD,STATUS] = HDFPT('fwdlinkinfo',POINT_ID,LEVEL)

Returns the linkfield to the following level. STATUS is -1 and

LINKFIELD is [] if the operation fails.

PTgetlevelname

[LEVELNAME,STATUS] = HDFPT('getlevelname',POINT_ID,LEVEL)

Returns the name of a level given the level index. STATUS is -1 and

LEVELNAME is [] if the operation fails.

PTsizeof

[BYTESIZE,FIELDLEVELS] = HDFPT('sizeof',POINT_ID,FIELDLIST)

Returns the size in bytes and field levels of the specified fields.

FIELDLIST is a string containing a comma-separated list of field

names. BYTESIZE is the total size of bytes of the specified

fields, and FIELDLEVELS is a vector containing the level index

corresponding to each field. BYTESIZE is -1 and FIELDLEVELS is []

if the operation fails.

PTattrinfo

[NUMBERTYPE,COUNT,STATUS] = HDFPT('attrinfo',POINT_ID,ATTRNAME)

Returns the number type and size in bytes of the specified

attribute. ATTRNAME is the name of the attribute. NUMBERTYPE is a

string corresponding to the HDF data type of the attribute. COUNT

is the number of bytes used by the attribute data. STATUS is -1

and NUMBERTYPE and COUNT are [] if the operation fails.

PTinqattrs

[NATTRS,ATTRNAMES] = HDFPT('inqattrs',POINT_ID)

Retrieve information about attributes defined in a point data set.

NATTRS and ATTRNAMES are the number and names of all the defined

attributes, respectively. If the operation fails, NATTRS is -1 and

ATTRNAMES is [].

PTinqpoint

[NUMPOINTS,POINTNAMES] = HDFPT('inqpoint',FILENAME)

Retrieve number and names of point data sets defined in an HDF-EOS

file. POINTNAMES is a string containing a comma-separated list of

point names. NUMPOINTS is -1 and POINTNAMES is [] if the operation

fails.

Utility routines

----------------

PTgetrecnums

[OUTRECORDS,STATUS] = HDFPT('getrecnums',...

POINT_ID,INLEVEL,OUTLEVEL,INRECORDS)

Returns the record numbers in OUTLEVEL corresponding the group of

records specified by INRECORDS in level INLEVEL. INLEVEL and

OUTLEVEL are zero-based level indices. INRECORDS is a vector of

zero-based record indices. STATUS is -1 and OUTRECORDS is [] if the

operation fails.

Subset routines

---------------

PTdefboxregion

REGION_ID = HDFPT('defboxregion',POINT_ID,...

CORNERLON,CORNERLAT)

Defines a longitude-latitude box region for a point. CORNERLON is a

two-element vector containing the longitudes of opposite box

corners. CORNERLAT is a two-element vector containing the

latitudes of opposite box corners. REGION_ID is -1 if the

operation fails.

PTdefvrtregion

PERIOD_ID = HDFPT('defvrtregion',POINT_ID,REGION_ID,,...