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

# EOS_SW_WRITEFIELD

This function writes data to a swath field. The values within start, stride, and edge arrays refer to the swath field (output) dimensions. The default values for start and stride are 0 and 1 respectively and are used if keywords are not set. The default value for edge is (dim – start) / stride where dim refers to the size of the dimension. Note that the data buffer for a compressed field must be the size of the entire field as incremental writes are not supported by the underlying HDF routines.

Note: Array ordering of variables used or returned by this routine changed in IDL 5.5. Programs written for versions of this routine prior to IDL 5.5 may need to be modified to work correctly with the current version.

## Examples

In this example, we write data to the Longitude field:

; Define elements of longitude array:

longitude = indgen(2000, 1000)

status = EOS_SW_WRITEFIELD(swathID,"Longitude", longitude)

; We now update Track 10 (0 - based) in this field:

newtrack = intarr (1,1000)

start=[10,0]

edge =[1,1000]

; Define elements of newtrack array:

status = EOS_SW_WRITEFIELD(swathID, "Longitude",newtrack, $

START = start, EDGE = edge)

## Syntax

Result = EOS_SW_WRITEFIELD( swathID, fieldname, data [, EDGE=array] [, START=array] [, STRIDE=array] )

## Return Value

Returns SUCCEED (0) if successful and FAIL (–1) otherwise.

## Arguments

### swathID

Swath id (long) returned by EOS_SW_CREATE or EOS_SW_ATTACH.

### fieldname

Name of field to write (string).

### data

Values to be written to the field.

## Keywords

### EDGE

Array (long) specifying the number of values to write along each dimension.

### START

Array (long) specifying the starting location within each dimension (0-based).

### STRIDE

Set this keyword to an array of integers specifying the number of values to step along each dimension. The default is [1, 1, ...] indicating that every value should be included. Specifying a stride of 0 is equivalent to 1.

## Version History

5.2 | Introduced