[Top] [Prev] [Next] [Bottom]

SDwritedata/sfwdata/sfwcdata

intn SDwritedata(int32 sds_id, int32 start[], int32 stride[], int32 edge[], VOIDP data)
sds_id

IN:

Dataset identifier returned from SDselect

start

IN:

Array specifying the starting location

stride

IN:

Array specifying the number of values to skip along each dimension

edge

IN:

Array specifying the number of values to be written along each dimension

data

IN:

Values to be written to the dataset

Purpose

Writes a hyperslab of data for a dataset.

Return value

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

Description

The array start specifies the multi-dimensional index of the starting corner of the hyperslab to write. The values are zero-based. The array edge gives the number of values to write along each dimension of the hyperslab.

The stride array allows for sub-sampling along each dimension. If a stride value is specified for a dimension, that many values will be skipped over when reading along that dimension. Specifying stride = NULL in the C interface or stride = 1 in either interface specifies the contiguous reading of data. If the stride values are set to 0, SDreaddata returns FAIL (or -1). No matter what stride value is provided, data is always placed contiguously in buffer.

When writing data to a "chunked" SDS using SDwritedata, consideration should be given to be issues presented in the section on chunking in Chapter 3 of the HDF User's Manual, tited Scientific Data Sets (SD API) and Chapter 13 of the HDF User's Manual, titled HDF Performance Issues.

Note that there are two Fortran-77 versions of this routine: sfwdata and sfwcdata. The sfwdata routine writes numeric data and sfwcdata writes character scientific data.

FORTRAN

integer function sfwdata(sds_id, start, stride, edge, data)

integer sds_id

integer start(*), stride(*), edge(*)

<valid numeric data type> data

integer function sfwcdata(sds_id, start, stride, edge, data)

integer sds_id

integer start(*), stride(*), edge(*)

character* (*) data



[Top] [Prev] [Next] [Bottom]

hdfhelp@ncsa.uiuc.edu
HDF User's Reference Manual, Draft 06/09/97, NCSA HDF Development Group.