This article is organized as follow (3 min read):

Context

MOTU Service is a Web Server allowing to handles and extract oceanographic huge volumes of data, creating the connection between heterogeneous Data Providers and End Users.

You can remotely subset and download Copernicus Marine Products hosted on MOTU server via two options :

  1. MOTU Client API (for End-User)

  2. MOTU REST API (for Developers)

MOTU Client API

motu-client-to-retrieve-only-the-needed-data

MOTU Client (also known as motuclient) is a multiplatform and easy-to-use Command Line Interface (CLI). It enables interaction between a Copernicus Marine user and the MOTU HTTP server via script, exposing the following feature:

  • get information about a dataset

  • get the size of an extraction with geospatial, temporal and variables criteria

  • extract a subset of data, along its dimensions (time and space) and variables criteria

It can be launched under different environments and integrated into a processing chain.

The processing chain can be written in any computer programming languages (R, Matlab, Fortran, Java, bash, ...).

Requirements

  • Python
    With version 2.7.9+ or 3.4+. To check it, input in your command prompt:

python --version

Copernicus Pro Tips: If Python is not yet installed on your machine or if the version does not match with the requirements, we recommend you install Anaconda.

  • MOTU Client
    To install the client as a package on your machine, input in your command prompt:

python -m pip install motuclient==1.8.4 --no-cache-dir

Copernicus Pro Tips: The motuclient being developed by a third-party, there might be issues in some versions that we do not control. The version to be used, tested and approved by our team, is 1.8.4.

MOTU REST API

motu-rest-api-for-developers

It lets developers use MOTU server services with any package that retrieves binary information over HTTP or HTTPS protocols, such as like cURL or Wget, but also Python requests module, R httr package etc...

All URLs have always the same pattern:

http://${motuServer}/${context}/Motu?action=${actionName}

The third-party documentation is available on GitHub.

Copernicus Pro Tips: In our HelpCenter section for developers, examples of HTTPs requests dealing with cookies authentication and MOTU API have been published.

What's next?

The following articles might be interesting to learn how use the motuclient python module :


For any further question, feel free to contact us:

  • through a chat session available in the bottom right corner of the page

  • via our contact webpage

  • via e-mail to our support team (servicedesk.cmemsATmercator-ocean.eu)

Did this answer your question?