Interface SampleDimension

  • All Known Implementing Classes:
    GridSampleDimension

    @UML(identifier="CV_SampleDimension",
         specification=OGC_01004)
    public interface SampleDimension
    Contains information for an individual sample dimension of coverage. This interface is applicable to any coverage type. For grid coverages, the sample dimension refers to an individual band.
    Since:
    GeoAPI 1.0
    Author:
    Martin Desruisseaux (IRD)
    • Method Detail

      • getCategoryNames

        @UML(identifier="categoryNames",
             obligation=MANDATORY,
             specification=OGC_01004)
        InternationalString[] getCategoryNames()
        Sequence of category names for the values contained in a sample dimension. This allows for names to be assigned to numerical values. The first entry in the sequence relates to a cell value of zero. For grid coverages, category names are only valid for a classified grid data.

        For example:

        • 0 Background
        • 1 Water
        • 2 Forest
        • 3 Urban
        Note: If no category names exist, an empty sequence is returned.
        Returns:
        The category names.
      • getMinimumValue

        @UML(identifier="minimumValue",
             obligation=MANDATORY,
             specification=OGC_01004)
        double getMinimumValue()
        The minimum value occurring in the sample dimension. If this value is not available, this value can be determined from the org.opengis.coverage.processing.GridAnalysis#getMinValue operation. This value can be empty if this value is not provided by the implementation.
        Returns:
        The minimum value occurring in the sample dimension.
        See Also:
        getMaximumValue(), getNoDataValues()
      • getMaximumValue

        @UML(identifier="maximumValue",
             obligation=MANDATORY,
             specification=OGC_01004)
        double getMaximumValue()
        The maximum value occurring in the sample dimension. If this value is not available, this value can be determined from the org.opengis.coverage.processing.GridAnalysis#getMaxValue operation. This value can be empty if this value is not provided by the implementation.
        Returns:
        The maximum value occurring in the sample dimension.
        See Also:
        getMinimumValue(), getNoDataValues()
      • getUnits

        @UML(identifier="units",
             obligation=MANDATORY,
             specification=OGC_01004)
        Unit<?> getUnits()
        The unit information for this sample dimension. This interface typically is provided with grid coverages which represent digital elevation data. This value will be null if no unit information is available.
        Returns:
        The unit information for this sample dimension.
      • getOffset

        @UML(identifier="offset",
             obligation=MANDATORY,
             specification=OGC_01004)
        double getOffset()
        Offset is the value to add to grid values for this sample dimension. This attribute is typically used when the sample dimension represents elevation data. The default for this value is 0.
        Returns:
        The offset.
        See Also:
        getScale()
      • getScale

        @UML(identifier="scale",
             obligation=MANDATORY,
             specification=OGC_01004)
        double getScale()
        Scale is the value which is multiplied to grid values for this sample dimension. This attribute is typically used when the sample dimension represents elevation data. The default for this value is 1.
        Returns:
        The scale factor.
        See Also:
        getOffset()