This function creates a new point structure. The point is created as a Vgroup within the HDF file with the name pointname and class POINT.

Examples


In this example, we create a new point structure, ExamplePoint, in the previously created file, PointFile.hdf:

pointID = EOS_PT_CREATE(fid, "ExamplePoint")

The point structure is then referenced by subsequent routines using the handle, pointID.

Syntax


Result = EOS_PT_CREATE(fid, pointname)

Return Value


Returns the point handle (pointID) if successful and FAIL (–1) otherwise.

Arguments


fid

Point file id (long) returned by EOS_PT_OPEN.

pointname

Name of point (string) to be created.

Keywords


None

Version History


5.2

Introduced