tracks

Class ArcadeMachine

java.lang.Object

tracks.ArcadeMachine

public class ArcadeMachine
extends java.lang.Object

Created with IntelliJ IDEA. User: Diego Date: 06/11/13 Time: 11:24 This is a Java port from Tom Schaul's VGDL - https://github.com/schaul/py-vgdl

Field Summary

Fields

Modifier and Type	Field and Description
static StatSummary	performance
static boolean	VERBOSE

Constructor Summary

Constructors

Constructor and Description
ArcadeMachine()

Method Summary

Modifier and Type	Method and Description
protected static Player	createController(java.lang.String playerName, int playerID, StateObservation so) Creates and initializes a new controller with the given name.
static AbstractMultiPlayer	createMultiPlayer(java.lang.String playerName, java.lang.String actionFile, StateObservationMulti so, int randomSeed, int id, boolean isHuman) Creates a player given its name with package for multiplayer.
static AbstractPlayer	createPlayer(java.lang.String playerName, java.lang.String actionFile, StateObservation so, int randomSeed, boolean isHuman) Creates a player given its name with package.
static boolean	isHuman(java.lang.String agentName)
static double[]	playOneGame(java.lang.String game_file, java.lang.String level_file, java.lang.String actionFile, int randomSeed) Reads and launches a game for a human to be played.
static double[]	playOneGameMulti(java.lang.String game_file, java.lang.String level_file, java.lang.String actionFile, int randomSeed) Reads and launches a game for a human to be played.
static double[]	replayGame(java.lang.String game_file, java.lang.String level_file, boolean visuals, java.lang.String actionFile) Runs a replay given a game, level and file with the actions to execute.
static void	runGames(java.lang.String game_file, java.lang.String[] level_files, int level_times, java.lang.String agentName, java.lang.String[] actionFiles) Reads and launches a game for a bot to be played.
static double[]	runOneGame(java.lang.String game_file, java.lang.String level_file, boolean visuals, java.lang.String agentNames, java.lang.String actionFile, int randomSeed, int playerID) Reads and launches a game for a bot to be played.
static boolean	tearPlayerDown(Game toPlay, Player[] players, java.lang.String actionFile, int randomSeed, boolean record) Tears the player down.
static void	warmUp(Game toPlay, long howLong) This methods takes the game and warms it up.

Methods inherited from class java.lang.Object

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

Field Detail

VERBOSE

public static final boolean VERBOSE

See Also:

Constant Field Values

performance

public static StatSummary performance

Constructor Detail

ArcadeMachine

public ArcadeMachine()

Method Detail

playOneGame

public static double[] playOneGame(java.lang.String game_file,
                                   java.lang.String level_file,
                                   java.lang.String actionFile,
                                   int randomSeed)

Reads and launches a game for a human to be played. Graphics always on.

Parameters:

game_file - game description file.

level_file - file with the level to be played.

playOneGameMulti

public static double[] playOneGameMulti(java.lang.String game_file,
                                        java.lang.String level_file,
                                        java.lang.String actionFile,
                                        int randomSeed)

Reads and launches a game for a human to be played. Graphics always on.

Parameters:

game_file - game description file.

level_file - file with the level to be played.

actionFile - to save the actions of the game.

randomSeed - for the game to be played.

runOneGame

public static double[] runOneGame(java.lang.String game_file,
                                  java.lang.String level_file,
                                  boolean visuals,
                                  java.lang.String agentNames,
                                  java.lang.String actionFile,
                                  int randomSeed,
                                  int playerID)

Reads and launches a game for a bot to be played. Graphics can be on or off.

Parameters:

game_file - game description file.

level_file - file with the level to be played.

visuals - true to show the graphics, false otherwise.

agentNames - names (inc. package) where the tracks are otherwise. Names separated by space.

actionFile - filename of the files where the actions of these players, for this game, should be recorded.

randomSeed - sampleRandom seed for the sampleRandom generator.

playerID - ID of the human player

replayGame

public static double[] replayGame(java.lang.String game_file,
                                  java.lang.String level_file,
                                  boolean visuals,
                                  java.lang.String actionFile)

Runs a replay given a game, level and file with the actions to execute.

Parameters:

game_file - game description file.

level_file - file with the level to be played.

visuals - true to show the graphics, false otherwise.

actionFile - name of the file where the actions of these players, for this game, must be read from. If the game is multi player, this file contains meta game information (winner, scores, timesteps, random seed) and names of all the files for player actions.

runGames

public static void runGames(java.lang.String game_file,
                            java.lang.String[] level_files,
                            int level_times,
                            java.lang.String agentName,
                            java.lang.String[] actionFiles)

Reads and launches a game for a bot to be played. It specifies which levels to play and how many times. Filenames for saving actions can be specified. Graphics always off.

Parameters:

game_file - game description file.

level_files - array of level file names to play.

level_times - how many times each level has to be played.

actionFiles - names of the files where the actions of this player, for this game, should be recorded. Accepts null if no recording is desired. If not null, this array must contain as much String objects as level_files.length*level_times.

createPlayer

public static AbstractPlayer createPlayer(java.lang.String playerName,
                                          java.lang.String actionFile,
                                          StateObservation so,
                                          int randomSeed,
                                          boolean isHuman)

Creates a player given its name with package. This class calls the constructor of the agent and initializes the action recording procedure. PlayerID used is 0, default for single player games.

Parameters:

playerName - name of the agent to create. It must be of the type ".Agent".

actionFile - filename of the file where the actions of this player, for this game, should be recorded.

so - Initial state of the game to be played by the agent.

randomSeed - Seed for the sampleRandom generator of the game to be played.

isHuman - Indicates if the player is human

Returns:

the player, created and initialized, ready to start playing the game.

createMultiPlayer

public static AbstractMultiPlayer createMultiPlayer(java.lang.String playerName,
                                                    java.lang.String actionFile,
                                                    StateObservationMulti so,
                                                    int randomSeed,
                                                    int id,
                                                    boolean isHuman)

Creates a player given its name with package for multiplayer. This class calls the constructor of the agent and initializes the action recording procedure. PlayerID used is 0, default for single player games.

Parameters:

playerName - name of the agent to create. It must be of the type ".Agent".

actionFile - filename of the file where the actions of this player, for this game, should be recorded.

so - Initial state of the game to be played by the agent.

randomSeed - Seed for the sampleRandom generator of the game to be played.

isHuman - Indicates if the player is human

Returns:

the player, created and initialized, ready to start playing the game.

createController

protected static Player createController(java.lang.String playerName,
                                         int playerID,
                                         StateObservation so)
                                  throws java.lang.RuntimeException

Creates and initializes a new controller with the given name. Takes into account the initialization time, calling the appropriate constructor with the state observation and time due parameters.

Parameters:

playerName - Name of the controller to instantiate.

so - Initial state of the game to be played by the agent.

Returns:

the player if it could be created, null otherwise.

Throws:

java.lang.RuntimeException

warmUp

public static void warmUp(Game toPlay,
                          long howLong)

This methods takes the game and warms it up. This allows Java to finish the runtime compilation process and optimize the code before the proper game starts.

Parameters:

toPlay - game to be warmed up.

howLong - for how long the warming up process must last (in milliseconds).

tearPlayerDown

public static boolean tearPlayerDown(Game toPlay,
                                     Player[] players,
                                     java.lang.String actionFile,
                                     int randomSeed,
                                     boolean record)

Tears the player down. This initiates the saving of actions to file. It should be called when the game played is over.

Parameters:

toPlay - game played.

players - players to be closed.

actionFile - file where players' actions should be saved.

randomSeed - random seed of the game.

record - boolean, true if actions should be recorded, false otherwise

Returns:

false if there was a timeout from the players. true otherwise.

isHuman

public static final boolean isHuman(java.lang.String agentName)