icesat2db: A toolbox for Ice, Cloud, and land Elevation Satellite 2 (ICESat-2) ATL08 data
Project description
icesat2DB: A toolbox for Ice, Cloud, and land Elevation Satellite 2 (ICESat-2) ATL08 data
icesat2DB is an open-source Python package designed to streamline the processing, analysis, and management of ICESat-2 ATL08 data. This toolbox enables efficient and flexible data querying and management of large ICESat-2 datasets stored with TileDB, a high-performance, multi-dimensional array database.
icesat2DB integrates key functionalities such as structured data querying, multi-dimensional data processing, and metadata management. With built-in support for parallel engines (e.g. Dask), the toolbox ensures scalability for large datasets, allowing efficient parallel processing on local machines or clusters.
Key Features of icesat2DB
- TileDB-Based Storage: ICESat-2 data is stored and managed in TileDB arrays, providing efficient, scalable, multi-dimensional data storage, enabling fast and flexible access to large volumes of data.
- Flexible Data Querying: Easily query ICESat-2 data across spatial, temporal, and variable dimensions. Access data within bounding boxes, or retrieve the nearest shots to a specific location, using intuitive filtering options for precision.
- Parallel Processing: Process large ICESat-2 datasets in parallel, enabling concurrent downloading, processing, and TileDB insertion of ICESat-2 products. The number of concurrent processes can be easily controlled based on available system resources.
- Metadata-Driven: Maintain and manage metadata for each dataset, ensuring that important contextual information like units, descriptions, and source details are stored and accessible.
- Geospatial Data Management: Integrate seamlessly with TileDB to enable spatial queries, transformations, and geospatial analyses.
Why icesat2DB?
icesat2DB simplifies and automates the workflow for ICESat-2 data processing, making it easier to retrieve, filter, and analyze complex datasets in an efficient, scalable manner. Whether you're investigating biomass distribution, monitoring forest dynamics, or conducting large-scale ecological studies, icesat2DB supports users with tools to handle and analyze large ICESat-2 datasets with ease.
Installation
Install the latest release from PyPI:
pip install icesat2db
Or install from source:
git clone https://github.com/simonbesnard1/icesat2db.git
cd icesat2db
pip install -e .
For optional dependencies (visualization, I/O, etc.):
pip install "icesat2db[viz]" # matplotlib, cartopy, plotly, ...
pip install "icesat2db[io]" # zarr, rasterio, fsspec, ...
Requires Python >= 3.10.
See the examples/ folder for full notebooks on authentication, data processing, and building a regional TileDB database.
Documentation
Learn more about icesat2DB in its official documentation at https://icesat2db.readthedocs.io/en/latest/.
Contributing
You can find information about contributing to icesat2DB on our Contributing page.
About the authors
Felix Dombrowski is a Bachelor’s student in Computer Science at the University of Potsdam and a research intern in the Global Land Monitoring Group at GFZ Helmholtz Centre Potsdam. At GFZ, his work has focused on developing toolboxes to process Earth Observation data efficiently.
Simon Besnard, a senior researcher in the Global Land Monitoring Group at GFZ Helmholtz Centre Potsdam, studies terrestrial ecosystems' dynamics and their feedback on environmental conditions. He specializes in developing methods to analyze large EO and climate datasets to understand ecosystem functioning in a changing climate. His current research focuses on forest structure changes over the past decade and their links to the carbon cycle.
Mikhail Urbazaev is a Research Associate at the Helmholtz Centre for Geosciences (GFZ). His research focuses on the synergetic use of lidar, synthetic aperture radar, and optical remote sensing data for estimation of aboveground biomass and vegetation structural parameters across different biomes.
Amelia Holcomb is a Postdoc at the University of Maryland, researching remote sensing of tropical forest degradation and recovery. She completed her PhD in Computer Science at the University of Cambridge, where she studied remote sensing and machine learning for carbon sequestration and forest regrowth. Previously, she worked as a site reliability engineer at Google on Bigtable. She holds an MMath from the University of Waterloo and a B.A. in Mathematics from Yale.
Contact
For any questions or inquiries, please contact:
- Felix Dombrowski (felixd@gfz.de)
- Simon Besnard (besnard@gfz.de)
- Mikhail Urbazaev (urbazaev@gfz.de)
- Amelia Holcomb (amelia.holcomb@gmail.com)
Acknowledgments
The development of icesat2DB was supported by the European Union through the FORWARDS and NextGenCarbon projects, and by the Helmholtz Association via the Helmholtz Foundation Model Initiative (3D-ABC project). Amelia Holcomb acknowledges funding from the Harding Distinguished Postgraduate Scholarship.
License
This project is licensed under the EUROPEAN UNION PUBLIC LICENCE v.1.2 License - see the LICENSE file for details.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file icesat2db-2026.4.13.tar.gz.
File metadata
- Download URL: icesat2db-2026.4.13.tar.gz
- Upload date:
- Size: 3.9 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b1f0fc1c9beff3c96c0ba566323f48549fe6927da7302253bff57aeb831d0ce4
|
|
| MD5 |
2ec51d063320b8dda56c39b0b4feaa1c
|
|
| BLAKE2b-256 |
06f0e76338f90b059f15d87128e938c42a72ac0848db49edc755106b69dc6f8b
|
Provenance
The following attestation bundles were made for icesat2db-2026.4.13.tar.gz:
Publisher:
pypi-release.yaml on simonbesnard1/icesat2db
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
icesat2db-2026.4.13.tar.gz -
Subject digest:
b1f0fc1c9beff3c96c0ba566323f48549fe6927da7302253bff57aeb831d0ce4 - Sigstore transparency entry: 1283185867
- Sigstore integration time:
-
Permalink:
simonbesnard1/icesat2db@4bd8e8af297d3aee916604e8cafcd02d324f69be -
Branch / Tag:
refs/tags/v2026.04.13 - Owner: https://github.com/simonbesnard1
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
pypi-release.yaml@4bd8e8af297d3aee916604e8cafcd02d324f69be -
Trigger Event:
release
-
Statement type:
File details
Details for the file icesat2db-2026.4.13-py3-none-any.whl.
File metadata
- Download URL: icesat2db-2026.4.13-py3-none-any.whl
- Upload date:
- Size: 3.9 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c233d89814577ceb502ea2e36fa8cd29dc40d54a6428382d614f193cd6c88402
|
|
| MD5 |
2ddd6fc2a63642e8b119305ab044661c
|
|
| BLAKE2b-256 |
0523a11da23e0ab4543211ac8bf656242e446f429ede19bc4215fb462fcad83b
|
Provenance
The following attestation bundles were made for icesat2db-2026.4.13-py3-none-any.whl:
Publisher:
pypi-release.yaml on simonbesnard1/icesat2db
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
icesat2db-2026.4.13-py3-none-any.whl -
Subject digest:
c233d89814577ceb502ea2e36fa8cd29dc40d54a6428382d614f193cd6c88402 - Sigstore transparency entry: 1283185874
- Sigstore integration time:
-
Permalink:
simonbesnard1/icesat2db@4bd8e8af297d3aee916604e8cafcd02d324f69be -
Branch / Tag:
refs/tags/v2026.04.13 - Owner: https://github.com/simonbesnard1
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
pypi-release.yaml@4bd8e8af297d3aee916604e8cafcd02d324f69be -
Trigger Event:
release
-
Statement type: