Interface DiscreteCoverage

    • Method Detail

      • getElements

        @UML(identifier="element",
             obligation=OPTIONAL,
             specification=ISO_19123)
        Set<? extends GeometryValuePair> getElements()
        Returns the set of geometry-value pairs included in this coverage.
        Returns:
        the set of geometry-value pairs, or null.
        TODO:
        Is it duplicating Coverage.list()?
      • locate

        @UML(identifier="locate",
             obligation=OPTIONAL,
             specification=ISO_19123)
        Set<? extends GeometryValuePair> locate​(DirectPosition p)
        Returns the set of geometry-value pairs that include the domain objects containing the specified direct position. It shall return null if the direct position is not on any of the objects within the domain of the discrete coverage.
        Parameters:
        p - The position where to search for geometry-value pairs.
        Returns:
        geometry-value pairs, or null.
      • evaluate

        @UML(identifier="evaluate",
             obligation=MANDATORY,
             specification=ISO_19123)
        Set<Record> evaluate​(DirectPosition p,
                             Collection<String> list)
                      throws CannotEvaluateException
        Returns a set of records of feature attribute values for the specified direct position. Normally, the input direct position will fall within only one geometry-value pair, and the operation will return the record of feature attribute values associated with that geometry-value pair. If the direct position falls on the boundary between two geometry-value pairs, or within two or more overlapping geometry-value pairs, the operation shall return a record of feature attribute values derived according to the common point rule. It shall return an empty set if the direct position is not on any of the objects within the domain of the discrete coverage.
        Specified by:
        evaluate in interface Coverage
        Parameters:
        p - The position where to evaluate.
        list - The field of interest, or null for every fields.
        Returns:
        the feature attributes.
        Throws:
        PointOutsideCoverageException - if the point is outside the coverage domain.
        CannotEvaluateException - if the point can not be evaluated for some other reason.
      • evaluateInverse

        @UML(identifier="evaluateInverse",
             obligation=OPTIONAL,
             specification=ISO_19123)
        Set<? extends DomainObject<?>> evaluateInverse​(Record v)
        Locates the geometry-value pairs for which value equals the input record, and return the set of domain objects belonging to those geometry-value pairs. It shall return null set if none of the geometry-value pairs associated with this discrete coverage has a value equal to the input record.
        Specified by:
        evaluateInverse in interface Coverage
        Parameters:
        v - The feature attributes.
        Returns:
        the domain where the attributes are found.