Papers › UrbanDiT: A Foundation Model for Open-World Urban Spatio-Temporal Learning

UrbanDiT: A Foundation Model for Open-World Urban Spatio-Temporal Learning

19 Nov 2024arXiv:2411.12164archive 2025-07-28

Yuan Yuan, Chonghua Han, Jingtao Ding, Depeng Jin, Yong Li

The urban environment is characterized by complex spatio-temporal dynamics arising from diverse human activities and interactions. Effectively modeling these dynamics is essential for understanding and optimizing urban systems In this work, we introduce UrbanDiT, a foundation model for open-world urban spatio-temporal learning that successfully scale up diffusion transformers in this field. UrbanDiT pioneers a unified model that integrates diverse spatio-temporal data sources and types while learning universal spatio-temporal patterns across different cities and scenarios. This allows the model to unify both multi-data and multi-task learning, and effectively support a wide range of spatio-temporal applications. Its key innovation lies in the elaborated prompt learning framework, which adaptively generates both data-driven and task-specific prompts, guiding the model to deliver superior performance across various urban applications. UrbanDiT offers three primary advantages: 1) It unifies diverse data types, such as grid-based and graph-based data, into a sequential format, allowing to capture spatio-temporal dynamics across diverse scenarios of different cities; 2) With masking strategies and task-specific prompts, it supports a wide range of tasks, including bi-directional spatio-temporal prediction, temporal interpolation, spatial extrapolation, and spatio-temporal imputation; and 3) It generalizes effectively to open-world scenarios, with its powerful zero-shot capabilities outperforming nearly all baselines with training data. These features allow UrbanDiT to achieves state-of-the-art performance in different domains such as transportation traffic, crowd flows, taxi demand, bike usage, and cellular traffic, across multiple cities and tasks. UrbanDiT sets up a new benchmark for foundation models in the urban spatio-temporal domain.

PaperPDFCodeCode Syntology ran

In Syntology Open this paper in Syntology's Atlas, the map of the papers in Syntology's graph and their citations.

For agents, Syntology's MCP tool lists every function and class Syntology harvested from this paper and whether it ran (how to connect): get_harvested_code_for_paper(arxiv_id="2411.12164")

Code

Syntology Ran 13 of 22 code samples harvested from 2 repositories linked to this paper; 9 have no recorded run. Of those that ran: 3 ran · honoured contract; 6 ran · our draft was wrong; 2 ran · fixture could not drive it; 2 ran with no contract checked.

By repository: official repository: 2 samples from 1 repository, 2 ran; found in paper text by Syntology: 20 samples from 1 repository, 11 ran. The run record, sample by sample. “Ran” means executed on a synthesized input, not that the code is correct or reproduces the paper.

YuanYuan98/UrbanDiT officialpytorch report

Repository list and official/mentioned flags are the archive's, frozen 2025-07-28. Reachability, where shown, is from one Syntology probe window (2026-09-16 to 2026-09-18); repositories not probed show nothing. GitHub stars are not tracked.

Code Syntology ran Syntology

22 samples harvested; 13 ran; 3 honoured the contract we drafted; 9 have no recorded run. Read from Syntology's graph 2026-09-24; that is when this build read the record, not when the samples ran.

3ran · honoured contract
6ran · our draft was wrong
2ran · fixture could not drive it
2ran
9unverified

Licence: 0 of the 22 samples are pointer only, meaning Syntology does not serve that copy's text. This page shows no code text for any sample; each one links to its file in the repository.

Harvested from 2 repositories linked to this paper, official or community; each sample names its own and says which. “Ran” means the sample executed on a synthesized input. It does not mean the output is correct, and nothing here reproduces the paper's results. “Honoured” and “violated” refer to a contract Syntology drafted from the code itself; “our draft was wrong” and “fixture could not drive it” are failures of Syntology's instrument, not of the code.

Each sample ends with its code_sha256, Syntology's identity for that exact code. An agent fetches the stored sample with Syntology's MCP tool get_code(code_sha256="…") (how to connect); click an identity to copy that call.

Repository labels, per sample. official repository: The archive marks this repository official for the paper. named in the paper: The archive records that the paper mentions this repository; it is not marked official. community (archive-listed): In the archive's code links for this paper, not marked official and not recorded as mentioned in the paper. found in paper text by Syntology: Syntology found this repository in the paper's own text; whether it is the authors' implementation is not asserted. community: Not in the archive's code links for this paper; a community repository Syntology harvested. Samples from a repository marked official are listed first. Licence labels name the repository's licence as recorded at harvest. “Pointer only” means Syntology does not serve that copy's text, for one of four reasons: no licence file was found; the licence was not identified; the licence is recorded as permissive but that copy's record is not marked cleared; or the licence is outside the permissive list Syntology serves text under (MIT, Apache-2.0, BSD and similar). Some licences outside that list permit redistribution, such as WTFPL, and GPL-3.0 under its conditions; they are simply not on the list. Hover a licence label for the reason. File links open the file on GitHub at the default branch, which may have changed since the harvest.

GCN YuanYuan98/UrbanDiT/src/Embed.py official repository ran · metamorphic tier: deterministic MIT (permissive) · 85748648fb97ed30 · report
GraphEmbedding2 YuanYuan98/UrbanDiT/src/Embed.py official repository ran · metamorphic tier: deterministic MIT (permissive) · 4af35c2b62c7fb82 · report
approx_standard_normal_cdf tsinghua-fib-lab/UrbanDiT/src/diffusion/diffusion_utils.py found in paper text by Syntology ran · our draft was wrong fingerprinted MIT (permissive) · d6a68e210556f857 · report
center_crop_arr tsinghua-fib-lab/UrbanDiT/src/train_one_step.py found in paper text by Syntology ran · our draft was wrong MIT (permissive) · 1712a07966b542ee · report
continuous_gaussian_log_likelihood tsinghua-fib-lab/UrbanDiT/src/diffusion/diffusion_utils.py found in paper text by Syntology ran · our draft was wrong MIT (permissive) · ab1c9568b4e13899 · report
create_logger tsinghua-fib-lab/UrbanDiT/src/train_one_step.py found in paper text by Syntology ran · our draft was wrong MIT (permissive) · b2cc78f4103df806 · report
get_1d_sincos_pos_embed_from_grid tsinghua-fib-lab/UrbanDiT/src/Embed.py found in paper text by Syntology ran · fixture could not drive it fingerprinted MIT (permissive) · 5c8ea92d43ead77d · report
get_beta_schedule tsinghua-fib-lab/UrbanDiT/src/diffusion/gaussian_diffusion.py found in paper text by Syntology ran · honoured contract MIT (permissive) · 3e0fa4efc22272d4 · report
get_named_beta_schedule tsinghua-fib-lab/UrbanDiT/src/diffusion/gaussian_diffusion.py found in paper text by Syntology ran · honoured contract MIT (permissive) · 36e30c7fb679ec78 · report
get_sigmas tsinghua-fib-lab/urbandit/src/train_one_step.py found in paper text by Syntology ran · our draft was wrong MIT (permissive) · 0897f66c098e3d8d · report
mean_flat tsinghua-fib-lab/UrbanDiT/src/diffusion/gaussian_diffusion.py found in paper text by Syntology ran · our draft was wrong fingerprinted MIT (permissive) · f6d7c009a8efb8b7 · report
normal_kl tsinghua-fib-lab/UrbanDiT/src/diffusion/diffusion_utils.py found in paper text by Syntology ran · honoured contract fingerprinted MIT (permissive) · 8afbfc42c6ea0448 · report
space_timesteps tsinghua-fib-lab/UrbanDiT/src/diffusion/respace.py found in paper text by Syntology ran · fixture could not drive it MIT (permissive) · ea9dbc131adf582e · report
create_named_schedule_sampler tsinghua-fib-lab/UrbanDiT/src/diffusion/timestep_sampler.py found in paper text by Syntology unverified MIT (permissive) · e48218d7d73db0b3 · report
edge_generate_grid tsinghua-fib-lab/UrbanDiT/src/DataLoader.py found in paper text by Syntology unverified MIT (permissive) · 61bae757140432aa · report
get_2d_sincos_pos_embed tsinghua-fib-lab/UrbanDiT/src/Embed.py found in paper text by Syntology unverified MIT (permissive) · 3739773ec6873943 · report
get_2d_sincos_pos_embed_from_grid tsinghua-fib-lab/UrbanDiT/src/Embed.py found in paper text by Syntology unverified MIT (permissive) · 2884deadbb637c3e · report
partition_graph tsinghua-fib-lab/UrbanDiT/src/DataLoader.py found in paper text by Syntology unverified MIT (permissive) · 1770fcb3db2d760a · report
retrieve_timesteps tsinghua-fib-lab/UrbanDiT/src/validation.py found in paper text by Syntology unverified MIT (permissive) · 572665172cac0917 · report
select_batch_size tsinghua-fib-lab/UrbanDiT/src/utils.py found in paper text by Syntology unverified MIT (permissive) · cb94ddc96b9220cc · report
select_patch_size tsinghua-fib-lab/UrbanDiT/src/utils.py found in paper text by Syntology unverified MIT (permissive) · 847b1b87d9c07bf8 · report
tensor_to_adjacency_matrix tsinghua-fib-lab/UrbanDiT/src/utils.py found in paper text by Syntology unverified MIT (permissive) · b97edc3163f3ded8 · report

Tasks

ImputationMulti-Task LearningPrompt Learning

Results from the paper archive 2025-07-28

No leaderboard rows for this paper in the archive.

Methods

Diffusion

Report a problem or propose a change · a person checks every report against the paper or source before anything changes; decisions are listed on /corrections