getLevel2BPAVDProfile: Get GEDI Plant Area Volume Density (PAVD) Index Profile (GEDI...

View source: R/getLevel2BPAVDProfile.R

getLevel2BPAVDProfileR Documentation

Get GEDI Plant Area Volume Density (PAVD) Index Profile (GEDI Level2B)

Description

This function extracts the Plant Area Volume Density (PAVD) Profile from GEDI Level2B data.

Usage

getLevel2BPAVDProfile(level2b)

Arguments

level2b

A GEDI Level2B object (output of readLevel2B() function). An S4 object of class "gedi.level2b".

Details

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

  • beam Beam identifier

  • shot_number Shot number

  • algorithmrun_flag The L2B algorithm is run if this flag is set to 1 indicating data have sufficient waveform fidelity for L2B to run

  • l2b_quality_flag L2B quality flag

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

  • 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

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

  • height_lastbin Height of the last bin of the pgap_theta_z, relative to the ground

  • pavd_z Plant Area Volume Density profile

Value

Returns an S4 object of class data.table::data.table containing the Plant Area Volume Density Index.

See Also

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

Examples

# Specifying the path to GEDI level2B data (zip file)
outdir = tempdir()
level2B_fp_zip <- system.file("extdata",
                  "GEDI02_B_2019108080338_O01964_T05337_02_001_01_sub.zip",
                  package="rGEDI")

# Unzipping GEDI level2A data
level2Bpath <- unzip(level2B_fp_zip,exdir = outdir)

# Reading GEDI level2B data (h5 file)
level2b<-readLevel2B(level2Bpath=level2Bpath)

# Extracting GEDI Plant Area Volume Density (PAVD) Index
level2BPAVDProfile<-getLevel2BPAVDProfile(level2b)
head(level2BPAVDProfile)

close(level2b)

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