Documentation – ScoreGenius

Purpose & Usage

ScoreGenius is designed to give you clear, pre-game insights and advanced statistics for NBA (and MLB when available). Use the controls at the top of the app to:

Switch Sport: Toggle between NBA and MLB data.
Select Tab: Choose Teams, Players (NBA only), or Advanced stats.
Pick Season: Use the dropdown to view past seasons’ data.
Filter Players: Search by name on the NBA Players tab.

Teams Tab

Displays basic team rankings for the selected sport and season.

Win %: wins_all_percentage = wins ÷ games_played
Avg. Points For / Runs For: points_for_avg_all (NBA) or runs_for_avg_all (MLB) = total points (runs) ÷ games_played
Avg. Points Against / Runs Against: points_against_avg_all (NBA) or runs_against_avg_all (MLB) = total points allowed ÷ games_played
Streak: current_form = “W” or “L” streak count.

NBA Players Tab

Key per-game stats for NBA players in the selected season.

Points (Pts): points = total points scored per game.
Rebounds (Reb): rebounds = total rebounds per game.
Assists (Ast): assists = total assists per game.
3-Point % (3P%): three_pct = 3PM ÷ 3PA × 100
Free Throw % (FT%): ft_pct = FTM ÷ FTA × 100
Minutes (Min): minutes = average minutes played per game.
Games Played (GP): games_played = total games appeared.

Advanced Stats Tab

More in-depth metrics to compare team efficiency and performance.

NBA Advanced

Pace: Possessions per 48 min — measures game tempo.
OffRtg: Points scored per 100 possessions.
DefRtg: Points allowed per 100 possessions.
eFG%: efg_pct = (FGM + 0.5×3PM) ÷ FGA × 100
TOV%: tov_pct = Turnovers ÷ Possessions × 100
ORB%: oreb_pct = Offensive rebounds ÷ (OffReb + Opponent DefReb) × 100
GP: games_played = total games in season.

MLB Advanced

Win %: win_pct = wins ÷ games_played × 100
Pythagorean W%: pythagorean_win_pct = runs_for² ÷ (runs_for² + runs_against²) × 100
Run Diff: run_differential = runs_for − runs_against
Avg. Run Diff: run_differential_avg = run_differential ÷ games_played
Luck Factor: luck_factor = actual wins − expected wins
GP: games_played = total games in season.