classify_grid_urban_clusters: Create the DEGURBA grid cell classification of urban clusters

Description

classify_grid_urban_clusters() has been renamed to DoU_classify_grid_urban_clusters() to create a more consistent API and to better indicate that this function is specifically designed to classify urban clusters in the context of the DEGURBA classification.

Usage

classify_grid_urban_clusters(
  data,
  classification,
  density_threshold = 300,
  size_threshold = 5000,
  contiguity_rule = 8,
  smooth_pop = FALSE,
  smooth_pop_window = 5,
  value = 2
)

Value

SpatRaster with the grid cell classification of urban clusters

Arguments

data: path to the directory with the data, or named list with the data as returned by function DoU_preprocess_grid()
classification: SpatRaster. A grid with the classification of urban centres to which the classification of urban clusters will be added. Note that the grid will be adapted in-place.
density_threshold: numeric. Minimum population density per permanent land of a cell required to belong to an urban cluster
size_threshold: numeric. Minimum total population size required for an urban cluster
contiguity_rule: integer. Which cells are considered adjacent: 4 for rooks case (horizontal and vertical neighbours) or 8 for queens case (horizontal, vertical and diagonal neighbours)
smooth_pop: logical. Whether to smooth the population grid before delineating urban clusters. If TRUE, the population grid will be smoothed with a moving average of window size smooth_pop_window.
smooth_pop_window: integer. Size of the moving window used to smooth the population grid before delineating urban clusters. Ignored when smooth_pop is FALSE.
value: integer. Value assigned to urban clusters in the resulting grid