get_optimal_builtup

<a href="https://lifecycle.r-lib.org/articles/stages.html#deprecated"><img src="figures/lifecycle-deprecated.svg?package=flexurba&version=0.2.3" alt="[Deprecated]"></a>
<code>get_optimal_builtup()</code> has been renamed to <code>DoU_get_optimal_builtup()</code> to create a more consistent API and to better indicate that this function is specifically designed for detecting the optimal builtup threshold in the context of the DEGURBA classification with <code>DoU_classify_units()</code>.

internal

Enables the construction of flexible urban delineations that
can be tailored to specific applications or research questions, see Van
Migerode et al. (2024) <DOI:10.1177/23998083241262545> and Van Migerode
et al. (2025) <DOI:10.5281/zenodo.15173220>.
Originally developed to flexibly reconstruct the Degree of
Urbanisation classification of cities,
towns and rural areas developed by Dijkstra et al.
(2021) <DOI:10.1016/j.jue.2020.103312>. Now it also support a broader
range of delineation approaches, using multiple datasets – including
population, built-up area, and night-time light grids – and different
thresholding methods.

Céline Van Migerode

flexurba

Construct Flexible Urban Delineations

Ate Poorthuis

Ben Derudder

KU Leuven 

FWO 

get_optimal_builtup function

<dl><dt>data</dt>
<dd>path to the directory with the data, or named list with the data as returned by function <code>DoU_preprocess_grid()</code>. Ideally, it contains data on a global scale.</dd>
<dt>density_threshold</dt>
<dd>numeric. Minimum population density per permanent land</dd>
<dt>size_threshold</dt>
<dd>numeric. Minimum population size</dd>
<dt>directions</dt>
<dd>integer. Which cells are considered adjacent: <code>4</code> for rooks case (horizontal and vertical neighbours) or <code>8</code> for queens case (horizontal, vertical and diagonal neighbours)</dd></dl>

Arguments

<a href='https://lifecycle.r-lib.org/articles/stages.html#deprecated'><img src='figures/lifecycle-deprecated.svg' alt='[Deprecated]' /></a>
<code>get_optimal_builtup()</code> has been renamed to <code>DoU_get_optimal_builtup()</code> to create a more consistent API and to better indicate that this function is specifically designed for detecting the optimal builtup threshold in the context of the DEGURBA classification with <code>DoU_classify_units()</code>.

Preprocess the data for the DEGURBA spatial units classification — get_optimal_builtup

<dl>

<dt>data</dt>
<dd>path to the directory with the data, or named list with the data as returned by function <code>DoU_preprocess_grid()</code>. Ideally, it contains data on a global scale.</dd>


<dt>density_threshold</dt>
<dd>numeric. Minimum population density per permanent land</dd>


<dt>size_threshold</dt>
<dd>numeric. Minimum population size</dd>


<dt>directions</dt>
<dd>integer. Which cells are considered adjacent: <code>4</code> for rooks case (horizontal and vertical neighbours) or <code>8</code> for queens case (horizontal, vertical and diagonal neighbours)</dd>

</dl>

get_optimal_builtup: Preprocess the data for the DEGURBA spatial units classification

Description

Usage

Value

Arguments