Files
gridpilot.gg/docs/concept/STATS.md
2025-12-01 22:01:58 +01:00

270 lines
6.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# GridPilot — In-Depth Stats & Scoring
*A modern statistics and scoring engine that gives meaning, context, and clarity to every race, every season, and every driver.*
---
# 1. Purpose of GridPilot Stats
iRacings official results are powerful, but extremely limited:
- no career progression
- no cross-season view
- no team context
- no advanced analytics
- no identity
GridPilot turns league racing into a structured competitive ecosystem by adding **deep, consistent, cross-league analytics** that drivers, teams, and admins can all rely on.
---
# 2. Core Data We Track
GridPilot automatically imports race metadata from iRacing and expands it into a full statistical model.
### **Per Race**
- finishing position
- starting position
- positions gained/lost
- incidents
- best lap
- average lap pace (optional if telemetry available)
- laps completed
- penalties applied
- classification after penalties
### **Per Driver (Season)**
- points
- average finish
- consistency rating
- race attendance
- clean race percentage
- total incidents
- incidents per lap
- podiums
- wins
- DNF count
- performance trend
### **Per Team (Season)**
- total team points
- points contribution per driver
- average team finish
- number of drivers scoring
- team attendance
- team success over time
### **All-Time Stats**
- total races
- total wins
- total podiums
- historical point totals
- incident history
- class-specific stats (e.g., GT4, F4, F3)
- multi-league performance overview
These stats give GridPilot the ability to create meaningful identity and competitive depth.
---
# 3. Scoring Engine (Flexible + Transparent)
Each league defines its scoring rules, but GridPilot standardizes them into clear, consistent structures.
### **Supported Scoring Models**
- Formula-style points (F1, F2, F3, F4, GP2, etc.)
- Endurance-style points
- Fixed points per position
- Bonus points:
- fastest lap
- pole position
- clean race
- most positions gained
### **Drop Weeks**
- configurable number of drops
- visual indicator for dropped results
- fully automated recalculation
### **Team Scoring**
A true Constructors-style model:
- multiple drivers score per race
- flexible configuration (best 2 scores, all scores, custom rules)
- team standings calculated instantly
- team stats update automatically
---
# 4. Driver Performance Metrics (Advanced)
GridPilot doesnt just store results — it analyzes them.
### **Key Driver Metrics**
- **Consistency Score**
Statistical deviation of finishing positions over time.
Lower = more consistent.
- **Pace Index** (optional if telemetry available)
Comparison of average lap times vs. field median.
- **Clean Driving Score**
Incidents per race + severity weighting.
- **Racecraft Score**
Positions gained/lost vs. incident involvement.
- **Progression Score**
Improvement across a season, shown as a trendline.
- **Clutch Factor**
Performance in high-pressure scenarios (late-season races, close battles).
### **Visibility**
All metrics appear on:
- driver profile
- season detail page
- league overview
- team contribution breakdown
Drivers finally see **how** they drive — not just where they finish.
---
# 5. Team Metrics (Depth That Makes Teams Matter)
Teams get **quantitative identity**.
### **Team Performance Metrics**
- team points
- team pace
- average finishing position
- contribution per driver
- lineup efficiency (who delivers consistent points)
- recruitment performance (improvement after roster changes)
- team form (last 5 races)
### **Team Contribution Breakdown**
Each driver has:
- points contributed
- percentage of team output
- consistency
- clean driving impact
- reliability (attendance)
This creates real internal and external rivalries.
---
# 6. Season Intelligence
GridPilot gives leagues a complete analytical picture:
### **Season Insights**
- top improvers
- most consistent drivers
- hard chargers
- clean drivers
- most valuable drivers (team scoring)
- pace distribution
- incident hotspots
- attendance map
### **League Health Metrics**
- retention
- average field size
- finishing rate
- incident averages
- multi-class balancing
Admins get clarity without spreadsheets.
---
# 7. Classification Adjustments (Penalties Included)
Results are never final until all penalties are processed.
GridPilot automatically handles:
- time penalties (+5s / +10s / +30s / custom)
- points deductions
- disqualifications (race-level)
- attendance penalties (if used)
- warning tracking
After admin decisions:
- standings recalculate
- driver stats update
- team stats update
- classification changes are logged
- penalty history is visible
No manual recalculation.
No mistakes.
No drama.
---
# 8. Global Scoring Vision (Future-Friendly)
GridPilot tracks:
- per-league points
- per-season points
- all-time points
- team points
- class-based points
This allows future scaling into:
- global leaderboards
- cross-league rankings
- multi-class ladders
- team world rankings
We dont implement everything on day one —
but the **data model is built for it**.
---
# 9. Why GridPilot Stats Matter
For Drivers:
- proof of skill
- motivation
- long-term identity
- visible improvement
- fairness & transparency
For Teams:
- real constructors competition
- driver scouting
- lineup planning
- prestige and pride
For Admins:
- no spreadsheets
- no miscalculations
- clarity for the community
- instant transparency
- professionalism
For Leagues:
- structure
- identity
- competitiveness
- return of drivers season after season
---
# Summary
GridPilots scoring and analytics system turns scattered league racing into a **structured competitive ecosystem**:
- complete results
- meaningful metrics
- constructors-style team scoring
- clean & consistent standings
- penalty-aware classification
- multi-season depth
- driver identity
- team identity
- league clarity
This is the **foundation** that makes GridPilot more than a tool —
it becomes the home of competition in iRacing league racing.