Package org.opengis.coverage
A coverage is a feature that associates positions within a bounded space (its domain) to feature attribute values (its range). In other words, it is both a feature and a function. Examples include a raster image, a polygon overlay, or a digital elevation matrix.
A coverage may represent a single feature or a set of features.
Domain of a coverage
A coverage domain is a set of geometric objects described in terms of direct positions. It may be extended to all of the direct positions within the convex hull of that set of geometric objects. The direct positions are associated with a spatial or temporal coordinate reference system. Commonly used domains include point sets, grids, collections of closed rectangles, and other collections of geometric objects. The geometric objects may exhaustively partition the domain, and thereby form a tessellation such as a grid or a TIN. Point sets and other sets of nonconterminous geometric objects do not form tessellations. Coverage subtypes may be defined in terms of their domains.
Coverage domains differ in both the coordinate dimension of the space in which they
exist and in the topological dimension of the geometric objects they contain. Clearly, the geometric
objects that make up a domain cannot have a topological dimension greater than the coordinate dimension
of the domain. A domain of coordinate dimension 3 may be composed of points, curves, surfaces, or solids,
while a domain of coordinate dimension 2 may be composed only of points, curves, or surfaces.
ISO 19107 defines a number of geometric objects
(subtypes of the interface Geometry
) to be used for the description
of features. Many of these geometric objects can be used to define domains for coverages. In addition, ISO 19108
defines TM_GeometricPrimitives
that may also be used to define domains of coverages.
The range of a coverage
The range of a coverage is a set of feature attribute values. It may be either a finite or a transfinite set. Coverages often model many associated functions sharing the same domain. Therefore, the value set is represented as a collection of records with a common schema.
Example: A coverage might assign to each direct position in a county the temperature, pressure, humidity, and wind velocity at noon, today, at that point. The coverage maps every direct position in the county to a record of 4 fields.
A feature attribute value may be of any data type. However, evaluation of a continuous coverage is usually implemented by interpolation methods that can be applied only to numbers or vectors. Other data types are almost always associated with discrete coverages.
Given a record from the range of a coverage, inverse evaluation is the calculation and exposure of a set of geometric objects associated with specific values of the attributes. Inverse evaluation may return many geometric objects associated with a single feature attribute value.
Example: Inverse evaluation is used for the extraction of contours from an elevation coverage and the extraction of classified regions in an image.
Discrete and continuous coverages
Coverages are of two types. A discrete coverage has a domain that consists of a finite collection of geometric objects and the direct positions contained in those geometric objects. A discrete coverage maps each geometric object to a single record of feature attribute values. The geometric object and its associated record form a geometry value pair. A discrete coverage is thus a discrete or step function as opposed to a continuous coverage. Discrete functions can be explicitly enumerated as (input, output) pairs. A discrete coverage may be represented as a collection of ordered pairs of independent and dependent variables. Each independent variable is a geometric object and each dependent variable is a record of feature attribute values.
Example: A coverage that maps a set of polygons to the soil type found within each polygon is an example of a discrete coverage.
A continuous coverage has a domain that consists of a set of direct positions in a coordinate space. A continuous coverage maps direct positions to value records.
Example: Consider a coverage that maps direct positions in San Diego County to their temperature at noon today. Both the domain and the range may take infinitely many different values. This continuous coverage would be associated with a discrete coverage that holds the temperature values observed at a set of weather stations.
A continuous coverage may consist of no more than a spatially bounded, but transfinite set of direct positions, and a mathematical function that relates direct position to feature attribute value. This is called an analytical coverage.
Example: A statistical trend surface that relates land value to position relative to a city centre is an example of a continuous coverage.
More often, the domain of a continuous coverage consists of the direct positions in the union or in the convex hull of a finite collection of geometric objects; it is specified by that collection. In most cases, a continuous coverage is also associated with a discrete coverage that provides a set of control values to be used as a basis for evaluating the continuous coverage. Evaluation of the continuous coverage at other direct positions is done by interpolating between the geometry value pairs of the control set. This often depends upon additional geometric objects constructed from those in the control set; these additional objects are typically of higher topological dimension than the control objects. In this set of interfaces, such objects are called geometry value objects. A geometry value object is a geometric object associated with a set of geometry value pairs that provide the control for constructing the geometric object and for evaluating the coverage at direct positions within the geometric object.
Example: Evaluation of a triangulated irregular network involves interpolation of values within a triangle composed of three neighbouring point value pairs.
 Since:
 GeoAPI 2.0

Interface Summary Interface Description AttributeValues Represents an element from the range of the coverage.ContinuousCoverage A coverage that returns a distinct record of feature attribute values for any direct position within its domain.Coverage A function from a spatial, temporal or spatiotemporal domain to an attribute range.CurveValuePair A geometryvalue pair that has a curve as the value of its geometry attribute.DiscreteCoverage A coverage that returns the same record of feature attribute values for any direct position within a single object in its domain.DiscreteCurveCoverage A discrete coverage characterized by a finite spatial domain consisting of curves.DiscreteGridPointCoverage A discrete coverage with a domain defined as a set of grid points that are associated with records of feature attribute values through a grid values matrix.DiscretePointCoverage A discrete coverage characterized by a finite domain consisting of points.DiscreteSolidCoverage A coverage whose domain consists of a collection of solids.DiscreteSurfaceCoverage A coverage whose domain consists of a collection of surfaces.DomainObject<G extends Geometry> Represents an element of the domain of the coverage.GeometryValuePair Describes an element of a set that defines the relationships of a discrete coverage.PointValuePair A geometryvalue pair that has a point as the value of its geometry attribute.SampleDimension Contains information for an individual sample dimension of coverage.SegmentedCurveCoverage Model phenomena that vary continuously or discontinuously along curves, which may be elements of a network.SolidValuePair A geometryvalue pair that has a solid as the value of its geometry attribute.SurfaceValuePair A geometryvalue pair that has a surface as the value of its geometry attribute.ThiessenPolygonCoverage Evaluates a coverage at direct positions within a Thiessen polygon network constructed from a set of discrete pointvalue pairs.ThiessenValuePolygon A value from a Thiessen polygon coverage.TinCoverage A continuous coverage characterized by a TIN.ValueCurve Basis for interpolating within a segmented curve coverage.ValueObject Basis for interpolating feature attribute values within a continuous coverage.ValueSegment Limits of a value segment specified by two values of the arclength parameter of the curve underlying its parent value curve.ValueTriangle A value object that consists of three pointvalue pairs where the points are noncollinear. 
Class Summary Class Description ColorInterpretation Deprecated. No replacement.CommonPointRule List of codes that identify methods for handling cases where the direct position input to theevaluate
operation falls within two or more of the geometric objects.InterpolationMethod A list of codes that identify interpolation methods that may be used for evaluating continuous coverages.PaletteInterpretation Describes the color entry in a color table.SampleDimensionType Specifies the various dimension types for coverage values. 
Exception Summary Exception Description CannotEvaluateException The base class for exceptions thrown when a quantity can't be evaluated.PointOutsideCoverageException Thrown when aevaluate
method is invoked for a location outside the domain of the coverage.