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

Description Usage Arguments Details Value See Also

View source: R/gfc_stats.R


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 data_year). 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.


gfc_stats(aoi, gfc, scale_factor = 1e-04, data_year = 2015)



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


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


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


which version of the Hansen data was used when


If theaoi SpatialPolygons* 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.


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 May 19, 2017, 9:53 p.m.

Search within the gfcanalysis package
Search all R packages, documentation and source code

Questions? Problems? Suggestions? Tweet to @rdrrHQ or email at

Please suggest features or report bugs in the GitHub issue tracker.

All documentation is copyright its authors; we didn't write any of that.