wcsDescribeCoverage.xsd 2010-02-02
http://schemas.opengis.net/wcs/1.1/gml4wcs.xsd
This XML Schema Document defines the DescribeCoverage operation request and response XML elements and types, used by the OGC Web Coverage Service (WCS).
WCS is an OGC Standard.
Copyright (c) 2006,2010 Open Geospatial Consortium, Inc. All Rights Reserved.
To obtain additional rights of use, visit http://www.opengeospatial.org/legal/ .
Request to a WCS to perform the DescribeCoverage operation. This operation allows a client to retrieve descriptions of one or more coverages. In this XML encoding, no "request" parameter is included, since the element name specifies the specific operation.
Unordered list of identifiers of desired coverages. A client can obtain identifiers by a prior GetCapabilities request, or from a third-party source.
Response from a WCS DescribeCoverage operation, containing one or more coverage descriptions.
Full description of one coverage available from a WCS server. This description shall include sufficient information to allow all valid GetCoverage operation requests to be prepared by a WCS client.
Unambiguous identifier of this coverage, unique for this WCS server.
Optional unordered list of more metadata elements about this coverage. A list of metadata elements for CoverageDescriptions could be specified in a WCS Application Profile.
Unordered list of references to all the coordinate reference systems that may be referenced as the GridBaseCRS of a GridCRS specified in the Output part of a GetCoverage operation request. The GridBaseCRS of the GridCRS of a georectified offered coverage shall be listed as a SupportedCRS. An ImageCRS for an unrectified offered image shall be listed as a SupportedCRS, so that it may be referenced as the GridBaseCRS of a GridCRS. This ImageCRS shall be the ImageCRS of that unrectified offered image, or the ImageCRS that is referenced as the GridBaseCRS of the GridCRS that is used by that unrectified offered image In addition, the GetCoverage operation output may be expressed in the ImageCRS or GridCRS of an unrectified offered coverage, instead of in a specified GridCRS. These Supported¬CRSs can also be referenced in the BoundingBox in the DomainSubset part of a GetCoverage request.
Unordered list of identifiers of all the formats in which GetCoverage operation responses can be encoded for this coverage.
Definition of the spatial-temporal domain of a coverage. The Domain shall include a SpatialDomain (describing the spatial locations for which coverages can be requested), and should included a TemporalDomain (describing the time instants or intervals for which coverages can be requested).
Although optional, the TemporalDomain should be included whenever a value is known or a useful estimate is available, to provide a time for the coverage.
Definition of the spatial domain of a coverage.
The first bounding box shall exactly specify the spatial domain of the offered coverage in the (one offered) CRS of the offered coverage, thus specifying the available grid row and column indices. For a georectified coverage (that has a GridCRS), this bounding box shall specify the spatial domain in that GridCRS. For an image that is not georectified, this bounding box shall specify the spatial domain in the ImageCRS or GridCRS of that image, whether or not that image is georeferenced.
Additional bounding boxes, if any, shall specify the spatial domain in other CRSs. These additional bounding boxes may be approximate, but should be as accurate as practical. One bounding box could simply duplicate the information in the ows:WGS84BoundingBox in the CoverageSummary; but the intent is to describe the spatial domain in more detail (e.g., in several different CRSs, or several rectangular areas instead of one overall bounding box). Multiple bounding boxes with the same CRS shall be interpreted as an unordered list of bounding boxes whose union covers spatial domain of this coverage. WCS use of a BoundingBox is further specified in specification Subclause 7.5.4.
Definition of the GridCRS of the offered coverage. This GridCRS shall be included in the SpatialDomain when the offered coverage has a GridCRS. A georectified coverage shall always have a GridCRS. An unrectified image may have a known GridCRS that has an ImageCRS as its GridBaseCRS. This GridCRS applies to this offered coverage, and specifies its spatial resolution in its GridBaseCRS.
Georeferencing coordinate transformation for unrectified coverage, which should be included when available for a coverage that is georeferenced but not georectified. When included, a concrete gml:Transformation or gml:ConcatenatedOperation element shall be substituted for this abstract CoordinateOperation element. In both cases, the substitution will specify the variable spatial resolution of this non-georectified image.
To support use cases 4, 5, 9, and/or 10 specified in Annex H, a WCS server needs to use a georeferencing coordinate transformation for a georeferenced but not georectified coverage. However, a WCS server may not support those use cases, not use a georeferencing transformation specified in that manner, or not make that transformation available to clients.
Association to ImageCRS of an unrectified offered coverage. The ImageCRS shall be referenced in the SpatialDomain when the offered coverage does not have a known GridCRS. Such a coverage is always unrectified, but an unrectified coverage may have a GridCRS instead of an ImageCRS. This ImageCRS applies to this offered coverage, but does not (normally) specify its spatial resolution. The ImageCRS and the GridCRS shall be mutually exclusive in this SpatialDomain.
Unordered list of polygons which more accurately describe the coverage spatial domain in various CRSs. Polygons are particularly useful for areas that are poorly approximated by a BoundingBox (such as satellite image swaths, island groups, other non-convex areas).
Georeferencing coordinate transformation for unrectified coverage. This georeferencing transformation can be specified as a Transformation, or a ConcatenatedOperation that includes at least one Transformation.
Association to an image coordinate reference system, either referencing or containing the definition of that reference system.
Definition of the temporal domain of a coverage, the times for which valid data are available. The times should to be ordered from the oldest to the newest.
Defines the fields (categories, measures, or values) in the range records available for each location in the coverage domain. Each such field may be a scalar (numeric or text) value, such as population density, or a vector (compound or tensor) of many similar values, such as incomes by race, or radiances by wavelength. Each range field is typically an observable whose meaning and reference system are referenced by URIs.
Unordered list of the Fields in the Range of a coverage.
Description of an individual field in a coverage range record.
Identifier of this Field. These field identifiers shall be unique in one CoverageDescription.
Further definition of this field, including meaning, units, etc. In this Definition, the AllowedValues should be used to encode the extent of possible values for this field, excluding the Null Value. If the range is not known, AnyValue should be used.
Unordered list of the values used when valid Field values are not available for whatever reason. The coverage encoding itself may specify a fixed value for null (e.g. “–99999” or “N/A”), but often the choice is up to the provider and must be communicated to the client outside the coverage itself. Each null value shall be encoded as a string. The optional codeSpace attribute can reference a definition of the reason why this value is null.
Spatial interpolation method(s) that server can apply to this field. One of these interpolation methods shall be used when a GetCoverage operation request requires resampling. When the only interpolation method listed is ‘none’, clients may only retrieve coverages from this coverage with its offered resolution and grid point locations.
Unordered list of the axes in a vector field for which there are Field values. This list shall be included when this Field has a vector of values. Notice that the axes can be listed here in any order; however, the axis order listed here shall be used in the KVP encoding of a GetCoverage operation request.
Definition of one axis in a field for which there are a vector of values.
This type is largely a subset of the ows:DomainType as needed for a range field axis.
Meaning metadata, which should be referenced for this axis.
Data type metadata, which may be referenced for this axis.
Unit of measure, which should be included when this axis has units or a more complete reference system.
Optional unordered list of other metadata elements about this axis. A list of required and optional other metadata elements for this quantity can be specified in a WCS Application Profile.
Name or identifier of this axis.
List of all the available (valid) key values for this axis. For numeric keys, signed values should be ordered from negative infinity to positive infinity.
Valid key value for this axis. There will normally be more than one key value for an axis, but one is allowed for special circumstances.