Skip to main content

GEDI Tools Library

This library is currently experimental and is under heavy development.

Overview

GEDI Tools is a Python library designed to facilitate the transformation and processing of GEDI (Global Ecosystem Dynamics Investigation) data. It is especially geared towards converting GEDI data in HDF5 format to L2B objects for easier manipulation and analysis.

Features

  • Single File Transformation: Convert a single HDF5 file to L2B format with ease.
  • Batch File Transformation: Efficiently convert a list of HDF5 files to L2B format.
  • Data Clipping: Optionally clip data using a GeoDataFrame.

Installation

To install the GEDI Tools library, run:

pip install gedi-tools

Usage

Single File Transformation

Here's a simple example to transform a single HDF5 file to L2B format:

from gedi_tools import GediTransformer

l2b_single = GediTransformer.hd5_to_l2b("path/to/hd5_file.hd5")

Multiple File Transformation with Clipping

Transform multiple HDF5 files and clip data using a GeoDataFrame:

from gedi_tools import GediTransformer

clip_gdf = ...  # Your GeoDataFrame for clipping
l2b_multiple = GediTransformer.hd5_list_to_l2b(["path1.hd5", "path2.hd5"], clip_gdf=clip_gdf)

Documentation

For more details, please refer to the Full Documentation.

Contributing

We welcome contributions! Please see the Contributing Guidelines.

License

This project is licensed under the MIT License - see the LICENSE.md file for details.

Metadata

Release files for gedi-tools 0.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gedi-tools 0.0.3
File Size Uploaded Provenance Actions
gedi_tools-0.0.3.tar.gz 15.5 kB Without provenance Details for gedi_tools-0.0.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for gedi-tools 0.0.3
File Interpreter ABI Platform Actions
gedi_tools-0.0.3-py3-none-any.whl Python 3 none any Details for gedi_tools-0.0.3-py3-none-any.whl

Total release size: 31.2 kB

Release files / gedi_tools-0.0.3.tar.gz

Download URL gedi_tools-0.0.3.tar.gz
Size 15.5 kB
Tags Source
SHA-256 checksum
How to use checksums
57847ed4b2363e1581b6008c07be2b89d0c2831534b3e74366c5f107186d0f99
BLAKE2b-256 checksum
How to use checksums
cec74dcf33a89f28c73bb8d69c75475eb7c06bd97e1d47cbb7692b2a5338aed4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.11.3

Release files / gedi_tools-0.0.3-py3-none-any.whl

Download URL gedi_tools-0.0.3-py3-none-any.whl
Size 15.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
bf8b679c94cbb4795310473ff4d465d05b0cf3a31d268a133b6b843ff50e2a22
BLAKE2b-256 checksum
How to use checksums
b39ab2d6936cc6300e28adca6d9a8a38542d21ed4bfc6930d0ee3e4441573662
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.11.3

Security for gedi-tools 0.0.3

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page