sos4py 0.2.0

sos4py is a convenience layer for Python environment to access services from SOS instances.

sos4py

sos4py is a convenience layer for Python environment to access services, extract data, and allow querying from SOS instances.

• Free software: Apache Software License 2.0

Features

• Allows connection to an SOS service using OWSLib.

• Explore and summarize service capabilities, sensor metadata, offerings, observed properties, and available phenomena.

• Query requests to an SOS service for Get Data Availability.

• Query requests to an SOS service for Get Feature of Interest.

Usage

EXAMPLES OF THE PACKAGE CAN BE SEEN:: https://github.com/52North/sos4py/tree/master/examples

Connecting to an SOS service:

Description

Base class of a connection to a Sensor Observation Service. The result is class object SensorObservationService_2_0_0(object) of the OWSLib (<https://github.com/geopython/OWSLib/blob/master/owslib/swe/observation/sos200.py>)

Usage

def connection_sos(url, xml=None, username=None, password=None,):

Parameters

xmlstr

Xml file path.

usernamestr

Username to access the SOS service.

passwordstr

User password to access the SOS service.

Example

from sos4py.main import connection_sos

service = sos4py('http://sensorweb.demo.52north.org/52n-sos-webapp/sos/kvp')

Get capabilities functions (summaries):

Description

Construction class sos_2_0_0. Implements the the return of the function connection_sos() as input. The methods of the class can be used for metadata retrieval of sensors, and observation data queries.

Usage

class sos_2_0_0(self, url, version, xml=None, username=None, password=None):

Methods

sosServiceIdentification() The identification section of a SOS v2.0 capabilities document. This function queries the identification metadata available and returns the data as a pandas Series dataframe.

sosProvider() The provider section of an SOS v2.0 capabilities document. This function queries the provider metadata available and returns the data as a pandas Series dataframe.

sosOperationsMetadata() Elements in an OperationsMetadata object.This function queries the operations available of a SOS v2.0 capabilities document and returns the data as a pandas Series dataframe.

sosOfferings() Explore offerings section of an SOS v2.0 capabilities document. This function queries the offerings and returns the data as a pandas Series dataframe.

sosPhenomena() Queries a SOS v2.0 for all its phenomena. Returns a list of the phenomena ids.

Examples

from sos4py.main import connection_sos

service = connection_sos('http://sensorweb.demo.52north.org/52n-sos-webapp/sos/kvp')

service.sosServiceIdentification()

service.sosProvider()

service.sosOperationsMetadata()

service.sosOfferings()

service.phenomena()

Get Data Availability function:

Description

Base class of a connection to a Sensor Observation Service. The result is class object SensorObservationService_2_0_0(object) of the OWSLib (<https://github.com/geopython/OWSLib/blob/master/owslib/swe/observation/sos200.py>)

Usage

def get_data_availability(object, procedures=None, observedProperties=None, featuresOfInterest=None, offerings=None, method=None, **kwargs)

Parameters

objectstr

Xml file path.

procedureslist of str

Query the data based on the availability of the indicated procedures.

observedProperties: list of str

Query the data based on the availability of the indicated observed properties.

featuresOfInterestlist of str

Query the data based on the availability of the indicated features of interest.

offeringslist of str

Query the data based on the availability of the indicated offerings.

methodstr

‘Get’ or ‘Post’ request parameter.

Examples

service.get_data_availability()

service.get_data_availability(procedures=['http://www.52north.org/test/procedure/6'], featuresOfInterest=['http://www.52north.org/test/featureOfInterest/6'])

Get Feature of Interest function:

Description

Method to retrieve feature(s) of interest from an SOS. The result is <class ‘bytes’>.

Usage

def get_feature_of_interest(self, responseFormat=None, featureOfInterest=None, method=None, **kwargs)

Parameters

responseFormatstr

Xml schema path.

featureOfIntereststr

Query the data only for a specific feature of interest.

methodstr

‘Get’ or ‘Post’ request parameter.

Examples

service.get_feature_of_interest()

service.get_feature_of_interest(featureOfInterest='foi_name')

from owslib.etree import etree

from sos4py.main import connection_sos

from sos4py.sos_2_0_0 import SOSGetFeatureOfInterestResponse

service = connection_sos("https://fluggs.wupperverband.de/sos2/service")

response = service.get_feature_of_interest()

xml_tree = etree.fromstring(response)

parsed_response = SOSGetFeatureOfInterestResponse(xml_tree)

name = parsed_response.features[0].name

geometry = parsed_response.features[0].get_geometry()

Credits

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.

History

0.1.0 (2020-05-09)

• First release on PyPI.

0.2.0 (2020-08-20)

• Add method get_feature_of_interest()

• Add example for accessing and plotting sensor data