Overview and Rationale

Across Africa's rapidly growing cities, communities remain invisible in formal planning systems despite being well-represented in OpenStreetMap (OSM). While citizens map what matters to them, the analytical potential of this rich OSM data remains largely untapped—especially for education, community advocacy, and understanding urban inequalities.

geo3D

geo3D is an openly licensed Python framework that transforms OSM building footprints into interactive 3D city models and spatial analysis tools. It bridges the gap between grassroots mapping and data-driven urban insights, making sophisticated spatial analysis accessible to educators, NGOs, and community organizations across Africa.

geo3D is timely and novel in that it:

• Connects grassroots mapping with spatial data science;
• Produces ISO-conformant Level of Detail 1 (LoD1) models and lightweight pseudo-3D html visualisations from OSM building footprints;
• Enables value-added analysis like population estimation and BVPC to examine spatial inequality;
• Prioritises pedagogical transparency and reproducibility through open Jupyter Notebook;
• Embeds feedback loops between learning and OSM data improvement by flagging topological errors in buildings for user correction at the source;
• Is designed specifically for place-based learning at the neighbourhood level in African cities and settlements.

This workshop builds on a successful pilot in Cape Town, South Africa, geo3D was used to model local environments and uncover patterns of overcrowding, and housing inequality.

Structure and Activities

Duration: 1.5–1.75 hours
Format: Hands-on workshop with semi-structured demonstrations, peer learning, and Q\&A

• Introduction and Framing (10 minutes): Welcome and orientation to the workshop objectives with overview of geo3D.
• Live Demonstration and Guided Hands-on Activity (80 minutes): Work-through 4 Jupyter notebooks (3D modeling, spatial analysis --population estimation and Building Volume per Capita and visualization.
• Wrap-up and Community Building (15 minutes): Q&A, sharing ideas, and invitation to collaborate on geo3D’s GitHub repo and share derivative research and projects

OSM Alignment and Thematic Fit

geo3D is powered by OpenStreetMap. Its entire workflow—from extraction of building footprints to modelling and metric generation—is designed to extend the value of OSM data into educational, analytical, and advocacy contexts. The tool is intended not only to use OSM, but to enhance and contribute to it: participants are encouraged to detect and correct topological errors in OSM building data through geo3D's built-in diagnostic functions.

Thematically, the workshop aligns strongly with:
- Mapping for social justice and inclusion: by enabling visibility of housing inequality and under-resourced communities.
- Education and capacity-building: by bringing reproducible OSM workflows into classrooms and local organisations.
- Data quality and community verification: by supporting feedback loops between analysis and source improvement.

Learning Outcomes

By the end of the workshop, participants will:

1. Understand how to generate and validate 3D City Models from OSM data using open tools.
2. Be able to run and adapt geo3D to perform spatial analysis.
3. Learn how to estimate population and BVPC from building data and interpret results in local contexts.
4. Gain insights into reproducible workflow design for teaching, research, or community engagement.
5. Build confidence to lead similar workshops in their own institutions or communities.
6. Leave with links to reusable resources, sample data, and open documentation.

Target Audience and Requirements

Audience:
Primary: educators, community organizers, NGO's and development practitioners seeking accessible tools for spatial analysis and civic engagement. Secondary: OSM contributors interested in extending their mapping impact into advocacy and education

Requirements:
- Participants: Basic familiarity with GIS concepts is recommended but not mandatory. (Skill level: beginner - intermediate)
- Bring: Participants should bring laptops. Installation instructions and sample datasets will be made available.
- Room Requirements: A projector and reliable internet connection are essential for live demonstrations and collaborative exercises.

Reproducibility and Open Access

Participants will leave with a full reproducible pipeline they can adapt, reuse, and share. The workshop models best practices in open science and computational reproducibility.

geo3D. Harnessing OpenStreetMap for Community-Led 3D City Modelling and Sustainable Development Education in Africa

Abstract

While OpenStreetMap (OSM) has become central to participatory mapping across Africa, tools for extending 2D mapping into spatial modelling remain fragmented. This paper addresses: How can open geospatial data and free software enable reproducible, interactive, and meaningful local-scale 3D modelling for education and community empowerment in Africa?

We present geo3D: an openly licensed tool integrating OSM data, Jupyter Notebook, and 3D urban modelling for spatial reasoning and SDG-aligned learning. Rather than claiming educational effectiveness, we present geo3D as a foundational framework enabling communities to progress from descriptive mapping to analytical modelling for evidence-based planning and spatial literacy development.

Problem Statement

Participatory mapping has expanded rapidly across Africa through OSM, HOTOSM, and YouthMappers, contributing 6.2M building footprints between 2015-2021. However, engagement remains largely descriptive, focused on feature collection rather than analytical modelling or scenario exploration.

Key gaps identified include: Fragmented tools (Existing 3D tools, such as QGIS 3D, OSM2World and 3dfier address discrete pipeline stages without integration), Missing reproducible workflows (Participatory mapping remains project-based with undocumented processes), Educational limitations (Activities confined to digitization rather than higher-order spatial analysis), Technical barriers (No openly licensed framework links OSM data validation, 3D model generation, and spatial analysis)

This fragmentation reflects broader pedagogical challenges where mapping is introduced as an end rather than a pathway to spatial reasoning and problem-solving.

geo3D Framework (Technical Architecture / Methodology)

Implemented in Python within Jupyter Notebook, geo3D is guided by four principles:

1. Integration: Unified preprocessing, 3D generation, and spatial analysis workflows designed to execute at a community (local) level to facilitate hands-on, grassroots learning.
2. Reproducibility: Documented, replicable notebook-based pipelines
3. Standards compliance: ISO 19107-compliant topologically valid models with Jupyter Notebooks that conform to Computing Best Practice.
4. Accessibility: Openly licensed, cloud-deployable for low-resource contexts

geo3D operates under two primary Processing Options, determined by the scale of analysis:
- Village: Optimised for areas with fewer than 2500 buildings.
- Suburb: Tailored for areas with more than 2500 buildings.

Following this, users select a Processing Strategy based on their needs:
1. osm_LoD1_3DCityModel: A high-quality, lightweight LoD1 3D City Model adhering to Open Geospatial Consortium (OGC) and International Standards Organization (ISO) spatial schema for 3D primitives (ISO 19107). This model enables quantitative analyses for urban planning, noise propagation, energy demand, and wind comfort factors. The strategy requires a raster Digital Elevation Model (DEM).
2. interactiveOnly: A pseudo-3D HTML-based interactive visualisation tool for user engagement, navigation, and sharing.

Spatial Analysis Capabilities
Integrated analytical functions include: Population estimation based on building footprints and local knowledge, Building Volume per Capita (BVPC) spatial equity metric linking residential volume to population, Topology error detection creating feedback loops for OSM data improvement.

Cape Town Case Study

Testing across four diverse sites demonstrated technical feasibility:

Performance results:
Processing time varied from 8 seconds (50 buildings, 25m DEM) to 45 minutes (2,187 buildings, 5m DEM) with all models validated using val3dity for ISO 19107 compliance. Proof-of-concept demonstrates alignment between grassroots learning and neighbourhood-scale suitability .

Spatial analysis outcomes:
Population for all areas where estimated based on local knowledge and OSM data. Where areas had an existing census metric; a population growth rate and projected (future) population estimate was possible. These values yield: Mamre (peri-urban): 10,736 current population, 1.43% growth → 12,368 by 2034 and Salt River (urban): 9,023 current population, 2.63% growth → 11,703 by 2034

BVPC inequality analysis highlighted housing and economic disparity across all areas. Walmer Estate (affluent): 190.1m³/person, Salt River (urban): formal: 86.1m³/person and social housing: 96.6m³/person, Mamre (rural): formal 83.1m³/person and informal: 42.6m³/person (indicating overcrowding) and CPUT dormitories: 99.4m³/person

Results correspond with recent spatial inequality studies, providing quantitative evidence for SDG 11 discussions.

Discussion

By bridging descriptive and analytical practice geo3D addresses the mapping-to-modelling gap (highlighted in the Problem Statement) through:
- Integrated learning: Students learn programming while practicing scientific computing
- Place-based inquiry: Operating where users have local knowledge and experience
- Dual pedagogical tracks: Analytical rigour (LoD1 models) and community communication (pseudo-3D visualizations)
- Reproducible workflows: All steps documented in openly licensed Jupyter notebooks

SDG Alignment
While untested without validation; the geo3D framework supports: SDG 4 (Quality Education): Integrating digital literacy and computational thinking, SDG 8 (Decent Work): Building geospatial data science skills and SDG 11 (Sustainable Cities): Enabling communities to model and assess built environments

Scope Limitations and Future Research

While demonstrating technical feasibility, several critical aspects require further investigation:
- Educational effectiveness: No empirical evidence that geo3D improves spatial literacy or student engagement compared to traditional approaches. Educational value claims remain theoretical.
- Community empowerment impact: Assumptions that analytical tools lead to empowerment lack demonstration. Whether communities use geo3D outputs for advocacy or decision-making requires investigation.
- Meaningfulness: BVPC and population metrics reflect researcher rather than demonstrated community priorities. Indicator relevance needs community validation.
- Contextual transferability: Evidence limited to Cape Town. Applicability across diverse African contexts—varying infrastructure, resources, linguistic and cultural approaches—remains untested.

This positioning establishes geo3D as a proven technical foundation while acknowledging the empirical work needed to validate its educational and empowerment potential. In other words: the research question (how) has been satisfied but the paper has exposed several avenues of further research that must investigate the tools effectiveness.

Research Opportunities and Implementation

Community Research Pathways
- Participatory validation: Feedback loops between analysis and OSM editing
- Educational research: Investigating how 3D modelling influences spatial literacy
- Interdisciplinary collaboration: Linking mapping with public health, climate adaptation, housing policy

Technical Requirements
- Python 3.9 with Jupyter Notebook
- Cloud deployment eliminates installation barriers
- Optimized for neighbourhood scales (50-5,000 buildings)
- Modular design adaptable to schools, universities, NGOs, community organizations

Contribution and Future Development

This tool paper contributes:
1. Methodological innovation: Linking grassroots mapping with analytical urban modelling
2. Educational framework: Demonstrating reproducible spatial workflows as pedagogical tools
3. Technical foundation: Providing tested, extensible pipeline for diverse contexts
4. Community platform: Enabling progression from descriptive cartography to interactive modelling

Future development focuses on partnerships with OSM Africa networks and responding to the needs of the community

Conclusion

geo3D addresses how open geospatial data and openly licensed software can enable meaningful local-scale modelling by providing a reproducible foundation for participatory spatial education. The framework transforms the question from "what is mapped" to "what can be modeled and interrogated," supporting evolution from descriptive cartography to analytical spatial reasoning.

As proven technical capability rather than demonstrated social impact, geo3D establishes a platform for collaborative research addressing African urban development challenges while acknowledging the empirical work needed to validate educational and empowerment potential.

A lightning talk is available at: https://adriankriger.github.io/geo3D/