# nagix/mini-tokyo-3d architecture

> Architecture diagram of the GitHub repository nagix/mini-tokyo-3d, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nagix/mini-tokyo-3d
- Repository: https://github.com/nagix/mini-tokyo-3d

## Overview

Mini Tokyo 3D is a browser-based, real-time 3D map of Tokyo public transport. The main workflow is user interaction with the map: it loads static and timetable data, refreshes live vehicle information, then renders transport movement and map layers; users can search routes and inspect stations, trains, and buses. The graph also preserves major visualization and UI capabilities. Edges reflect shown calls or README descriptions; some unsampled subsystem wiring is omitted rather than inferred.

Main entry points: [`src/map.js`](https://github.com/nagix/mini-tokyo-3d/blob/master/src/map.js) (Map controller), [`src/loader.js`](https://github.com/nagix/mini-tokyo-3d/blob/master/src/loader.js) (Data loading), [`src/layers/traffic-layer.js`](https://github.com/nagix/mini-tokyo-3d/blob/master/src/layers/traffic-layer.js) (Traffic renderer), [`src/worker.js`](https://github.com/nagix/mini-tokyo-3d/blob/master/src/worker.js) (Data worker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Map experience"]
  node_map["Map controller<br/>[map.js]"]
  node_controls["Map controls<br/>[search-control.js]"]
  node_panels["Info panels<br/>[station-panel.js]"]
  node_popup["Map popups<br/>[popup.js]"]
end

subgraph group_data["Transport data"]
  node_loader["Data loading<br/>[loader.js]"]
  node_loaders["Dataset loaders"]
  node_worker["Data worker<br/>[worker.js]"]
  node_models["Transport models"]
  node_gtfs["GTFS helpers<br/>[helpers-gtfs.js]"]
end

subgraph group_render["Visualization"]
  node_traffic["Traffic renderer<br/>[traffic-layer.js]"]
  node_three["3D map layer<br/>[three-layer.js]"]
  node_layers["Map layers"]
  node_glow["Glow pipeline<br/>[glow-pipeline.js]"]
  node_meshes["Vehicle meshes<br/>[index.js]"]
  node_compute["Movement compute"]
  node_textures["GPU data textures"]
end

subgraph group_support["Shared capabilities"]
  node_clock["Simulation clock<br/>[clock.js]"]
  node_animation["Animation<br/>[animation.js]"]
  node_geo["GeoJSON helpers<br/>[helpers-geojson.js]"]
end

node_user(("Map user"))
node_mapbox["Map rendering service"]
node_odpt["Transit data sources"]

node_user -->|"interacts with"| node_map
node_map -->|"loads data"| node_loader
node_loader -.->|"dispatches loads"| node_loaders
node_loader -->|"loads transit data"| node_odpt
node_map -.->|"uses time"| node_clock
node_map -->|"offers search"| node_controls
node_map -->|"shows details"| node_panels
node_map -.->|"shows information"| node_popup
node_map -.->|"renders movement"| node_traffic
node_traffic -.->|"updates positions"| node_compute
node_compute -->|"uses textures"| node_textures
node_traffic -->|"renders vehicles"| node_meshes
node_traffic -->|"uses glow"| node_glow
node_map -.->|"configures layers"| node_layers
node_layers -->|"exports layer"| node_three
node_map -->|"displays map"| node_mapbox
node_map -.->|"delegates processing"| node_worker
node_worker -->|"uses geo helpers"| node_geo
node_worker -->|"uses GTFS helpers"| node_gtfs
node_loader -.->|"builds transport models"| node_models
node_map -.->|"uses animation"| node_animation

click node_map "https://github.com/nagix/mini-tokyo-3d/blob/master/src/map.js"
click node_controls "https://github.com/nagix/mini-tokyo-3d/blob/master/src/controls/search-control.js"
click node_panels "https://github.com/nagix/mini-tokyo-3d/blob/master/src/panels/station-panel.js"
click node_popup "https://github.com/nagix/mini-tokyo-3d/blob/master/src/popup.js"
click node_loader "https://github.com/nagix/mini-tokyo-3d/blob/master/src/loader.js"
click node_loaders "https://github.com/nagix/mini-tokyo-3d/tree/master/src/loader"
click node_worker "https://github.com/nagix/mini-tokyo-3d/blob/master/src/worker.js"
click node_models "https://github.com/nagix/mini-tokyo-3d/tree/master/src/data-classes"
click node_gtfs "https://github.com/nagix/mini-tokyo-3d/blob/master/src/helpers/helpers-gtfs.js"
click node_traffic "https://github.com/nagix/mini-tokyo-3d/blob/master/src/layers/traffic-layer.js"
click node_three "https://github.com/nagix/mini-tokyo-3d/blob/master/src/layers/three-layer.js"
click node_layers "https://github.com/nagix/mini-tokyo-3d/tree/master/src/layers"
click node_glow "https://github.com/nagix/mini-tokyo-3d/blob/master/src/layers/glow/glow-pipeline.js"
click node_meshes "https://github.com/nagix/mini-tokyo-3d/blob/master/src/mesh-set/index.js"
click node_compute "https://github.com/nagix/mini-tokyo-3d/blob/master/src/gpgpu/compute-renderer.js"
click node_textures "https://github.com/nagix/mini-tokyo-3d/blob/master/src/gpgpu/linear-data-texture.js"
click node_clock "https://github.com/nagix/mini-tokyo-3d/blob/master/src/clock.js"
click node_animation "https://github.com/nagix/mini-tokyo-3d/blob/master/src/animation.js"
click node_geo "https://github.com/nagix/mini-tokyo-3d/blob/master/src/helpers/helpers-geojson.js"

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_map,node_controls,node_panels,node_popup,node_user toneBlue
class node_loader,node_loaders,node_worker,node_models,node_gtfs toneAmber
class node_traffic,node_three,node_layers,node_glow,node_meshes,node_compute,node_textures toneMint
class node_clock,node_animation,node_geo toneRose
class node_mapbox,node_odpt toneIndigo
```

## Components

### Map experience

- [Map controller](https://github.com/nagix/mini-tokyo-3d/blob/master/src/map.js): `src/map.js`
- [Map controls](https://github.com/nagix/mini-tokyo-3d/blob/master/src/controls/search-control.js): `src/controls/search-control.js`
- [Info panels](https://github.com/nagix/mini-tokyo-3d/blob/master/src/panels/station-panel.js): `src/panels/station-panel.js`
- [Map popups](https://github.com/nagix/mini-tokyo-3d/blob/master/src/popup.js): `src/popup.js`

### Transport data

- [Data loading](https://github.com/nagix/mini-tokyo-3d/blob/master/src/loader.js): `src/loader.js`
- [Dataset loaders](https://github.com/nagix/mini-tokyo-3d/tree/master/src/loader): `src/loader`
- [Data worker](https://github.com/nagix/mini-tokyo-3d/blob/master/src/worker.js): `src/worker.js`
- [Transport models](https://github.com/nagix/mini-tokyo-3d/tree/master/src/data-classes): `src/data-classes`
- [GTFS helpers](https://github.com/nagix/mini-tokyo-3d/blob/master/src/helpers/helpers-gtfs.js): `src/helpers/helpers-gtfs.js`

### Visualization

- [Traffic renderer](https://github.com/nagix/mini-tokyo-3d/blob/master/src/layers/traffic-layer.js): `src/layers/traffic-layer.js`
- [3D map layer](https://github.com/nagix/mini-tokyo-3d/blob/master/src/layers/three-layer.js): `src/layers/three-layer.js`
- [Map layers](https://github.com/nagix/mini-tokyo-3d/tree/master/src/layers): `src/layers`
- [Glow pipeline](https://github.com/nagix/mini-tokyo-3d/blob/master/src/layers/glow/glow-pipeline.js): `src/layers/glow/glow-pipeline.js`
- [Vehicle meshes](https://github.com/nagix/mini-tokyo-3d/blob/master/src/mesh-set/index.js): `src/mesh-set/index.js`
- [Movement compute](https://github.com/nagix/mini-tokyo-3d/blob/master/src/gpgpu/compute-renderer.js): `src/gpgpu/compute-renderer.js`
- [GPU data textures](https://github.com/nagix/mini-tokyo-3d/blob/master/src/gpgpu/linear-data-texture.js): `src/gpgpu/linear-data-texture.js`

### Shared capabilities

- [Simulation clock](https://github.com/nagix/mini-tokyo-3d/blob/master/src/clock.js): `src/clock.js`
- [Animation](https://github.com/nagix/mini-tokyo-3d/blob/master/src/animation.js): `src/animation.js`
- [GeoJSON helpers](https://github.com/nagix/mini-tokyo-3d/blob/master/src/helpers/helpers-geojson.js): `src/helpers/helpers-geojson.js`

### Other components

- **Map user**
- **Map rendering service**
- **Transit data sources**

## Connections

- Map user → Map controller: interacts with (evidence: `README.md`)
- Map controller → Data loading: loads data (evidence: `src/map.js`)
- Data loading → Dataset loaders: dispatches loads
- Data loading → Transit data sources: loads transit data (evidence: `README.md`)
- Map controller → Simulation clock: uses time (evidence: `src/map.js`)
- Map controller → Map controls: offers search (evidence: `src/map.js`)
- Map controller → Info panels: shows details (evidence: `README.md`)
- Map controller → Map popups: shows information
- Map controller → Traffic renderer: renders movement
- Traffic renderer → Movement compute: updates positions (evidence: `src/layers/traffic-layer.js`)
- Movement compute → GPU data textures: uses textures (evidence: `src/gpgpu/compute-renderer.js`)
- Traffic renderer → Vehicle meshes: renders vehicles (evidence: `src/layers/traffic-layer.js`)
- Traffic renderer → Glow pipeline: uses glow (evidence: `src/layers/traffic-layer.js`)
- Map controller → Map layers: configures layers (evidence: `src/map.js`)
- Map layers → 3D map layer: exports layer (evidence: `src/layers/index.js`)
- Map controller → Map rendering service: displays map (evidence: `README.md`)
- Map controller → Data worker: delegates processing
- Data worker → GeoJSON helpers: uses geo helpers (evidence: `src/worker.js`)
- Data worker → GTFS helpers: uses GTFS helpers (evidence: `src/worker.js`)
- Data loading → Transport models: builds transport models
- Map controller → Animation: uses animation (evidence: `src/map.js`)
