.. WCS Request Parameters #----------------------------------------------------------------------------- # # Project: EOxServer # Authors: Stephan Krause # Stephan Meissl # Fabian Schindler # #----------------------------------------------------------------------------- # Copyright (C) 2011 EOX IT Services GmbH # # Permission is hereby granted, free of charge, to any person obtaining a # copy of this software and associated documentation files (the "Software"), # to deal in the Software without restriction, including without limitation # the rights to use, copy, modify, merge, publish, distribute, sublicense, # and/or sell copies of the Software, and to permit persons to whom the # Software is furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies of this Software or works derived from this Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING # FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER # DEALINGS IN THE SOFTWARE. #----------------------------------------------------------------------------- .. _wcs: Web Coverage Service (WCS) ========================== A Web Coverage Service (WCS) offers multi-dimensional coverage data for access over the Internet. The standard can be obtained from the `Open Geospatial Consortiums homepage `_. The following tables provide an overview over the available WCS request parameters for each operation supported by EOxServer. .. index:: single: GetCapabilities (WCS Request Parameters) GetCapabilities --------------- Table: ":ref:`table_wcs_request_parameters_getcapabilities`" below lists all parameters that are available with Capabilities requests. .. _table_wcs_request_parameters_getcapabilities: .. table:: WCS GetCapabilities Request Parameters +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | Parameter | Description / Subparameter | Allowed value(s) / Example | Mandatory (M) / Optional (O) | +===========================+===========================================================+==================================+================================+ | service | Requested service | WCS | M | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | request | Type of request | GetCapabilities | M | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | acceptVersions [1]_ | Prioritized sequence of one or more specification | 2.0.1, 1.1.2, 1.0.0 | O | | | versions accepted by the client, with preferred versions | | | | | listed first (first supported version will be used) | | | | | version1[,version2[,...]] | | | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | sections | Comma-separated unordered list of zero or more names of | - DatasetSeriesSummary | O | | | zero or more names of sections of service metadata | - CoverageSummary | | | | document to be returned in service metadata document. | - Contents | | | | Request only certain sections of Capabilities | - All | | | | Document section1[,section2[,...]] | - ServiceIdentification | | | | | - ServiceProvider | | | | | - OperationsMetadata | | | | | - Languages | | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | updateSequence | Date of last issued GetCapabilities request; to receive | "2013-05-08" | O | | | new document only if it has changed since | | | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ .. index:: single: DescribeCoverage (WCS Request Parameters) DescribeCoverage ---------------- Table: ":ref:`table_wcs_request_parameters_describecoverage`" below lists all parameters that are available with DescribeCoverage requests. .. _table_wcs_request_parameters_describecoverage: .. table:: WCS DescribeCoverage Request Parameters +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | Parameter | Description / Subparameter | Allowed value(s) / Example | Mandatory (M) / Optional (O) | +===========================+===========================================================+==================================+================================+ | service | Requested service | WCS | M | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | request | Type of request | DescribeCoverage | M | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | version [1]_ | Version number | 2.0.1 | M | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | coverageId | NCName(s): | | M | | | | | | | | - valid coverageID of a Dataset | | | | | - valid coverageID of a StichedMosaic | | | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ .. index:: single: DescribeEOCoverageSet (EO-WCS Request Parameters) DescribeEOCoverageSet --------------------- Table: ":ref:`table_eo-wcs_request_parameters_describeeocoverageset`" below lists all parameters that are available with DescribeEOCoverageSet requests. .. _table_eo-wcs_request_parameters_describeeocoverageset: .. table:: EO-WCS DescribeEOCoverageSet Request Parameters +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | Parameter | Description / Subparameter | Allowed value(s) / Example | Mandatory (M) / Optional (O) | +===========================+===========================================================+==================================+================================+ | service | Requested service | WCS | M | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | request | Type of request | DescribeEOCoverageSet | M | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | version [1]_ | Version number | 2.0.1 | M | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | eoId | Valid eoId: | | M | | | | | | | | - using the coverageId of a Datatset | | | | | - using the eoId of a DatatsetSeries | | | | | - using the coverageId of a StitchedMosaic | | | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | subset | Allows to constrain the request in each dimensions and | - Lat(32,47) | O | | | define how these parameters are applied. | | | | | | - Long(11,33) | | | | The spatial constraint is expressed in WGS84, the | | | | | temporal constraint in ISO 8601. | - phenomenonTime("2006-08-01", | | | | | "2006-08-22T09:22:00Z") | | | | Spatial trimming: Name of an coverage axis (Long or Lat) | - Lat(32,47)&Long(11,33)& | | | | Temporal trimming: phenomenonTime | phenomenonTime("2006-08-01"& | | | | Plus optional either: | "2006-08-22T09:22:00Z")& | | | | | containment=contains | | | | - containment = overlaps (default) | | | | | - containment = contains | | | | | | | | | | Any combination thereof (but each value only once per | | | | | request) | | | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | containment | see `subset` parameter | - overlaps (default) | O | | | | - contains | | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | section | see GetCapabilities | - DatasetSeriesSummary | O | | | | - CoverageSummary | | | | | - All | | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | count | Limits the maximum number of DatasetDescriptions returned | 10 | O | | | in the EOCoverageSetDescription. | | | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ .. index:: single: GetCoverage (EO-WCS Request Parameters) GetCoverage ----------- Table: ":ref:`table_eo-wcs_request_parameters_getcoverage`" below lists all parameters that are available with GetCoverage requests. .. _table_eo-wcs_request_parameters_getcoverage: .. table:: EO-WCS GetCoverage Request Parameters +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | Parameter | Description / Subparameter | Allowed value(s) / Example | Mandatory (M) / Optional (O) | +===========================+===========================================================+==================================+================================+ | service | Requested service | WCS | M | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | request | Type of request | GetCoverage | M | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | version [1]_ | Version number | 2.0.1 | M | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | coverageId | NCName(s): | | M | | | | | | | | - valid coverageID of a Dataset | | | | | - valid coverageID of a StichedMosaic | | | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | format | Requested format of coverage to be returned. By default | image/tiff | O | | | the coverage is returned in its original format. | | | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | mediatype | Coverage delivered directly as image file or enclosed in | multipart/mixed | O | | | GML structure | | | | | | | | | | - not present or | | | | | - multipart/mixed | | | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | subset | Trimming of coverage dimension (no slicing allowed!) |- x(400,200) | O | | | |- Lat(12,14) | | | | - the label of a coverage axis |- Long(17,17.4) | | | | | | | | | + The meaning of the subset can be altered by the | | | | | subsettingCrs parameter. | | | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | subsettingCrs | The CRS the subsets are expressed in. This also defines | \http://www.opengis.net/def/crs/ | O | | | the output CRS, if no further outputCrs is specified. | EPSG/0/4326 | | | | If no subsettingCrs is given, pixel coordinates are | | | | | assumed. | | | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | outputCrs | CRS for the requested output coverage | \http://www.opengis.net/def/crs/ | O | | | | EPSG/0/3035 | | | | - not present or | | | | | - CRS | | | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | rangesubset | Subsetting in the range domain (e.g. Band-Subsetting). | - Blue,Green,Red | O | | | | - Band1:Band3,Band5,Band7:Band9 | | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | scaleFactor | Scale the output by this factor. | - 0.5 | O | | | The 'scaleFactor' parameter requires MapServer v7.0. | - 1.25 | | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ |- scaleAxes | Mutually exclusive per axis, either: |- scaleAxes=x(1.5),y(0.5) | O | |- scaleSize | |- scaleSize=x(50),y(100) | | |- scaleExtent | - a scale factor (per axis) |- scaleExtent=long(50:100) | | | | - absolute pixel size as integer (per axis) | | | | | - the size given as extent (per axis). This is internally | | | | | translated to a 'scaleSize' | | | | | | | | | | The 'scaleAxes' parameter requires MapServer v7.0. | | | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | interpolation [2]_ | Interpolation method to be used | bilinear | O | | | | | | | | - \http://www.opengis.net/def/interpolation/OGC/1/ | | | | | nearest-neighbour (default) | | | | | - \http://www.opengis.net/def/interpolation/OGC/1/ | | | | | average | | | | | - \http://www.opengis.net/def/interpolation/OGC/1/ | | | | | bilinear | | | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | geotiff:compression [3]_ | The internal compression method used. One of: | LZW | O | | | | | | | | - None | | | | | - PackBits | | | | | - Huffman | | | | | - LZW | | | | | - JPEG | | | | | - Deflate | | | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | geotiff:jpeg_quality [3]_ | The quality of the JPEG compression when this compression | 75 | O | | | method is used. Must be an integer between 1 and 100. | | | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | geotiff:predictor [3]_ | The predictor method used for the Deflate or LZW | Horizontal | O | | | compression. One of: | | | | | | | | | | - None | | | | | - Horizontal | | | | | - FloatingPoint | | | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | geotiff:interleave [3]_ | Defines how the output image shall be interleaved. | Horizontal | O | | | One of: | | | | | | | | | | - Pixel | | | | | - Band | | | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | geotiff:tiling [3]_ | Defines whether or not the image shall be internally | true | O | | | tiled. Must be a boolean value (true/false). If this is | | | | | set to 'true', also a tilewidth and tileheight must be | | | | | specified. | | | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | geotiff:tilewidth [3]_ | Defines the width of the internal tiles. Must be an | 256 | O | | | integer and a multiple of 16. | | | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ | geotiff:tileheight [3]_ | Defines the height of the internal tiles. Must be an | 128 | O | | | integer and a multiple of 16. | | | +---------------------------+-----------------------------------------------------------+----------------------------------+--------------------------------+ .. [1] Version, acceptVersions: Support for EO-WCS is available only together with WCS version 2.0.1. .. [2] Interpolation: (Note: Resampling options other than NEAREST can dramatically slow down raster processing). The default (and fastest) is NEAREST. Replaces the target pixel with its NEAREST Neighbor. AVERAGE will compute the average pixel value of all pixels in the region of the disk file being mapped to the output pixel (or possibly just a sampling of them). Generally AVERAGE can be desirable for reducing noise in dramatically downsampled data, and can give something approximating anti-aliasing for black and white linework. BILINEAR will compute a linear interpolation of the four pixels around the target location. BILINEAR can be helpful when oversampling data to give a smooth appearance. .. [3] These parameters are only used in conjunction with GeoTIFF output. Thus the format parameter must be either 'image/tiff' or the "native" format of the coverage maps to GeoTIFF. The specificaiton of this encoding extension can be found `here `_