Client libraries provide quick, easy and consistent access to Oceans 2.0 API, in popular scientific programming languages.
These libraries provide a class with methods that wrap web service calls, complex workflows, and business logic so that users can discover and download data (raw, text, image, audio, video or any other available) in a single line of code.
They are all free projects, published under Open Source licenses:
Language | Latest library version | Repository | License | |
---|---|---|---|---|
Python | 2.3.5 (12/12/2019) | PyPI | Apache 2 | |
MATLAB |
| File Exchange | BSD 2 | |
R |
| Github | MIT |
If this is your first time using these client libraries, we suggest you visit the Installation and Getting started pages.
Methods summary
Search for available locations, deployments, device categories, devices, properties, and data products.
Method | Description |
---|---|
| Returns a filtered list of locations |
| Returns a filtered tree of locations with their children |
| Returns a filtered list of deployments |
| Returns a filtered list of device categories |
| Returns a filtered list of devices |
| Returns a filtered list of properties |
| Returns a filtered list of data products |
Data product download methods
Order the generation and download of more than 120 different types of ONC data products, with your own configuration.
Method | Description |
---|---|
| Request, run and download a data product |
| Request a data product |
| Run a data product request |
| Download an available data product |
Near real-time data access methods
Extract sensor data as time-series, either as processed scalar data or as raw data directly from the device.
Method | Description |
---|---|
| Obtain scalar data readings from a device category in a location |
getDirectByDevice (filters, allPages) | Obtain scalar data readings from a device |
| Obtain raw data readings from a device category in a location |
| Obtain raw data readings from a device |
Archive file download methods
Download previously generated data product files from our archive.
Method | Description |
---|---|
| Get a list of archived files for a device category in a location |
| Get a list of archived files for a device |
| Download a file with the given filename |
getDirectFiles (filters, overwrite, allPages) | Download a list of archived files that match the filters provided |
Utility methods
Methods included as convenience shortcuts for end users.
Method | Description |
---|---|
| Prints collections in a format easier to read |
| Formats the provided date string to meet ISO8601 |
The latest library version works with the current version of Oceans 2.0 Web API.
New versions are created to resolve known client library issues, add new functionality or handle changes to the underlying Web Services.
Please report all issues with the web services, documentation and client libraries to the Oceans 2.0 Help Centre.