This function creates a swath within the file. The swath is created as a Vgroup within the HDF file with the name swathname and class EOS_SWATH.

Syntax


Result = EOS_SW_CREATE(fid, swathname)

Return Value


Returns the swath handle (swathID) if successful and FAIL (–1) otherwise.

Arguments


fid

Swath file id (long) returned by EOS_SW_OPEN.

swathname

Name of swath (string) to be created.

Keywords


None

Examples


In this example, we create a new swath structure, “ExampleSwath”, in the previously created file, SwathFile.hdf.

swathID = EOS_SW_CREATE(fid, "ExampleSwath")

The swath structure is referenced by subsequent routines using the handle, swathID.

Version History


5.2

Introduced