org.geotoolkit.image.io

Interface AggregatedImageStore

All Known Implementing Classes:

NetcdfImageReader

public interface AggregatedImageStore

Interface for ImageReader and ImageWriter implementations that may store a large dataset as an aggregation of smaller datasets. There is many different way in which an aggregation may be used:

• A n dimensional coverage (the aggregation) may be defined as a list of n-1 dimensional slices (the aggregated files).
• A long time series (the aggregation) may be separated in a sequence of smaller time series (the aggregated files). In this use case, the aggregation and the aggregated files have the same number of dimension.
• The bands (or variables in NetCDF files) may be defined in separated files.

The main practical case for this interface is NcML files, which are XML files enumerating the NetCDF files that are the elements of the aggregation.

Since:

3.16

Version:

3.16

Author:

Martin Desruisseaux (Geomatys)

Defined in the geotk-coverage module

Method Summary

Modifier and Type	Method and Description
List<URI>	getAggregatedFiles(int imageIndex) Returns the URIs to the aggregated files, or null if the current input is not an aggregation.

Method Detail

getAggregatedFiles

List<URI> getAggregatedFiles(int imageIndex)
                      throws IOException

Returns the URIs to the aggregated files, or null if the current input is not an aggregation.

Parameters:

imageIndex - The index of the image (or variable) for which to get the aggregated files.

Returns:

The individual files which are aggregated, or null if none.

Throws:

IOException - If an error occurred while building the list of files.