openEO by TiTiler

TiTiler backend for openEO

Overview

titiler-openeo is a TiTiler backend implementation for openEO developed by and .

The main goal of this project is to provide a light and fast backend for openEO services and processes using the TiTiler engine. This simplicity comes with some specific implementation choices like the type of data managed by the backend. It is focused on image raster data that can be processed on-the-fly and served as tiles or as light dynamic raw data. A concept note is available here to describe in more detail the implementation choices.

The application provides with a minimal openEO API (L1A and L1C).

Features

• STAC API integration with external STAC services
• Synchronous processing capabilities
• Various output formats (e.g., JPEG, PNG)
• Multiple supported processes
• Dynamic tiling services
• FastAPI-based application
• Middleware for CORS, compression, and caching
• Enhanced RasterStack data model with temporal dimension support
• LazyRasterStack implementation with concurrent execution and intelligent caching

Installation

uv is the recommended way to install the project's runtime dependencies:

uv sync

Usage

Once dependencies are installed, copy one of the sample environment files (e.g. .env.eoapi) and start the API:

cp .env.eoapi .env
export $(cat .env | xargs)
uvicorn titiler.openeo.main:app --host 0.0.0.0 --port 8081

Configuration

Configuration settings can be provided via environment variables. The following settings are available:

• TITILER_OPENEO_STAC_API_URL: URL of the STAC API with the collections to be used
• TITILER_OPENEO_STORE_URL: URL of the openEO service/UDP store json file

In this repository, 2 .env sample files are provided:

• .env.eoapi that uses the Earth Observation API (EOAPI).

  TITILER_OPENEO_STAC_API_URL="https://stac.eoapi.dev"
  TITILER_OPENEO_STORE_URL="services/eoapi.json"

• .env.cdse that uses the Copernicus Data Space Ecosystem (CDSE)

  TITILER_OPENEO_STAC_API_URL="https://stac.dataspace.copernicus.eu/v1"
  TITILER_OPENEO_STORE_URL="services/copernicus.json"

  In order to access asset object store and to retrieve data efficiently, it requires to set additional environment variables:

  AWS_S3_ENDPOINT=eodata.dataspace.copernicus.eu # CDSE S3 endpoint URL
  AWS_ACCESS_KEY_ID=<your_access_key> # S3 access key
  AWS_SECRET_ACCESS_KEY=<your_secret_key> # S3 secret key
  AWS_VIRTUAL_HOSTING=FALSE # Disable virtual hosting
  CPL_VSIL_CURL_CACHE_SIZE=200000000 # Global LRU cache size
  GDAL_HTTP_MULTIPLEX=TRUE # Enable HTTP multiplexing
  GDAL_CACHEMAX=500 # Set GDAL cache size
  GDAL_INGESTED_BYTES_AT_OPEN=50000 # Open a larger bytes range when reading
  GDAL_HTTP_MERGE_CONSECUTIVE_RANGES=YES # Merge consecutive ranges
  VSI_CACHE_SIZE=5000000 # Set VSI cache size
  VSI_CACHE=TRUE # Enable VSI cache

visit 'Access to EO data via S3' for information on how to access the Copernicus Data Space Ecosystem (CDSE) data via S3.

Contributing

See CONTRIBUTING.md for development setup, testing, and documentation workflows.

License

See LICENSE

Authors

Created by Development Seed and Sinergise.

See contributors for a listing of individual contributors.

Changes

See CHANGES.md.