SWAN

An open-source 3D shadow analysis tool for cities

Journal Article (2026)
Author(s)

Ziya Usta (TU Delft - Urban Data Science)

DOI related publication
https://doi.org/10.1016/j.softx.2026.102659 Final published version
More Info
expand_more
Publication Year
2026
Language
English
Journal title
SoftwareX
Volume number
34
Article number
102659
Downloads counter
1
Reuse Rights

Other than for strictly personal use, it is not permitted to download, forward or distribute the text or part of it, without the consent of the author(s) and/or copyright holder(s), unless the work is under an open content license such as Creative Commons.

Abstract

SWAN (S hado W AN alysis for Cities) is an open-source, platform-independent Python tool designed for high-fidelity 3D shadow analysis using CityJSON-format 3D city models. Unlike proprietary or limited tools, SWAN performs tessellation of building surfaces and applies ray-tracing via Open3D to compute shadow durations with fine spatial and temporal granularity. The software integrates results into PostGIS, enabling advanced spatial queries for urban planning, solar energy optimization, and microclimate studies. With modular architecture, reproducibility, and MIT licensing, SWAN provides a reusable and extensible solution for researchers, planners, and architects, advancing urban sustainability and supporting data-driven decisions in smart city applications.