Skip to main content
Petanque Life

Match Detail Analytics

F10.02 12 features Shipped

At a glance

Match Detail Analytics goes one level deeper than win/loss, mining mène-level and throw-level events to surface shooting accuracy, pointing precision, carreau rate, clutch behaviour, score-distribution heatmaps, and contextual factors like terrain surface and weather. It turns each scored boule into a structured data point that profiles how a player actually performs across formats, courts, and conditions.

How it works

When live scoring is enabled the scorekeeper app emits structured events for every mène close (points, leader, cumulative score) and, optionally, for individual throws (type=tir/point, outcome=carreau/devant/derriere/raté, distance to cochonnet). These events are persisted on the match document and replicated into a per-player throw fact table. A nightly aggregator reads the fact table and writes detail rollups: shooting accuracy (F10.02.03) is successful_tirs / total_tirs per bucket, pointing accuracy (F10.02.04) is the share of points landing within 50 cm of the cochonnet, and carreau rate (F10.02.05) counts perfect hits.

Mène-level analysis (F10.02.01) classifies match shapes by scanning the mène-by-mène sequence and tagging patterns like strong-start, comeback, and closer; points-per-mène (F10.02.02) is a simple ratio derived from the same sequence. Clutch performance (F10.02.06) and performance under pressure (F10.02.10) compute conditional win rates over a filtered subset (mènes where the player was behind, or where the score was 12-anything). First-mène win rate (F10.02.07) joins the very first mène's leader against the eventual match winner to expose correlation.

Average match duration (F10.02.08) reads start_at and end_at timestamps. The score distribution heatmap (F10.02.09) is a 13x13 matrix of final-score frequencies, written as a single nested document so the chart renders from one read. Terrain (F10.02.11) and weather (F10.02.12) impact analysis enrich each match with the court's surface_type and, when the venue captured it, a weather snapshot at start_at; rollups are then keyed on those dimensions so comparisons by surface or rain/wind are one query.

All detail rollups are versioned and idempotent, so re-importing a corrected scoresheet rewrites the same rows.

Key capabilities

  • Throw-level fact table for tir/point classification and distance
  • Shooting, pointing, and carreau accuracy ratios computed per bucket
  • Mène pattern classifier: strong-start, comeback, closer
  • Clutch and pressure splits via conditional win-rate filters
  • 13x13 score distribution heatmap rendered from a single rollup document
  • Surface and weather dimensions joined from court and venue context
  • Idempotent re-aggregation when scoresheets are corrected

In practice

Marc, a serious tireur, opens his match analytics after a tournament weekend. The shooting accuracy widget shows 58% across 47 attempts, broken down into 12% carreau and 46% successful displacements. The mène pattern view reveals that three of his four losses were comeback matches he led through mène 8, prompting him to drill closing routines.

He filters by surface and notices his pointing accuracy drops 9 points on synthetic terrain, then by weather and sees that wind above 6 m/s correlates with a 14-point dip in carreau rate. The score distribution heatmap shows 13-7 as his most frequent winning final, and clutch performance confirms he wins 71% of mènes when behind by two. He bookmarks the surface filter for his next pre-tournament prep.

Features in this subsystem

12
ID Status Features
F10.02.01 Shipped Mène-level analysis (scoring patterns: strong starts, comebacks, closers) ✅ PL-F1002a
F10.02.02 Shipped Points-per-mène average ✅ PL-F1002a
F10.02.03 Shipped Shooting accuracy (successful tirs / total tirs) ✅ PL-F1002a
F10.02.04 Shipped Pointing accuracy (boules within 50cm of cochonnet) ✅ PL-F1002a
F10.02.05 Shipped Carreau rate (perfect hits) ✅ PL-F1002a
F10.02.06 Shipped Clutch performance (win rate when behind, when match point) ✅ PL-F1002a
F10.02.07 Shipped First-mène win rate (correlation with match outcome) ✅ PL-F1002b
F10.02.08 Shipped Average match duration ✅ PL-F1002b
F10.02.09 Shipped Score distribution heatmap (how often each final score occurs) ✅ PL-F1002b
F10.02.10 Shipped Performance under pressure (scoring in decisive mènes) ✅ PL-F1002b
F10.02.11 Shipped Terrain/surface performance (results by court type) ✅ PL-F1002b
F10.02.12 Shipped Weather impact analysis (if weather data captured) ✅ PL-F1002b