cfbseedR 0.3.0
The MAC and Conference USA tiebreakers are now dated epochs that follow the published procedures. The MAC uses its 2024 order (common opponents, order of finish, opponents’ win pct, then SportSource) through 2024, and from 2025 puts SportSource right after common opponents, then order of finish and opponents’ combined conference win pct before the draw; the old entry stopped at SportSource and went to a draw (#16). Conference USA keeps its 2024 cascade (CFP clause, composite, APR) through 2024 and from 2025 uses record vs common opponents, a common-opponent descent, the average computer ranking and opponents’ combined conference win pct before the coin toss (#17).
The SEC, Big Ten, ACC and Big 12 “record against common opponents in order of finish” tiebreaker now compares only opponents that every tied team played, as those conferences’ published policies require (“common conference opponents played by all other teams involved in the tie”). Before, a tier of tied opponents counted once each tied team had played any one team in it. The real 2025 ACC berth now goes to Duke (it went to Georgia Tech) and the real 2025 SEC pairing is Alabama then Georgia (it was Georgia then Ole Miss), matching the actual title games. The Sun Belt’s “next highest position” rung is unchanged (#14).
Multi-team tiebreakers now restart from the first rung whenever a rung eliminates a team, instead of continuing down the rung list with the survivors. The Big 12’s published policy says “the multiple-team tiebreaker will repeat the tie-breaking procedure” after a team is seeded, and that a tie “reduced to two teams” gets the two-team procedure; the SEC restarts the same way. When a record-vs-common-opponents rung drops a third team and leaves two level, the pair’s head-to-head now decides. Previously the cascade kept descending: e.g. a Big 12 field of Utah (clear), BYU, Arizona and Texas Tech dropped Texas Tech on common opponents but then handed the berth to Arizona on its Utah win, even though BYU had beaten Arizona and the two-team procedure gives it to BYU. A rung that keeps every candidate still advances as before.
cfb_simulations()now aborts with a clear error when a team appearing in a game that still has to be simulated is missing fromteams. Previously the missing team produced anNArating,rnorm()returnedNA, and theNApropagated through every remaining week - so the run either returned a season in which no team won a game, or failed much later with an unrelated complaint thatplayoff_seedsexceeded the number of teams. The check is deliberately limited to games awaiting a result: a PLAYED game against an unlisted opponent remains valid, exactly as it is incfb_standings(), because standings only read results while simulation has to generate them. An unplayed game whosehome_teamoraway_teamisNAis rejected the same way and for the same reason -standings_validate_games()checks that those columns exist and rejectsNAresults, but neverNAteam names.The test suite now runs on CRAN, reversing the 0.2.0 change that skipped every test there. All tests are offline against the bundled toy season; the ones that need gt or scales call
skip_if_not_installed().Examples are no longer wrapped in
\donttest{}: they are all offline and fast, so CRAN’s regular example run now exercises them. Thefmt_pct_special()andsummary.cfbseedR_simulation()examples run only when their Suggests packages (scales, gt) are installed, via@examplesIf.cfbfastR is no longer listed in Suggests. No code, test or example used it;
cfb_games_from_schedule()still accepts itsload_cfb_schedules()output.DESCRIPTION declares
Language: en-US, and aninst/WORDLISTwas added for spell checking.The citation year is pinned to 2026 instead of following the current date.
cfbseedR 0.2.0
CRAN release: 2026-09-09
2026-season rules refresh (researched against official conference and CFP sources, 2026-08-26).
-
cfb_playoff_seeds()gains a season-keyedautobidpolicy. The new default"2026"implements the current CFP automatic-qualifier rule: the ACC / Big 12 / Big Ten / SEC champions are in regardless of ranking, the highest-ranked Group-of-6 team is in whether or not it won its conference, and Notre Dame is in when ranked inside the field.autobid = "2025"keeps the 2024-2025 rule (5 highest-ranked champions).cfb_simulations()passes the policy through. - The conference tiebreaker registry is now season-scoped: each conference registers dated epochs, resolved per season (current rules for plain
simids). The ACC’s all-new 2026 policy (head-to-head, then SportSource Team Success Ranking, then a draw, with the alternate-game-count candidate-pool rule and the postseason-eligibility filter) applies from 2026; earlier ACC seasons keep the 2024 cascade. - New official registry entries: American, Conference USA, and Mountain West (head-to-head / CFP-ranked-final-week clause / metric-composite procedures), and the Sun Belt (division format). The MAC entry now matches its published three-step procedure. The re-formed Pac-12 has not published a procedure and stays on the generic fallback.
- New rung primitives:
cfp_ranked_final_week(fed bytiebreaker_data$cfp_rankings; the best-ranked tied team advances only if it won its final conference game) anddiv_pct(win pct vs same-division opponents). -
cfb_simulations()gainstiebreaker_data(external tiebreaker inputs, held static across simulations) so simulated standings use the same official rungs ascfb_standings(). - The CUSA registry gains the policy’s late
aprrung (fed bytiebreaker_data$apr); the CFP auto-bid policy matches both short and full conference spellings (e.g."Southeastern Conference"). - CRAN preparation: every test skips on CRAN, every example is wrapped in
\donttest{}, and the packaging metadata (LICENSE, cph, CITATION,.Rbuildignore,.gitattributes) was reviewed. -
teamsgains two optional columns:conf_division(division-format ranking - the two division champions takeconf_rank1-2, as in the 2026 Sun Belt) andpostseason_eligible(an ineligible team cannot occupy a championship-game berth while its games still count).
nflseedR surface parity
-
Parallel simulation.
cfb_simulations()gainschunks(default 8): simulations are split into contiguous blocks and dispatched withfurrr::future_map(), so setting a parallel plan (future::plan("multisession")) spreads them across cores. Progress is reported throughprogressr. A given seed reproduces exactly for a fixedchunks, and a parallel plan gives bit-identical results to a sequential one – but the RNG stream differs from a single unchunked pass, so output for the same seed changes if you changechunks. -
summary()for simulations.cfbseedR_simulationobjects were classed but had no methods, sosummary()fell back to R’s generic list summary. There is now asummary.cfbseedR_simulation()gt method rendering theoveralltable grouped by conference, the counterpart of nflseedR’ssummary.nflseedR_simulation(). -
fmt_pct_special()formats probabilities the way simulation summaries want them:<1%instead of a flat0%,>99.9%instead of a false100%. Ported from nflseedR. -
Exported example data.
cfb_games_exampleandcfb_teams_examplereplace theread.csv(system.file(...))dance in examples, mirroring nflseedR’ssims_games_example/sims_teams_example. -
verbosityoncfb_simulations(), matchingcfb_standings()andnfl_simulations();"NONE"silences it completely. The simulation’s tiebreak notes are now attached to the returned standings as well – they were previously computed and discarded. -
ranks = "NONE"oncfb_standings()skips the conference-rank cascade entirely when you only need records, after nflseedR’sranksargument. - New Imports: furrr, future, progressr. New Suggests: gt, scales (both only needed for
summary()andfmt_pct_special()).
cfbseedR 0.1.0
Initial release.
-
cfb_standings()computes overall and conference standings with a documented generic tiebreaker cascade (win pct, head-to-head, common opponents, SOV, SOS, point differential, coin flip) gated bytiebreaker_depth. -
cfb_playoff_seeds()implements 12-team College Football Playoff straight seeding (5 highest-ranked conference champions guaranteed). -
cfb_simulations()simulates seasons week by week with a pluggablecompute_resultsfunction and returns a classedcfbseedR_simulationlist with standings, games, and aggregated probabilities. -
cfbseedR_compute_results()is the default ELO-based results generator, a faithful adaptation ofnflseedR_compute_results(). -
cfb_games_from_schedule()mapscfbfastR::load_cfb_schedules()output to the engine games schema. -
simulations_verify_fct()verifies customcompute_resultsfunctions.
Adapted from nflseedR (MIT) by Sebastian Carl and Lee Sharpe.