earthcare-downloader 1.2.0

Download EarthCARE satellite data

earthcare-downloader

A Python tool for downloading EarthCARE satellite data

Installation

python3 -m pip install earthcare-downloader

:penguin: CLI usage

Authentication

Store your ESA EO Sign In credentials in the environment variables ESA_EO_USERNAME and ESA_EO_PASSWORD. If these variables are not set, the program will prompt you to enter your credentials.

Running the program

earthcare-downloader -p PRODUCT [options]

where the arguments are:

Argument	Description
-p, --product	Product type to download (see full list below).
--lat LAT	Latitude of the target location.
--lon LON	Longitude of the target location.
-d, --distance	Search radius around the location in km. Use with --lat and --lon.
--start	Start date (YYYY-MM-DD).
--stop	Stop date (YYYY-MM-DD).
--orbit-min	Minimum orbit number.
--orbit-max	Maximum orbit number.
-o, --output-path	Directory to save downloaded files (default: current directory).
--max-workers	Maximum number of concurrent downloads (default: 5).
--show	Show filenames before downloading.
--unzip	Automatically unzip downloaded files (keeps only .h5 files).
--quiet	Hide progress bars during download.
--no-prompt	Skip confirmation prompt before downloading.
-h, --help	Show help message and exit.

Available products:

Level	Product Code	Description
Level 1	ATL_NOM_1B	ATLID Nominal Mode
	AUX_JSG_1D	Auxiliary Joint Standard Grid
	BBR_NOM_1B	Broadband Radiometer Nominal Mode
	BBR_SNG_1B	Broadband Radiometer Single View
	CPR_NOM_1B	Cloud Profiling Radar Nominal Mode
	MSI_NOM_1B	Multi-Spectral Imager Nominal Mode
	MSI_RGR_1C	Multi-Spectral Imager Re-Gridded
Level 2A	ATL_ARE_2A	ATLID Aerosol Parameters
	ATL_ALD_2A	ATLID Aerosol Layer Descriptors
	ATL_CTH_2A	ATLID Cloud Top Height
	ATL_EBD_2A	ATLID Extinction, Backscatter and Depolarization
	ATL_FM__2A	ATLID Feature Mask
	ATL_ICE_2A	ATLID Ice Parameters
	ATL_TC__2A	ATLID Target Classification
	CPR_CD__2A	CPR Cloud Doppler parameters
	CPR_CLD_2A	CPR Cloud Parameters
	CPR_FMR_2A	CPR Feature Mask and Radar Reflectivity
	CPR_TC__2A	CPR Target Classification
	MSI_AOT_2A	MSI Aerosol Optical Thickness
	MSI_CM__2A	MSI Cloud Mask
	MSI_COP_2A	MSI Cloud Optical Properties
Level 2B	AC__TC__2B	ATLID-CPR Target Classification
	AM__ACD_2B	ATLID-MSI Aerosol Column Descriptors
	AM__CTH_2B	ATLID-MSI Cloud Top Height
	BM__RAD_2B	BBR-MSI Radiative Fluxes and Heating Rates

Examples

Download all CPR_TC__2A overpass data within 5 km of Hyytiälä, Finland:

earthcare-downloader --lat 61.844 --lon 24.287 --distance 5 --product CPR_TC__2A

:snake: Python API

You can also use earthcare-downloader as a Python library:

from earthcare_downloader import search, download

urls = search(product="CPR_TC__2A", start="2025-01-01", stop="2025-01-02")
paths = download(urls, output_path="data/", unzip=True)

When working in notebooks, use the asynchronous versions of these functions:

from earthcare_downloader.aio import search, download

urls = await search(product="CPR_TC__2A", start="2025-01-01", stop="2025-01-02")
paths = await download(urls, output_path="data/", unzip=True)

License

MIT