Interface SegmentedCurveCoverage

  • All Superinterfaces:
    ContinuousCoverage, Coverage

    @UML(identifier="CV_SegmentedCurveCoverage",
         specification=ISO_19123)
    public interface SegmentedCurveCoverage
    extends ContinuousCoverage
    Model phenomena that vary continuously or discontinuously along curves, which may be elements of a network. The domain of a segmented curve coverage is described by a set of curves and includes all the direct positions in all of the curves in the set.

    Arc-length parameterization of a curve simplifies interpolation between direct positions on the curve. Representation of phenomena that vary discontinuously along a curve requires segmentation of the curve into regions of continuous variation. Such segmentation is also simplified by arc-length parameterization. Curve supports arc-length parameterization. In particular, the operation:

    GenericCurve.getParamForPoint(org.opengis.geometry.DirectPosition)

    returns the arc-length distance from the start point of the curve to the input direct position.

    A segmented curve coverage operates on a domain composed of curves. It is composed of a set of ValueCurves, each of which maps feature attribute values to position on a curve.

    Since:
    GeoAPI 2.1
    • Method Detail

      • getElements

        @UML(identifier="element",
             obligation=OPTIONAL,
             specification=ISO_19123)
        Set<ValueCurve> getElements()
        Returns the set of value objects used to evaluate the coverage. This association is optional - an analytical coverage needs no value objects.
        Specified by:
        getElements in interface ContinuousCoverage
        Returns:
        the value used to evaluate the coverage, or null if not applicable.
      • getInterpolationMethod

        @UML(identifier="interpolationType",
             obligation=OPTIONAL,
             specification=ISO_19123)
        InterpolationMethod getInterpolationMethod()
        Returns the interpolation method to be used in evaluating the coverage. The default value shall be "linear". An application schema may define other interpolation methods.
        Specified by:
        getInterpolationMethod in interface ContinuousCoverage
        Returns:
        the interpolation method, or null if not applicable.
      • curve

        @UML(identifier="curve",
             obligation=MANDATORY,
             specification=ISO_19123)
        ValueCurve curve​(DirectPosition position,
                         double tolerance)
        Return the value curve nearest to the specified direct position. The operation shall throw an exception if the direct position is not close (i.e., within the distance specified by the tolerance parameter) to one of the value curves in this segmented curve coverage. The default value for tolerance is zero.
        Parameters:
        position - The position where to search for a value curve.
        tolerance - The maximal distance between the curve and the specified position.
        Returns:
        the curve nearest to the specified position.
      • curve

        @UML(identifier="curve",
             obligation=MANDATORY,
             specification=ISO_19123)
        ValueCurve curve​(DirectPosition position)
        Return the value curve nearest to the specified direct position. This method is equivalent to curve(position, 0).
        Parameters:
        position - The position where to search for a value curve.
        Returns:
        the curve nearest to the specified position.