Welcome! This repository provides guides, short how-tos, and tutorials to help users access and work with data from the Global Ecosystem Dynamics Investigation (GEDI) mission. In the interest of open science this repository has been made public but is still under active development. All Jupyter notebooks and scripts should be functional, however, changes or additions may be made. Contributions from all parties are welcome.
The Global Ecosystem Dynamics Investigation (GEDI) mission aims to characterize ecosystem structure and dynamics to enable radically improved quantification and understanding of the Earth's carbon cycle and biodiversity. GEDI Level 1 and Level 2 Data Products are distributed by the Land Processes Distributed Active Archive Center (LP DAAC) and Level 3 and Level 4 Data Products are distributed by the ORNL DAAC.
Search for and download GEDI Version 2 data products via a graphical user interface (GUI) using NASA EarthData Search or programmatically using NASA's Common Metadata Repository (CMR).
- GEDI L1B Geolocated Waveform Data Global Footprint Level - GEDI01_B.002
- GEDI L2A Elevation and Height Metrics Data Global Footprint Level - GEDI02_A.002
- GEDI L2B Canopy Cover and Vertical Profile Metrics Data Global Footprint Level - GEDI02_B.002
These granules below are used within the tutorials. Click/copy the URLs into a browser to download. Save them into the ./data/ folder within this repository. You will need a NASA Earth Data Search login to download the data used in this tutorial. You can create an account at the link provided.
- L1B Granule - https://e4ftl01.cr.usgs.gov/GEDI/GEDI01_B.002/2019.06.19/GEDI01_B_2019170155833_O02932_02_T02267_02_005_01_V002.h5
- L2A Granule - https://e4ftl01.cr.usgs.gov/GEDI/GEDI02_A.002/2019.06.19/GEDI02_A_2019170155833_O02932_02_T02267_02_003_01_V002.h5
- L2B Granule - https://e4ftl01.cr.usgs.gov/GEDI/GEDI02_B.002/2019.06.19/GEDI02_B_2019170155833_O02932_02_T02267_02_003_01_V002.h5
Instructions for setting up a compatible environment for working with GEDI data are linked to below.
Clone or download the GEDI-Data-Resources repository.
- Download
- To clone the repository, type
git clone https://github.com/nasa/GEDI-Data-Resources.gitin the command line.
Content in this repository is divided into Python and R tutorials/scripts. The tutorials walk you through workin with GEDI data step by step while the scripts are command line executables.
| Repository Contents | Summary | Path |
|---|---|---|
| GEDI_L1B_V2_Tutorial.ipynb | Jupyter Notebook tutorial demonstrating how to work with the Geolocated Waveform GEDI01_B.002 data product using Python | python\tutorials |
| GEDI_L2A_V2_Tutorial.ipynb | Jupyter Notebook tutorial demonstrating how to work with the Geolocated Waveform GEDI02_A.002 data product using Python | python\tutorials |
| GEDI_L2B_V2_Tutorial.ipynb | Jupyter Notebook tutorial demonstrating how to how to work with the Geolocated Waveform GEDI02_B.002 data product using Python | python\tutorials |
| GEDI_Finder_Tutorial_Python.ipynb | Jupyter Notebook tutorial demonstrating how to perform spatial [bounding box] queries for GEDI V2 L1B, L2A, and L2B data using NASA's CMR, and how to reformat the CMR response into a list of links that will allow users to download the intersecting GEDI V2 sub-orbit granules directly from the LP DAAC Data Pool using Python | python\tutorials |
| GEDI_Finder_Tutorial_R.Rmd | R Markdown tutorial demonstrating how to use R to perform spatial [bounding box] queries for GEDI V2 L1B, L2A, and L2B data using NASA's CMR, and how to reformat the CMR response into a list of links that will allow users to download the intersecting GEDI V2 sub-orbit granules directly from the LP DAAC Data Pool | R |
| GEDI_Finder.py | Command line executable performing spatial [bounding box] and temporal queries for GEDI V2 L1B, L2A, and L2B data using NASA's CMR and reformats the CMR response into a list of links that will allow users to download the intersecting GEDI V2 sub-orbit granules directly from the LP DAAC Data Pool. | python/scripts/GEDI_Finder |
| GEDI_Subsetter.py | Command line executable converting GEDI data products, stored in Hierarchical Data Format version 5 (HDF5, .h5) into GeoJSON files that can be loaded into GIS and Remote Sensing Software | python/scripts/GEDI_Subsetter |
- University of Maryland GEDI - Learn more about the GEDI Mission
- OpenAltimetry - Learn about GEDI coverage
- LP DAAC Website
- LP DAAC GitHub
- NASA Earthdata Search
Email: LPDAAC@usgs.gov
Voice: +1-866-573-3222
Organization: Land Processes Distributed Active Archive Center (LP DAAC)¹
Website: https://lpdaac.usgs.gov/
Date last modified: 06-08-2023
¹Work performed under USGS contract G15PD00467 for NASA contract NNG14HH33I.