Coverage
- class wtss.coverage.Coverage(service, metadata=None)
A class that describes a coverage in WTSS.
Note
For more information about coverage definition, please, refer to WTSS specification.
- __init__(service, metadata=None)
Create a coverage object associated to a WTSS client.
- Parameters:
service (wtss.wtss.WTSS) – The client to be used by the coverage object.
metadata (dict) – The coverage metadata.
- property attributes
Return the list of coverage attributes.
- property crs
Return the coordinate reference system metadata.
- property description
Return the coverage description.
- property dimensions
Return the coverage dimensions metadata.
- property name
Return the coverage name.
- property spatial_extent
Return the coverage spatial extent.
- property spatial_resolution
Return the coverage spatial resolution metadata.
- property timeline
Return the coverage timeline.
- ts(**options)
Retrieve the time series for a given location and time interval.
- Keyword Arguments:
attributes (optional) – A string with attribute names separated by commas, or any sequence of strings. If omitted, the values for all coverage attributes are retrieved.
longitude (int/float) – A longitude value according to EPSG:4326.
latitude (int/float) – A latitude value according to EPSG:4326.
start_date (
str
, optional) – The begin of a time interval.end_date (
str
, optional) – The begin of a time interval.
- Returns:
A time series object as a dictionary.
- Return type:
- Raises:
HTTPError – If the server response indicates an error.
ValueError – If the response body is not a json document.
ImportError – If Maptplotlib or Numpy can no be imported.
Example
Retrieves a time series for MODIS13Q1 data product:
>>> from wtss import * >>> service = WTSS(WTSS_EXAMPLE_URL) >>> coverage = service['MOD13Q1'] >>> ts = coverage.ts(attributes=('red', 'nir'), ... latitude=-12.0, longitude=-54.0, ... start_date='2001-01-01', end_date='2001-12-31') ... >>> ts.red [236.0, 289.0, ..., 494.0, 1349.0]