gfc_stats: Produce a table of forest cover change statistics for a given...

View source: R/gfc_stats.R

gfc_statsR Documentation

Produce a table of forest cover change statistics for a given AOI

Description

For a given AOI, this function produces two tables: an annual forest loss table (in hectares, by default), and a table specifying 1) the total area of pixels that experienced forest gain and, 2) the total area of pixels that experienced both loss and gain over the full period (from 2000 through the end date of the specific product you are using, depending on the chosen dataset). Note that forest gain and combined loss and gain are not available in the GFC product on an annualized basis. Use extract_gfc to extract the GFC data for the AOI, and threshold it using threshold_gfc prior to running this function.

Usage

gfc_stats(aoi, gfc, scale_factor = 1e-04, dataset = "GFC-2022-v1.10")

Arguments

aoi

one or more Area of Interest (AOI) polygon(s) as a SpatialPolygons*. See Details.

gfc

extract of GFC product for a given AOI (see extract_gfc), recoded using threshold_gfc.

scale_factor

how to scale the output data (from meters). Defaults to .0001 for output in hectares.

dataset

which version of the Hansen data to use

Details

If theaoi object is not in the coordinate system of gfc, it will be reprojected. If there is a "label" attribute, it will be used to label the output statistics. Otherwise, unique names ("AOI 1", "AOI 2", etc.) will be generated and used to label the output. If multiple AOIs share the same labels, statistics will be provided for the union of these AOIs.

Value

list with two elements "loss_table", a data.frame with statistics on forest loss, and "gain_table", with the area of forest gain, and area that experienced both loss and gain. The units of the output are hectares (when scale_factor is set to .0001).

See Also

extract_gfc, threshold_gfc


gfcanalysis documentation built on Oct. 11, 2023, 5:15 p.m.