Skip to content

YusufEminoglu/PlanX-Settlement

Repository files navigation

PlanX Settlement Planning Toolset icon

PlanX Settlement Planning Toolset

9-stage parametric settlement-plan pipeline for QGIS — blocks, parcels, building footprints, parking and landscape (Processing).

QGIS Version License QGIS Plugin Hub


Why this toolset?

Producing a complete settlement plan by hand — subdividing blocks, placing footprints, fitting parking, adding landscape — takes days of repetitive geometry work. This toolset automates the full production line as a sequential, parameter-driven Processing pipeline: start from zoning blocks, end with a populated, reported settlement plan.

✨ Features

  • Real-time parcel asymmetry — ParcelFlux distributes widths with organic variation across opposing block rows.
  • Four footprint strategies — detached, attached, twin/triple block, and island-scale FAR-driven generation.
  • Procedural architectural forms — 12 mass typologies (I, L, U, T, …) with minimum 7 m wing depths, matched to parcel structure.
  • Road-guided parking — the engine analyzes the road network and connects parking entry lines to the nearest road alignment (90°/60°/45°).
  • Landscape & reporting — vegetation adapted to parcel geometry, plus population projection and statistics summary.
  • QGIS 3.40+ LTR compatible — core geometry engine updated for recent API revisions.

🚀 Installation

From the QGIS Plugin Hub (recommended): Plugins → Manage and Install Plugins… → search for "PlanX Settlement"Install.

From a release zip: download the latest zip from ReleasesPlugins → Install from ZIP.

Requires QGIS 3.28 or newer (3.40/3.44 LTR recommended). No external Python dependencies.

📖 Quick start

  1. Install and activate the plugin — tools appear under Processing Toolbox → PlanX Settlement Planning Toolset.
  2. Load a zoning block polygon layer.
  3. Run 1 — ParcelFlux to subdivide blocks into parcels.
  4. Continue down the pipeline: facades → footprints → optimizer → parking → landscape → finalizer.

⚙️ The 9-stage workflow

# Tool What it does
1 ParcelFlux Subdivides blocks into parcels with width variation and row asymmetry
2 FacadeDetector Detects and classifies parcel facades (front / side / rear setbacks)
3A CoverageFootprint Detached Parcel footprints for detached layout using edge-based setbacks and TAKS
3B CoverageFootprint Attached Attached-layout row footprints by grouping side-neighbor parcels in the same block
3C CoverageFootprint Block Twin / triple block-layout footprints by grouping parcels with shared block IDs
3D CoverageFootprint FAR Island-scale footprints from emsal and yençok values with fixed approach distances
3B Building Macroform Places basic building masses on parcels
3C Dynamic Macroform Procedurally derives 12 realistic architectural form typologies (I, L, U, T, …)
4 BuildingOptimizer Validates building-parcel fit and resolves geometric conflicts
5 Hard Surface Calculates hard surface and pedestrian circulation areas
6 ParkingGenerator Road-network-aware parametric parking engine (90° / 60° / 45°)
7 LandscapeGenerator Places trees and vegetation adapted to parcel geometry
8 SettlementFinalizer Population projection, statistics summary, and reporting

Full version history: CHANGELOG.md

🧩 Part of the PlanX ecosystem

This plugin is one of 15 open-source QGIS plugins for urban planning by the same author:

Planning & analysis CAD & production 3D & visualization
PlanX — spatial-planning suite PlanX CAD Toolset — drafting-grade CAD PlanX 3D City — Three.js city viewer
GeoStats Lab — spatial statistics EasyFillet — tangent-arc fillet 3D OSM Model — OSM → 3D city in browser
Suitability Lab — raster MCDA Settlement Toolset — 9-stage settlement plans OSM Quick 3D — OSM → native QGIS 3D
DataCube Lab — spatiotemporal cubes UIP Toolset — Turkish master-plan automation Urban Procedural 3D — parametric zoning lab
Urban Resilience — 28 resilience tools ParcelFlux — parcel subdivision CartoLab — publication cartography

📜 License & author

GPL-3.0 © Yusuf Eminoğlu — Dokuz Eylül University, Department of City and Regional Planning. Bug reports and feature requests welcome in Issues.

About

9-stage parametric settlement-plan pipeline for QGIS - blocks, parcels, building footprints, parking and landscape (Processing).

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages