Package org.geotools.gce.imagemosaic

Class ImageMosaicReader

Object

AbstractGridCoverage2DReader

ImageMosaicReader

All Implemented Interfaces:

GridCoverageReader, GridCoverage2DReader, StructuredGridCoverage2DReader

public class ImageMosaicReader
extends AbstractGridCoverage2DReader
implements StructuredGridCoverage2DReader

Reader responsible for providing access to mosaic of georeferenced images. Citing JAI documentation:

The "Mosaic" operation creates a mosaic of two or more source images. This operation could be used for example to assemble a set of overlapping geospatially rectified images into a contiguous image. It could also be used to create a montage of photographs such as a panorama.

All source images are assumed to have been geometrically mapped into a common coordinate space. The origin (minX, minY) of each image is therefore taken to represent the location of the respective image in the common coordinate system of the source images. This coordinate space will also be that of the destination image.

All source images must have the same data type and sample size for all bands and have the same number of bands as color components. The destination will have the same data type, sample size, and number of bands and color components as the sources.

Since:

2.3

Author:

Simone Giannecchini, GeoSolutions S.A.S, Stefan Alfons Krueger (alfonx), Wikisquare.de : Support for jar:file:foo.jar/bar.properties URLs

Field Summary

Fields

Modifier and Type	Field	Description
static String	UNSPECIFIED

Fields inherited from class AbstractGridCoverage2DReader

closeMe, coverageFactory, coverageName, crs, dtLayout, EPS, gzipped, highestRes, hints, inStream, inStreamSPI, numOverviews, offsets, originalEnvelope, originalGridRange, overViewResolutions, raster2Model, scales, source

Fields inherited from interface GridCoverage2DReader

ELEVATION_DOMAIN, ELEVATION_DOMAIN_MAXIMUM, ELEVATION_DOMAIN_MINIMUM, ELEVATION_DOMAIN_RESOLUTION, FILE_SOURCE_PROPERTY, HAS_ELEVATION_DOMAIN, HAS_TIME_DOMAIN, MULTICRS_EPSGCODES, MULTICRS_READER, PAM_DATASET, REPROJECTING_READER, SOURCE_URL_PROPERTY, TIME_DOMAIN, TIME_DOMAIN_MAXIMUM, TIME_DOMAIN_MINIMUM, TIME_DOMAIN_RESOLUTION

Constructor Summary

Constructors

Constructor	Description
ImageMosaicReader(Object source)	Constructor.
ImageMosaicReader(Object source, Hints uHints)	Constructor.

Method Summary

Modifier and Type	Method	Description
protected RasterManager	addRasterManager(MosaicConfigurationBean configuration, boolean init)	Create a RasterManager on top of this MosaicConfigurationBean
protected boolean	checkName(String coverageName)	This method is responsible for checking the provided coverage name against the coverage name for this GridCoverage2DReader.
void	createCoverage(String coverageName, SimpleFeatureType indexSchema)	Creates a granule store for a new coverage with the given feature type
void	delete(boolean deleteData)	delete all stuff (database content, indexer files, property files, associated auxiliary files and so on).
void	dispose()	Releases resources held by this reader.
CoordinateReferenceSystem	getCoordinateReferenceSystem()	Retrieves the GeneralBounds for this AbstractGridCoverage2DReader.
CoordinateReferenceSystem	getCoordinateReferenceSystem(String coverageName)	Retrieves the GeneralBounds for this AbstractGridCoverage2DReader.
DatasetLayout	getDatasetLayout()	Returns the DatasetLayout for the coverage.
List<DimensionDescriptor>	getDimensionDescriptors(String coverageName)	Describes the dimensions supported by the specified coverage, if any.
Set<ParameterDescriptor<List>>	getDynamicParameters()	Return the set of dynamic parameterDescriptors (the ones related to domains) for this reader.
Set<ParameterDescriptor<List>>	getDynamicParameters(String coverageName)	Return the set of dynamic parameterDescriptors (the ones related to domains) for this reader.
Format	getFormat()	Returns the format handled by this GridCoverageReader.
GranuleSource	getGranules(String coverageName, boolean readOnly)	Returns the granule source for the specified coverage (might be null, if there is only one supported coverage)
int	getGridCoverageCount()	Number of coverages for this reader is 1
String[]	getGridCoverageNames()	Retrieve the list of coverages contained within the input source.
protected double[]	getHighestRes()	Package private accessor for the highest resolution values.
ImageLayout	getImageLayout()	Retrieve the ImageLayout for the default coverage.
ImageLayout	getImageLayout(String coverageName)	Retrieve the ImageLayout for the specified coverage.
ServiceInfo	getInfo()	Information about this source.
ResourceInfo	getInfo(String coverageName)	Default implementation returns a FileResourceInfo containing same fileGroup list contained in the ServiceInfo object.
String[]	getMetadataNames()	Returns the list of metadata keywords associated with the input source as a whole (not associated with any particular grid coverage).
String[]	getMetadataNames(String coverageName)	Populate the metadata names array for the specified coverageName
String	getMetadataValue(String name)	Retrieve the metadata value for a given metadata name.
String	getMetadataValue(String coverageName, String name)	Retrieve the metadata value for a given metadata name for a specified coverage.
ExecutorService	getMultiThreadedLoader()
GeneralBounds	getOriginalEnvelope()	Retrieves the GeneralBounds for this AbstractGridCoverage2DReader.
GeneralBounds	getOriginalEnvelope(String coverageName)	Retrieves the GeneralBounds for this AbstractGridCoverage2DReader.
GridEnvelope	getOriginalGridRange()	Retrieves the GeneralGridEnvelope that represents the raster grid dimensions of the highest resolution level in this dataset.
GridEnvelope	getOriginalGridRange(String coverageName)	Retrieves the GeneralGridEnvelope that represents the raster grid dimensions of the highest resolution level in this dataset.
MathTransform	getOriginalGridToWorld(String coverageName, PixelInCell pixInCell)	Retrieves the original grid to world transformation for this AbstractGridCoverage2DReader.
MathTransform	getOriginalGridToWorld(PixelInCell pixInCell)	Retrieves the original grid to world transformation for this AbstractGridCoverage2DReader.
RasterManager	getRasterManager(String name)
double[]	getReadingResolutions(String coverageName, OverviewPolicy policy, double[] requestedResolution)	Returns the actual resolution used to read the data given the specified target resolution and the specified overview policy
double[]	getReadingResolutions(OverviewPolicy policy, double[] requestedResolution)	Returns the actual resolution used to read the data given the specified target resolution and the specified overview policy
double[][]	getResolutionLevels()	Retrieve the resolution levels for the default coverage.
double[][]	getResolutionLevels(String coverageName)	Retrieve the resolution levels for the specified coverage.
List<HarvestedSource>	harvest(String defaultCoverage, Object source, Hints hints)	Harvests the specified source into the reader.
boolean	isParameterSupported(String coverageName, Identifier parameterName)	Check whether the specified parameter is supported for the specified coverage.
boolean	isParameterSupported(Identifier name)
boolean	isReadOnly()	Return whether this reader can modify the granule source
GridCoverage2D	read(String coverageName, GeneralParameterValue[] params)	Retrieves the GridEnvelope associated to the specified coverageName for this GridCoverage2DReader.
GridCoverage2D	read(GeneralParameterValue[] params)	Read the current grid coverage from the stream.
boolean	removeCoverage(String coverageName, boolean delete)	removes a granule store for the specified coverageName

Methods inherited from class AbstractGridCoverage2DReader

addAllSiblings, addSiblings, collectScaleOffset, createImageCoverage, createImageCoverage, createImageCoverage, createImageCoverage, decimationOnReadingControl, finalize, getDatasetLayout, getFiles, getGroundControlPoints, getGroundControlPoints, getHighestRes, getMultiLevelROIProvider, getOverviewGridEnvelope, getOverviewGridEnvelope, getPamDataset, getPamDataset, getRescaledRasterToModel, getResolution, getSibling, getSource, getSourceAsFile, setlayout, setLayout, setReadParams, setReadParams

Methods inherited from class Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface GridCoverage2DReader

getDatasetLayout

Methods inherited from interface GridCoverageReader

getSource

Field Detail

UNSPECIFIED

public static final String UNSPECIFIED

See Also:

Constant Field Values

Constructor Detail

ImageMosaicReader

public ImageMosaicReader(Object source,
                         Hints uHints)
                  throws IOException

Constructor.

Parameters:

source - The source object.

Throws:

IOException

ImageMosaicReader

public ImageMosaicReader(Object source)
                  throws IOException

Constructor.

Parameters:

source - The source object.

Throws:

IOException

Method Detail

getRasterManager

public RasterManager getRasterManager(String name)

getGridCoverageNames

public String[] getGridCoverageNames()

Description copied from interface: GridCoverageReader

Retrieve the list of coverages contained within the input source. Each grid can have a different coordinate system, number of dimensions and grid geometry. For example, a HDF-EOS file (GRID.HDF) contains 6 grid coverages each having a different projection. An empty array will be returned if no sub names exist.

Specified by:

getGridCoverageNames in interface GridCoverageReader

Overrides:

getGridCoverageNames in class AbstractGridCoverage2DReader

Returns:

The list of grid coverages contained within the input source.

getFormat

public Format getFormat()

Description copied from interface: GridCoverageReader

Returns the format handled by this GridCoverageReader.

Specified by:

getFormat in interface GridCoverageReader

See Also:

GridCoverageReader.getFormat()

read

public GridCoverage2D read(GeneralParameterValue[] params)
                    throws IOException

Description copied from class: AbstractGridCoverage2DReader

Read the current grid coverage from the stream.

Example:

Specified by:

read in interface GridCoverage2DReader

Specified by:

read in interface GridCoverageReader

Specified by:

read in class AbstractGridCoverage2DReader

Parameters:

params - Optional parameters matching Format.getReadParameters().

Returns:

a grid coverage from the input source.

Throws:

IOException - if a read operation failed for some other input/output reason, including FileNotFoundException if no file with the given name can be found, or IIOException if an error was thrown by the underlying image library.

read

public GridCoverage2D read(String coverageName,
                           GeneralParameterValue[] params)
                    throws IOException

Description copied from interface: GridCoverage2DReader

Retrieves the GridEnvelope associated to the specified coverageName for this GridCoverage2DReader.

Specified by:

read in interface GridCoverage2DReader

Specified by:

read in interface GridCoverageReader

Overrides:

read in class AbstractGridCoverage2DReader

Parameters:

coverageName - the name of the coverage to work with

params - an array of GeneralParameterValue that uses a subset of the available read params for this GridCoverage2DReader as specified by the Format

Returns:

a GridCoverage2D for the underlying default coverage for this GridCoverage2DReader or null in case no GridCoverage2D can be read for the provided parameters.

Throws:

IOException - if a read operation failed for some other input/output reason, including FileNotFoundException if no file with the given name can be found, or IIOException if an error was thrown by the underlying image library.

See Also:

@Override

getHighestRes

protected double[] getHighestRes()

Package private accessor for the highest resolution values.

Overrides:

getHighestRes in class AbstractGridCoverage2DReader

Returns:

the highest resolution values.

getGridCoverageCount

public int getGridCoverageCount()

Number of coverages for this reader is 1

Specified by:

getGridCoverageCount in interface GridCoverageReader

Overrides:

getGridCoverageCount in class AbstractGridCoverage2DReader

Returns:

the number of coverages for this reader.

See Also:

GridCoverageReader.getGridCoverageCount()

dispose

public void dispose()

Releases resources held by this reader.

Specified by:

dispose in interface GridCoverageReader

Overrides:

dispose in class AbstractGridCoverage2DReader

getMetadataNames

public String[] getMetadataNames()

Description copied from interface: GridCoverageReader

Returns the list of metadata keywords associated with the input source as a whole (not associated with any particular grid coverage). If no metadata is available, the array will be empty.

Specified by:

getMetadataNames in interface GridCoverageReader

Overrides:

getMetadataNames in class AbstractGridCoverage2DReader

Returns:

The list of metadata keywords for the input source.

See Also:

GridCoverageReader.getMetadataNames()

getMetadataNames

public String[] getMetadataNames(String coverageName)

Populate the metadata names array for the specified coverageName

Specified by:

getMetadataNames in interface GridCoverageReader

Overrides:

getMetadataNames in class AbstractGridCoverage2DReader

Returns:

The list of metadata keywords for the input source.

getMetadataValue

public String getMetadataValue(String name)

Description copied from interface: GridCoverageReader

Retrieve the metadata value for a given metadata name.

Specified by:

getMetadataValue in interface GridCoverageReader

Overrides:

getMetadataValue in class AbstractGridCoverage2DReader

Parameters:

name - Metadata keyword for which to retrieve metadata.

Returns:

The metadata value for the given metadata name. Should be one of the name returned by GridCoverageReader.getMetadataNames().

See Also:

GridCoverageReader.getMetadataValue(java.lang.String)

getMetadataValue

public String getMetadataValue(String coverageName,
                               String name)

Description copied from interface: GridCoverageReader

Retrieve the metadata value for a given metadata name for a specified coverage.

Specified by:

getMetadataValue in interface GridCoverageReader

Overrides:

getMetadataValue in class AbstractGridCoverage2DReader

name - Metadata keyword for which to retrieve metadata.

Returns:

The metadata value for the given metadata name. Should be one of the name returned by GridCoverageReader.getMetadataNames().

getDynamicParameters

public Set<ParameterDescriptor<List>> getDynamicParameters()

Description copied from class: AbstractGridCoverage2DReader

Return the set of dynamic parameterDescriptors (the ones related to domains) for this reader. Default implementation returns an empty set of parameters

Specified by:

getDynamicParameters in interface GridCoverage2DReader

Overrides:

getDynamicParameters in class AbstractGridCoverage2DReader

Returns:

the Set of dynamic read parameters supported by this GridCoverage2DReader.

getDynamicParameters

public Set<ParameterDescriptor<List>> getDynamicParameters(String coverageName)

Description copied from class: AbstractGridCoverage2DReader

Return the set of dynamic parameterDescriptors (the ones related to domains) for this reader. Default implementation returns an empty set of parameters

Specified by:

getDynamicParameters in interface GridCoverage2DReader

Overrides:

getDynamicParameters in class AbstractGridCoverage2DReader

Parameters:

coverageName - the name of the coverage to work with

Returns:

the Set of dynamic read parameters supported by this GridCoverage2DReader.

isParameterSupported

public boolean isParameterSupported(Identifier name)

getReadingResolutions

public double[] getReadingResolutions(OverviewPolicy policy,
                                      double[] requestedResolution)
                               throws IOException

Description copied from class: AbstractGridCoverage2DReader

Returns the actual resolution used to read the data given the specified target resolution and the specified overview policy

Specified by:

getReadingResolutions in interface GridCoverage2DReader

Overrides:

getReadingResolutions in class AbstractGridCoverage2DReader

Parameters:

policy - the OverviewPolicy to use during evaluation.

requestedResolution - the requested resolution

Returns:

an array of 2 double with the resolution of the selected overview.

Throws:

IOException - in case an error occurs.

getReadingResolutions

public double[] getReadingResolutions(String coverageName,
                                      OverviewPolicy policy,
                                      double[] requestedResolution)
                               throws IOException

Description copied from class: AbstractGridCoverage2DReader

Returns the actual resolution used to read the data given the specified target resolution and the specified overview policy

Specified by:

getReadingResolutions in interface GridCoverage2DReader

Overrides:

getReadingResolutions in class AbstractGridCoverage2DReader

Parameters:

coverageName - the name of the coverage to work on.

policy - the OverviewPolicy to use during evaluation.

requestedResolution - the requested resolution

Returns:

an array of 2 double with the resolution of the selected overview.

Throws:

IOException - in case an error occurs.

isParameterSupported

public boolean isParameterSupported(String coverageName,
                                    Identifier parameterName)

Check whether the specified parameter is supported for the specified coverage.

checkName

protected boolean checkName(String coverageName)

Description copied from class: AbstractGridCoverage2DReader

This method is responsible for checking the provided coverage name against the coverage name for this GridCoverage2DReader.

Overrides:

checkName in class AbstractGridCoverage2DReader

Parameters:

coverageName - the coverage name to check.

Returns:

true if this GridCoverage2DReader contains the provided coverage name, false otherwise.

addRasterManager

protected RasterManager addRasterManager(MosaicConfigurationBean configuration,
                                         boolean init)
                                  throws IOException

Create a RasterManager on top of this MosaicConfigurationBean

Parameters:

configuration - the MosaicConfigurationBean to be used to create the RasterManager

init - true if the Manager should be initialized.

Throws:

IOException

getGranules

public GranuleSource getGranules(String coverageName,
                                 boolean readOnly)
                          throws IOException,
                                 UnsupportedOperationException

Description copied from interface: StructuredGridCoverage2DReader

Returns the granule source for the specified coverage (might be null, if there is only one supported coverage)

Specified by:

getGranules in interface StructuredGridCoverage2DReader

Parameters:

coverageName - the name of the specified coverage

readOnly - a boolean indicating whether we may want modify the GranuleSource

Returns:

the requested GranuleSource

Throws:

IOException

UnsupportedOperationException

isReadOnly

public boolean isReadOnly()

Description copied from interface: StructuredGridCoverage2DReader

Return whether this reader can modify the granule source

Specified by:

isReadOnly in interface StructuredGridCoverage2DReader

createCoverage

public void createCoverage(String coverageName,
                           SimpleFeatureType indexSchema)
                    throws IOException,
                           UnsupportedOperationException

Description copied from interface: StructuredGridCoverage2DReader

Creates a granule store for a new coverage with the given feature type

Specified by:

createCoverage in interface StructuredGridCoverage2DReader

Throws:

IOException

UnsupportedOperationException

removeCoverage

public boolean removeCoverage(String coverageName,
                              boolean delete)
                       throws IOException

Description copied from interface: StructuredGridCoverage2DReader

removes a granule store for the specified coverageName

Specified by:

removeCoverage in interface StructuredGridCoverage2DReader

Throws:

IOException

getOriginalEnvelope

public GeneralBounds getOriginalEnvelope()

Description copied from class: AbstractGridCoverage2DReader

Retrieves the GeneralBounds for this AbstractGridCoverage2DReader.

Specified by:

getOriginalEnvelope in interface GridCoverage2DReader

Overrides:

getOriginalEnvelope in class AbstractGridCoverage2DReader

Returns:

the GeneralBounds for this AbstractGridCoverage2DReader.

getOriginalEnvelope

public GeneralBounds getOriginalEnvelope(String coverageName)

Description copied from class: AbstractGridCoverage2DReader

Retrieves the GeneralBounds for this AbstractGridCoverage2DReader.

Specified by:

getOriginalEnvelope in interface GridCoverage2DReader

Overrides:

getOriginalEnvelope in class AbstractGridCoverage2DReader

Parameters:

coverageName - the name of the coverage to work on.

Returns:

the GeneralBounds for this AbstractGridCoverage2DReader.

getOriginalGridRange

public GridEnvelope getOriginalGridRange()

Description copied from class: AbstractGridCoverage2DReader

Retrieves the GeneralGridEnvelope that represents the raster grid dimensions of the highest resolution level in this dataset.

Specified by:

getOriginalGridRange in interface GridCoverage2DReader

Overrides:

getOriginalGridRange in class AbstractGridCoverage2DReader

Returns:

the GeneralGridEnvelope that represents the raster grid dimensions of the highest resolution level in this dataset.

getOriginalGridRange

public GridEnvelope getOriginalGridRange(String coverageName)

Description copied from class: AbstractGridCoverage2DReader

Retrieves the GeneralGridEnvelope that represents the raster grid dimensions of the highest resolution level in this dataset.

Specified by:

getOriginalGridRange in interface GridCoverage2DReader

Overrides:

getOriginalGridRange in class AbstractGridCoverage2DReader

Parameters:

coverageName - the name of the coverage to work with

Returns:

the GeneralGridEnvelope that represents the raster grid dimensions of the highest resolution level in this dataset.

getOriginalGridToWorld

public MathTransform getOriginalGridToWorld(PixelInCell pixInCell)

Description copied from class: AbstractGridCoverage2DReader

Retrieves the original grid to world transformation for this AbstractGridCoverage2DReader.

Specified by:

getOriginalGridToWorld in interface GridCoverage2DReader

Overrides:

getOriginalGridToWorld in class AbstractGridCoverage2DReader

Parameters:

pixInCell - specifies the datum of the transformation we want.

Returns:

the original grid to world transformation for this AbstractGridCoverage2DReader.

getOriginalGridToWorld

public MathTransform getOriginalGridToWorld(String coverageName,
                                            PixelInCell pixInCell)

Description copied from class: AbstractGridCoverage2DReader

Retrieves the original grid to world transformation for this AbstractGridCoverage2DReader.

Specified by:

getOriginalGridToWorld in interface GridCoverage2DReader

Overrides:

getOriginalGridToWorld in class AbstractGridCoverage2DReader

Parameters:

coverageName - the name of the coverage to work with

pixInCell - specifies the datum of the transformation we want.

Returns:

the original grid to world transformation for this AbstractGridCoverage2DReader.

getCoordinateReferenceSystem

public CoordinateReferenceSystem getCoordinateReferenceSystem()

Description copied from class: AbstractGridCoverage2DReader

Retrieves the GeneralBounds for this AbstractGridCoverage2DReader.

Specified by:

getCoordinateReferenceSystem in interface GridCoverage2DReader

Overrides:

getCoordinateReferenceSystem in class AbstractGridCoverage2DReader

Returns:

the GeneralBounds for this AbstractGridCoverage2DReader.

getCoordinateReferenceSystem

public CoordinateReferenceSystem getCoordinateReferenceSystem(String coverageName)

Description copied from class: AbstractGridCoverage2DReader

Retrieves the GeneralBounds for this AbstractGridCoverage2DReader.

Specified by:

getCoordinateReferenceSystem in interface GridCoverage2DReader

Overrides:

getCoordinateReferenceSystem in class AbstractGridCoverage2DReader

Returns:

the GeneralBounds for this AbstractGridCoverage2DReader.

getImageLayout

public ImageLayout getImageLayout()
                           throws IOException

Description copied from interface: GridCoverage2DReader

Retrieve the ImageLayout for the default coverage.

Throw an IllegalArgumentException in case the name is wrong and/or no such a coverage exists.

Specified by:

getImageLayout in interface GridCoverage2DReader

Overrides:

getImageLayout in class AbstractGridCoverage2DReader

Returns:

an ImageLayout that is useful for actually knowing the ColorModel, the SampleModel as well as the tile grid for the default coverage.

Throws:

IOException

getImageLayout

public ImageLayout getImageLayout(String coverageName)
                           throws IOException

Description copied from interface: GridCoverage2DReader

Retrieve the ImageLayout for the specified coverage.

Throw an IllegalArgumentException in case the name is wrong and/or no such a coverage exists.

Specified by:

getImageLayout in interface GridCoverage2DReader

Overrides:

getImageLayout in class AbstractGridCoverage2DReader

Parameters:

coverageName - the name of the coverage for which we want to know the GridEnvelope.

Returns:

an ImageLayout that is useful for actually knowing the ColorModel, the SampleModel as well as the tile grid for a certain coverage.

Throws:

IOException

getResolutionLevels

public double[][] getResolutionLevels()
                               throws IOException

Description copied from interface: GridCoverage2DReader

Retrieve the resolution levels for the default coverage.

Throw an IllegalArgumentException in case the name is wrong and/or no such a coverage exists.

Specified by:

getResolutionLevels in interface GridCoverage2DReader

Overrides:

getResolutionLevels in class AbstractGridCoverage2DReader

Returns:

the resolution levels for the default coverage.

Throws:

IOException

getResolutionLevels

public double[][] getResolutionLevels(String coverageName)
                               throws IOException

Description copied from interface: GridCoverage2DReader

Retrieve the resolution levels for the specified coverage.

Throw an IllegalArgumentException in case the name is wrong and/or no such a coverage exists.

Specified by:

getResolutionLevels in interface GridCoverage2DReader

Overrides:

getResolutionLevels in class AbstractGridCoverage2DReader

Parameters:

coverageName - the name of the coverage for which we want to know the resolution levels.

Returns:

the resolution levels for the specified coverage.

Throws:

IOException

harvest

public List<HarvestedSource> harvest(String defaultCoverage,
                                     Object source,
                                     Hints hints)
                              throws IOException,
                                     UnsupportedOperationException

Description copied from interface: StructuredGridCoverage2DReader

Harvests the specified source into the reader. Depending on the implementation, the original source is harvested in place (e.g., image mosaic), or might be copied into the reader persistent storage (e.g., database raster handling)

Specified by:

harvest in interface StructuredGridCoverage2DReader

Parameters:

defaultCoverage - Default target coverage, to be used in case the sources being harvested are not structured ones. The parameter is optional, in case it's missing the reader will use the first coverage as the default target.

source - The source can be any kind of object, it's up to the reader implementation to understand and use it. Commons source types could be a single file, or a folder.

hints - Used to provide implementation specific hints on how to harvest the sources

Throws:

IOException

UnsupportedOperationException

getDimensionDescriptors

public List<DimensionDescriptor> getDimensionDescriptors(String coverageName)
                                                  throws IOException

Description copied from interface: StructuredGridCoverage2DReader

Describes the dimensions supported by the specified coverage, if any. (coverageName might be null, if there is only one supported coverage)

Specified by:

getDimensionDescriptors in interface StructuredGridCoverage2DReader

Throws:

IOException

delete

public void delete(boolean deleteData)
            throws IOException

Description copied from interface: StructuredGridCoverage2DReader

delete all stuff (database content, indexer files, property files, associated auxiliary files and so on).

Specified by:

delete in interface StructuredGridCoverage2DReader

Parameters:

deleteData - specifies whether data (granules) should be deleted too.

Throws:

IOException

getInfo

public ResourceInfo getInfo(String coverageName)

Description copied from class: AbstractGridCoverage2DReader

Default implementation returns a FileResourceInfo containing same fileGroup list contained in the ServiceInfo object.

Specified by:

getInfo in interface GridCoverage2DReader

Overrides:

getInfo in class AbstractGridCoverage2DReader

Returns:

ResourceInfo describing a specific coverage.

getInfo

public ServiceInfo getInfo()

Description copied from class: AbstractGridCoverage2DReader

Information about this source.

Subclasses should provide additional format specific information.

Specified by:

getInfo in interface GridCoverage2DReader

Overrides:

getInfo in class AbstractGridCoverage2DReader

Returns:

ServiceInfo describing getSource().

getMultiThreadedLoader

public ExecutorService getMultiThreadedLoader()

getDatasetLayout

public DatasetLayout getDatasetLayout()

Description copied from interface: GridCoverage2DReader

Returns the DatasetLayout for the coverage.

Specified by:

getDatasetLayout in interface GridCoverage2DReader

Overrides:

getDatasetLayout in class AbstractGridCoverage2DReader

Returns:

a DatasetLayout object containing info about Overview number and Image masks.