Extract Urban/Rural Extent Raster — extract

Extracts the `afurextent.asc` raster file from the package's `inst/extdata` directory to a specified destination.

Usage

extract_afurextent(
  dest_dir = here::here("01_data", "1b_rasters", "urban_extent"),
  overwrite = FALSE
)

Arguments

dest_dir: A character string specifying the directory to save the extracted raster file.
overwrite: Logical. Whether to overwrite an existing file in the destination directory. Default is FALSE.

Value

A character string representing the full path to the extracted raster file.

Details

This function extracts the `afurextent.asc` file from the package's `extdata` directory, where it is stored as a compressed `.zip` file. It requires the `raster` package to load the raster file.

Examples

# \donttest{
 extract_afurextent(tempdir(), overwrite = TRUE)
#> ℹ Extracting raster file to /tmp/RtmpioKZmp...
#> Warning: cannot remove file '/tmp/RtmpioKZmp/__MACOSX', reason 'Directory not empty'
#> Warning: cannot remove file '/tmp/RtmpioKZmp/bslib-0bda59d17e9d391339779413dfcc5d3a', reason 'Directory not empty'
#> Warning: cannot remove file '/tmp/RtmpioKZmp/downlit', reason 'Directory not empty'
#> Warning: cannot remove file '/tmp/RtmpioKZmp/test_env', reason 'Directory not empty'
#> ✔ Raster file successfully extracted to: /tmp/RtmpioKZmp/afurextent.asc
#> [1] "/tmp/RtmpioKZmp/afurextent.asc"
# }