wcs.service

List all coverages, or get full information about a particular coverage from a WCS endpoint.

Attributes

DEFAULT_CONN_TIMEOUT	Default timeout to establish a connection to the WCS service: 10 seconds.
DEFAULT_READ_TIMEOUT	Default timeout to wait for a query to execute: 10 minutes.

Classes

WebCoverageService

Establish a connection to a WCS service, send requests and retrieve results.

Module Contents

DEFAULT_CONN_TIMEOUT = 10

Default timeout to establish a connection to the WCS service: 10 seconds.

DEFAULT_READ_TIMEOUT = 600

Default timeout to wait for a query to execute: 10 minutes.

class WebCoverageService(endpoint, username=None, password=None, conn_timeout=DEFAULT_CONN_TIMEOUT, read_timeout=DEFAULT_READ_TIMEOUT)

Establish a connection to a WCS service, send requests and retrieve results.

Parameters:

• endpoint (str) – the WCS server endpoint URL, e.g. https://ows.rasdaman.org/rasdaman/ows

• username (str) – optional username for basic authentication to the WCS server

• password (str) – optional password for basic authentication to the WCS server

• conn_timeout (int) – how long (seconds) to wait for the connection to be established

• read_timeout (int) – how long (seconds) to wait for the query to execute

Example usage:

service = WebCoverageService(
    "https://ows.rasdaman.org/rasdaman/ows")

coverages = service.list_coverages()
avg_land_temp = coverages['AvgLandTemp']

full_avg_land_temp = service.list_full_info('AvgLandTemp')

endpoint

auth = None

Map of coverage objects retreived from the endpoint, as (name, coverage) pairs.

conn_timeout = 10

read_timeout = 600

version = '2.1.0'

service = 'WCS'

list_coverages(only_local=False)

Retreives the available coverages from the WCS server with a GetCapabilities request.

Parameters:

only_local (bool) – list only local coverages, filtering out any remote coverages.

Returns:

a dict of (coverage name, wcs.model.BasicCoverage) pairs for each available coverage.

Raises:

WCSClientException – if resolving the GetCapabilities or parsing it fails.

Return type:

dict[str, wcs.model.BasicCoverage]

list_full_info(coverage_name)

Retrieve full information of coverage nacoverage_nameme with a DescribeCoverage request.

Parameters:

coverage_name – coverage name to lookup

Raises:

WCSClientException – if the coverage does not exist, or its DescribeCoverage document fails to parse.

Return type:

wcs.model.FullCoverage