Coverage stores are resources that provide access to raster data. The most common use case for coverage stores is to provide data for coverage layers. You can access this configuration level by clicking the coverage stores link in the service console. The corresponding resource configuration files are located in subdirectory datasources/coverage/ of the active deegree workspace directory.
For raster data there are three different possible configurations. One is for <Raster> and one is for <MultiResolutionRaster>. The third possibility is for <Pyramid>. If you are not sure which one to use, you probably want the <Raster> configuration.
The most common method to provide coverages with deegree, is to use Raster. With the Raster configuration it is possible to provide single RasterFiles or a complete RasterDirectory directly.
Here are two examples showing RasterFile and RasterDirectory configuration:
<Raster xmlns="http://www.deegree.org/datasource/coverage/raster" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.deegree.org/datasource/coverage/raster http://schemas.deegree.org/datasource/coverage/raster/3.0.0/raster.xsd" configVersion="3.0.0" originLocation="outer">
<StorageCRS>EPSG:26912</StorageCRS>
<RasterFile>../../../data/utah/raster/dem.tiff</RasterFile>
</Raster>
<Raster xmlns="http://www.deegree.org/datasource/coverage/raster" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.deegree.org/datasource/coverage/raster http://schemas.deegree.org/datasource/coverage/raster/3.0.0/raster.xsd" configVersion="3.0.0" originLocation="outer">
<StorageCRS>EPSG:26912</StorageCRS>
<RasterDirectory>../../../data/utah/raster/Satellite_Provo/</RasterDirectory>
</Raster>
A Raster can have several attributes:
A <MultiResolutionRaster> wraps single raster elements and adds a resolution for each raster. This means, depending on the resolution of the map a different raster source is used.
Here is an example for a MultiResolutionRaster:
<MultiResolutionRaster xmlns="http://www.deegree.org/datasource/coverage/raster" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.deegree.org/datasource/coverage/raster http://schemas.deegree.org/datasource/coverage/raster/3.0.0/raster.xsd" configVersion="3.0.0" originLocation="outer">
<StorageCRS>EPSG:26912</StorageCRS>
<Resolution>
<Raster configVersion="3.0.0" originLocation="outer" res="1.0">
<StorageCRS>EPSG:26912</StorageCRS>
<RasterFile>../../../data/utah/raster/dem.tiff</RasterFile>
</Raster>
</Resolution>
<Resolution>
<Raster configVersion="3.0.0" res="2.0">
<StorageCRS>EPSG:26912</StorageCRS>
<RasterDirectory>../../../data/utah/raster/Satellite_Provo/</RasterDirectory>
</Raster>
</Resolution>
</MultiResolutionRaster>
A <Pyramid> is used for deegree’s support for raster pyramids. For this, it is required that the raster pyramid must be a GeoTIFF, containing the extent and coordinate system of the data. Overlays must be multiples of 2. This is best tested with source data being processed with GDAL.
The following example shows, how to configure a coverage pyramid:
<Pyramid xmlns="http://www.deegree.org/datasource/coverage/pyramid" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.deegree.org/datasource/coverage/pyramid http://schemas.deegree.org/datasource/coverage/raster/3.1.0/pyramid.xsd" configVersion="3.1.0">
<PyramidFile>data/example.tif</PyramidFile>
<CRS>EPSG:4326</CRS>
</Pyramid>