/GEDI-Data-Resources

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.

Primary LanguageJupyter NotebookApache License 2.0Apache-2.0

GEDI-Data-Resources

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. All Jupyter notebooks and scripts should be functional, however, changes or additions may be made. Contributions from all parties are welcome.


GEDI Background

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), earthaccess python package, or Harmony API.


  • 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

Prerequisites/Setup Instructions

Environment Setup

Instructions for setting up a compatible environment for working with GEDI data are linked to below.


Getting Started

Clone or download the GEDI-Data-Resources repository.

  • Download
  • To clone the repository, type git clone https://github.com/nasa/GEDI-Data-Resources.git in the command line.

Repository Contents

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.

Name Type Summary Services and Tools
GEDI_L1B_V2_Tutorial.ipynb Jupyter Notebook Tutorial demonstrating how to work with the Geolocated Waveform GEDI01_B.002 data product using Python
GEDI_L2A_V2_Tutorial.ipynb Jupyter Notebook Tutorial demonstrating how to work with the Geolocated Waveform GEDI02_A.002 data product using Python
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
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 using Python CMR API
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 CMR API
GEDI_Finder.py Command line executable Script 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 CMR API
GEDI_Subsetter.py Command line executable Script 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
how-to-find-and-access-GEDI-data_earthaccess.ipynb Jupyter Notebook Shows how to access GEDI data using earthaccess Python package locally and directly in the cloud earthaccess

Helpful Links


Contact Info

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: 02-20-2024

¹Work performed under USGS contract G15PD00467 for NASA contract NNG14HH33I.