A Python package to simplify working with EarthCARE satellite data.
⚠️ Project Status: In Development
This project is still under active development. It is not yet feature-complete, and parts of the user documentation are missing or incomplete. Use at your own risk and expect breaking changes. Feedback and contributions are welcome!
- Documentation: https://tropos-rsd.github.io/earthcarekit/
- Source code: https://github.com/TROPOS-RSD/earthcarekit
- Examples: https://github.com/TROPOS-RSD/earthcarekit/tree/main/examples/notebooks
- Feature requests and bug reports: https://github.com/TROPOS-RSD/earthcarekit/issues
What is earthcarekit?
earthcarekit is an open-source Python package that provides comprehensive and flexible tools for downloading, reading, analysing and visualizing data from ESA (European Space Ageny) and JAXA's (Japan Aerospace Exploration Agency) joint satellite mission EarthCARE (Earth Cloud, Aerosol and Radiation Explorer, Wehr et al., 2023). The goal of this software is to support the diverse calibration/validation (cal/val) and scientific efforts related to the mission and provide easy-to-use functions for new EarthCARE data users.
You can find more info about the package, setup, and usage in the documentation.
Contact
The package is developed and maintained by Leonard König at Leibniz Institute for Tropospheric Research (TROPOS). For questions, suggestions, or bug reports, please create an issue or reach out via email.
Acknowledgments
The visual style of the along-track/vertical curtain plots was inspired by the exellent ectools repository by Shannon Mason (ECMWF), from which the colormap definitions for calipso and chiljet2 were adapted.
Citation
If you use this software in your work, please cite it. We recommend citing the specific version you are using, which you can select on Zenodo.
Alternatively, if you want to cite version-independent use:
@software{koenig_2025_earthcarekit,
author = {König, Leonard and
Floutsi, Athena Augusta and
Haarig, Moritz and
Baars, Holger and
Mason, Shannon and
Wandinger, Ulla},
title = {earthcarekit: A Python package to simplify working
with EarthCARE satellite data},
month = aug,
year = 2025,
publisher = {Zenodo},
doi = {10.5281/zenodo.16813294},
url = {https://doi.org/10.5281/zenodo.16813294},
}
or in text:
König, L., Floutsi, A. A., Haarig, M., Baars, H., Mason, S. & Wandinger, U. (2025). earthcarekit: A Python package to simplify working with EarthCARE satellite data. Zenodo. https://doi.org/10.5281/zenodo.16813294
License
This project is licensed under the Apache 2.0 License (see LICENSE file or opensource.org/license/apache-2-0). See also third-party licenses listed in the documentation.
References
- Wehr, T., Kubota, T., Tzeremes, G., Wallace, K., Nakatsuka, H., Ohno, Y., Koopman, R., Rusli, S., Kikuchi, M., Eisinger, M., Tanaka, T., Taga, M., Deghaye, P., Tomita, E., and Bernaerts, D.: The EarthCARE mission – science and system overview, Atmos. Meas. Tech., 16, 3581–3608, https://doi.org/10.5194/amt-16-3581-2023, 2023.
Metadata
Release files for earthcarekit 0.19.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| earthcarekit-0.19.0.tar.gz | 319.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| earthcarekit-0.19.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 795.9 kB
Release files / earthcarekit-0.19.0.tar.gz
| Download URL | earthcarekit-0.19.0.tar.gz |
|---|---|
| Size | 319.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
848f7d9b036bb962569e3cd5f20a99dc769a72a9193d1528ec4346e4748e1549
|
|
BLAKE2b-256 checksum How to use checksums |
38e6a6aa1b9715400fb58e711d5cee0c881661dda9719db9d8ef1ca142627fed
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 30, 2026.
Transparency logRelease files / earthcarekit-0.19.0-py3-none-any.whl
| Download URL | earthcarekit-0.19.0-py3-none-any.whl |
|---|---|
| Size | 476.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
80d978d6bca7ab6c8065b9750554ca14433c9d22bef52c6312dff871378eb960
|
|
BLAKE2b-256 checksum How to use checksums |
61d4e3152c70e684c0fdd1a9456b31d357aa596998467e6a700fd2d2db9f02a2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 30, 2026.
Transparency log