# abhishekbansode198/lila-player-journey architecture

> Architecture diagram of the GitHub repository abhishekbansode198/lila-player-journey, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/abhishekbansode198/lila-player-journey
- Repository: https://github.com/abhishekbansode198/lila-player-journey

## Overview

LILA Player Journey Visualizer is a Streamlit tool for level designers to inspect production match telemetry. Users choose a map, date, and match, then view a timeline-scrubbable journey or map-and-date heatmap, with player/event filters and match statistics. The app coordinates data loading and visualization; the loader combines parquet telemetry, derives player types, map pixels, and match timing, while Plotly renderers overlay paths and events on minimaps. Source excerpts show the main calls and file reads; heatmap and playback capabilities are also documented in the README.

Main entry points: [`app.py`](https://github.com/abhishekbansode198/lila-player-journey/blob/master/app.py) (Streamlit app), [`src/data_loader.py`](https://github.com/abhishekbansode198/lila-player-journey/blob/master/src/data_loader.py) (Load and enrich), [`src/visualizations.py`](https://github.com/abhishekbansode198/lila-player-journey/blob/master/src/visualizations.py) (Match playback), [`data/player_data/minimaps`](https://github.com/abhishekbansode198/lila-player-journey/tree/master/data/player_data/minimaps) (Minimap images)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Interactive app"]
  node_app["Streamlit app<br/>[app.py]"]
end

subgraph group_data["Telemetry data"]
  node_telemetry[("Parquet telemetry")]
  node_loader["Load and enrich<br/>[data_loader.py]"]
end

subgraph group_visuals["Map visualization"]
  node_journey["Match playback<br/>[visualizations.py]"]
  node_heatmap["Event heatmaps<br/>[visualizations.py]"]
end

subgraph group_assets["Map assets"]
  node_minimaps["Minimap images"]
end

node_designer(("Level designer"))

node_designer -->|"selects filters"| node_app
node_app -->|"loads and filters"| node_loader
node_loader -->|"reads parquet"| node_telemetry
node_loader -->|"returns event data"| node_app
node_app -->|"requests playback"| node_journey
node_app -->|"requests heatmap"| node_heatmap
node_journey -->|"loads background"| node_minimaps
node_heatmap -->|"loads background"| node_minimaps

click node_app "https://github.com/abhishekbansode198/lila-player-journey/blob/master/app.py"
click node_telemetry "https://github.com/abhishekbansode198/lila-player-journey/tree/master/data/player_data"
click node_loader "https://github.com/abhishekbansode198/lila-player-journey/blob/master/src/data_loader.py"
click node_journey "https://github.com/abhishekbansode198/lila-player-journey/blob/master/src/visualizations.py"
click node_heatmap "https://github.com/abhishekbansode198/lila-player-journey/blob/master/src/visualizations.py"
click node_minimaps "https://github.com/abhishekbansode198/lila-player-journey/tree/master/data/player_data/minimaps"

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_app toneBlue
class node_telemetry,node_loader toneAmber
class node_journey,node_heatmap toneMint
class node_minimaps toneRose
class node_designer toneIndigo
```

## Components

### Interactive app

- [Streamlit app](https://github.com/abhishekbansode198/lila-player-journey/blob/master/app.py): `app.py`

### Telemetry data

- [Parquet telemetry](https://github.com/abhishekbansode198/lila-player-journey/tree/master/data/player_data): `data/player_data`
- [Load and enrich](https://github.com/abhishekbansode198/lila-player-journey/blob/master/src/data_loader.py): `src/data_loader.py`

### Map visualization

- [Match playback](https://github.com/abhishekbansode198/lila-player-journey/blob/master/src/visualizations.py): `src/visualizations.py`
- [Event heatmaps](https://github.com/abhishekbansode198/lila-player-journey/blob/master/src/visualizations.py): `src/visualizations.py`

### Map assets

- [Minimap images](https://github.com/abhishekbansode198/lila-player-journey/tree/master/data/player_data/minimaps): `data/player_data/minimaps`

### Other components

- **Level designer**

## Connections

- Level designer → Streamlit app: selects filters (evidence: `README.md`)
- Streamlit app → Load and enrich: loads and filters (evidence: `app.py`)
- Load and enrich → Parquet telemetry: reads parquet (evidence: `src/data_loader.py`)
- Load and enrich → Streamlit app: returns event data (evidence: `app.py`)
- Streamlit app → Match playback: requests playback (evidence: `app.py`)
- Streamlit app → Event heatmaps: requests heatmap (evidence: `app.py`)
- Match playback → Minimap images: loads background (evidence: `src/visualizations.py`)
- Event heatmaps → Minimap images: loads background (evidence: `src/visualizations.py`)
