STM-Graph: A Python Framework for Spatio-Temporal Mapping and Graph Neural Network Predictions

arXiv:2509.10528 · cs.LG, cs.AI · Submitted 2025-09-04 · Read on arXiv

cs.LG, cs.AI

Submitted: 2025-09-04

Updated: 2025-09-04

Comments: Accepted manuscript (CC BY 4.0). To appear in ACM CIKM 2025, Seoul, Nov 10-14, 2025. DOI: 10.1145/3746252.3761645. The Version of Record will be uploaded when available

Journal ref: Proceedings of the 34th ACM International Conference on Information and Knowledge Management (CIKM '25), 2025, pp. 6377-6381

DOI: 10.1145/3746252.3761645

License: http://creativecommons.org/licenses/by/4.0/

The gist: Urban spatio-temporal data present unique challenges for predictive analytics due to their dynamic and complex nature.

Terminology

Abstract

Urban spatio-temporal data present unique challenges for predictive analytics due to their dynamic and complex nature. We introduce STM-Graph, an open-source Python framework that transforms raw spatio-temporal urban event data into graph representations suitable for Graph Neural Network (GNN) training and prediction. STM-Graph integrates diverse spatial mapping methods, urban features from OpenStreetMap, multiple GNN models, comprehensive visualization tools, and a graphical user interface (GUI) suitable for professional and non-professional users. This modular and extensible framework facilitates rapid experimentation and benchmarking. It allows integration of new mapping methods and custom models, making it a valuable resource for researchers and practitioners in urban computing. The source code of the framework and GUI are available at: https://github.com/Ahghaffari/stm graph and https://github.com/tuminguyen/stm graph gui.

Related papers