IDS_MERGE_SERIES(3)

NAME

     ids_merge_series    -    collapses an IDS into a SDS

SYNOPSIS

          SDS *ids_merge_series(IDS *ids, int start, int end);

DESCRIPTION

     This function converts the series of SDSs in the IDS, speci-
     fied  by  the  start  and  end (inclusive), to a single SDS.
     While the IDS remains unchanged, the new SDS will  have  one
     higher  dimension then each SDS in IDS, and contains minimal
     header information (ie. no attribute list).

     With this function,  a  series  of  2D  images  can  be  put
     together  as one single 3D image.  Of course, it should work
     with any conceivable dimension.

KEYWORDS

RETURN VALUES

     Pointer to the new SDS.  NULL if an error is encountered.

EXAMPLES

          IDS *ids;

          ids = ids_init();
          status = ids_get_series(ids, fp, numFiles);

          merged_sds = ids_merge_series(ids, 3, 10);
          /* make an SDS of images starting from 3rd till 10th */

SEE ALSO

WARNINGS

     None

FILES

BUGS

     None

RESTRICTIONS

     None

PLANNED IMPROVEMENTS

     None

REFERENCES

     None

VERSION

     1994-02-24     Lup Ng    SOI Version 0.8