Skip to content

This repo consists of codes, presentations and other details of the Breaklines Project

Notifications You must be signed in to change notification settings

CoDIS-Lab/Breaklines

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

28 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

BreakLines: Uncovering Tactical Line-Breaking Passes

This repo consists of codes, presentations and other details of the Breaklines Project

An unsupervised, interpretable framework for detecting and analysing line-breaking passes (LBPs) using spatiotemporal football data.

Figure 1: Core Framework โ€” Detecting LBPs and computing SBR

Overview

Line-breaking passes (LBPs) are a cornerstone of vertical progression and attacking structure in football. This project introduces a clustering-based method to detect LBPs from synchronised event and tracking data, modelling opponent defensive shape dynamically at the moment of each pass.

BreakLines further introduces two key tactical metrics:

  • SBR (Space Buildup Ratio): Quantifies the spatial advantage gained from a pass.
  • LBPChยน & LBPChยฒ: Capture direct and chained progression sequences that culminate in goal-scoring attempts.

Our approach combines spatial logic with tactical relevance to uncover the structure behind dangerous build-up sequences โ€” without relying on proprietary labels or pre-defined formations.

๐Ÿ“„ Paper

Read the full paper here:
โžก๏ธ Through the Gaps: Uncovering Tactical Line-Breaking Passes with Clustering

๐Ÿ”ง Features

  • ๐Ÿง  Unsupervised Clustering: Dynamic vertical segmentation of defensive lines using K-Means with adaptive k (โ‰ฅ2 clusters).
  • ๐Ÿ“Š SBR Metric: Interpretable spatial impact score based on area expansion around receivers.
  • ๐Ÿ”„ Chain Analysis: Detection of chained LBPs (LBPChยฒ) for sustained vertical build-ups.
  • โšฝ Player/Team Analysis: Identify top line-breakers, space creators, and tactical contributors.

๐Ÿ—ƒ๏ธ Dataset

Uses the PFF FC World Cup 2022 Dataset which includes:

  • Event data (passes, duels, shots)
  • Tracking data at 29.97Hz for all players and ball
  • Roster, meta, and alignment information for full context

๐Ÿ“‚ Folder Structure

breaklines/
โ”‚
โ”œโ”€โ”€ figures/             # Paper and visualization assets
โ”œโ”€โ”€ codes/               # Jupyter analysis notebooks
โ”œโ”€โ”€ src/                 # Core scripts for clustering, SBR, LBPCh
โ”œโ”€โ”€ videos/              # Video recording for the presentations
โ””โ”€โ”€ README.md

๐Ÿ“Œ Citation

@article{karakus2025breaklines,
  title={Through the Gaps: Uncovering Tactical Line-Breaking Passes with Clustering},
  author={KarakuลŸ, Oktay and ArkadaลŸ, Hasan},
  journal={arXiv preprint arXiv:2506.06666},
  year={2025}
}

Made with โค๏ธ by Dead Ball Analytics and Cardiff University

Contact: Dr Oktay Karakus: [email protected]

About

This repo consists of codes, presentations and other details of the Breaklines Project

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published