GHS-WUP-DEGURBA · R2025A · epoch 2025

Settlement context, globally.

Check if a point belongs to an urban centre, cluster, suburb, rural settlement, low-density countryside, or water—offline.

Why DEGURBA?

DEGURBA considers not only population density but also connected cells, cluster population, distance, permanent land, and smoothing. That makes it useful for settlement context, urban/rural stratification, sampling, service-area analysis, and contextual map styling. This library uses 1-km grid as the master source.

Results

class_share is the dominant source-class area share inside the T3 cell—not confidence. mixed marks a source boundary. A finer triangle represents that boundary; it does not improve on the source's 1 km analytical resolution.

The Level-1 source hierarchy puts water in its residual “rural grid cell” domain. Use surface to distinguish water, land, mixed coast, and unknown/nodata.

DEGURBA classes

CodePublic valueMeaning
30urban_centreUrban centre
23dense_urban_clusterDense urban cluster
22semi_dense_urban_clusterSemi-dense urban cluster
21suburban_or_peri_urbanSuburban or peri-urban
13rural_clusterRural cluster
12low_density_ruralLow-density rural
11very_low_density_ruralVery-low-density rural
10waterWater grid cell

Python

pip install settlementcheck

from settlementcheck import SettlementCheck
sc = SettlementCheck()
r = sc.classify(24.7536, 59.4370)
print(r.settlement_class)
# sc.check(...) lazily reads optional local details.

JavaScript

npm install settlementcheck

import { SettlementCheck } from "settlementcheck";
const sc = await SettlementCheck.fromFile();
const r = sc.classify(24.7536, 59.4370);
// await sc.checkAsync(...) loads optional details.

Source and provenance

The bundled data derives from the European Commission Joint Research Centre's GHS-WUP-DEGURBA R2025A, epoch 2025, using projected 2025 population input. Read the methodology report and product record. Data reuse is CC BY 4.0; the Trifold transfer is a change to representation, not to the DEGURBA method.