flexurba (version 0.2.3)

DoU_classify_grid_water: Create the DEGURBA grid cell classification of water cells

Description

The Degree of Urbanisation identifies water cells as cells with no built-up area, no population, and less than 50% permanent land.

For more information about the Degree of Urbanisation methodology, see the methodological manual, GHSL Data Package 2022 and GHSL Data Package 2023.

The arguments of the function allow to adapt the standard specifications in the Degree of Urbanisation in order to construct an alternative version of the grid classification.

Usage

DoU_classify_grid_water(
  data,
  classification = NULL,
  water_land_threshold = 0.5,
  water_pop_threshold = 0,
  water_built_threshold = 0,
  value = 0,
  allow_overwrite = c(1)
)

Value

SpatRaster with the grid cell classification of water cells

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 to which the classification of water cells will be added. The grid can already contain the classification or urban centres, urban clusters and rural grid cell, but this is not mandatory. Note that the grid will be adapted in-place.

water_land_threshold

numeric. Maximum proportion of permanent land allowed in a water cell

water_pop_threshold

numeric. Maximum population size allowed in a water cell

water_built_threshold

numeric. Maximum built-up area allowed in a water cell

value

integer. Value assigned to water cells in the resulting grid

allow_overwrite

vector. Values in classification that can be overwritten by water cells. By default, the classification of rural cells (1) can be overwritten, but the classification of urban clusters (2) and urban centres (3) cannot.

Examples

data_belgium <- DoU_load_grid_data_belgium()
classification <- DoU_classify_grid_urban_centres(data_belgium)
classification <- DoU_classify_grid_urban_clusters(data_belgium, classification = classification)
classification <- DoU_classify_grid_rural(data_belgium, classification = classification)
classification <- DoU_classify_grid_water(data_belgium, classification = classification)
DoU_plot_grid(classification)