Data sources
CFBD, caching, conference championships, and Sample data inputs.
Selection Room pulls game, ranking, and team metadata from documented external sources with local caching for reproducible runs.
What this page covers
- Live CFBD vs Sample data
- Caching behavior
- Conference championship handling
Live CFBD
Live runs use CollegeFootballData.com (CFBD) for schedules, scores, and team metadata. An API key is required for live mode; Sample data does not need one.
Sample data
Sample data ships a fixed CSV subset under data/processed/sample/ so contributors and CI can run without network access.
Committee reference data
Final CFP committee rankings for completed seasons are checked into the repository as reference data. They power the Model vs Committee comparison and the historical validation harness. Seasons without checked-in final rankings simply omit those surfaces.
Conference championships
When CFBD championship results exist (weeks 14–16), Selection Room uses them. Before results are available, documented tiebreakers and simulated resolution may apply.
Note
Team logos and colors may come from ESPN CDN URLs embedded in cached team assets.