How zhu-xlab/globalbuildingatlas works
GlobalBuildingAtlas provides global building footprints, estimated heights and LoD1 models. Its documented development workflow covers satellite-image building-map extraction and polygon refinement, height inference, footprint fusion, and LoD1 generation; users can then derive final LoD1 GeoJSON from released polygon and model data. The repository also includes a geospatial dataset/transform library and plotting utilities. Several implementation stages are documented but not sampled, so those links are labeled from the README; source-level edges are limited to relationships visible in excerpts or the SOURCE INDEX.
Main entry points: utils.py Inference utilities · main.py LoD1 generation · inference.py Segmentation inference · encoder_decoder.py Segmentation model
Components 19
Building polygons
- Segmentation inference
im2bf/GBA_Poly/rsipoly/apis/inference.py - Segmentation model
im2bf/GBA_Poly/rsipoly/models/segmentors/encoder_decoder.py - Polygon simplification
im2bf/GBA_Poly/rsipoly/models/segmentors/poly_simplifier_v15.py - Footprint fusion
fuse_bf/main.py - Source queries and fusion
fuse_bf/utils.py
Height inference
- Height inference runner
infer_height/main.py - Inference utilities
infer_height/utils.py - Height models
infer_height/baselines/adabins_htc.py - UNet baseline
infer_height/baselines/unet.py
LoD1 generation
- LoD1 generation
make_lod1/main.py - LoD1 GeoJSON
Dataset tooling
- EO datasets
im2bf/Dataset4EO/Dataset4EO/datasets/_api.py - Image augmentation
im2bf/Dataset4EO/Dataset4EO/transforms/_auto_augment.py
Visualization
- Publication plots
make_plots
Other components
- Data user
- Satellite imagery
- Footprint sources
- Released datasets
- Research user
Connections 16
- Satellite imagery → Segmentation inference: provides imagery
README.md - Segmentation inference → Segmentation model: runs model
im2bf/GBA_Poly/rsipoly/apis/inference.py - Segmentation model → Polygon simplification: supports refinement
README.md - EO datasets → Image augmentation: supports training
README.md - Data user → Footprint fusion: runs fusion
README.md - Footprint fusion → Source queries and fusion: queries and processes
fuse_bf/main.py - Source queries and fusion → Footprint sources: queries footprints
fuse_bf/utils.py - Satellite imagery → Height inference runner: provides imagery
README.md - Height inference runner → Inference utilities: calls utilities
infer_height/main.py - Inference utilities → Height models: uses model
infer_height/utils.py - Inference utilities → UNet baseline: uses baseline
infer_height/utils.py - Data user → LoD1 generation: runs generation
README.md - Released datasets → LoD1 generation: supplies polygons and models
README.md - LoD1 generation → LoD1 GeoJSON: writes models
README.md - Data user → Released datasets: downloads tiles
README.md - Research user → Publication plots: reproduces figures
README.md