Package org.geotools.api.coverage.grid

Interface GridCoverage

All Superinterfaces:
Coverage
All Known Subinterfaces:
GridCoverageResponse
All Known Implementing Classes:
AbstractGridCoverage, DefaultGridCoverageResponse, GridCoverage2D, Interpolator2D
public interface GridCoverage extends Coverage
Represent the basic implementation which provides access to grid coverage data. A GridCoverage implementation may provide the ability to update grid values.
Since:
GeoAPI 1.0
Author:
Martin Desruisseaux (IRD)
See Also:

  • Method Details

    • isDataEditable

      boolean isDataEditable()
      Returns true if grid data can be edited.
      Returns:
      true if grid data can be edited.

    • getGridGeometry

      GridGeometry getGridGeometry()
      Information for the grid coverage geometry. Grid geometry includes the valid range of grid coordinates and the georeferencing.
      Returns:
      The information for the grid coverage geometry.

    • getOptimalDataBlockSizes

      int[] getOptimalDataBlockSizes()
      Optimal size to use for each dimension when accessing grid values. These values together give the optimal block size to use when retrieving grid coverage values. For example, a client application can achieve better performance for a 2-D grid coverage by reading blocks of 128 by 128 if the grid is tiled into blocks of this size. The sequence is ordered by dimension. If the implementation does not have optimal sizes, the sequence will be null.
      Returns:
      The optimal size to use for each dimension when accessing grid values, or null if none.

    • getNumOverviews

      int getNumOverviews()
      Number of predetermined overviews for the grid.
      Returns:
      The number of predetermined overviews for the grid.

    • getOverviewGridGeometry

      GridGeometry getOverviewGridGeometry(int index) throws IndexOutOfBoundsException
      Returns the grid geometry for an overview.
      Parameters:
      index - Overview index for which to retrieve grid geometry. Indices start at 0.
      Returns:
      The grid geometry for an overview.
      Throws:
      IndexOutOfBoundsException - if overviewIndex is out of bounds.

    • getOverview

      GridCoverage getOverview(int index) throws IndexOutOfBoundsException
      Returns a pre-calculated overview for a grid coverage. The overview indices are numbered from 0 to numberOverviews-1. The overviews are ordered from highest (index 0) to lowest (numberOverviews-1 ) resolution. Overview grid coverages will have overviews which are the overviews for the grid coverage with lower resolution than the overview. For example, a 1 meter grid coverage with 3, 9, and 27 meter overviews will be ordered as in the left side below. The 3 meter overview will have 2 overviews as in the right side below:
      1 meter GC   3 meter overview
      Index   resolution
      0 3
      1 9
      2 27
      		            
      Index   resolution
      0 9
      1 27
      Parameters:
      index - Index of grid coverage overview to retrieve. Indexes start at 0.
      Returns:
      A pre-calculated overview for a grid coverage.
      Throws:
      IndexOutOfBoundsException - if overviewIndex is out of bounds.

    • getSources

      List<GridCoverage> getSources()
      Returns the sources data for a grid coverage. If the GridCoverage was produced from an underlying dataset (by read(...) for instance), this method should returns an empty list.

      If the GridCoverage was produced using {link org.geotools.api.coverage.processing.GridCoverageProcessor} then it should return the source grid coverages of the one used as input to GridCoverageProcessor. In general this method is intended to return the original GridCoverage on which it depends.

      This is intended to allow applications to establish what GridCoverages will be affected when others are updated, as well as to trace back to the "raw data".

      Specified by:
      getSources in interface Coverage
      Returns:
      The sources data for a grid coverage.

    • getRenderedImage

      RenderedImage getRenderedImage()
      Returns grid data as a rendered image.