Census and register counts arrive in administrative zones that rarely match the units a planner needs: grid cells, blocks, buildings, hazard footprints, catchments. 02Dasymetric moves those counts into finer units inside QGIS. It takes source zones with one or more count fields and, optionally, building footprints, a built-up raster (GHS-BUILT-S or GHS-BUILT-V), a gridded population product (GHS-POP or WorldPop) and a land-cover raster (ESA WorldCover or any class raster), and produces a population surface on an equal-area grid with seven methods, building-level estimates, estimates for any target polygons, an accuracy assessment and a self-contained HTML report.
Every method keeps each zone total exactly: allocation runs over (cell, zone) pairs whose shares come from a supersampled rasterisation, and a run whose largest relative zone mass error exceeds is rejected. Cells outside every zone are nodata; inhabited cells without people are 0.
The same steps are available in the lab dock (toolbar button 02Dasymetric lab) and as fifteen Processing algorithms in the provider 02Dasymetric, which also run in the graphical modeller and in batch mode.
The methods that move counts into finer units are well documented (areal weighting, binary and multi-class dasymetric mapping, intelligent dasymetric mapping, Tobler's pycnophylactic interpolation, building-based allocation), but inside QGIS they are scattered or absent. A Hub search on 14 Nov 2026 for "dasymetric", "pycnophylactic", "disaggregation", "areal interpolation", "GHSL" and "WorldPop" found one areal-weighting tool with an optional binary mask (PlanX), raster-to-raster random-forest downscaling without a zone mass constraint, and tools that consume WorldPop for other purposes. Nothing implemented pycnophylactic interpolation, nothing fetched GHSL, and nothing reported accuracy. Outside QGIS the methods live in libraries (PySAL tobler, CRAN pycno, populR, areal) and in the ArcGIS-only Intelligent Dasymetric Mapping toolbox. 02Dasymetric carries one study end to end in one panel and in Processing, with no extra installs.
From QGIS: Plugins > Manage and Install Plugins, search for 02Dasymetric, install. From a release zip: Plugins > Manage and Install Plugins > Install from ZIP.
Requirements: QGIS 3.28 or later, QGIS 4 included (Qt5 and Qt6). The plugin uses only what every QGIS
install ships: qgis.core, GDAL/OGR, NumPy and PyQt. SciPy is used for non-negative least squares
when it is importable; a built-in Lawson-Hanson solver gives identical densities without it. No Python package
has to be installed.
A count per cell is only a density when every cell has the same area, so the plugin works on an equal-area grid in metres. The working CRS is chosen from the zone extent:
+proj=laea +lat_0=... +lon_0=... +datum=WGS84 +units=m);Every vector input is transformed into the working CRS and every raster is warped onto the grid with GDAL: sum resampling for count rasters (GHS-POP, WorldPop, GHS-BUILT-S, GHS-BUILT-V) so totals are kept, average for shares, and class fractions for land cover (supersampled nearest neighbour, then block counting). Areas are planar areas in the working CRS. The grid origin snaps to multiples of the cell size, so a translation by whole cells reproduces the same arrays.
Zone fractions. Each cell is split into sub-cells (supersampling , default ), GDAL burns the zone index into the sub-cells whose centre lies inside a zone, and the sub-cells are counted per (cell, zone) pair:
where is the number of sub-cells of cell whose centre lies in zone , the share of cell inside zone , the cell area and the rasterised zone area. (not the polygon area ) is the allocation denominator of a zone, so the zone total is exact by construction. A zone too small to hold one sub-cell centre is placed at its point on surface with and listed in the log. When ( grid cells), the supersampling is reduced and the log says so.
GeoTIFF output is Float32 by default (relative round trip about ) or Float64 on request.
The lab is a dock on the right of the QGIS window with a vertical icon rail. A study runs top to bottom; every step can be repeated. Long work (reading layers, downloads, runs, assessments, exports) runs as a QGIS background task with a progress strip and a Cancel button, so the dock never freezes. Results go to a 02Dasymetric layer group with one subgroup per run.
Source zones: the polygon layer that carries the counts, its key field and one or more numeric count fields (a checklist). Load demo city adds the synthetic city of section 10. Working grid: cell size chips (25, 50, 100, 250 m) and a spin box, supersampling, and an optional CRS override; a badge shows the working CRS and why it was chosen (for example "UTM 35N - extent inside one zone"). Zone summary: zones, total count, median zone area, mean density per and grid cells, plus the share of zones with a valid count (NULL counts are skipped and reported, never treated as 0).
Four cards, each with a status pill (missing, local, downloaded) and a licence and citation line.
<profile>/zero2dasymetric/cache). A fetch first
asks the server for the size (HTTP HEAD) and shows it; the download starts on the second click.Methods: chips for the seven methods; a method whose input is missing is switched off and its tooltip says why. Parameters shows only the parameters of the chosen methods: binary mask source and threshold; class mode (IDM, regression, fixed), IDM minimum share and minimum zones; continuous exponents and the optional mask; pycnophylactic iterations, tolerance, relaxation and boundary. Outputs: optional target polygons and the GeoTIFF precision. Run disaggregation runs every chosen method on every ticked count field; the run table lists the mass error, fallback zones and people, inhabited cells and pycnophylactic iterations per method.
Surfaces: one GeoTIFF layer per method with show/hide and Active buttons. People per cell: a histogram of the occupied cells of one surface, KPIs (occupied cells, median, largest cell, sum) and Restyle surfaces (quantile classes on an amber ramp, lighter on a dark theme). Class densities: people per of each land-cover class from the multi-class method. Buildings and targets: buildings with people, the integer total and the target polygons summary.
Three modes. Validation zones: finer polygons with a known count (for example neighbourhoods); every surface is summed over them and compared. Self-validation: aggregate-up, with the block side (0 = automatic). Prior agreement: the population prior summed per census zone over the census count. The comparison table holds RMSE, MAE, bias, MdAPE, and the misallocated share per method with the best value per column in amber; the observed-against-estimated scatter has a 1:1 line and a method switcher; the error layer is added with a diverging style. When only the accuracy settings changed since the last run, the assessment reuses that run and computes the accuracy stage only.
Export report writes the self-contained HTML report (inline CSS, SVG and an embedded KaTeX bundle that typesets every formula as in this manual, offline, no external resources) and offers a link to open it. GeoTIFF per method (plus the method spread, see section 9), GeoPackage (buildings, targets, error layer, run table and accuracy metrics) and Metrics CSV (one row per count field and method: total, mass error, fallbacks, iterations and, after an assessment, every accuracy metric).
Workflow, which method when, formulas, data licences and citations, method references and links to this manual and the repository. The plugin menu also has a Manual entry.
Notation: source zone with count and planar area ; grid cell with area (the same for every cell of the equal-area grid); the share of cell inside zone , equation (1); ancillary weight . Every method allocates over (cell, zone) pairs and sums per cell:
where is the count zone places in cell , the sum over runs over the cells of zone , and is the people in cell , the value of the output surface. A zone whose ancillary weight is zero everywhere () falls back to areal weighting; the run lists these zones and the people they hold.
| Method | What it does | Formula | References |
|---|---|---|---|
Areal weightingareal | Spread each zone's count evenly over its area (baseline). | Goodchild & Lam 1980 | |
Binary dasymetricbinary | Spread each zone's count evenly over its inhabited cells only. | Langford & Unwin 1994; Eicher & Brewer 2001; Mennis 2003 | |
Multi-class dasymetricclasses | Weight cells by land-cover class densities (fixed, intelligent sampling or regression). | ; IDM: ; regression: (NNLS); | Mennis 2003; Mennis & Hultgren 2006; Langford et al. 1991; Yuan et al. 1997; Lawson & Hanson 1974 |
Continuous ancillarycontinuous | Weight cells by built-up surface/volume or a population prior, rescaled to the census. | ; | Stevens et al. 2015; Leyk et al. 2019 |
Building-basedbuildings | Split each zone's count over its buildings by count, footprint, floor area, volume or a field. | ; integers by largest remainder per zone | Lwin & Murayama 2009; Zandbergen & Ignizio 2010 |
Pycnophylacticpycno | The smoothest non-negative surface that keeps every zone total (Tobler). | ; ; ; rescale to | Tobler 1979 |
Dasymetric-pycnophylacticpycno_dasy | Pycnophylactic smoothing over inhabited cells only; the rest stays 0. | as pycnophylactic, with cells fixed at 0 and left out of the means and corrections | Kim & Yao 2010; Tobler 1979 |
The baseline: each zone's count spread evenly over its area, equation (2) with . Every other method is judged against it.
Only inhabited cells receive people:
where is the inhabited mask, the mask threshold (default ) and the value of the mask source in cell : the summed weight of the eligible buildings whose point on surface lies in the cell (with : an eligible building is present), the built-up value, or the land-cover weight , with the relative density of class in the class table.
The cell weight is the class-fraction mix of class densities:
where is the fraction of cell in land-cover class (supersampled, not the majority class), the density of class and the area of class in zone , in . Three ways to get :
The class density table lists in people per and where each value came from (sampled, regression, zero, fixed).
where is the value of ancillary layer (built-up surface or volume, or a population prior) in cell , warped onto the grid, its mean over the positive cells and its exponent (default ). Cells without data get ; optionally is multiplied by the binary mask . With a population product as the only layer and this is the census-constrained rescaling step of top-down gridded population products.
where is the estimate of building , its weight (count, footprint , floor area , volume or a field such as dwellings), its floors, its height (the height field, else ) and the share of building assigned to zone : 1 for the zone holding its point on surface and 0 elsewhere, or the share of its footprint inside when split by overlap area. Floors come from the floors field, else from the height:
with the storey height (default ), so halves are rounded up; unknown floors take the zone median of known floors, else 1. Integer counts per zone by the largest remainder method sum exactly to . The grid surface puts each in the cell of its point on surface; zones without an eligible building fall back to areal weighting on the grid and are reported.
Starts from areal weighting on the majority-zone raster, , and repeats, for every cell of zone :
where are the four rook neighbours of cell (outside the study area for the zero boundary and , a mirror, for the free boundary), the relaxation (default ) and the number of cells of zone . It stops when
with the change in one iteration, the tolerance (default ) and the mean cell value, or at the iteration limit. The volume is kept at every iteration. With the zero boundary the density falls towards the study edge, as Tobler's condition implies; the free boundary keeps a single zone uniform.
As above, but cells with are fixed at 0 and left out of , and the zone corrections (Kim and Yao 2010). A zone without an inhabited cell is smoothed over all its cells and listed as a fallback.
Validation zones: disaggregate from the coarse source zones, aggregate every surface to finer zones with known counts (e.g. districts to neighbourhoods) and compare. When the two levels hold different totals the report says so.
Aggregate-up self-validation (one level of data): merge the source zones into deterministic square-block groups (block side by default, about four zones per group, the block grid starting at the top-left of the zones), disaggregate from the groups with the same ancillary data and compare with the original zone counts. Groups holding a single zone carry no information and are left out (Fisher and Langford 1995; Kim and Yao 2010).
Metrics. With the observed and the estimated count of unit , the error and the units where both are known:
where and are the means of the observed and estimated counts. MAPE and MdAPE (in percent) use only; the excluded count is reported, never a division by zero. is Pearson's correlation; the misallocated share is the share of people placed in the wrong unit. An undefined metric is NULL. Report MAE beside RMSE (Willmott and Matsuura 2005). The best method per metric has the lowest error, the highest and , and the smallest .
Prior agreement (agreement, not accuracy): GHS-POP or WorldPop summed per census zone divided by the census count,
where is the prior in cell (warped with sum resampling); zones with NULL or 0 get no ratio. Reported: the median of , the interquartile range and the share of zones with (within ).
All downloads go through the QGIS network manager (proxy and authentication settings) into the cache folder, and every fetch records source, URL, licence and citation in the run log and the report. Sizes are shown before anything is downloaded; cached files are reused offline.
| Product | Access | Licence | Citation |
|---|---|---|---|
| GHS-POP R2023A, 100 m, Mollweide (ESRI:54009), epochs 1975-2030 every 5 years | 1000 km tiles from the JRC open-data server (zip, inner GeoTIFF read through /vsizip/); missing ocean tiles (HTTP 404) are listed and read as zero | CC BY 4.0 | Schiavina, Freire, MacManus (2023), European Commission JRC, doi:10.2905/2FF68A52-5B5B-4A22-8F40-C41DA8332CFE |
| GHS-BUILT-S R2023A (built-up per cell), same grid | as GHS-POP | CC BY 4.0 | Pesaresi (2023), JRC, doi:10.2905/9F06F36F-4B11-47EC-ABB0-4F8B7B1D72EA |
| GHS-BUILT-V R2023A (built-up per cell), same grid | as GHS-POP | CC BY 4.0 | Pesaresi, Politis (2023), JRC, doi:10.2905/AB2F107A-03CD-47A3-85E5-139D8EC63283 |
| WorldPop R2025A constrained, 3 arc-second, 2015-2030 | country file found through the WorldPop REST catalogue (ISO3 code); the server serves no byte ranges, so the file is downloaded whole. Labelled alpha by WorldPop. | CC BY 4.0 | Bondarenko et al. (2025), doi:10.5258/SOTON/WP00839 |
| ESA WorldCover 10 m, 2021 v200 (and 2020 v100) | cloud-optimised GeoTIFF tiles | CC BY 4.0 | Zanaga et al. (2022), doi:10.5281/zenodo.7254221 (2020: doi:10.5281/zenodo.5571936) |
| Building footprints | your own layer (OSM, cadastre, Overture); the plugin downloads no buildings | as supplied | as supplied |
GHSL and WorldCover can also be read remotely through GDAL /vsicurl/ (opt-in stream mode); the QGIS proxy is then copied into the GDAL configuration for the duration of the read only.
Provider 02Dasymetric (id zero2dasymetric). Each algorithm wraps one step of the core; the
method algorithms run the same staged pipeline as the dock for one method and one count field, so their surfaces
are identical to the dock's. Outputs are not styled by the algorithms. From the Python console, for example:
processing.run("zero2dasymetric:areal_weighting", {
"ZONES": zones, "COUNT_FIELD": "population", "CELL": 100,
"OUTPUT": "TEMPORARY_OUTPUT"})
Group: Study.
The whole study of the dock in one step (core.pipeline.run_lab): working CRS and grid, zone fractions, ancillary data, every chosen method on every count field with the per-zone mass check (a run is rejected above a relative error of ), optional target polygons, accuracy assessment, one GeoTIFF per method and count field, building estimates and a self-contained HTML report naming every formula, data source, licence and reference.
Methods: Areal weighting ; Binary dasymetric ; Multi-class dasymetric ; IDM: ; regression: (NNLS); ; Continuous ancillary ; ; Building-based ; integers by largest remainder per zone; Pycnophylactic ; ; ; rescale to ; Dasymetric-pycnophylactic as pycnophylactic, with cells fixed at 0 and left out of the means and corrections.
Inputs each method needs: binary and the hybrid a mask source (buildings, built-up or land cover); multi-class a land-cover raster; continuous a built-up raster or a population prior; building-based a building layer. Validation zones compares every method with finer polygons of known counts; self runs the aggregate-up self-validation.
Metrics, with (estimate minus observed count) over units: ; ; ; MAPE and MdAPE, the mean and median of (percent), over only, the excluded count is reported; ; ; Pearson ; total absolute error ; misallocated share , the share of people placed in the wrong unit. Undefined metrics are NULL. best_in lists the metrics a method is best in (lowest error, highest and , smallest ).
| Parameter | Description | Type | Default |
|---|---|---|---|
ZONES | Source zones (census polygons) | vector layer | |
KEY_FIELD | Zone key field (empty: feature id) | field (optional) | |
METHODS | Methods; options: Areal weighting | Binary dasymetric | Multi-class dasymetric | Continuous ancillary | Building-based | Pycnophylactic | Dasymetric-pycnophylactic | choice | Areal weighting, Building-based |
BUILDINGS | Building footprints | vector layer (optional) | |
WEIGHT | Building weight; options: Count (1 per building) | Footprint area | Floor area (footprint floors) | Volume (footprint height) | A field (e.g. dwellings) | choice | Floor area (footprint floors) |
HEIGHT_FIELD | Height field (m) | field (optional) | |
FLOORS_FIELD | Floors field | field (optional) | |
WEIGHT_FIELD | Weight field (weight = a field) | field (optional) | |
STOREY | Storey height (m), floors | number (advanced) | 3.0 |
DEFAULT_FLOORS | Floors when unknown (0: zone median of known floors, else 1) | number (advanced) | 0.0 |
SPLIT | Zone of a building; options: Zone of the point on surface | Split by overlap area | choice (advanced) | Zone of the point on surface |
FILTER | Building filter expression (empty: all) | expression (optional, advanced) | |
MIN_AREA | Minimum footprint area () | number (advanced) | 20.0 |
BUILTUP | Built-up raster (GHS-BUILT-S/V or local) | raster layer (optional) | |
BUILTUP_KIND | Built-up raster values; options: Count per cell (GHS-BUILT-S/V, summed) | Share or density (averaged) | choice (advanced) | Count per cell (GHS-BUILT-S/V, summed) |
PRIOR | Population prior (GHS-POP, WorldPop or local) | raster layer (optional) | |
LANDCOVER | Land-cover raster (WorldCover or local) | raster layer (optional) | |
CLASS_WEIGHTS | Land-cover class table (class, relative density) | table (optional, advanced) | WorldCover default table |
CLASS_MODE | Multi-class densities; options: Intelligent dasymetric mapping (sampled densities) | Regression (NNLS) | Fixed relative densities (class table) | choice (advanced) | Intelligent dasymetric mapping (sampled densities) |
IDM_THRESHOLD | IDM: minimum class share of a sampled zone | number (advanced) | 0.8 |
IDM_MIN_ZONES | IDM: minimum sampled zones per class | number (advanced) | 3 |
MASK_SOURCE | Binary and hybrid mask from; options: Buildings present | Built-up raster above the threshold | Land-cover class weight above the threshold | choice (advanced) | Buildings present |
MASK_THRESHOLD | Mask threshold | number (advanced) | 0.0 |
BETA_BUILTUP | Continuous: exponent of the built-up layer | number (advanced) | 1.0 |
BETA_PRIOR | Continuous: exponent of the population prior | number (advanced) | 1.0 |
USE_MASK | Continuous: multiply by the mask | yes/no (advanced) | False |
ITERATIONS | Pycnophylactic: maximum iterations | number (advanced) | 500 |
TOLERANCE | Pycnophylactic: tolerance | number (advanced) | 0.0001 |
RELAX | Pycnophylactic: relaxation | number (advanced) | 0.5 |
BOUNDARY | Pycnophylactic: boundary; options: Zero outside the study area (Tobler) | Free (mirrored edge) | choice (advanced) | Zero outside the study area (Tobler) |
CELL | Cell size (m) | number | 100.0 |
SUPERSAMPLE | Supersampling per cell side (zone fractions) | number (advanced) | 4 |
WORKING_CRS | Working CRS (empty: UTM or LAEA by the extent rule) | CRS (optional, advanced) | |
COUNT_FIELDS | Count fields | field | |
TARGETS | Target polygons (optional) | vector layer (optional) | |
TARGETS_OUT | Target polygons with estimates | vector output (optional) | |
VALIDATION | Accuracy assessment; options: None | Validation zones with known counts | Aggregate-up self-validation | choice | None |
VALIDATION_ZONES | Validation zones (known counts) | vector layer (optional) | |
VALIDATION_FIELD | Validation count field | field (optional) | |
BLOCK | Self-validation block side (m, 0: automatic) | number (advanced) | 0.0 |
DTYPE | GeoTIFF data type; options: Float32 | Float64 | choice (advanced) | Float32 |
OUTPUT_FOLDER | Folder for the GeoTIFFs | folder output | |
BUILDINGS_OUT | Buildings with estimates | vector output (optional) | |
ERRORS_OUT | Error layer | vector output (optional) | |
METRICS_OUT | Accuracy metrics | vector output (optional) | |
RUN_TABLE | Run checks per method | vector output (optional) | |
REPORT | HTML report | file output (optional) |
Outputs: TARGETS_OUT Target polygons with estimates; OUTPUT_FOLDER Folder for the GeoTIFFs; BUILDINGS_OUT Buildings with estimates; ERRORS_OUT Error layer; METRICS_OUT Accuracy metrics; RUN_TABLE Run checks per method; REPORT HTML report; SURFACES Surfaces written; BEST_RMSE Lowest RMSE; WORKING_CRS_USED Working CRS.
Group: Study.
A deterministic synthetic city of in UTM 35N, far from the projection origin, for learning the tools and checking them: nine 2 km districts with a population count (the source zones), thirty-six 1 km neighbourhoods with the true count pop_true (validation zones), about six thousand building footprints with type, height and floors (people live only in residential buildings, in proportion to floor area times a smooth radial gradient), a built-up surface raster, a noisy population prior and a 20 m land-cover raster with WorldCover codes. The counts are the planted truth summed per zone, so every method can be scored. Suggested building filter: "type" = 'residential'.
| Parameter | Description | Type | Default |
|---|---|---|---|
SEED | Random seed | number (advanced) | 7 |
RASTER_FOLDER | Folder for the demo rasters | folder output | |
DISTRICTS | Districts (source zones) | vector output | |
NEIGHBOURHOODS | Neighbourhoods (validation zones) | vector output | |
BUILDINGS | Buildings | vector output |
Outputs: RASTER_FOLDER Folder for the demo rasters; DISTRICTS Districts (source zones); NEIGHBOURHOODS Neighbourhoods (validation zones); BUILDINGS Buildings; BUILTUP Built-up surface ( per cell); PRIOR Population prior; LANDCOVER Land cover (WorldCover codes); TOTAL Total population.
Group: Zones and grid.
Builds the equal-area working grid of a study and rasterises the source zones on it with supersampling: every cell gets the share of its area inside each zone ( sub-cells per cell, block-counted). Every method of the plugin allocates over these (cell, zone) pairs, so this is the grid the other algorithms use with the same cell size and CRS.
Outputs: the majority zone raster (zone index + 1 of the zone that covers most of a cell when the zones cover at least half of it; nodata elsewhere), the coverage raster (share of each cell inside any zone), the working CRS with the reason it was chosen, and the rasterised-area error . Zones smaller than one sub-cell are placed at their point on surface and counted.
CRS rule: the UTM zone when the extent lies within of its central meridian, otherwise Lambert azimuthal equal-area on the extent centre.
| Parameter | Description | Type | Default |
|---|---|---|---|
ZONES | Source zones (census polygons) | vector layer | |
COUNT_FIELD | Count field | field | |
KEY_FIELD | Zone key field (empty: feature id) | field (optional) | |
CELL | Cell size (m) | number | 100.0 |
SUPERSAMPLE | Supersampling per cell side (zone fractions) | number (advanced) | 4 |
WORKING_CRS | Working CRS (empty: UTM or LAEA by the extent rule) | CRS (optional, advanced) | |
ZONE_INDEX | Majority zone (index + 1) | raster output | |
COVERAGE | Zone coverage share | raster output |
Outputs: ZONE_INDEX Majority zone (index + 1); COVERAGE Zone coverage share; WORKING_CRS_USED Working CRS; CRS_REASON Why this CRS; ZONE_COUNT Zones; CELLS Grid cells; AREA_ERROR Rasterised area error (share); PLACED_AT_POINT Zones placed at their point on surface.
Group: Disaggregation methods.
Spread each zone's count evenly over its area (baseline).
Formula: . is the count of source zone , the share of cell inside (supersampled), the cell area. Every zone total is kept exactly; a zone with no ancillary weight falls back to areal weighting and is reported.
The baseline every other method is compared with: no ancillary data.
The working grid is equal-area: the UTM zone when the zones fit inside one, otherwise a Lambert azimuthal equal-area projection on the zone centre (or the CRS you choose). The output GeoTIFF holds people per cell; cells outside every zone are nodata.
| Parameter | Description | Type | Default |
|---|---|---|---|
ZONES | Source zones (census polygons) | vector layer | |
COUNT_FIELD | Count field | field | |
KEY_FIELD | Zone key field (empty: feature id) | field (optional) | |
CELL | Cell size (m) | number | 100.0 |
SUPERSAMPLE | Supersampling per cell side (zone fractions) | number (advanced) | 4 |
WORKING_CRS | Working CRS (empty: UTM or LAEA by the extent rule) | CRS (optional, advanced) | |
TARGETS | Target polygons (optional) | vector layer (optional) | |
TARGETS_OUT | Target polygons with estimates | vector output (optional) | |
OUTPUT | Population surface (people per cell) | raster output | |
DTYPE | GeoTIFF data type; options: Float32 | Float64 | choice (advanced) | Float32 |
Outputs: TARGETS_OUT Target polygons with estimates; OUTPUT Population surface (people per cell); TOTAL Total count on the surface; MASS_ERROR_MAX Largest relative zone mass error; FALLBACK_ZONES Zones that fell back to areal weighting; FALLBACK_PEOPLE People placed by the fallback; INHABITED_CELLS Inhabited cells; WORKING_CRS_USED Working CRS; LOG Run log.
Group: Disaggregation methods.
Spread each zone's count evenly over its inhabited cells only.
Formula: . is the count of source zone , the share of cell inside (supersampled), the cell area. Every zone total is kept exactly; a zone with no ancillary weight falls back to areal weighting and is reported.
Inhabited mask : cells whose summed eligible-building weight is above the threshold (with threshold 0: cells holding an eligible building), cells whose built-up value is above the threshold, or cells whose land-cover weight ( from the class table) is above the threshold.
The working grid is equal-area: the UTM zone when the zones fit inside one, otherwise a Lambert azimuthal equal-area projection on the zone centre (or the CRS you choose). The output GeoTIFF holds people per cell; cells outside every zone are nodata.
| Parameter | Description | Type | Default |
|---|---|---|---|
ZONES | Source zones (census polygons) | vector layer | |
COUNT_FIELD | Count field | field | |
KEY_FIELD | Zone key field (empty: feature id) | field (optional) | |
MASK_SOURCE | Inhabited mask from; options: Buildings present | Built-up raster above the threshold | Land-cover class weight above the threshold | choice | Buildings present |
MASK_THRESHOLD | Mask threshold (value above it = inhabited) | number | 0.0 |
BUILDINGS | Building footprints | vector layer (optional) | |
FILTER | Building filter expression (empty: all) | expression (optional, advanced) | |
MIN_AREA | Minimum footprint area () | number (advanced) | 20.0 |
BUILTUP | Built-up raster (GHS-BUILT-S/V or local) | raster layer (optional) | |
LANDCOVER | Land-cover raster (WorldCover or local) | raster layer (optional) | |
CLASS_WEIGHTS | Land-cover class table (class, relative density) | table (optional, advanced) | WorldCover default table |
CELL | Cell size (m) | number | 100.0 |
SUPERSAMPLE | Supersampling per cell side (zone fractions) | number (advanced) | 4 |
WORKING_CRS | Working CRS (empty: UTM or LAEA by the extent rule) | CRS (optional, advanced) | |
TARGETS | Target polygons (optional) | vector layer (optional) | |
TARGETS_OUT | Target polygons with estimates | vector output (optional) | |
OUTPUT | Population surface (people per cell) | raster output | |
DTYPE | GeoTIFF data type; options: Float32 | Float64 | choice (advanced) | Float32 |
Outputs: TARGETS_OUT Target polygons with estimates; OUTPUT Population surface (people per cell); TOTAL Total count on the surface; MASS_ERROR_MAX Largest relative zone mass error; FALLBACK_ZONES Zones that fell back to areal weighting; FALLBACK_PEOPLE People placed by the fallback; INHABITED_CELLS Inhabited cells; WORKING_CRS_USED Working CRS; LOG Run log.
Group: Disaggregation methods.
Weight cells by land-cover class densities (fixed, intelligent sampling or regression).
Formula: ; IDM: ; regression: (NNLS); . is the count of source zone , the share of cell inside (supersampled), the cell area. Every zone total is kept exactly; a zone with no ancillary weight falls back to areal weighting and is reported.
Class fractions come from the land-cover raster (supersampled, not the majority class). Intelligent dasymetric mapping: over the set of source zones whose share of class , , is at least the IDM threshold ; classes with fewer sampled zones than the minimum get their density from the NNLS regression on the remaining counts; classes with weight in the class table stay at 0. Regression: , no intercept, non-negative least squares. Fixed: the class table values are the relative densities. The class density table output lists in people per and where each value came from.
The working grid is equal-area: the UTM zone when the zones fit inside one, otherwise a Lambert azimuthal equal-area projection on the zone centre (or the CRS you choose). The output GeoTIFF holds people per cell; cells outside every zone are nodata.
| Parameter | Description | Type | Default |
|---|---|---|---|
ZONES | Source zones (census polygons) | vector layer | |
COUNT_FIELD | Count field | field | |
KEY_FIELD | Zone key field (empty: feature id) | field (optional) | |
LANDCOVER | Land-cover raster (WorldCover or local) | raster layer | |
MODE | Class densities; options: Intelligent dasymetric mapping (sampled densities) | Regression (NNLS) | Fixed relative densities (class table) | choice | Intelligent dasymetric mapping (sampled densities) |
CLASS_WEIGHTS | Land-cover class table (class, relative density) | table (optional, advanced) | WorldCover default table |
IDM_THRESHOLD | IDM: minimum class share of a sampled zone | number (advanced) | 0.8 |
IDM_MIN_ZONES | IDM: minimum sampled zones per class | number (advanced) | 3 |
DENSITIES | Class densities | vector output (optional) | |
CELL | Cell size (m) | number | 100.0 |
SUPERSAMPLE | Supersampling per cell side (zone fractions) | number (advanced) | 4 |
WORKING_CRS | Working CRS (empty: UTM or LAEA by the extent rule) | CRS (optional, advanced) | |
TARGETS | Target polygons (optional) | vector layer (optional) | |
TARGETS_OUT | Target polygons with estimates | vector output (optional) | |
OUTPUT | Population surface (people per cell) | raster output | |
DTYPE | GeoTIFF data type; options: Float32 | Float64 | choice (advanced) | Float32 |
Outputs: DENSITIES Class densities; TARGETS_OUT Target polygons with estimates; OUTPUT Population surface (people per cell); TOTAL Total count on the surface; MASS_ERROR_MAX Largest relative zone mass error; FALLBACK_ZONES Zones that fell back to areal weighting; FALLBACK_PEOPLE People placed by the fallback; INHABITED_CELLS Inhabited cells; WORKING_CRS_USED Working CRS; LOG Run log.
Group: Disaggregation methods.
Weight cells by built-up surface/volume or a population prior, rescaled to the census.
Formula: ; . is the count of source zone , the share of cell inside (supersampled), the cell area. Every zone total is kept exactly; a zone with no ancillary weight falls back to areal weighting and is reported.
Each layer (built-up surface or volume, a population prior such as GHS-POP or WorldPop, or any local raster) is warped onto the working grid (summed for counts, averaged for shares), divided by the mean of its positive cells and raised to its exponent . With a population prior as the only layer and this is the census-constrained rescaling of top-down gridded population products. Optionally the weight is multiplied by the inhabited mask.
Inhabited mask : cells whose summed eligible-building weight is above the threshold (with threshold 0: cells holding an eligible building), cells whose built-up value is above the threshold, or cells whose land-cover weight ( from the class table) is above the threshold.
The working grid is equal-area: the UTM zone when the zones fit inside one, otherwise a Lambert azimuthal equal-area projection on the zone centre (or the CRS you choose). The output GeoTIFF holds people per cell; cells outside every zone are nodata.
| Parameter | Description | Type | Default |
|---|---|---|---|
ZONES | Source zones (census polygons) | vector layer | |
COUNT_FIELD | Count field | field | |
KEY_FIELD | Zone key field (empty: feature id) | field (optional) | |
BUILTUP | Built-up raster (GHS-BUILT-S/V or local) | raster layer (optional) | |
BUILTUP_KIND | Built-up raster values; options: Count per cell (GHS-BUILT-S/V, summed) | Share or density (averaged) | choice (advanced) | Count per cell (GHS-BUILT-S/V, summed) |
BETA_BUILTUP | Exponent of the built-up layer | number | 1.0 |
PRIOR | Population prior (GHS-POP, WorldPop or local) | raster layer (optional) | |
BETA_PRIOR | Exponent of the population prior | number | 1.0 |
USE_MASK | Multiply by the inhabited mask | yes/no (advanced) | False |
MASK_SOURCE | Inhabited mask from; options: Buildings present | Built-up raster above the threshold | Land-cover class weight above the threshold | choice (advanced) | Built-up raster above the threshold |
MASK_THRESHOLD | Mask threshold | number (advanced) | 0.0 |
CELL | Cell size (m) | number | 100.0 |
SUPERSAMPLE | Supersampling per cell side (zone fractions) | number (advanced) | 4 |
WORKING_CRS | Working CRS (empty: UTM or LAEA by the extent rule) | CRS (optional, advanced) | |
TARGETS | Target polygons (optional) | vector layer (optional) | |
TARGETS_OUT | Target polygons with estimates | vector output (optional) | |
OUTPUT | Population surface (people per cell) | raster output | |
DTYPE | GeoTIFF data type; options: Float32 | Float64 | choice (advanced) | Float32 |
Outputs: TARGETS_OUT Target polygons with estimates; OUTPUT Population surface (people per cell); TOTAL Total count on the surface; MASS_ERROR_MAX Largest relative zone mass error; FALLBACK_ZONES Zones that fell back to areal weighting; FALLBACK_PEOPLE People placed by the fallback; INHABITED_CELLS Inhabited cells; WORKING_CRS_USED Working CRS; LOG Run log.
Group: Disaggregation methods.
The smoothest non-negative surface that keeps every zone total (Tobler).
Formula: ; ; ; rescale to . is the count of source zone , the share of cell inside (supersampled), the cell area. Every zone total is kept exactly; a zone with no ancillary weight falls back to areal weighting and is reported.
Starts from areal weighting on the majority-zone raster and iterates: the mean of the four neighbours (outside the study area 0 for the zero boundary, mirrored for the free boundary), relaxation , a per-zone additive correction, clamping at 0 and a per-zone rescale to , until or the iteration limit. Volume is kept at every iteration. With Restrict to inhabited cells it becomes the dasymetric-pycnophylactic hybrid of Kim and Yao (2010): masked cells stay at exactly 0 and are left out of the neighbour means and zone corrections.
Inhabited mask : cells whose summed eligible-building weight is above the threshold (with threshold 0: cells holding an eligible building), cells whose built-up value is above the threshold, or cells whose land-cover weight ( from the class table) is above the threshold.
| Parameter | Description | Type | Default |
|---|---|---|---|
ZONES | Source zones (census polygons) | vector layer | |
COUNT_FIELD | Count field | field | |
KEY_FIELD | Zone key field (empty: feature id) | field (optional) | |
ITERATIONS | Maximum iterations | number | 500 |
TOLERANCE | Tolerance (share of the mean value) | number (advanced) | 0.0001 |
RELAX | Relaxation | number (advanced) | 0.5 |
BOUNDARY | Boundary condition; options: Zero outside the study area (Tobler) | Free (mirrored edge) | choice | Zero outside the study area (Tobler) |
HYBRID | Restrict to inhabited cells (dasymetric-pycnophylactic) | yes/no | False |
MASK_SOURCE | Inhabited mask from (hybrid only); options: Buildings present | Built-up raster above the threshold | Land-cover class weight above the threshold | choice | Buildings present |
MASK_THRESHOLD | Mask threshold (value above it = inhabited) | number | 0.0 |
BUILDINGS | Building footprints | vector layer (optional) | |
FILTER | Building filter expression (empty: all) | expression (optional, advanced) | |
MIN_AREA | Minimum footprint area () | number (advanced) | 20.0 |
BUILTUP | Built-up raster (hybrid mask) | raster layer (optional) | |
LANDCOVER | Land-cover raster (hybrid mask) | raster layer (optional) | |
CLASS_WEIGHTS | Land-cover class table (class, relative density) | table (optional, advanced) | WorldCover default table |
CELL | Cell size (m) | number | 100.0 |
SUPERSAMPLE | Supersampling per cell side (zone fractions) | number (advanced) | 4 |
WORKING_CRS | Working CRS (empty: UTM or LAEA by the extent rule) | CRS (optional, advanced) | |
TARGETS | Target polygons (optional) | vector layer (optional) | |
TARGETS_OUT | Target polygons with estimates | vector output (optional) | |
OUTPUT | Population surface (people per cell) | raster output | |
DTYPE | GeoTIFF data type; options: Float32 | Float64 | choice (advanced) | Float32 |
Outputs: ITERATIONS_USED Iterations; CONVERGED Converged (1) or stopped at the limit (0); TARGETS_OUT Target polygons with estimates; OUTPUT Population surface (people per cell); TOTAL Total count on the surface; MASS_ERROR_MAX Largest relative zone mass error; FALLBACK_ZONES Zones that fell back to areal weighting; FALLBACK_PEOPLE People placed by the fallback; INHABITED_CELLS Inhabited cells; WORKING_CRS_USED Working CRS; LOG Run log.
Group: Disaggregation methods.
Split each zone's count over its buildings by count, footprint, floor area, volume or a field.
Formula: ; integers by largest remainder per zone. is the count of source zone , the share of cell inside (supersampled), the cell area. Every zone total is kept exactly; a zone with no ancillary weight falls back to areal weighting and is reported.
Each eligible building gets the weight (count), its footprint , its floor area , its volume ( from the height field, else ) or a field (e.g. dwellings); the filter expression and minimum area drop sheds, garages and non-residential buildings. A building belongs to the zone holding its point on surface, or is split by overlap area. Floors from a height field: , the storey height. Unknown floors take the zone median of known floors (or a fixed value).
Output fields (a contract shared with 02GreenRule and 02NoiseLab): src_key, w_<mode>, <field>_est (float) and <field>_int (largest remainder integers whose zone sum is ). Ineligible buildings carry NULL estimates; zones without an eligible building are reported (no building receives them). The layer is in the working CRS of the zones.
| Parameter | Description | Type | Default |
|---|---|---|---|
ZONES | Source zones (census polygons) | vector layer | |
COUNT_FIELDS | Count fields | field | |
KEY_FIELD | Zone key field (empty: feature id) | field (optional) | |
BUILDINGS | Building footprints | vector layer | |
WEIGHT | Building weight; options: Count (1 per building) | Footprint area | Floor area (footprint floors) | Volume (footprint height) | A field (e.g. dwellings) | choice | Floor area (footprint floors) |
HEIGHT_FIELD | Height field (m) | field (optional) | |
FLOORS_FIELD | Floors field | field (optional) | |
WEIGHT_FIELD | Weight field (weight = a field) | field (optional) | |
STOREY | Storey height (m), floors | number (advanced) | 3.0 |
DEFAULT_FLOORS | Floors when unknown (0: zone median of known floors, else 1) | number (advanced) | 0.0 |
SPLIT | Zone of a building; options: Zone of the point on surface | Split by overlap area | choice (advanced) | Zone of the point on surface |
FILTER | Building filter expression (empty: all) | expression (optional, advanced) | |
MIN_AREA | Minimum footprint area () | number (advanced) | 20.0 |
OUTPUT | Buildings with estimates | vector output |
Outputs: OUTPUT Buildings with estimates; ELIGIBLE Eligible buildings; FALLBACK_ZONES Zones without an eligible building; FALLBACK_PEOPLE People in those zones; MASS_ERROR_MAX Largest relative zone mass error; TOTAL Sum of the float estimates (first field).
Group: Aggregation.
Sums a population surface (people per cell) over target polygons: , with the share of cell inside polygon and the surface value from the same supersampled rasterisation the methods use, so a polygon that cuts a cell receives the share of the cell's count equal to the share of the cell it covers (uniform density inside a cell). Nodata cells add nothing; a polygon with no finite cell gets NULL, never 0. Polygons smaller than one sub-cell are placed at their point on surface. The output is a copy of the targets (their CRS and fields) plus the estimate field.
| Parameter | Description | Type | Default |
|---|---|---|---|
SURFACE | Population surface (people per cell) | raster layer | |
TARGETS | Target polygons | vector layer | |
FIELD_NAME | Estimate field name | text | pop_est |
SUPERSAMPLE | Supersampling per cell side | number (advanced) | 4 |
OUTPUT | Targets with estimates | vector output |
Outputs: OUTPUT Targets with estimates; TOTAL Sum over the targets.
Group: Aggregation.
Sums a numeric building field (for example population_est from Building-based allocation) per cell of each building's point on surface, on an equal-area grid of the chosen cell size over the building extent (UTM or LAEA by the extent rule, or the CRS you choose). Cells without a building hold 0; NULL values are skipped. The grid origin snaps to multiples of the cell size, so grids of the same CRS and cell size line up with the other algorithms.
| Parameter | Description | Type | Default |
|---|---|---|---|
BUILDINGS | Buildings | vector layer | |
VALUE_FIELD | Value field | field | |
CELL | Cell size (m) | number | 100.0 |
SUPERSAMPLE | Supersampling per cell side (zone fractions) | number (advanced) | 4 |
WORKING_CRS | Working CRS (empty: UTM or LAEA by the extent rule) | CRS (optional, advanced) | |
OUTPUT | Grid of summed values | raster output | |
DTYPE | GeoTIFF data type; options: Float32 | Float64 | choice (advanced) | Float32 |
Outputs: OUTPUT Grid of summed values; TOTAL Sum on the grid.
Group: Accuracy.
Compares one or more estimate fields with an observed count field on the same polygons (for example validation neighbourhoods carrying their census count and the estimates of several methods). The metrics table holds one row per estimate field; the error layer is a copy of the polygons with obs, est_<m>, err_<m> and ape_<m> (percent, NULL where ).
Metrics, with (estimate minus observed count) over units: ; ; ; MAPE and MdAPE, the mean and median of (percent), over only, the excluded count is reported; ; ; Pearson ; total absolute error ; misallocated share , the share of people placed in the wrong unit. Undefined metrics are NULL. best_in lists the metrics a method is best in (lowest error, highest and , smallest ).
| Parameter | Description | Type | Default |
|---|---|---|---|
INPUT | Polygons with observed and estimated counts | vector layer | |
OBS_FIELD | Observed count field | field | |
EST_FIELDS | Estimate fields | field | |
METRICS | Accuracy metrics | vector output | |
ERRORS | Error layer | vector output (optional) |
Outputs: METRICS Accuracy metrics; ERRORS Error layer; BEST_RMSE Lowest RMSE.
Group: Accuracy.
Accuracy with a single level of data: the source zones are merged into deterministic square-block groups (block side by default, about four zones per group, the block grid starting at the top-left of the zones), every chosen method disaggregates the group totals with the same ancillary data, and the estimates are compared with the original zone counts. Groups holding a single zone carry no information and are left out (reported).
Metrics, with (estimate minus observed count) over units: ; ; ; MAPE and MdAPE, the mean and median of (percent), over only, the excluded count is reported; ; ; Pearson ; total absolute error ; misallocated share , the share of people placed in the wrong unit. Undefined metrics are NULL. best_in lists the metrics a method is best in (lowest error, highest and , smallest ).
| Parameter | Description | Type | Default |
|---|---|---|---|
ZONES | Source zones (census polygons) | vector layer | |
COUNT_FIELD | Count field | field | |
KEY_FIELD | Zone key field (empty: feature id) | field (optional) | |
METHODS | Methods; options: Areal weighting | Binary dasymetric | Multi-class dasymetric | Continuous ancillary | Building-based | Pycnophylactic | Dasymetric-pycnophylactic | choice | Areal weighting, Building-based |
BUILDINGS | Building footprints | vector layer (optional) | |
WEIGHT | Building weight; options: Count (1 per building) | Footprint area | Floor area (footprint floors) | Volume (footprint height) | A field (e.g. dwellings) | choice | Floor area (footprint floors) |
HEIGHT_FIELD | Height field (m) | field (optional) | |
FLOORS_FIELD | Floors field | field (optional) | |
WEIGHT_FIELD | Weight field (weight = a field) | field (optional) | |
STOREY | Storey height (m), floors | number (advanced) | 3.0 |
DEFAULT_FLOORS | Floors when unknown (0: zone median of known floors, else 1) | number (advanced) | 0.0 |
SPLIT | Zone of a building; options: Zone of the point on surface | Split by overlap area | choice (advanced) | Zone of the point on surface |
FILTER | Building filter expression (empty: all) | expression (optional, advanced) | |
MIN_AREA | Minimum footprint area () | number (advanced) | 20.0 |
BUILTUP | Built-up raster (GHS-BUILT-S/V or local) | raster layer (optional) | |
BUILTUP_KIND | Built-up raster values; options: Count per cell (GHS-BUILT-S/V, summed) | Share or density (averaged) | choice (advanced) | Count per cell (GHS-BUILT-S/V, summed) |
PRIOR | Population prior (GHS-POP, WorldPop or local) | raster layer (optional) | |
LANDCOVER | Land-cover raster (WorldCover or local) | raster layer (optional) | |
CLASS_WEIGHTS | Land-cover class table (class, relative density) | table (optional, advanced) | WorldCover default table |
CLASS_MODE | Multi-class densities; options: Intelligent dasymetric mapping (sampled densities) | Regression (NNLS) | Fixed relative densities (class table) | choice (advanced) | Intelligent dasymetric mapping (sampled densities) |
IDM_THRESHOLD | IDM: minimum class share of a sampled zone | number (advanced) | 0.8 |
IDM_MIN_ZONES | IDM: minimum sampled zones per class | number (advanced) | 3 |
MASK_SOURCE | Binary and hybrid mask from; options: Buildings present | Built-up raster above the threshold | Land-cover class weight above the threshold | choice (advanced) | Buildings present |
MASK_THRESHOLD | Mask threshold | number (advanced) | 0.0 |
BETA_BUILTUP | Continuous: exponent of the built-up layer | number (advanced) | 1.0 |
BETA_PRIOR | Continuous: exponent of the population prior | number (advanced) | 1.0 |
USE_MASK | Continuous: multiply by the mask | yes/no (advanced) | False |
ITERATIONS | Pycnophylactic: maximum iterations | number (advanced) | 500 |
TOLERANCE | Pycnophylactic: tolerance | number (advanced) | 0.0001 |
RELAX | Pycnophylactic: relaxation | number (advanced) | 0.5 |
BOUNDARY | Pycnophylactic: boundary; options: Zero outside the study area (Tobler) | Free (mirrored edge) | choice (advanced) | Zero outside the study area (Tobler) |
CELL | Cell size (m) | number | 100.0 |
SUPERSAMPLE | Supersampling per cell side (zone fractions) | number (advanced) | 4 |
WORKING_CRS | Working CRS (empty: UTM or LAEA by the extent rule) | CRS (optional, advanced) | |
BLOCK | Block side (m, 0: ) | number | 0.0 |
METRICS | Accuracy metrics | vector output |
Outputs: METRICS Accuracy metrics; BEST_RMSE Lowest RMSE; LEVEL Validation level.
Group: Accuracy.
Sums a gridded population product (GHS-POP, WorldPop or a local raster, warped onto the working grid with sum resampling so totals are kept) over every census zone with the zone fractions and divides it by the census count: , with the prior in cell . Reports the median ratio, the interquartile range and the share of zones with (within ). This is agreement between two estimates, not accuracy. Zones with a NULL or zero count get a NULL ratio.
| Parameter | Description | Type | Default |
|---|---|---|---|
ZONES | Source zones (census polygons) | vector layer | |
COUNT_FIELD | Count field | field | |
KEY_FIELD | Zone key field (empty: feature id) | field (optional) | |
PRIOR | Population prior (GHS-POP, WorldPop or local) | raster layer | |
CELL | Cell size (m) | number | 100.0 |
SUPERSAMPLE | Supersampling per cell side (zone fractions) | number (advanced) | 4 |
WORKING_CRS | Working CRS (empty: UTM or LAEA by the extent rule) | CRS (optional, advanced) | |
OUTPUT | Zones with the prior ratio | vector output |
Outputs: OUTPUT Zones with the prior ratio; MEDIAN Median ratio; Q1 First quartile; Q3 Third quartile; WITHIN_20 Share of zones within 20 percent; N Zones compared; PRIOR_TOTAL Prior total over the zones; CENSUS_TOTAL Census total.
Group: Data.
Downloads the tiles of a population, built-up or land-cover product that cover an extent into a cache folder through the QGIS network settings (proxy and authentication), and returns the raster (a VRT mosaic when several tiles are needed). Run it first with Only report the size to see the URLs and the download size (HTTP HEAD) before anything is downloaded. Cached files are reused; GHSL ocean tiles that do not exist (HTTP 404) are listed and read as zero. WorldPop needs the ISO3 country code (e.g. TUR) and serves no byte ranges, so its file is always downloaded whole. Licence and citation are returned for the report.
| Parameter | Description | Type | Default |
|---|---|---|---|
PRODUCT | Product; options: GHS-POP R2023A (100 m) | GHS-BUILT-S R2023A (100 m) | GHS-BUILT-V R2023A (100 m) | WorldPop R2025A constrained (100 m) | ESA WorldCover 10 m | choice | GHS-POP R2023A (100 m) |
YEAR | Year (GHSL epochs 1975-2030 every 5 years; WorldPop 2015-2030; WorldCover 2020 or 2021) | number | 2020 |
EXTENT | Study extent | extent | |
ISO3 | Country (ISO3, WorldPop only) | text (optional) | |
CACHE | Cache folder | folder (optional) | system temp folder / zero2dasymetric_cache |
PLAN_ONLY | Only report the size (no download) | yes/no | False |
STREAM | Read GHSL and WorldCover remotely (GDAL /vsicurl/) instead of downloading | yes/no (advanced) | False |
Outputs: OUTPUT Raster; BYTES Bytes downloaded; PLANNED_BYTES Bytes still to download; URLS URLs; MISSING Missing tiles; LICENCE Licence; CITATION Citation.
| Output | Content |
|---|---|
Surface GeoTIFF <method>.tif (<field>_<method>.tif for further
count fields) | people per cell on the working grid; nodata outside every zone |
| Buildings | the building's own fields plus src_key (zone key), w_<mode>
(weight), <field>_est (float) and <field>_int (largest-remainder integer) per
count field; NULL for ineligible buildings. The _est and _int names are shared with
02GreenRule and 02NoiseLab, which read this layer directly. |
| Targets | a copy of the target polygons with <method>_est (one count field) or
<field>_<method>_est (several); building-based estimates sum the buildings whose point on
surface lies in each polygon. With one count field also area_km2 (planar, working CRS; added when
absent) and <method>_dens (people per ) |
Method spread GeoTIFF method_spread_cv.tif | per cell, the coefficient of variation , with and over the method surfaces of the first count field: where it is high, the estimate depends on the method choice. Defined where every surface is defined and , nodata elsewhere; written with every run of two or more methods and by GeoTIFF per method |
| Error layer | obs, est_<m>, err_<m> ,
ape_<m> (percent, NULL where ) |
| Accuracy metrics table | one row per method: n, obs_total, est_total, rmse, mae, bias, mape, mdape,
cv_rmse, r2, pearson_r, tae, misallocated_share, best_in (equations (14) to (18)) |
| Run table | one row per count field and method: mass_error_max , fallback_zones, fallback_people,
inhabited_cells, iterations, total |
| HTML report | inputs, working CRS and reason, parameters, per-method checks, class densities, the comparison table, the method spread summary, charts as inline SVG, every formula (typeset with KaTeX, numbered as in this manual), data source, licence and reference, and the run log |
The demo city is deterministic: in UTM 35N around (500 000, 4 250 000), far from the projection origin. People live only in residential buildings, in proportion to floor area times a smooth radial gradient; the zone counts are that planted truth summed per zone, so every method can be scored.
population (the source zones; 143 313 people in total);pop_true (validation zones);type (residential, commercial, garage), height and
floors;"type" = 'residential' and the height and floors fields are picked up by name (floors are
used before height): 5 157 of 5 942 buildings are eligible.pop_true, and press
Assess.population,
key dist_id, all seven methods, the buildings with the filter above and floors field
floors, the three rasters, validation Validation zones with known counts on the neighbourhoods
with pop_true, and a report path.RMSE against the 36 neighbourhoods (people per neighbourhood; mean count about 3 980):
| Method | RMSE |
|---|---|
| Building-based (floor area, residential filter) | 117 |
| Continuous (built-up and prior) | 351 |
| Pycnophylactic | 461 |
| Dasymetric-pycnophylactic (building mask) | 470 |
| Multi-class (IDM) | 877 |
| Binary (building mask) | 1 251 |
| Areal weighting | 1 732 |
Aggregate-up self-validation of areal weighting and building-based allocation on the districts alone gives RMSE 22 700 and 1 738: the same ranking without any finer data. Prior agreement: the median ratio of the noisy prior to the census is 0.99 over the nine districts.
The demo numbers are reproduced by the plugin's test suites on every release (smoke_truth, smoke_pipeline, smoke_processing).
If you use 02Dasymetric in published work, cite it (see CITATION.cff) together with the method
papers and the data products you used:
Eminoğlu, Y. (2026). 02Dasymetric - Population Disaggregation Lab (version 0.1.2) [QGIS plugin]. https://gitlab.com/geophilo1/zero2dasymetric. https://doi.org/10.5281/zenodo.24263646. The DOI 10.5281/zenodo.24263646 always resolves to the latest version; version 0.1.2 has DOI https://doi.org/10.5281/zenodo.24263647.
Licence: GPL-2.0-or-later. Copyright (C) 2026 Yusuf Eminoğlu (Geophilo).