GHIN Golf Tracker

Basic Analysis

python3 scripts/ghin_stats.py /path/to/ghin-data.json

JSON Output

python3 scripts/ghin_stats.py /path/to/ghin-data.json --format json

Expected Data Format

The script expects a JSON file with the following structure:

{
  "handicap_index": 18.0,
  "lifetime_rounds": 83,
  "handicap_history": [
    {"date": "2026-02-02", "index": 18.0},
    {"date": "2026-01-15", "index": 17.8}
  ],
  "stats": {
    "par3_avg": 4.06,
    "par4_avg": 4.94,
    "par5_avg": 5.73,
    "gir_pct": 50,
    "fairways_pct": 65,
    "putts_avg": 31.2
  },
  "scores": [
    {
      "date": "2026-02-01",
      "score": "82A",
      "course": "Las Vegas Golf Club",
      "cr_slope": "68.0/117",
      "differential": 13.5
    }
  ]
}

Example Output (Text Format)

GHIN Golf Statistics Report
==============================
Current Handicap: 18.0
Trend (last 5): ↗️  Improving
LIFETIME TOTALS
---------------
Total Rounds: 83
Best Score: 72
Worst Score: 95
BEST DIFFERENTIALS
-----------------
1. 8.2 - Pebble Beach Golf Links (2025-08-15)
2. 9.1 - Augusta National Golf Club (2025-09-22)
3. 10.4 - St. Andrews Old Course (2025-07-10)
MOST PLAYED COURSES
-------------------
Las Vegas Golf Club: 12 rounds (avg 84.2)
Phoenix Country Club: 8 rounds (avg 86.1)
Scottsdale National: 6 rounds (avg 82.9)
YEARLY BREAKDOWN
----------------
2026: 8 rounds (avg 83.4)
2025: 42 rounds (avg 84.7)
2024: 33 rounds (avg 87.2)