User Guide · every surface, every metric

GolfIQ is a comprehensive golf-intelligence dashboard built on a complete mirror of the DataGolf API. Every page reads from a Postgres database that refreshes every 15 minutes during live events and daily otherwise.

1.1 The sticky banner

At the top of every page, you’ll see a glowing header with:

• Eyebrow tag — tour + event status, e.g. PGA · ACTIVE EVENT
• Event title — the current tournament name and (in cyan) the course name
• Snapshot timestamp — when the DataGolf model last refreshed
• “Live mirror” badge — confirms data is flowing
• Tour pills — switch between PGA, DP World, Korn Ferry, Opposite, Alt, LIV. Pills only light up for tours that currently have data.

1.2 The hero row

Three cards (each hides cleanly when empty):

1.3 The AI insight card

A single GolfIQ-generated paragraph below the hero row, refreshed every 6 hours. Seeded with top predictions, biggest course-fit bumps, form movers, and hole-difficulty extremes. The Ask GolfIQ → button opens the command bar with the same context loaded.

1.4 The six tabs

A horizontal tab bar (scrollable on mobile) below the hero. When a live event is in progress, a pulsing green Live pill appears on the right.

Reached by clicking any player name across the app. Sections, top to bottom:

Reached from the Courses directory or by clicking course names in the History tab or live event banner.

Header

• Event name (current event, if any) + course name
• Stats strip — active event: field size, avg adjustment, max boost, biggest fade. Always: events on file, total rounds, avg score, year span

Skill importance

Bar chart with four horizontal bars: OTT, APP, ARG, PUTT — each showing what fraction of the spread between players at this course is attributable to that skill (variance-based). At Augusta you’ll see APP and PUTT dominating; at Bay Hill, OTT punches above its weight.

This week’s best/worst fits

Two side-by-side tables. Best fits = largest positive total adjustment from baseline. Worst fits = largest negative.

All-time top performers

Every player with 2+ starts, sorted by avg SG: Total. Headshots, events, rounds, full SG breakdown, last year played. Click any name to open their profile.

Course nemeses

The bottom 5 players with 2+ starts. Players the venue has consistently chewed up.

Reached by clicking any SG ▸ row in the History tab. The single best way to put any individual historical event under a microscope.

Accuracy summary tiles

Leaderboard

Full historical leaderboard, 80 players deep: finish position, name + headshot, predicted win %, round-by-round scores, SG breakdown averaged across rounds.

Model accuracy plot

Scatter chart: predicted win % on X-axis, actual finish position on Y-axis. Each dot is a player. Top-10 finishers in green, the rest in cyan. A well-calibrated model clusters dots in the upper-right (favorites finished high).

Closing-line value

Top 10 players by model edge vs. bet365 close (DG fair probability − closing-line implied probability). Columns: player, open/close odds, edge in pp, finish, bet result.

Clicking any event opens its full detail page (/dash/tournaments/[event_id]) with the live or pre-tournament leaderboard, betting markets, and tee pairings.

Press ⌘K (Mac) or Ctrl K (Win/Linux) from anywhere in the app, or click the floating logo at the bottom-right. A slide-out drawer opens with:

• The current page path shown as a context chip in the header
• 4 suggested prompts you can click to send
• A free-text input
• Open full link if you want the full-page chat at /golfiq
• Esc button (or just press Esc)

What you can ask

Tips for getting the best answers

• Be specific about the player. “Scheffler” works, “Scottie” works. Two-word ambiguous queries (“Brown”) may resolve to the wrong player — GolfIQ will list matches.
• Reference the current page. Because the chat knows your pathname, you can ask “explain this player’s edge” on a player profile and it will use that context.
• Ask follow-ups. The chat maintains conversation history. “Now compare him to Rory” works.
• Use it during research. Hit ⌘K from any page — faster than navigating back and forth.

Strokes Gained (SG)

The fundamental performance metric in modern golf. SG measures how a player performs vs. the PGA Tour field average on the same shot. Positive = above average, negative = below.

Model terms

Betting terms

DFS terms

• DK / FD — DraftKings / FanDuel
• Salary efficiency — projected fantasy points per $1,000 of salary. Higher = better value.

Glossary of DG markers

• sg_categories=‘yes’ — archived event has full SG breakdown available
• traditional_stats=‘yes’ — driving accuracy, GIR, proximity, scrambling recorded
• archived_preds=‘yes’ — pre-tournament predictions backfilled for this event

• Click any row in the History tab. Drills into the archived leaderboard with model accuracy.
• Click any course name in This Week’s decomposition table. Goes to the venue profile.
• Use the tour pills. The home dash is fully tour-scoped — pick LIV or DPWT to see those tours’ predictions.
• Sort the Players tab by Δ. Top-of-the-table = biggest weekly rank improvers. The forming bubble.
• Sort DFS by Value. Anything above 5.5 points per $1K is high-leverage; the value column is the single best DFS sort.
• Look at the calibration chart on the Backtest page. If a bucket’s green bar is taller than its cyan bar, the model under-predicted that group’s win rate (those longshots are real value). Inverse if green is shorter.

• Off-week dashboard — recent winners, biggest skill movers, archive featured event when no live tournament
• Shot-level visualizations from the historical-rounds payload
• User accounts + watchlists — pin players to a personal home view
• Multi-book historical odds — DK, FD, Pinnacle closing lines alongside bet365
• Auto-refresh of the Live tab during active rounds (no page reload required)