org.opengis.coverage
Interface SegmentedCurveCoverage

Show UML class diagram

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 Summary

ValueCurve	curve(DirectPosition position) Return the value curve nearest to the specified direct position.
ValueCurve	curve(DirectPosition position, double tolerance) Return the value curve nearest to the specified direct position.
Set<Record>	evaluate(DirectPosition p, Collection<String> list) Returns a set of records of feature attribute values for the specified direct position.
Set<ValueCurve>	getElements() Returns the set of value objects used to evaluate the coverage.
InterpolationMethod	getInterpolationMethod() Returns the interpolation method to be used in evaluating the coverage.

Methods inherited from interface ContinuousCoverage

evaluateInverse, getInterpolationParameterTypes, locate, select

Methods inherited from interface Coverage

evaluate, evaluate, evaluate, evaluate, evaluate, evaluate, find, find, getCommonPointRule, getCoordinateReferenceSystem, getDomainElements, getDomainExtents, getEnvelope, getNumSampleDimensions, getRangeElements, getRangeType, getRenderableImage, getSampleDimension, getSources, list

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.

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. Evaluation of a segmented curve coverage involves several steps:

• Invoke curve(org.opengis.geometry.DirectPosition, double) in order to find the value curve that contains the input direct position.
• Invoke ValueCurve.segment(org.opengis.geometry.DirectPosition, double) in order to find the value segment that contains the input direct position.
• If segment returns a single value segment, use the specified interpolation type to compute feature attribute values from the associated control values.
• If segment returns a pair of conterminous ValueSegments, compute the feature attribute values according to the rule specified by the common point rule.

Specified by:

evaluate in interface ContinuousCoverage

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't be evaluated for some other reason.