# hkuds/awesome-llm4urban-papers architecture

> Architecture diagram of the GitHub repository hkuds/awesome-llm4urban-papers, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-07-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hkuds/awesome-llm4urban-papers
- Repository: https://github.com/hkuds/awesome-llm4urban-papers

## Overview

1. This repository is a static curated knowledge base, not an executable application. Its “architecture” is primarily documentation structure: one top-level `README.md` plus a `fig/` directory for illustrative images.

2. The central subsystem is the taxonomy in the README. It organizes the literature into nine urban-computing application domains: transportation, safety, mobility, environment, travel, planning, energy, geoscience, and autonomous driving. This taxonomy is the main navigation boundary for readers.

4. The content itself is a bibliographic index. Each entry is a paper citation with venue/year, a short task label, and an outbound link to the paper. The repository does not store datasets, models, or code; it stores references and human-readable summaries.

5. The README also serves as the main entry point and table of contents. All major sections are linked internally, making the document behave like a single-page information portal rather than a multi-file site.

6. The `fig/` directory provides the visual framework referenced by the README. The images illustrate the survey’s high-level categorization and the role-based framing of LLMs in urban computing, but they are supportive artifacts rather than separate subsystems.

7. External dependencies are limited to linked resources: arXiv, IEEE, ACM, journal sites, and conference proceedings. These links are the primary data flow outward from the repo—users move from the curated index to source papers and the associated survey article.

8. There is a strong separation between curation and scholarship. The repository aggregates and classifies public research; it does not implement the surveyed methods. That boundary is important: the repo is a map of the field, not a platform for running urban-LLM workloads.

9. The repository’s update model is editorial. The badges and “PRs welcome” messaging imply community-maintained curation, so the only evolving “pipeline” is manual addition, reclassification, and linking of new papers.

Main entry points: [`README.md`](https://github.com/hkuds/awesome-llm4urban-papers/blob/main/README.md) (README), [`fig`](https://github.com/hkuds/awesome-llm4urban-papers/tree/main/fig) (Figures)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_docs["Documentation core"]
  node_readme["README<br/>entrypoint<br/>[README.md]"]
  node_taxonomy{{"Taxonomy<br/>survey framework"}}
  node_roles{{"LLM roles<br/>analysis lens"}}
  node_papers["Paper index<br/>bibliography"]
  node_citations["Citations<br/>reference list"]
  node_links(("Outbound links<br/>external refs"))
  node_transportation["Transportation<br/>domain"]
  node_safety["Safety<br/>domain"]
  node_mobility["Mobility<br/>domain"]
  node_environment["Environment<br/>domain"]
  node_travel["Travel<br/>domain"]
  node_planning["Planning<br/>domain"]
  node_energy["Energy<br/>domain"]
  node_geoscience["Geoscience<br/>domain"]
  node_autonomous["Autonomous driving<br/>domain"]
  node_encoder(("Encoder<br/>LLM role"))
  node_enhancer(("Enhancer<br/>LLM role"))
  node_predictor(("Predictor<br/>LLM role"))
  node_assistant(("Assistant<br/>LLM role"))
  node_agent(("Agent<br/>LLM role"))
end

subgraph group_figs["Visual assets"]
  node_figdir[("Figures<br/>supporting assets")]
end

node_readme -->|"organizes"| node_taxonomy
node_readme -->|"frames"| node_roles
node_readme -->|"indexes"| node_papers
node_readme -->|"references"| node_figdir
node_taxonomy -->|"includes"| node_transportation
node_taxonomy -->|"includes"| node_safety
node_taxonomy -->|"includes"| node_mobility
node_taxonomy -->|"includes"| node_environment
node_taxonomy -->|"includes"| node_travel
node_taxonomy -->|"includes"| node_planning
node_taxonomy -->|"includes"| node_energy
node_taxonomy -->|"includes"| node_geoscience
node_taxonomy -->|"includes"| node_autonomous
node_roles -->|"classifies"| node_encoder
node_roles -->|"classifies"| node_enhancer
node_roles -->|"classifies"| node_predictor
node_roles -->|"classifies"| node_assistant
node_roles -->|"classifies"| node_agent
node_papers -->|"contains"| node_citations
node_papers -->|"outlinks"| node_links
node_figdir -.->|"illustrates"| node_taxonomy
node_figdir -.->|"illustrates"| node_roles
node_papers -.->|"mapped by"| node_taxonomy
node_papers -.->|"mapped by"| node_roles

click node_readme "https://github.com/hkuds/awesome-llm4urban-papers/blob/main/README.md"
click node_figdir "https://github.com/hkuds/awesome-llm4urban-papers/tree/main/fig"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_readme,node_taxonomy,node_roles,node_papers,node_citations,node_links,node_transportation,node_safety,node_mobility,node_environment,node_travel,node_planning,node_energy,node_geoscience,node_autonomous,node_encoder,node_enhancer,node_predictor,node_assistant,node_agent toneBlue
class node_figdir toneAmber
```

## Components

### Documentation core

README-centered curated knowledge base and taxonomy

- [README](https://github.com/hkuds/awesome-llm4urban-papers/blob/main/README.md): entrypoint · Single-page table of contents and main curation surface · `README.md`
- **Taxonomy**: survey framework · Primary organization of the literature by urban-computing domain
- **LLM roles**: analysis lens · Second-level classification by how LLMs are used
- **Paper index**: bibliography · Curated list of cited research entries with metadata
- **Citations**: reference list · Individual paper references, venues, years, and task labels
- **Outbound links**: external refs · Links to paper sources and publisher pages
- **Transportation**: domain · Urban mobility and transit-related research
- **Safety**: domain · Public safety and incident-oriented research
- **Mobility**: domain · Movement behavior and accessibility research
- **Environment**: domain · Environmental sensing, impacts, and conditions
- **Travel**: domain · Trip planning and travel experience research
- **Planning**: domain · Urban planning and policy-support research
- **Energy**: domain · Urban energy systems and demand research
- **Geoscience**: domain · Spatial, earth, and geodata-focused research
- **Autonomous driving**: domain · Self-driving and traffic intelligence research
- **Encoder**: LLM role · LLMs used for representation or feature encoding
- **Enhancer**: LLM role · LLMs used to improve or augment another component
- **Predictor**: LLM role · LLMs used for forecasting or classification outputs
- **Assistant**: LLM role · LLMs used as interactive helpers or copilots
- **Agent**: LLM role · LLMs used for action-taking or workflow execution

### Visual assets

Supporting figures referenced by the survey

- [Figures](https://github.com/hkuds/awesome-llm4urban-papers/tree/main/fig): supporting assets · Illustrative images that frame the survey taxonomy · `fig`

## Connections

- README → Taxonomy: organizes · README introduces the domain taxonomy
- README → LLM roles: frames · README defines the role-based comparison lens
- README → Paper index: indexes · README aggregates the bibliographic index
- README → Figures: references · README points to supporting figures
- Taxonomy → Transportation: includes · One of the nine urban-computing domains
- Taxonomy → Safety: includes · One of the nine urban-computing domains
- Taxonomy → Mobility: includes · One of the nine urban-computing domains
- Taxonomy → Environment: includes · One of the nine urban-computing domains
- Taxonomy → Travel: includes · One of the nine urban-computing domains
- Taxonomy → Planning: includes · One of the nine urban-computing domains
- Taxonomy → Energy: includes · One of the nine urban-computing domains
- Taxonomy → Geoscience: includes · One of the nine urban-computing domains
- Taxonomy → Autonomous driving: includes · One of the nine urban-computing domains
- LLM roles → Encoder: classifies · First LLM usage mode in the survey
- LLM roles → Enhancer: classifies · First LLM usage mode in the survey
- LLM roles → Predictor: classifies · First LLM usage mode in the survey
- LLM roles → Assistant: classifies · First LLM usage mode in the survey
- LLM roles → Agent: classifies · First LLM usage mode in the survey
- Paper index → Citations: contains · Paper entries are stored as references with metadata
- Paper index → Outbound links: outlinks · Each entry points outward to the source paper
- Figures → Taxonomy: illustrates · Figures visualize the high-level categorization
- Figures → LLM roles: illustrates · Figures visualize the role-based framing
- Paper index → Taxonomy: mapped by · Entries are organized under urban-computing domains
- Paper index → LLM roles: mapped by · Entries are also compared by LLM role
