Interface DiscreteSurfaceCoverage

  • All Superinterfaces:
    Coverage, DiscreteCoverage

    @UML(identifier="CV_DiscreteSurfaceCoverage",
         specification=ISO_19123)
    public interface DiscreteSurfaceCoverage
    extends DiscreteCoverage
    A coverage whose domain consists of a collection of surfaces. In most cases, the surfaces that constitute the domain of a coverage are mutually exclusive and exhaustively partition the extent of the coverage. Surfaces or their boundaries may be of any shape. The boundaries of component surfaces often correspond to natural phenomena and are highly irregular.

    Example: A coverage that represents soil types typically has a spatial domain composed of surfaces with irregular boundaries.

    Any set of polygons can be used as a spatial domain for a discrete surface coverage. Spatial domains composed of congruent polygons are very common. Very often, these domains are composed of congruent rectangles or regular hexagons. The geometry of such a tessellation may be described in terms of a quadrilateral grid or a hexagonal grid. The spatial domain of a discrete surface coverage may also consist of the triangles that compose a TIN, or the polygons of a Thiessen polygon network.

    Since:
    GeoAPI 2.1
    TODO:
    evaluate and evaluateInverse
    • Method Detail

      • getTriangleSource

        @UML(identifier="triangleSource",
             obligation=OPTIONAL,
             specification=ISO_19123)
        TinCoverage getTriangleSource()
        Returns the TIN coverage associated to this surface coverage, or null if none. The following constraint must hold:

        element.geometry == triangleSource.controlValue.geometry

        Returns:
        the TIN coverage.
        TODO:
        Review the constraints. Something must be missing...
      • getPolygonSource

        @UML(identifier="polygonSource",
             obligation=OPTIONAL,
             specification=ISO_19123)
        ThiessenPolygonCoverage getPolygonSource()
        Returns the Thiessen polygon coverage associated to this surface coverage, or null if none. The following constraint must hold:

        element.geometry == polygonSource.controlValue.geometry

        Returns:
        the thiessen polygon coverage.
        TODO:
        Review the constraints. Something must be missing...
      • getElements

        @UML(identifier="element",
             obligation=OPTIONAL,
             specification=ISO_19123)
        Set<SurfaceValuePair> getElements()
        Returns the set of surface-value pairs included in this coverage.
        Specified by:
        getElements in interface DiscreteCoverage
        Returns:
        the set of geometry-value pairs, or null.
      • locate

        @UML(identifier="locate",
             obligation=OPTIONAL,
             specification=ISO_19123)
        Set<SurfaceValuePair> locate​(DirectPosition p)
        Returns the set of surface-value pairs that include the domain objects containing the specified direct position.
        Specified by:
        locate in interface DiscreteCoverage
        Parameters:
        p - The position where to search for geometry-value pairs.
        Returns:
        geometry-value pairs, or null.
      • list

        @UML(identifier="list",
             obligation=MANDATORY,
             specification=ISO_19123)
        Set<SurfaceValuePair> list()
        Returns the dictionary of surface-value pairs that contain the objects in the domain of the coverage each paired with its record of feature attribute values.
        Specified by:
        list in interface Coverage
        Returns:
        the geometry-value pairs.
      • find

        @UML(identifier="find",
             obligation=MANDATORY,
             specification=ISO_19123)
        SurfaceValuePair find​(DirectPosition p)
        Returns the nearest curve-value pair from the specified direct position. This is a shortcut for find(p,1).
        Specified by:
        find in interface Coverage
        Parameters:
        p - The search position.
        Returns:
        the geometry-value pair nearest to the given position.