Home

Awesome

https://spotthestation.nasa.gov/

Introduction

The new Global Ecosystem Dynamics Investigation GEDI launched on December 5th, 2018 is operating onboard the International Space Station ISS producing a high-resolution laser collecting 3D data around Earth on forest canopy height, canopy vertical structure, and surface elevation. As it is collecting daily data, a stable and fast platform is essential. For this reason, the library pyGEDI is developed in Python as it can utilize multiple CPUs, GPUs, and is supported by C and GDAL.

pyGEDI provides a high performance, lower cognitive load, and cleaner and more transparent code for data extraction, analysis, processing, and visualization of GEDI's products.

Package Overview

pyGEDI has multiple functions for visualization, processing, analysis, and data extraction all in one package. pyGEDI package contains the following functions:

https://github.com/EduinHSERNA/pyGEDI/blob/master/blog/graphics.jpeg

Dependencies

Installation

Loading pyGEDI Package

from pyGEDI import *

Session NASA

Connect with NASA's server Register for an Earthdata Login Profile (if you do not have an account register for a free account by providing your email).

username='write your user name'
password='write your password'

session=sessionNASA(username,password)

Set Parameters

Define the coordinates of your specific area of interest. The next line will exhibit an example using coordinates in Colombia.

ul_lat= 2.96845  
ul_lon=-73.32586
lr_lat=-1.26845
lr_lon=-70.23869  

bbox=[ul_lat,ul_lon,lr_lat,lr_lon]

Download GEDI Data

Now that the box is defined, download all GEDI trajectories that have flown over the area(s) of interest. Currently, there are only three products available with 25m resolution.

This includes:

For more information check GEDI Finder

Note: GEDI Trajectories contain heavy amounts of data. It is recommended to have good internet for it to download in a more timely manner. Depending on your area of interest and trajectories this may take a couple hours illustrated by the download bar.

product_1B='GEDI01_B'
product_2A='GEDI02_A'
product_2B='GEDI02_B'

version='001'

outdir_1B='data/'+product_1B+'.'+version+'/'
outdir_2A='data/'+product_2A+'.'+version+'/'
outdir_2B='data/'+product_2B+'.'+version+'/'

gediDownload(outdir_1B,product_1B,version,bbox,session)
gediDownload(outdir_2A,product_2A,version,bbox,session)
gediDownload(outdir_2B,product_2B,version,bbox,session)

Once the download starts it will show a download bar for each file

Created the subdirectory   
data/GEDI01_B.001/2019.08.05/
GEDI01_B_2019217151359_O03661_T02309_02_003_01.h5 | 7.405GB | 24.19%   
[███████████████████......................................................]

Research Products for Analysis, Processing, and Visualization

Access the following notebooks for each respective product.

Notebook:

Pendings for v0.3:

References

Acknowledgements

We would like to thank The University of Maryland and NASA's Goddard Space Flight Center for developing GEDI's mission and for providing free and open data.

Reporting Issues

Please report any issue regarding the pyGEDI package to:

pyGEDI blog forthcoming.

Call for Contributions

pyGEDI appreciates help from a wide range of different backgrounds. Small improvements or fixes are always appreciated. Kindly report any issues with labeling or processing. If you are considering larger contributions outside the traditional coding work, please contact us through the mailing list.

Other functions

pyGEDI has several functions and is a continuously improved package. If it does not exist in pyGEDI please ask us for a new feature, and depending on the feasibility we will be glad to implement your requested feature.

Citing pyGEDI

Eduin H.SERNA; Andres Hernandez-Serna. pyGEDI: NASA's Global Ecosystem Dynamics Investigation (GEDI) mission data extraction, analysis, processing and visualization. version 0.2, April. 5th 2020, available at: https://pypi.org/project/pyGEDI/

Disclaimer

pyGEDI package has not been developed by the GEDI team. It comes with no guarantee, expressed or implied, and the authors hold no responsibility for its use or reliability of its outputs.