IDS_SLICE_SERIES_FILE(3)

NAME

     ids_slice_series_file    -  slice the series of SDSs in  IDS
     from files

SYNOPSIS

          IDS *ids_slice_series_file(IDS *ids,  int  *start,  int
     *end);

DESCRIPTION

     Like sds_slice_file, this function takes a slice  from  each
     SDS  in the sds list, reading the data from file.  Note that
     the slice is a n-boid specified by vectors  start  and  end.
     For  example,  for an IDS with 3-dimensional SDSs, start and
     end forms the diagonal of a cuboid.   Hence  start  and  end
     would have to be n-vectors.

     The result is a corresponding series of "sliced" SDSs.  This
     series  is  stored  to  a  new IDS.  The old IDS (as well as
     SDSs) is not changed.

     Commonly used with ids_get_series_headers.

KEYWORDS

RETURN VALUES

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

EXAMPLES

          int status;
          IDS *head_ids, *sliced_ids;
          FILE *fp[];

          head_ids = ids_init();
          status = ids_get_series_headers(head_ids, fp, count);
          sliced_ids  =  ids_slice_series_file(head_ids,   start,
     end);

SEE ALSO

WARNINGS

     None

FILES

     TBA

BUGS

     None

RESTRICTIONS

     You can't specify the range of SDSs to be sliced.

PLANNED IMPROVEMENTS

     To write ids_copy_series (copying a certain range  of  SDSs)
     to compensate for above restriction.

REFERENCES

     None

VERSION

     1994-02-24     Lup Ng    SOI Version 0.8