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

View source: R/getLevel2AM.R

getLevel2AMR Documentation

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)

Arguments

level2a

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

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

Value

Returns an S4 object of class data.table::data.table containing the elevation and relative heights metrics.

See Also

https://lpdaac.usgs.gov/products/gedi02_av002/

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)

carlos-alberto-silva/rGEDI documentation built on Oct. 18, 2024, 4:46 a.m.