EOS_GD_WRITETILE

EOS_GD_WRITETILE

This function writes a single tile of data to a field. If the data to be written to a field can be arranged tile by tile, this routine is more efficient than EOS_GD_WRITEFIELD. In all other cases, the EOS_GD_WRITEFIELD routine should be used. EOS_GD_WRITETILE does not work on non-tiled fields. Note that the are coordinates in terms of tiles, not data elements.

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. See Note on Array Ordering for details.

Syntax

Result = EOS_GD_WRITETILE(gridID, fieldname, tilecoords, data)

Return Value

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

Arguments

gridID

Grid id (long) returned by EOS_GD_CREATE or EOS_GD_ATTACH.

fieldname

Fieldname (string).

tilecoords

Array of tile coordinates (long).

data

Data to be written to tile.

Keywords

None.

Examples

In this example, we write one tile to the Temperature field (see the EOS_GD_DEFTILE example) at the second column of the first row of tiles:

tilecoords[0] = 0 
tilecoords[1] = 1 
status=EOS_GD_WRITETILE(gridID, "Temperature", tilecoords, data)

Version History

Introduced: 5.2