# nvsclub/knnpitchcontrol architecture

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

- Interactive diagram: https://gitdiagram.com/nvsclub/knnpitchcontrol
- Repository: https://github.com/nvsclub/knnpitchcontrol

## Overview

This repository is a notebook-led soccer tracking and pitch-control analysis project. Its apparent workflow is to combine tracking datasets, run pitch-control models across matches, visualize results, and compare model runtimes or core usage. The library implements KNN, Spearman, and Fernandez pitch-control approaches, plus pitch drawing. The notebook names and files indicate these capabilities, but no README or notebook contents were provided, so notebook-to-notebook and notebook-to-library connections are shown as unverified rather than asserted.

Main entry points: [`lib/pitch_control.py`](https://github.com/nvsclub/knnpitchcontrol/blob/master/lib/pitch_control.py) (Pitch-control models), [`103 Running all datasets.ipynb`](https://github.com/nvsclub/knnpitchcontrol/blob/master/103%20Running%20all%20datasets.ipynb) (Run datasets), [`101 Merging Datasets.ipynb`](https://github.com/nvsclub/knnpitchcontrol/blob/master/101%20Merging%20Datasets.ipynb) (Merge datasets), [`102 Running all models.ipynb`](https://github.com/nvsclub/knnpitchcontrol/blob/master/102%20Running%20all%20models.ipynb) (Run models)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_analysis["Notebook analysis"]
  node_merge["Merge datasets"]
  node_run_models["Run models"]
  node_run_datasets["Run datasets"]
  node_visualize["Generate visualizations"]
  node_timing["Compare runtimes<br/>[105 Times.ipynb]"]
  node_cores["Compare core usage"]
end

subgraph group_runtime["Pitch-control library"]
  node_models["Pitch-control models<br/>[pitch_control.py]"]
  node_pitch_drawing["Pitch drawing<br/>[draw.py]"]
end

subgraph group_inputs["Tracking data"]
  node_tracking_data["Match tracking datasets"]
end

node_analyst(("Analyst"))

node_analyst -.->|"runs"| node_merge
node_analyst -.->|"runs"| node_run_models
node_analyst -.->|"runs"| node_run_datasets
node_analyst -.->|"runs"| node_visualize
node_analyst -.->|"runs"| node_timing
node_analyst -.->|"runs"| node_cores
node_merge -.->|"uses data"| node_tracking_data
node_run_models -.->|"runs models"| node_models
node_run_datasets -.->|"uses data"| node_tracking_data
node_run_datasets -.->|"runs models"| node_models
node_visualize -.->|"visualizes results"| node_models
node_timing -.->|"times models"| node_models
node_cores -.->|"compares execution"| node_models
node_models -->|"imports"| node_pitch_drawing

click node_merge "https://github.com/nvsclub/knnpitchcontrol/blob/master/101%20Merging%20Datasets.ipynb"
click node_run_models "https://github.com/nvsclub/knnpitchcontrol/blob/master/102%20Running%20all%20models.ipynb"
click node_run_datasets "https://github.com/nvsclub/knnpitchcontrol/blob/master/103%20Running%20all%20datasets.ipynb"
click node_visualize "https://github.com/nvsclub/knnpitchcontrol/blob/master/104%20Generate%20Viz.ipynb"
click node_timing "https://github.com/nvsclub/knnpitchcontrol/blob/master/105%20Times.ipynb"
click node_cores "https://github.com/nvsclub/knnpitchcontrol/blob/master/106%20No-cores%20vs%20cores.ipynb"
click node_models "https://github.com/nvsclub/knnpitchcontrol/blob/master/lib/pitch_control.py"
click node_pitch_drawing "https://github.com/nvsclub/knnpitchcontrol/blob/master/lib/draw.py"
click node_tracking_data "https://github.com/nvsclub/knnpitchcontrol/tree/master/data"

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_merge,node_run_models,node_run_datasets,node_visualize,node_timing,node_cores toneBlue
class node_models,node_pitch_drawing toneAmber
class node_tracking_data toneMint
class node_analyst toneIndigo
```

## Components

### Notebook analysis

- [Merge datasets](https://github.com/nvsclub/knnpitchcontrol/blob/master/101%20Merging%20Datasets.ipynb): `101 Merging Datasets.ipynb`
- [Run models](https://github.com/nvsclub/knnpitchcontrol/blob/master/102%20Running%20all%20models.ipynb): `102 Running all models.ipynb`
- [Run datasets](https://github.com/nvsclub/knnpitchcontrol/blob/master/103%20Running%20all%20datasets.ipynb): `103 Running all datasets.ipynb`
- [Generate visualizations](https://github.com/nvsclub/knnpitchcontrol/blob/master/104%20Generate%20Viz.ipynb): `104 Generate Viz.ipynb`
- [Compare runtimes](https://github.com/nvsclub/knnpitchcontrol/blob/master/105%20Times.ipynb): `105 Times.ipynb`
- [Compare core usage](https://github.com/nvsclub/knnpitchcontrol/blob/master/106%20No-cores%20vs%20cores.ipynb): `106 No-cores vs cores.ipynb`

### Pitch-control library

- [Pitch-control models](https://github.com/nvsclub/knnpitchcontrol/blob/master/lib/pitch_control.py): `lib/pitch_control.py`
- [Pitch drawing](https://github.com/nvsclub/knnpitchcontrol/blob/master/lib/draw.py): `lib/draw.py`

### Tracking data

- [Match tracking datasets](https://github.com/nvsclub/knnpitchcontrol/tree/master/data): `data`

### Other components

- **Analyst**

## Connections

- Analyst → Merge datasets: runs
- Analyst → Run models: runs
- Analyst → Run datasets: runs
- Analyst → Generate visualizations: runs
- Analyst → Compare runtimes: runs
- Analyst → Compare core usage: runs
- Merge datasets → Match tracking datasets: uses data
- Run models → Pitch-control models: runs models
- Run datasets → Match tracking datasets: uses data
- Run datasets → Pitch-control models: runs models
- Generate visualizations → Pitch-control models: visualizes results
- Compare runtimes → Pitch-control models: times models
- Compare core usage → Pitch-control models: compares execution
- Pitch-control models → Pitch drawing: imports (evidence: `lib/pitch_control.py`)
