burlap.oomdp.stochasticgames.tournament

Class Tournament

java.lang.Object

burlap.oomdp.stochasticgames.tournament.Tournament

public class Tournament
extends java.lang.Object

This class is designed to run tournaments of sets of users. It is particularly useful when there are a large number of agents whose performance is going to be compared in games in which only a subset of the agents can participate at a time, for instance running a tournament of many agents in 2-player games like iterated prisoner's dilemma. The Tournament class requires a list of agents, a world generator and a match selector. The MatchSelector determines which agents will be matched up in a game, which SGAgentType role they will play as and how many matches there will be.

Author:

James MacGlashan

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.List<AgentFactory>	agents
protected int	debugId
protected int	maxStages
protected int	numGames
protected MatchSelector	selector
protected java.util.List<java.lang.Double>	tournamentCumulatedReward
protected WorldGenerator	worldGenerator

Constructor Summary

Constructors

Constructor and Description
Tournament(int maxStages, int numGames, MatchSelector selector, WorldGenerator worldGenerator) Initializes the Tournament
Tournament(int maxStages, MatchSelector selector, WorldGenerator worldGenerator) Initializes the Tournament
Tournament(java.util.List<AgentFactory> agents, int maxStages, int numGames, MatchSelector selector, WorldGenerator worldGenerator) Initializes the Tournament
Tournament(java.util.List<AgentFactory> agents, int maxStages, MatchSelector selector, WorldGenerator worldGenerator) Initializes the Tournament

Method Summary

Methods

Modifier and Type	Method and Description
int	addAgent(AgentFactory agent) Adds an agent to the tournament
double	getCumulativeRewardFor(int i) Returns the cumulative reward received by the agent who is indexed at position i
int	getNumAgents() Returns the number of agents who are playing in this tournament
void	printOutResults() Prints the tournament results by agent index and their cumulative reward received in the tournament.
void	resetTournamentReward() Reset the cumulative reward received by each agent in this tournament.
void	runTournament() Runs the tournament

Methods inherited from class java.lang.Object

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

Field Detail

agents

protected java.util.List<AgentFactory> agents

tournamentCumulatedReward

protected java.util.List<java.lang.Double> tournamentCumulatedReward

maxStages

protected int maxStages

numGames

protected int numGames

selector

protected MatchSelector selector

worldGenerator

protected WorldGenerator worldGenerator

debugId

protected int debugId

Constructor Detail

Tournament

public Tournament(int maxStages,
          MatchSelector selector,
          WorldGenerator worldGenerator)

Initializes the Tournament

Parameters:

maxStages - the maximum number of stages to be played in any single game of the tournament.

selector - a match selector that dictates which agents will play who and in which games

worldGenerator - a world generator to create new worlds for each match

Tournament

public Tournament(int maxStages,
          int numGames,
          MatchSelector selector,
          WorldGenerator worldGenerator)

Initializes the Tournament

Parameters:

maxStages - the maximum number of stages to be played in any single game of the tournament.

numGames - the number of games that will be played for each agent matching

selector - a match selector that dictates which agents will play who and in which games

worldGenerator - a world generator to create new worlds for each match

Tournament

public Tournament(java.util.List<AgentFactory> agents,
          int maxStages,
          MatchSelector selector,
          WorldGenerator worldGenerator)

Initializes the Tournament

Parameters:

agents - the list of agents that will participate in the tournament

maxStages - the maximum number of stages to be played in any single game of the tournament.

selector - a match selector that dictates which agents will play who and in which games

worldGenerator - a world generator to create new worlds for each match

Tournament

public Tournament(java.util.List<AgentFactory> agents,
          int maxStages,
          int numGames,
          MatchSelector selector,
          WorldGenerator worldGenerator)

Initializes the Tournament

Parameters:

agents - the list of agents that will participate in the tournament

maxStages - the maximum number of stages to be played in any single game of the tournament.

numGames - the number of games that will be played for each agent matching

selector - a match selector that dictates which agents will play who and in which games

worldGenerator - a world generator to create new worlds for each match

Method Detail

addAgent

public int addAgent(AgentFactory agent)

Adds an agent to the tournament

Parameters:

agent - the agent to add to the tournament

Returns:

the index of the agent in this tournament

getNumAgents

public int getNumAgents()

Returns the number of agents who are playing in this tournament

Returns:

the number of agents who are playing in this tournament

getCumulativeRewardFor

public double getCumulativeRewardFor(int i)

Returns the cumulative reward received by the agent who is indexed at position i

Parameters:

i - the index of the agent

Returns:

the cumulative reward received by the agent who is indexed at position i

resetTournamentReward

public void resetTournamentReward()

Reset the cumulative reward received by each agent in this tournament.

printOutResults

public void printOutResults()

Prints the tournament results by agent index and their cumulative reward received in the tournament.

runTournament

public void runTournament()

Runs the tournament