l4_get: Get AGBD data from a single path of GEDI Level 4 file

In VangiElia/GEDI4R: What the Package Does (One Line, Title Case)

Get AGBD data from a single path of GEDI Level 4 file

Description

Get GEDI L4 data from h5 file format. See here for more documentation on GEDI L4 data. This function work as l4_getmulti but for a single file

Usage

l4_get(gediL4_path, just_colnames = F, add_col = NULL, tct = NULL)

Arguments

gediL4_path	Character path to GEDI level 4A h5 file.
just_colnames	Logical: if TRUE, the function return the dataset names in the h5 file. Useful to get names for the argument add_col.
add_col	Character vector of extra datasets names to cbind to the default output. Names already present will be dropped.
tct	Numeric: tree cover threshold to filter GEDI data.

Details

Columns specification: Flag indicating likely invalid waveform (1=valid,0=invalid).

• date: Date of acquisition in yyyy-mm-dd hh:mm:ss

• beam: Beam identifier

• shot_number: Shot number

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

• l4_quality_flag: Flag identifying the most useful L4 data for biomass predictions

• l2_quality_flag: Flag identifying the most useful L2 data for biomass predictions

• algorithm_run_flag: The L4A algorithm is run if this flag is set to 1. This flag selects data that have sufficient waveform fidelity for AGBD estimation.

• sensitivity: Maxmimum canopy cover that can be penetrated considering the SNR of the waveform

• lat_lowestmode: Latitude of center of lowest mode

• lon_lowestmode: Longitude of center of lowest mode

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

• tree_cover: Tree cover in the year 2010, defined as canopy closure for all vegetation taller than 5 m in height (Hansen et al., 2013) and encoded as a percentage per output grid cell.

• pft_class: Plant Functional Type (PFT) derived from the MODIS MCD12Q1 V006 product. Values follow the Land Cover Type 5 Classification scheme.

• agbd_se: Aboveground biomass density (Mg/ha) prediction standard error

• agbd: Aboveground biomass density (Mg/ha)

For downloading more detailed information on GEDI level 4A data (version 1) see here Note that by default the function will dropp all footprint in which agbd<0. These observations are considered sensor errors.

Value

an S4 object of class data.table.

See Also

l4_getmulti, l4_process

VangiElia/GEDI4R documentation built on April 8, 2023, 6:13 p.m.