The binaries in this directory are the ATT-CMUnited-2000 simulated
robotic soccer team which competed at RoboCup2000. It was created by
Patrick Riley, Peter Stone, David McAllester, and Manuela
Veloso. Please contact Patrick Riley <pfr@cs.cmu.edu> or Peter Stone
<pstone@research.att.com>. Note that this software is provided as-is
and is unsupported. 

There are two binaries: peterclient (for the players on the field) and 
coach (for the on-line coach). They were compiled under Linux RH5.2,
but they should also run under RH6.x and other versions of Linux. If
you would like to have compiled binaries for another platform, please 
contact us and we may be able to do that.

Note that we have some associated tools (such as the trainer and the
Layered Disclosure logplayer). These can be downloaded from our
CMUnited99 web site as they as essentially unchanged from the previous 
year
http://www.cs.cmu.edu/~pstone/RoboCup/CMUnited99-sim.html

**********************
Running the clients
**********************
The easiest way to run the clients is to use the given 'start'
script, which takes (optionally) the machine to connect to and the
team name to use. It starts up 11 players and the coach.

Note that you need to wait a couple of seconds after the players
connect for the coach to connect. The coach will print "Coach started"
on standard out once it has connected and initialized.

Also note that once you kill the server, the players and coach
*should* exit automatically. It may however, take a few seconds for
this to happen.

When you run the client, it is normal to see a few errors of the form:
PETER's ERROR (player 8, time 2.0): Only 2 interrupts last cycle
PETER's ERROR (player 1, time 15.0): Missed a cycle??
However, if you are getting many errors of this form, the players do
not have enough computation power and will not perform well.

Many aspects of the play of the game are controlled by the .conf file
settings. The .conf files given here are the ones used at RoboCup-2000
Feel free to change the values, though you are warned that some of
them may have unexpected consequences and not all are documented very
well.


***********
FILES
***********
The files in this directory are:
README: you're reading it right now
coach: the executable for the on-line coach
peterclient: the executable for the player
quicksleep: a little program that sleep for 1ms, used to keep players
            from connecting too quickly  
start: A script to start all players and the coach
coach.conf: configuration file for the coach
client.conf: configuration file for the player
server.conf: configuration file for server parameters (from v6.06 of
             the soccer server)
share.conf: configuration file shared by the coach and player
Plans/: this directory holds some default plans and some "seeds" used
        in the coach's planning for each set play

  
*********************************
More information and downloads
*********************************
The source code for our low levels (server interactions, world model,
and basic skills) is largely unchanged from the CMUnited99
team. Please see the CMUnited99 team web page if you are interested in 
getting source code for the low levels
http://www.cs.cmu.edu/~pstone/RoboCup/CMUnited99-sim.html
                                                                    
Please see our team web page
(http://www.cs.cmu.edu/~pstone/RoboCup/ATTCMUnited2000-sim.html) which
has pointers to a team description and other papers describing our
team. Also, we would appreciate an email if you start using these
binaries for any evaluations.

Thank you
The ATT-CMUunited-2000 Simulator Team Developers
Patrick Riley
Peter Stone
David McAllester
Manuela Veloso
