Here we answer various questions regarding the 3D simulator and the UT Austin Villa code base.

Is there something missing? Something you want to add? Email us, and we'll add it.

• Are there any example agents I can test my agent against? Yes, you can play against released binaries from the 2015 competiton. You will find them in the /projects/cs344M.pstone/3d/opponents/ directory. These binaries have been configured to run on UTCS. The RoboCup 2015 released binaries (not specifically configured to run on UTCS) are also located at http://chaosscripting.net/files/competitions/RoboCup/WorldCup/2015/3DSim/binaries/. To see how the different teams did during the tournament you can check the RoboCup 2015 3D simulation league results page.
  General instructions for running a binary:
  • You can run any of the teams from within their agent directory with the following command:

         % ./start.sh localhost (some teams might require 127.0.0.1
         instead of localhost)
    

    If you are running a server on a remote machine (usually a good idea when running a full game) Replace localhost with the name of the machine (or ip address) the server is running on.

         % ./start.sh remote_machine_name (some teams might require the ip
         address of the machine instead of its name)
    

  • Important: Some of the teams don't kill themselves when the server is shutdown meaning that you need to manually kill the team after running it. This is true of the miracle3d team and possibly others. For these teams you need to manually kill their agent processes when you're finished running them.

         % ./kill.sh
    

• Is there a good place to find out what the UT Austin Villa team does for different things? There is a farily comprehensive description of the UT Austin Villa team in the UT Austin Villa 2011 3D Simulation Team Report.
• How can I run the server remotely on UTCS but watch games locally on my machine at home?
  • 1. Checkout roboviz from the repo at https://github.com/magmaOffenburg/RoboViz.
  • 2. Follow the RoboViz installation instructions at https://sites.google.com/site/umroboviz/usage/setup - ie. download JDK, compile with sh build-<OS>.sh (ignore intructions for obtaining source code as that is for an older version of roboviz...the latest version's source was retrieved in the first step)
  • 3. Run server on remote machine as usual (run_server3d)
  • 4. Run roboviz monitor on local machine and have it connect to remote machine (./roboviz.sh --serverHost=<remote_machine>)
  • 5. Run agents remotely on another UTCS machine as usual
• How do I use the UT Austin Villa positioning system with dynamic role assignment? In order to use dynamic role assignment from the SCRAM: Scalable Collision-avoiding Role Assignment with Minimal-makespan for Formational Positioning paper you will need to set the useDynamicRoleAssignment variable to true in naobehavior.cc. Note that this only enables computation of role assignments and does not include the voting coordination system from the Positioning to Win: A Dynamic Role Assignment and Formation Positioning System paper (which is not in the code base).
  
  You can specify position locations for the different roles in the getSpaceForRole() function in positioning.cc. The positioning system has two special roles: ON_BALL and GOALIE. The ON_BALL role is always assigned to the player closest to the ball (as determined by the getClosenessToBallMeasure() metric in positioning.cc) while the GOALIE role is assigned to the goalie (the agent with uniform number 1) unless the goalie is the closest to the ball and has been assigned the ON_BALL role.
  
  A good way to get the current position assigned to an agent by the positioning system is to get the value returned by getSpaceForRole(worldModel->getProposedRoles()[worldModel->getUNum()-1]).
• Is there code for communication among teammates I can use? We have released code that allows for basic things such as players communicating the position of the ball and their own positions. Look at README.audio and the audio.* files.
• Penalty Kick Shootouts: A penalty kick shootout occurs when two teams are tied after both regulation and overtime periods when a tie must be broken. Each time gets 5 attempts to score with a lone shooter against the other team's goalie. At the start of an attempt the ball is placed at the center of the field and the shooter has 60 seconds to score. The goalie for the defending team trying to stop the shooter is not allowed to leave the penalty box (the shooter is allowed to enter the penalty box). After the 5 scoring attempts by each team the team with the most goals wins. If the teams have the same number of goals after 5 attempts each then they continue alternating scoring attempts until one team scores and the other doesn't.
  • How do I create a penalty kick shooter? You can edit the methods in the PKShooterBehavior class in pkbehaviors.cc. In order to start a penalty kick shooter run the start_penalty_kicker.sh script.
  • How do I create a penalty kick goalie? You can edit the methods in the PKGoalieBehavior class in pkbehaviors.cc. You may find the isOutsidePenaltyBox() method useful which lets you know whether a location is inside the penalty box. In order to start a penalty kick goalie run the start_penalty_goalie.sh script.
• I want to run repeated trials of an agent doing something and then measure X. Is there an automated way to do this? We have created agents for doing this sort of thing for reinforcement learning.
  • Look in the optimization directory. Here you will find scripting files for what we call optimization agents. Optimization agents perform some behavior (potentially determined by an input file) and then write out some output to a file. Check the README file for some pointers as to what is going on here.
  • Run the optimization/run-opt.sh script. This will by default run an agent that measures how far it can walk forward in 15 seconds.
    Example usage: run-opt.sh /tmp/out.txt
  • Checkout optimizationbehaviors.cc. Here you will find the behavior classes for the optimization agents. Methods for the classes are beam() to initialize where an agent starts, selectSkill() to control an agent's behavior, and updateFitness() to monitor and write out data.
• How can I play two teams against each other and automatically record the score from the game? We have a script for doing this which plays a single half between your team and an opponent team and then writes out the score.
  • Look in the stats directory. Here you will find scripting files for playing your team against an opponent team for a half. Check the README file for some pointers as to what is going on here.
  • Run the stats/run-stats.sh script. This will run your agent against an opponent agent, with your agent either starting on the left or right side of the field, and then write output to the given output file.
    Example usage: run-stats.sh /tmp/out.txt ~/opponent_dir left
  • Checkout recordstatsbehavior.cc. Here you can change the updateFitness() method in the RecordStatsBehavior class to change what data is being recorded and written out.
  • We have scripts for running many games in parallel on the condor distributed computing cluster. Talk to us if you want to learn how to do this.
• Can I get an agent's ground truth position? Yes, you can use the worldModel->getMyPositionGroundTruth() method which gets an agent's ground truth position from the server. Note that this functionality will NOT be turned on during the class tournament so don't use this function in your final agent submission or you will be sorry. Also you will need to use a version of the server that has ground truth data enabled: rcroboviz_gt, run_server3d_gt, and rcsoccsersim3d_gt.
• Is there a way to move the ball or players around and also change the current game state? You can change the game state in RoboViz by typing 'O' and choosing a state from the menu. You can also select agents and the ball and then control-click to move them. Additionally you can use the Coach/Trainer command parser documented here to change the play mode as well as the positions and velocities of objects on the field. Examples of its usage can be found in move-ball.pl, stats/kickoff.pl, and optimization/beamball-and-kickoff.pl. The agent can also send commands directly to the Coach/Trainer command parser directly by passing the message to the setMonMessage() method. In order for this to work, however, the agent must connect to the server through the monitor port by adding the command line argument "--mport 3200".
• Is there a way to graphically edit librcsc formations? Yes, you can use the fedit2 tool. It is located in the /projects/cs344M.pstone/3d/fedit2-0.0.0/src directory.

       % cd /projects/cs344M.pstone/3d/fedit2-0.0.0/src
       % ./fedit2
  

  We hope to add more information about how to use this tool soon.
• How do I create a delaunay triangulation formation file for use with librcsc? See formations/delaunay_example.conf for an example formation file.
• Can I have the server run faster than real-time? Yes, before running the server run the following command:

       % export SPARK_FAST_TIME=true
  

  Note that if you try and run more than one agent when attempting to run the server in faster than real-time mode it may freeze the server.