## org.opengis.coverage.processing
Interface GridAnalysis

All Superinterfaces:
  Coverage, GridCoverage

Deprecated. In favor of migrating to ISO 19123 definition for Coverage.

    @UML(identifier="GP_GridAnalysis",
         specification=OGC_01004)
    public interface GridAnalysis

extends GridCoverage

Performs various analysis operations on a grid coverage. Such processing functionality includes histogram calculation, grid coverage covariance and other statistical measurements.

WARNING: THIS CLASS WILL CHANGE. Current API is derived from OGC Grid Coverages Implementation specification 1.0. We plan to replace it by new interfaces derived from ISO 19123 (Schema for coverage geometry and functions). Current interfaces should be considered as legacy and are included in this distribution only because they were part of GeoAPI 1.0 release. We will try to preserve as much compatibility as possible, but no migration plan has been determined yet.

Since:
  GeoAPI 1.0
Version:
  Grid Coverage specification 1.0
TODO:
  All methods except `getCorrelation()` work on a particuler sample dimension. Why not defines those methods right into `SampleDimension`?

Method Summary
`Matrix` `getCorrelation()` Deprecated. Determine the correlation between sample dimensions in the grid.
`int[]` `getHistogram(int sampleDimension, double minimumEntryValue, double maximumEntryValue, int numberEntries)` Deprecated. Determine the histogram of the grid values for a sample dimension.
`double` `getMaxValue(int sampleDimension)` Deprecated. Determine the maximum grid value for a sample dimension.
`double` `getMeanValue(int sampleDimension)` Deprecated. Determine the mean grid value for a sample dimension.
`double` `getMedianValue(int sampleDimension)` Deprecated. Determine the median grid value for a sample dimension.
`double` `getMinValue(int sampleDimension)` Deprecated. Determine the minimum grid value for a sample dimension.
`double` `getModeValue(int sampleDimension)` Deprecated. Determine the mode grid value for a sample dimension.
`double` `getStandardDeviation(int sampleDimension)` Deprecated. Determine the standard deviation from the mean of the grid values for a sample dimension.

Methods inherited from interface GridCoverage
`getDataBlock, getDataBlock, getDataBlock, getDataBlock, getDataBlock, getDataBlock, getGridGeometry, getGridPacking, getNumOverviews, getOptimalDataBlockSizes, getOverview, getOverviewGridGeometry, getPackedDataBlock, isDataEditable, setDataBlock, setDataBlock, setDataBlock, setDataBlock, setDataBlock, setDataBlock, setPackedDataBlock`

Methods inherited from interface Coverage
`evaluate, evaluate, evaluate, evaluate, evaluate, evaluate, evaluate, evaluateInverse, find, find, getCommonPointRule, getCoordinateReferenceSystem, getDimensionNames, getDomainElements, getDomainExtents, getEnvelope, getMetadataNames, getMetadataValue, getNumSampleDimensions, getRangeElements, getRangeType, getRenderableImage, getSampleDimension, getSources, list, select`

Method Detail

### getHistogram

    @UML(identifier="histogram",
         obligation=MANDATORY,
         specification=OGC_01004)
    int[] getHistogram(int sampleDimension,
                                                                              double minimumEntryValue,
                                                                              double maximumEntryValue,
                                                                              int numberEntries)
                       throws InvalidSampleDimensionException

  Deprecated.
  Determine the histogram of the grid values for a sample dimension.

  Parameters:
    `sampleDimension` - Index of sample dimension to be histogrammed.
    `minimumEntryValue` - Minimum value stored in the first histogram entry.
    `maximumEntryValue` - Maximum value stored in the last histogram entry.
    `numberEntries` - Number of entries in the histogram.
  Returns:
    The histogram of the grid values for a sample dimension.
  Throws:
    `InvalidSampleDimensionException` - if the sample dimension index is out of bounds.
  See Also:
    `Histogram`

### getMinValue

    @UML(identifier="minValue",
         obligation=MANDATORY,
         specification=OGC_01004)
    double getMinValue(int sampleDimension)
                       throws InvalidSampleDimensionException

  Deprecated.
  Determine the minimum grid value for a sample dimension.

  Parameters:
    `sampleDimension` - Index of sample dimension.
  Returns:
    the minimum grid value for a sample dimension.
  Throws:
    `InvalidSampleDimensionException` - if the sample dimension index is out of bounds.

### getMaxValue

    @UML(identifier="maxValue",
         obligation=MANDATORY,
         specification=OGC_01004)
    double getMaxValue(int sampleDimension)
                       throws InvalidSampleDimensionException

  Deprecated.
  Determine the maximum grid value for a sample dimension.

  Parameters:
    `sampleDimension` - Index of sample dimension.
  Returns:
    the maximum grid value for a sample dimension.
  Throws:
    `InvalidSampleDimensionException` - if the sample dimension index is out of bounds.

### getMeanValue

    @UML(identifier="meanValue",
         obligation=MANDATORY,
         specification=OGC_01004)
    double getMeanValue(int sampleDimension)
                        throws InvalidSampleDimensionException

  Deprecated.
  Determine the mean grid value for a sample dimension.

  Parameters:
    `sampleDimension` - Index of sample dimension.
  Returns:
    the mean grid value for a sample dimension.
  Throws:
    `InvalidSampleDimensionException` - if the sample dimension index is out of bounds.

### getMedianValue

    @UML(identifier="medianValue",
         obligation=MANDATORY,
         specification=OGC_01004)
    double getMedianValue(int sampleDimension)
                          throws InvalidSampleDimensionException

  Deprecated.
  Determine the median grid value for a sample dimension.

  Parameters:
    `sampleDimension` - Index of sample dimension.
  Returns:
    the median grid value for a sample dimension.
  Throws:
    `InvalidSampleDimensionException` - if the sample dimension index is out of bounds.

### getModeValue

    @UML(identifier="modeValue",
         obligation=MANDATORY,
         specification=OGC_01004)
    double getModeValue(int sampleDimension)
                        throws InvalidSampleDimensionException

  Deprecated.
  Determine the mode grid value for a sample dimension.

  Parameters:
    `sampleDimension` - Index of sample dimension.
  Returns:
    the mode grid value for a sample dimension.
  Throws:
    `InvalidSampleDimensionException` - if the sample dimension index is out of bounds.

### getStandardDeviation

    @UML(identifier="stdDev",
         obligation=MANDATORY,
         specification=OGC_01004)
    double getStandardDeviation(int sampleDimension)
                                throws InvalidSampleDimensionException

  Deprecated.
  Determine the standard deviation from the mean of the grid values for a sample dimension.

  Parameters:
    `sampleDimension` - Index of sample dimension.
  Returns:
    he standard deviation from the mean of the grid values for a sample dimension.
  Throws:
    `InvalidSampleDimensionException` - if the sample dimension index is out of bounds.

### getCorrelation

    @UML(identifier="correlation",
         obligation=MANDATORY,
         specification=OGC_01004)
    Matrix getCorrelation()

  Deprecated.
  Determine the correlation between sample dimensions in the grid.

  Returns:
    the correlation between sample dimensions in the grid.

Copyright © 1994-2008 Open Geospatial Consortium. All Rights Reserved.