Python Tournament Engine

[nneonneo]

After a few days of feverish coding, the Python tournament engine is ready for general use.

This engine comprises two main programs: round and tournament.

Round runs a single match against two players (either human or bot), allowing you to play matches directly against your bot to test its mettle.

Tournament runs a full tournament between any number of bot players, allowing you to quickly test multiple strategies and variations against each other.

Both can be run as-is, and they will prompt you for the initial setup. They each have several command-line options for power users, and you can get more information with the "--help" switch.

Windows users are recommended to get the "windows.zip" package, which includes precompiled versions of both programs, so you don't need Python installed. The Windows package also includes two precompiled starter bots (starter_cs from the C# package and starter_cpp from the C++ package) so that you can try out the tournament and round features without needing to have a bot of your own.

Everyone else should get the "source.zip" or "source.tar.gz" package, which includes executable Python source code for both programs.

Grab them here: http://csclub.uwaterloo.ca/~b2xiao/ai/

If you have any questions, problems, comments or concerns, please voice them in this thread!

Changelog:
Feb 7 2010

• Added Java tournament maps
• Added visualizer output for nsasherr's visualizer (pdf/png output like the forum header image) and pgpaskar's visualizer (JavaScript visualizer still in development)
• Fixed encoding-related bug in Windows package; thanks to m3lawren for finding this

Feb 4 2010

• Files can now be used to specify intricate board layouts. The format is two integers on a line (width and height) separated by a space, followed by several lines containing "#" for walls and " " for spaces; see sampleboard.txt for an example and sampleboardlist.txt for use in a tournament.
• Timing adjustments for the tournament engine: the final result of each match is now shown for a longer time in detail level 3 (-vvv) mode.
• Included MSVCR71.dll in the Windows packages to fix missing DLL errors on certain Windows computers
• Fixed -u flag to tournament engine to make specific bots play in every round (this is similar to gauntlet.py, posted below).

[nneonneo]

Usage notes:

To run multiple commands for a bot, separate the commands with a & character on Windows, or a ; character on non-Windows computers. So, for instance, if you need to change directories to run your bot, you would use

(Windows)

Code: Select all

cd ../bot/ & bot_program

(Linux, UNIX, Mac OS X, etc.)

Code: Select all

cd ../bot/; bot_program

[mzulak]

Holy hell, this tournament engine is hella-sweet, especially with -vvv. Thanks so much for putting this together!

[amstan]

How do i give round.py a map that i made?

[nneonneo]

How do i give round.py a map that i made?

Code: Select all

./round.py BOT1 BOT2 -b "Board(10,10,layout=[
'##1    ###',
'###    ###',
<snip>
'###    2##'])"

[amstan]

Ugh, could you make it input a map file, tron.jar like?

[nneonneo]

Done in SVN, try it out (it's the "-B" flag for a filename and "-b" for a board specification).

[amstan]

Could you update your attachments in this topic, forum users can't access the svn.

[nneonneo]

I'm still shaking it down to make sure it works. Packages will be updated when they are ready.

[joeyjoejoe]

I have modified tournament.py slightly to create gauntlet.py

It works essentially the same, except it runs the champion (the first program listed in the botlist.txt) against the field, instead of the field against the field. This might be useful if you're just trying to test one program against a range of bots.

Kyle