Summarize nearby imperviousness — get_nlcd_fct_imp

Summarizes fraction imperviousness (fractional surface area covered with artificial substrate or structures) within the buffer distance of each s2 cell; the year of each date is used to link to the corresponding annual snapshot.

Usage

get_nlcd_fct_imp_summary(x, fun = mean, buffer = 800, ...)

Arguments

x: a s2_cell_dates vector (see ?s2cd)
fun: function to summarize extracted data
buffer: distance from s2 cell (in meters) to summarize data
...: passed to stow::stow(). The package and subdir arguments are fixed by geomarker.

Value

a list of numeric vectors of NLCD fraction imperviousness summaries. Dates in unavailable years return NA_real_.

Details

Fractional Impervious Surface rasters from Annual NLCD Collection 1.2 are retrieved as full conterminous U.S. GeoTIFFs from the MRLC direct-download bundles at a 30 m grid. The currently available conterminous U.S. data span 1985 through 2025; dates outside the available years return NA_real_ values. See https://www.usgs.gov/centers/eros/science/annual-nlcd-data-access for data-access details and https://www.usgs.gov/centers/eros/science/usgs-eros-archive-land-cover-annual-nlcd-collection-1-fractional-impervious for product details.

Examples

local({
  withr::local_envvar(
    R_USER_DATA_DIR = fs::path_package("geomarker", "gmrkr--8841"),
    R_GEOMARKER_NO_DOWNLOAD = "true"
  )
  print(get_nlcd_fct_imp_summary(s2cd_example_cincy(2L)))
})
#> Using managed local copy: /home/runner/work/_temp/Library/geomarker/gmrkr--8841/R/geomarker/stow/get_nlcd_fct_imp_summary/f399724c78c9d166--Annual_NLCD_FctImp_2024_CU_C1V2.zip
#> [[1]]
#> [1] 2.174167 2.174167 2.174167
#> 
#> [[2]]
#> [1] 16.81483 16.81483 16.81483
#>