geedim

Search, composite, and download Google Earth Engine imagery, without size limits.

Description

geedim provides a command line interface and API for searching, compositing and downloading satellite imagery from Google Earth Engine (EE). It optionally performs cloud/shadow masking, and cloud/shadow-free compositing on supported collections. Images and composites can be downloaded; or exported to Google Drive, Earth Engine asset or Google Cloud Storage. Images larger than the EE size limit are split and downloaded as separate tiles, then re-assembled into a single GeoTIFF.

Cloud/shadow support

Any EE imagery can be searched, composited and downloaded by geedim. Cloud/shadow masking, and cloud/shadow-free compositing are supported on the following collections:

EE name

Description

LANDSAT/LT04/C02/T1_L2

Landsat 4, collection 2, tier 1, level 2 surface

reflectance.

LANDSAT/LT05/C02/T1_L2

Landsat 5, collection 2, tier 1, level 2 surface

reflectance.

LANDSAT/LE07/C02/T1_L2

Landsat 7, collection 2, tier 1, level 2 surface

reflectance.

LANDSAT/LC08/C02/T1_L2

Landsat 8, collection 2, tier 1, level 2 surface

reflectance.

LANDSAT/LC09/C02/T1_L2

Landsat 9, collection 2, tier 1, level 2 surface

reflectance.

COPERNICUS/S2

Sentinel-2, level 1C, top of atmosphere reflectance.

COPERNICUS/S2_SR

Sentinel-2, level 2A, surface reflectance.

COPERNICUS/S2_HARMONIZED

Harmonised Sentinel-2, level 1C, top of atmosphere

reflectance.

COPERNICUS/S2_SR_HARMONIZED

Harmonised Sentinel-2, level 2A, surface reflectance.

Installation

Requirements

geedim is a python 3 package, and requires users to be registered with Google Earth Engine.

conda

Under Windows, using conda is the easiest way to resolve binary dependencies. The Miniconda installation provides a minimal conda.

conda install -c conda-forge geedim

pip

pip install geedim

Authentication

Following installation, Earth Engine should be authenticated:

earthengine authenticate

Contents