The WCS Transaction extension (WCS-T) defines a standard way of inserting, deleting and updating coverages via a set of web requests. This guide describes the request types that WCS-T introduces and shows the steps necessary to import coverage data into a rasdaman server, data which is then available in the server's WCS offerings.
Supported coverage data format
Currently, WCS-T supports coverages in GML format for importing. The metadata of the coverge is thus explicitly specified, while the raw cell values can be stored either explicitly in the GML body, or in an external file linked in the GML body, as shown in the examples below. The format of the file storing the cell values must be one supported by the GDAL library (http://www.gdal.org/formats_list.html), such as TIFF / GeoTIFF, JPEG, JPEG2000, PNG etc.
Inserting a new coverage into the server's WCS offerings is done using the InsertCoverage request.
|version||2.0.1 or later||Yes|
|inputCoverageRef||a valid url.||Url pointing to the GML coverage to be inserted.||One of inputCoverageRef or inputCoverage is required|
|inputCoverage||a coverage in GML format||The coverage to be inserted, in GML format.||One of inputCoverageRef or inputCoverage is required|
|useId||new or existing||Indicates wheter to use the coverage id from the coverage body, or tells the server to generate a new one.||No|
Vendor specific parameters:
|pixelDataType||any GDAL supported data type||In cases where cell values are given in the GML body, the datatype can be indicated through this parameter. If omitted, it defaults to Byte.||No|
|tiling||same as rasdaman tiling clause (wiki:Tiling)||Indicates the tiling of the array holding the cell values.||No|
The response of a successful coverage request is the coverage id of the newly inserted coverage.
The following example shows how to insert the coverage available at: http://schemas.opengis.net/gmlcov/1.0/examples/exampleRectifiedGridCoverage-1.xml. The tuple list is given in the GML body.
The following example shows how to insert a coverage stored on the server on which rasdaman runs. The cell values are stored in a TIFF file (attachment:myCov.gml), the coverage id is generated by the server and aligned tiling is used for the array storing the cell values.
http://localhost:8080/rasdaman/ows?service=WCS&version=2.0.1&request=InsertCoverage&coverageRef=file:///etc/data/myCov.gml&useId=new&tiling=aligned [0:500, 0:500]
Coming soon: the same operation, but via a POST XML request to http://localhost:8080/rasdaman/ows:
<?xml version="1.0" encoding="UTF-8"?> <wcs:InsertCoverage xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:wcs="http://www.opengis.net/wcs/2.0" xmlns:gml="http://www.opengis.net/gml/3.2" xsi:schemaLocation="http://schemas.opengis.net/wcs/2.0 ../wcsAll.xsd" service="WCS" version="2.0.1"> <wcs:coverage>here goes the contents of myCov.gml</wcs:coverage> <wcs:useId> new </wcs:useId> </wcs:InsertCoverage>