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

# EOS_SW_CREATE

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