geoskill-building-density-mapping

Estimate building footprint density and floor area ratio (FAR) from building footprints and heights using kernel density estimation.

建筑密度制图 | Building Density Mapping

Estimates building density (building coverage ratio) and floor area ratio (FAR) from building footprint rasters, for urban form analysis, development intensity assessment, and planning management.

Core algorithm: takes a binary building footprint raster as input and applies local mean convolution with a square kernel to obtain a continuous density field in [0, 1]; FAR is then computed as FAR = building density × (building height / standard floor height). The density kernel is conservative, density equals 1 in purely built-up areas and 0 in purely vacant land, and FAR satisfies an analytical relationship with height/floor height.

Dependencies / 依赖

bash

pip install 'numpy' 'rasterio' 'scipy'

Usage / 使用方法

Basic Usage

bash

python geoskill-building-density-mapping.py --bbox 116.0 39.0 117.0 40.0 [other parameters]

Examples

Example 1 (Synthetic Data (Offline))

bash

python geoskill-building-density-mapping.py --bbox 116.0 39.0 117.0 40.0 --synthetic --output-dir ./out

Example 2 (Usage 2)

bash

python geoskill-building-density-mapping.py --input footprints.tif --heights heights.tif --output-dir ./out

Example 3 (Usage 3)

bash

python geoskill-building-density-mapping.py --bbox 121.0 31.0 122.0 32.0 --kernel-size 7 --output-dir ./out --quiet

Example 4 (Usage 4)

bash

python geoskill-building-density-mapping.py --input fp.tif --floor-height 3.5 --output-dir ./out

Example 5 (Usage 5)

bash

python geoskill-building-density-mapping.py --bbox 116.0 39.0 117.0 40.0 --synthetic --kernel-size 3 --output-dir ./out --quiet

Output / 输出

File	Format	Description
building_density.tif	GeoTIFF	Two bands: band1=building density, band2=floor area ratio (FAR)
density_stats.json	JSON	Density/FAR statistics (mean, maximum, floor height)
output-manifest.json	JSON	Run manifest

Data Source / 数据源 / Source

Local building footprint + building height GeoTIFFs; --synthetic mode generates an offline simulated scene containing random building blocks.

Privacy / 隐私声明 / Privacy

• Runs offline by default; --synthetic mode requires no network access at all.
• All processing is performed locally; no user data is uploaded.

License / License

MIT

---

---

name: geoskill-building-density-mapping description: 'Estimate building footprint density and floor area ratio (FAR) from building footprints and heights using kernel density estimation.'

建筑密度制图 | Building Density Mapping

从建筑足迹栅格估计建筑密度（建筑覆盖率）与容积率（FAR），用于城市形态分析、开发强度评估与规划管理。

核心算法：以建筑足迹二值栅格为输入，用方形核做局部均值卷积得到连续的密度场 [0,1]；再由 FAR = 建筑密度 × (建筑高度 / 标准层高) 计算容积率。密度核守恒、纯建筑区密度为 1、纯空地为 0，FAR 与高度/层高满足解析关系。

依赖

bash

pip install 'numpy' 'rasterio' 'scipy'

使用方法

基本用法

bash

python geoskill-building-density-mapping.py --bbox 116.0 39.0 117.0 40.0 [其他参数]

示例

示例 1（合成数据（离线））

bash

python geoskill-building-density-mapping.py --bbox 116.0 39.0 117.0 40.0 --synthetic --output-dir ./out

示例 2（用法 2）

bash

python geoskill-building-density-mapping.py --input footprints.tif --heights heights.tif --output-dir ./out

示例 3（用法 3）

bash

python geoskill-building-density-mapping.py --bbox 121.0 31.0 122.0 32.0 --kernel-size 7 --output-dir ./out --quiet

示例 4（用法 4）

bash

python geoskill-building-density-mapping.py --input fp.tif --floor-height 3.5 --output-dir ./out

示例 5（用法 5）

bash

python geoskill-building-density-mapping.py --bbox 116.0 39.0 117.0 40.0 --synthetic --kernel-size 3 --output-dir ./out --quiet

输出

文件	格式	说明
building_density.tif	GeoTIFF	双波段：band1=建筑密度，band2=容积率 FAR
density_stats.json	JSON	密度/FAR 统计（均值、最大值、层高）
output-manifest.json	JSON	运行清单

数据源 / Source

本地建筑足迹 + 建筑高度 GeoTIFF；--synthetic 模式生成含随机建筑块的离线模拟场景。

隐私声明 / Privacy

• 默认离线运行，--synthetic 模式完全无网络。
• 所有处理在本地完成，不上传用户数据。

License

MIT