# gniziemazity/virtual-world architecture

> Architecture diagram of the GitHub repository gniziemazity/virtual-world, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gniziemazity/virtual-world
- Repository: https://github.com/gniziemazity/virtual-world

## Overview

Virtual-world is a sequence of standalone JavaScript demos that build toward a self-driving-car simulation in an editable, rendered road world. The progression starts with spatial graphs and interactive editing, then adds viewport navigation, procedural roads and scenery, fake 3D, road markings and world saving; later demos integrate those capabilities with cars, sensors, traffic and neural-network visualization. The shown integration entry point loads a world, runs a car population and renders the best car. MiniMap adds a separate map view. Source excerpts are partial, so unsampled subsystem links are omitted where their runtime wiring is not evidenced.

Main entry points: [`9. Integration/main.js`](https://github.com/gniziemazity/virtual-world/blob/main/9.%20Integration/main.js) (Simulation entry), [`11. MiniMap/main.js`](https://github.com/gniziemazity/virtual-world/blob/main/11.%20MiniMap/main.js) (MiniMap simulation), [`4. Roads/js/world.js`](https://github.com/gniziemazity/virtual-world/blob/main/4.%20Roads/js/world.js) (Road geometry), [`9. Integration/car.js`](https://github.com/gniziemazity/virtual-world/blob/main/9.%20Integration/car.js) (Cars and sensors)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mapping["Graph and editing"]
  node_spatial["Spatial graph<br/>[graph.js]"]
  node_graphui["Graph editor<br/>[graphEditor.js]"]
end

subgraph group_world["World construction"]
  node_roadworld["Road geometry<br/>[world.js]"]
  node_scenery["Buildings and trees<br/>[world.js]"]
  node_osm["OSM world<br/>[world.js]"]
  node_osmimport["OSM conversion<br/>[osm.js]"]
end

subgraph group_editorial["World authoring"]
  node_markings["Road markings<br/>[world.js]"]
  node_saving["World persistence<br/>[world.js]"]
  node_browserstorage[("Browser storage")]
end

subgraph group_simulation["Driving simulation"]
  node_integration["Simulation entry<br/>[main.js]"]
  node_cars["Cars and sensors<br/>[car.js]"]
  node_traffic["Traffic network<br/>[network.js]"]
  node_minientry["MiniMap simulation<br/>[main.js]"]
end

subgraph group_views["Rendering and maps"]
  node_viewport["Dynamic viewport<br/>[viewport.js]"]
  node_fake3d["Fake 3D rendering<br/>[world.js]"]
  node_visualizer["Network visualizer<br/>[visualizer.js]"]
  node_osmmini["OSM map view<br/>[miniMap.js]"]
  node_minimap["MiniMap view<br/>[miniMap.js]"]
end

node_user(("User"))

node_user -.->|"edits graph"| node_graphui
node_graphui -.->|"updates graph"| node_spatial
node_spatial -.->|"defines roads"| node_roadworld
node_roadworld -.->|"adds scenery"| node_scenery
node_scenery -.->|"renders depth"| node_fake3d
node_roadworld -.->|"adds markings"| node_markings
node_markings -.->|"saves world"| node_saving
node_user -.->|"runs simulation"| node_integration
node_integration -->|"loads world"| node_saving
node_integration -->|"creates cars"| node_cars
node_integration -->|"follows best car"| node_viewport
node_integration -->|"draws network"| node_visualizer
node_integration -->|"reads and writes"| node_browserstorage
node_cars -.->|"uses sensors"| node_traffic
node_user -.->|"imports map data"| node_osmimport
node_osmimport -.->|"builds world"| node_osm
node_minientry -->|"updates map"| node_minimap
node_minientry -.->|"runs cars"| node_cars
node_minientry -->|"draws network"| node_visualizer
node_minientry -.->|"optional map view"| node_osmmini

click node_spatial "https://github.com/gniziemazity/virtual-world/blob/main/1.%20Spatial%20Graphs/js/math/graph.js"
click node_graphui "https://github.com/gniziemazity/virtual-world/blob/main/2.%20Graph%20Editor/js/graphEditor.js"
click node_viewport "https://github.com/gniziemazity/virtual-world/blob/main/3.%20Dynamic%20Viewport/js/viewport.js"
click node_roadworld "https://github.com/gniziemazity/virtual-world/blob/main/4.%20Roads/js/world.js"
click node_scenery "https://github.com/gniziemazity/virtual-world/blob/main/5.%20Buildings%20And%20Trees/js/world.js"
click node_fake3d "https://github.com/gniziemazity/virtual-world/blob/main/6.%20Fake%203D/js/world.js"
click node_markings "https://github.com/gniziemazity/virtual-world/blob/main/7.%20Markings/js/world.js"
click node_saving "https://github.com/gniziemazity/virtual-world/blob/main/8.%20Saving%20The%20World/js/world.js"
click node_integration "https://github.com/gniziemazity/virtual-world/blob/main/9.%20Integration/main.js"
click node_cars "https://github.com/gniziemazity/virtual-world/blob/main/9.%20Integration/car.js"
click node_traffic "https://github.com/gniziemazity/virtual-world/blob/main/9.%20Integration/network.js"
click node_visualizer "https://github.com/gniziemazity/virtual-world/blob/main/9.%20Integration/visualizer.js"
click node_osm "https://github.com/gniziemazity/virtual-world/blob/main/10.%20OpenStreetMap/world/js/world.js"
click node_osmimport "https://github.com/gniziemazity/virtual-world/blob/main/10.%20OpenStreetMap/world/js/math/osm.js"
click node_osmmini "https://github.com/gniziemazity/virtual-world/blob/main/10.%20OpenStreetMap/miniMap.js"
click node_minimap "https://github.com/gniziemazity/virtual-world/blob/main/11.%20MiniMap/miniMap.js"
click node_minientry "https://github.com/gniziemazity/virtual-world/blob/main/11.%20MiniMap/main.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_spatial,node_graphui,node_user toneBlue
class node_roadworld,node_scenery,node_osm,node_osmimport toneAmber
class node_markings,node_saving,node_browserstorage toneMint
class node_integration,node_cars,node_traffic,node_minientry toneRose
class node_viewport,node_fake3d,node_visualizer,node_osmmini,node_minimap toneIndigo
```

## Components

### Graph and editing

- [Spatial graph](https://github.com/gniziemazity/virtual-world/blob/main/1.%20Spatial%20Graphs/js/math/graph.js): `1. Spatial Graphs/js/math/graph.js`
- [Graph editor](https://github.com/gniziemazity/virtual-world/blob/main/2.%20Graph%20Editor/js/graphEditor.js): `2. Graph Editor/js/graphEditor.js`

### World construction

- [Road geometry](https://github.com/gniziemazity/virtual-world/blob/main/4.%20Roads/js/world.js): `4. Roads/js/world.js`
- [Buildings and trees](https://github.com/gniziemazity/virtual-world/blob/main/5.%20Buildings%20And%20Trees/js/world.js): `5. Buildings And Trees/js/world.js`
- [OSM world](https://github.com/gniziemazity/virtual-world/blob/main/10.%20OpenStreetMap/world/js/world.js): `10. OpenStreetMap/world/js/world.js`
- [OSM conversion](https://github.com/gniziemazity/virtual-world/blob/main/10.%20OpenStreetMap/world/js/math/osm.js): `10. OpenStreetMap/world/js/math/osm.js`

### World authoring

- [Road markings](https://github.com/gniziemazity/virtual-world/blob/main/7.%20Markings/js/world.js): `7. Markings/js/world.js`
- [World persistence](https://github.com/gniziemazity/virtual-world/blob/main/8.%20Saving%20The%20World/js/world.js): `8. Saving The World/js/world.js`
- **Browser storage**

### Driving simulation

- [Simulation entry](https://github.com/gniziemazity/virtual-world/blob/main/9.%20Integration/main.js): `9. Integration/main.js`
- [Cars and sensors](https://github.com/gniziemazity/virtual-world/blob/main/9.%20Integration/car.js): `9. Integration/car.js`
- [Traffic network](https://github.com/gniziemazity/virtual-world/blob/main/9.%20Integration/network.js): `9. Integration/network.js`
- [MiniMap simulation](https://github.com/gniziemazity/virtual-world/blob/main/11.%20MiniMap/main.js): `11. MiniMap/main.js`

### Rendering and maps

- [Dynamic viewport](https://github.com/gniziemazity/virtual-world/blob/main/3.%20Dynamic%20Viewport/js/viewport.js): `3. Dynamic Viewport/js/viewport.js`
- [Fake 3D rendering](https://github.com/gniziemazity/virtual-world/blob/main/6.%20Fake%203D/js/world.js): `6. Fake 3D/js/world.js`
- [Network visualizer](https://github.com/gniziemazity/virtual-world/blob/main/9.%20Integration/visualizer.js): `9. Integration/visualizer.js`
- [OSM map view](https://github.com/gniziemazity/virtual-world/blob/main/10.%20OpenStreetMap/miniMap.js): `10. OpenStreetMap/miniMap.js`
- [MiniMap view](https://github.com/gniziemazity/virtual-world/blob/main/11.%20MiniMap/miniMap.js): `11. MiniMap/miniMap.js`

### Other components

- **User**

## Connections

- User → Graph editor: edits graph
- Graph editor → Spatial graph: updates graph
- Spatial graph → Road geometry: defines roads
- Road geometry → Buildings and trees: adds scenery
- Buildings and trees → Fake 3D rendering: renders depth
- Road geometry → Road markings: adds markings
- Road markings → World persistence: saves world
- User → Simulation entry: runs simulation
- Simulation entry → World persistence: loads world (evidence: `9. Integration/main.js`)
- Simulation entry → Cars and sensors: creates cars (evidence: `9. Integration/main.js`)
- Simulation entry → Dynamic viewport: follows best car (evidence: `9. Integration/main.js`)
- Simulation entry → Network visualizer: draws network (evidence: `9. Integration/main.js`)
- Simulation entry → Browser storage: reads and writes (evidence: `9. Integration/main.js`)
- Cars and sensors → Traffic network: uses sensors
- User → OSM conversion: imports map data
- OSM conversion → OSM world: builds world
- MiniMap simulation → MiniMap view: updates map (evidence: `11. MiniMap/main.js`)
- MiniMap simulation → Cars and sensors: runs cars
- MiniMap simulation → Network visualizer: draws network (evidence: `11. MiniMap/main.js`)
- MiniMap simulation → OSM map view: optional map view
