Skip to content

CubeXpress

A Python package for efficient processing of cubic Earth-observation (EO) data 🚀

PyPI License Tests

CubeXpress turns Google Earth Engine into a fast, scriptable source of analysis-ready imagery. Point it at a location, a list of locations, or a polygon, and it discovers the images, mosaics multi-tile scenes, scores them with your own cloud metric, and downloads them — handling GEE's size limits, rate limits, and large-scale runs for you.

Install

pip install cubexpress

You need a Google Earth Engine account. Run ee.Initialize(project="your-project-id") before using CubeXpress.

A first example

import ee
import cubexpress

ee.Initialize(project="your-project-id")

rt = cubexpress.point_to_rt(lon=-77.06, lat=-9.54, width=512, height=512, scale=10)

table = cubexpress.discover_images(
    "COPERNICUS/S2_HARMONIZED", rt, "2023-01-01", "2023-06-01",
)

cubexpress.express(table.select_bands("B4", "B3", "B2"), "s2_output")

Where to go next

  • API Reference — every public function, generated from the source.
  • How it works — concurrency, adaptive workers, and retiling.
  • GEE methods — why getPixels/computePixels beat Export.