Skip to main content

Client API for openEO

Project description

PyPI - Python Version Status Lint Tests PyPI Conda (channel only)

openEO Python Client

Python Client Library for the openEO API. Allows you to interact with openEO backends from your own (local) Python environment.

openEO Python Client Library docs

Usage example

A simple example, to give a feel of using this library:

import openeo

# Connect to openEO back-end.
connection = openeo.connect("openeo.vito.be").authenticate_oidc()

# Load data cube from TERRASCOPE_S2_NDVI_V2 collection.
cube = connection.load_collection(
    "TERRASCOPE_S2_NDVI_V2",
    spatial_extent={"west": 5.05, "south": 51.21, "east": 5.1, "north": 51.23},
    temporal_extent=["2022-05-01", "2022-05-30"],
    bands=["NDVI_10M"],
)
# Rescale digital number to physical values and take temporal maximum.
cube = cube.apply(lambda x: 0.004 * x - 0.08).max_time()

cube.download("ndvi-max.tiff")

Example result

See the openEO Python Client Library documentation for more details, examples and in-depth discussion.

Installation

As always, it is recommended to work in some kind of virtual environment (using venv, virtualenv, conda, docker, ...) to install the openeo package and its dependencies:

pip install openeo

See the installation docs for more information, extras and alternatives.

General openEO background and links

Contributions and funding

The authors acknowledge the financial support for the development of this package during the H2020 project "openEO" (Oct 2017 to Sept 2020) by the European Union, funded by call EO-2-2017: EO Big Data Shift, under grant number 776242. We also acknowledge the financial support received from ESA for the project "openEO Platform" (Sept 2020 to Sept 2023).

This package received major contributions from the following organizations:

VITO Remote Sensing logoWWU Münster logoEurac Research logoTU Wien Logo

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

openeo-0.43.0-py3-none-any.whl (315.8 kB view details)

Uploaded Python 3

File details

Details for the file openeo-0.43.0-py3-none-any.whl.

File metadata

  • Download URL: openeo-0.43.0-py3-none-any.whl
  • Upload date:
  • Size: 315.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.4

File hashes

Hashes for openeo-0.43.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2f437e201f81d54d882a00c2273804c3c1f978452bdbe8d52e4ecf9c971e2a91
MD5 393f6435f13e199709460cedad61c7cb
BLAKE2b-256 183bf272a31b9a730b960b14b4360d8c33d48759848710a7bb90b6fc3446ec92

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page