earthcare-downloader 1.8.1

Download EarthCARE satellite data

earthcare-downloader

A Python tool for searching and downloading EarthCARE satellite data from the European Space Agency’s (ESA) Online Dissemination services.

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(s) to download (see full list below).
--start	Start date (YYYY-MM-DD).
--stop	Stop date (YYYY-MM-DD).
-d, --date	Single date (YYYY-MM-DD). Overrides --start and --stop
--orbit-min	Minimum orbit number.
--orbit-max	Maximum orbit number.
--orbit	Single orbit number. Overrides --orbit-min and --orbit-max
--lat LAT	Latitude of the target location (-90..90 degrees).
--lon LON	Longitude of the target location (-180..180 degrees).
-r, --radius	Search radius around the location in km. Use with --lat and --lon.
-o, --output-path	Directory to save downloaded files (default: current directory).
--by-product	Create subdirectories for each product type.
--max-workers	Maximum number of concurrent downloads (default: 5).
--show	Show filenames before downloading.
--unzip	Automatically unzip downloaded files.
--quiet	Hide progress bars during download.
--no-prompt	Skip confirmation prompt before downloading.
--all	Download all versions of the file. By default download only the newest version.
-h, --help	Show help message and exit.

Available products:

Level 1	Product Code	Description
	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_AER_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
:japanese_castle:	ATL_CLA_2A	ATLID Cloud and Aerosol Classification
:japanese_castle:	CPR_CLP_2A	CPR Cloud Properties
:japanese_castle:	CPR_ECO_2A	CPR Echo Characteristics
:japanese_castle:	MSI_CLP_2A	MSI Cloud 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
:japanese_castle:	AC__CLP_2B	CPR-ATLID Synergy Cloud Properties
Orbit Data
	AUX_ORBPRE	Orbit Predictions
	MPL_ORBSCT	Orbit Scenario

:japanese_castle: = JAXA product

Examples

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

earthcare-downloader -p CPR_TC__2A --lat 61.844 --lon 24.287 -r 5

Download all ATL_ALD_2A and AUX_JSG_1D data from two days:

earthcare-downloader -p ATL_ALD_2A,AUX_JSG_1D --start=2025-05-01 --stop=2025-05-02

:snake: Python API

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

from earthcare_downloader import search, download

files = search(product="CPR_TC__2A", date="2025-01-01")
paths = download(files, unzip=True)

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

from earthcare_downloader.aio import search, download

files = await search(product="CPR_TC__2A", date="2025-01-01")
paths = await download(files, unzip=True)

Disclaimer

This package provides tools to access data from the European Space Agency’s (ESA) Online Dissemination services. The package does not host or redistribute ESA data.

All data are © European Space Agency (ESA) and subject to the ESA Online Dissemination Terms and Conditions. Please ensure your use complies with ESA’s non-commercial and attribution requirements.

License

MIT