Run BPS on your own computer#

This tutorial walks through installing and running the BIOMASS Processing Suite (BPS) locally, on your own Linux or macOS workstation, from L1 framing through to L2A biomass estimation.

The companion scripts, notebooks, JobOrder templates and configuration files live in this same folder: docs/tutorials/run-bps-locally/. They are adapted from BioPAL/MAAP_BPS_scripts and ship with <BPS_ROOT> placeholders so you can drop them straight into your local filesystem.

By the end of this tutorial you will have:

  • BPS installed on your workstation (one of three install paths below)

  • A full Tomographic stack (7 repeat passes) downloaded from the ESA catalogue

  • The complete processing chain executed locally: L1F → L1 → STA → L2A

Audience

Scientific users and developers who want to run BPS on their own hardware (laptop or workstation) rather than on a cloud platform. Basic familiarity with conda and a Linux/macOS terminal is assumed.

Need a cloud environment instead?

ESA provides BPS pre-installable on the ESA MAAP platform. The MAAP_BPS_scripts README walks through that setup end-to-end.

MAAP access eligibility

MAAP is available only to users who are nationals of an ESA Member State or of a State that contributes to ESA programmes and participates in the MAAP platform. If you are not eligible, use the local install paths below instead.

Choose an install path#

Who it’s for: scientific users who want a working BPS without modifying processor code.

Installs all 14 processors at once from the Aresys-distributed conda bundle. See Install BPS from the bundle.

Who it’s for: contributors who want to modify Python processor code and test changes without rebuilding the bundle.

Installs the Python processors from this repository in editable mode (pip install -e .), plus only the native binary packages from the bundle. See Install BPS from source.

A fully source-based install is not possible because the native binaries (bps-l1_binaries, bps-stack_binaries, libl1framing.so) are not in the public repository. They are delivered via the Aresys bundle.

Who it’s for: users who don’t want to install anything locally.

Eligibility required

MAAP access is limited to nationals of ESA Member States and of States that contribute to ESA programmes and participate in MAAP. Users from non-participating countries should choose path A or B above.

ESA provides BPS pre-installable on the ESA MAAP platform. Follow the MAAP_BPS_scripts README instead of this tutorial.