rGEDI (version 0.6.0)

getLevel2AM: Get GEDI Elevation and Height Metrics (GEDI Level2A)

Description

This function extracts Elevation and Relative Height (RH) metrics from GEDI Level2A data.

Usage

getLevel2AM(level2a, beams = NULL, include_rh = TRUE)

Value

Returns an S4 object of class data.table::data.table

containing the elevation and relative heights metrics.

Arguments

level2a

A GEDI Level2A object (output of readLevel2A() function). An S4 object of class "gedi.level2a".

beams

Optional beam names. NULL reads every beam.

include_rh

Logical. Include the 101 relative-height columns. Set to FALSE for a faster metadata-only cloud read.

Details

Characteristics. Flag indicating likely invalid waveform (1=valid, 0=invalid).

• beam Beam identifier

• shot_number Shot number

• degrade_flag Flag indicating degraded state of pointing and/or positioning information

• quality_flag Flag simplifying selection of most useful data

• delta_time Transmit time of the shot since Jan 1 00:00 2018

• sensitivity Maxmimum canopy cover that can be penetrated

• solar_elevation Solar elevation

• lat_lowestmode Latitude of center of lowest mode

• lon_lowestmode Longitude of center of lowest mode

• elev_highestreturn Elevation of highest detected return relative to reference ellipsoid Meters

• elev_lowestmode Elevation of center of lowest mode relative to reference ellipsoid

• rh Relative height metrics at 1% interval

See Also

https://www.earthdata.nasa.gov/data/catalog/lpcloud-gedi02-a-002

Examples

# Specifying the path to GEDI level2A data (zip file)
outdir = tempdir()
level2A_fp_zip <- system.file("extdata",
                  "GEDI02_A_2019108080338_O01964_T05337_02_001_01_sub.zip",
                  package="rGEDI")

# Unzipping GEDI level2A data
level2Apath <- unzip(level2A_fp_zip,exdir = outdir)

# Reading GEDI level2A data (h5 file)
level2a<-readLevel2A(level2Apath=level2Apath)

# Extracting GEDI Elevation and Height Metrics
level2AM<-getLevel2AM(level2a)
head(level2AM)

close(level2a)