Class TournamentSchedulers

java.lang.Object

org.episteme.social.sports.TournamentSchedulers

public final class TournamentSchedulers
extends Object

Provides mathematical algorithms for scheduling sports competitions, including Round Robin, Single Elimination, and Swiss System pairings.

Since:

1.0

Version:

1.1

Author:

Silvere Martin-Michiellot, Gemini AI (Google DeepMind)

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	TournamentSchedulers.ScheduledMatch	Details of a scheduled match within a tournament structure.

Method Summary

Modifier and Type	Method	Description
static List<TournamentSchedulers.ScheduledMatch>	generateRoundRobin(List<Team> teams)	Generates a complete Round Robin schedule for the given teams.
static List<TournamentSchedulers.ScheduledMatch>	generateSwissRound(List<Team> teams, Map<Team,Integer> currentScores, int roundNumber)	Generates pairings for a Swiss System tournament round based on current scores.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

generateRoundRobin

public static List<TournamentSchedulers.ScheduledMatch> generateRoundRobin(List<Team> teams)

Generates a complete Round Robin schedule for the given teams. Uses the Circle Method algorithm.

Parameters:

teams - the participating teams

Returns:

a list of scheduled matches for all rounds

generateSwissRound

public static List<TournamentSchedulers.ScheduledMatch> generateSwissRound(List<Team> teams,
 Map<Team,Integer> currentScores,
 int roundNumber)

Generates pairings for a Swiss System tournament round based on current scores.

Parameters:

teams - list of all teams

currentScores - mapping of each team to their current points

roundNumber - the current round index

Returns:

pairings for this round