Skip to content

TROUBLESHOOTING.md

Latest commit

 

History

History
64 lines (49 loc) · 2.23 KB

TROUBLESHOOTING.md

File metadata and controls

64 lines (49 loc) · 2.23 KB

🔧 Troubleshooting Guide

✅ Issues Fixed

1. Python Version Check - RESOLVED

  • Problem: Start script rejected Python 3.13 as invalid
  • Solution: Fixed version comparison logic in start.sh
  • Status: ✅ Working - Python 3.9+ now correctly detected

2. Player Search Not Working - RESOLVED

  • Problem: "No players matching criteria" for all searches
  • Solution: Enhanced initialization and session state management
  • Status: ✅ Working - Search now finds players like "Judge", "Trout", "Acuna"

3. Plotly Visualization Error - RESOLVED

  • Problem: ValueError: Invalid property 'titleside' for ColorBar
  • Solution: Removed invalid titleside parameter from colorbar configuration
  • Status: ✅ Working - Charts now render without errors

🚀 Current Status: FULLY FUNCTIONAL

The Statcast Spray Chart Pro application is now working perfectly with all major issues resolved.

🎯 How to Use the Search

Available Players (Pre-loaded)

The app comes with 3 sample players for immediate testing:

  • Aaron Judge (NYY) - 2016-2024
  • Mike Trout (LAA) - 2011-2024
  • Ronald Acuña Jr. (ATL) - 2018-2024

Search Examples

✅ These searches will work:

  • "Aaron Judge" → Finds Aaron Judge
  • "Judge" → Finds Aaron Judge
  • "Trout" → Finds Mike Trout
  • "Acuna" → Finds Ronald Acuña Jr.
  • "Juge" → Fuzzy match finds Aaron Judge

Using the App

  1. Start the app: ./start.sh
  2. Search for a player: Use the sidebar search box
  3. Set date range: Choose from presets or custom dates
  4. Apply filters: Adjust exit velocity, launch angle, etc.
  5. Select stadiums: Choose ballparks for comparison
  6. View results: Interactive spray chart with stadium overlays

For Real MLB Data

To get live Statcast data for any MLB player:

  1. The app will automatically fetch data via pybaseball
  2. First-time searches may take 10-30 seconds to load
  3. Data is cached for faster subsequent access
  4. Internet connection required for new player data

🎊 Quick Start

cd /Users/jacobg/Desktop/Projects/mlb-data-graphs
./start.sh

Then open your browser to: http://localhost:8501

The application is now ready for full baseball analytics exploration! 🎯⚾