Differences

This shows you the differences between two versions of the page.

--- public:t-622-arti-13-1:prog2 [2013/02/05 14:50] – created stephan
+++ public:t-622-arti-13-1:prog2 [2024/04/29 13:33] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
 ====== Programming Assignment 2 - Adversarial Search ======
-**Use the [[http://ruclasses.proboards.com/index.cgi?action=display&board=arti2013|forum]] or email me, if you have any questions or problems with the assignment. Start early, so you still have time to ask in case of problems!**
+**Use the [[http://ruclasses.proboards.com/index.cgi?action=display&board=arti2013&thread=119|forum]] or email me, if you have any questions or problems with the assignment. Start early, so you still have time to ask in case of problems!**
 ===== Problem Description =====
@@ Line 18: / Line 18: @@
   - Test if it is really better by pitching two agents (one with each evaluation function) against each other or by pitching each evaluation function against a random agent. Make sure to run the experiments with the random agent several times to get significant results. Don't forget to switch sides because white has a slight advantage in the game.
   - Do all experiments with time constraints (play clock) of 1s, 5s and 10s.
-  - Make you code fast! The more state expansions you get per second, the better the player.
+  - Make your code fast! The more state expansions you get per second, the better the player.
 ===== Material =====
@@ Line 27: / Line 27: @@
 The zip file also contains the description of the environment (connect4.gdl) and a simulator (gamecontroller-gui.jar). To test your agent:
-  - Start the simulator (execute gamecontroller-gui.jar with either double-click or using the command "java -jar gamecontroller-gui.jar" on the command line).
+  * Start the simulator (execute gamecontroller-gui.jar with either double-click or using the command "java -jar gamecontroller-gui.jar" on the command line).
-  - Setup the simulator as shown in this picture:
+  * Setup the simulator as shown in this picture:
     {{:public:t-622-arti-12-1:gamecontroller-settings-connect4.png?nolink&|}}
-  - You can use your player as both the first and the second role of the game, just not at the same time.
+  * You can use your player as both the first and the second role of the game, just not at the same time. To let two instances of your agent play against each other, start your agent twice with different ports to listen on and use the respective ports in the simulator.
-  - Run the "Main" class in the project. If you added your own agent class, make sure that it is used in the main method of Main.java. You can also execute the "ant run" on the command line, if you have [[http://ant.apache.org/|Ant]] installed. The output of the agent should say "NanoHTTPD is listening on port 4001", which indicates that your agent is ready and waiting for messages to arrive on the specified port.
+  * Run the "Main" class in the project. If you added your own agent class, make sure that it is used in the main method of Main.java. You can also execute the "ant run" on the command line, if you have [[http://ant.apache.org/|Ant]] installed. The output of the agent should say "NanoHTTPD is listening on port 4001", which indicates that your agent is ready and waiting for messages to arrive on the specified port.
-  - Now push the "Start" button in the simulator and your agent should get some messages and reply with the actions it wants to execute. At the end, the output of the simulator tells you how many points both players got: "Game over! results: 0 100", the first number is for white and the second for red.
+  * Now push the "Start" button in the simulator and your agent should get some messages and reply with the actions it wants to execute. At the end, the output of the simulator tells you how many points both players got: "Game over! results: 0 100", the first number is for white and the second for red.
-  -  If the output of the simulator contains any line starting with "SEVERE", something is wrong. The two most common problems are the network connection (e.g., due to a firewall) between the simulator and the agent or the agent sending illegal moves.
+  * If the output of the simulator contains any line starting with "SEVERE", something is wrong. The two most common problems are the network connection (e.g., due to a firewall) between the simulator and the agent or the agent sending illegal moves.
 ===== Hints =====
@@ Line 40: / Line 40: @@
   * You have to implement the methods "init" and "nextAction". "init" will be called once at the start and should be used to initialize the agent. You will get the information, which role your agent is playing (white or red) and how much time the agent has for computing each move. "nextAction" gets the previous move as input and has to return the next action the agent is supposed to execute within the given time limit. "nextAction" is called for every step of the game. If it is not your players turn return "NOOP".
   * **Make sure your agent is able to play both roles (white and red)!**
-  * You can make sure to be on time by regularly checking whether there is time left during the search process and stopping the search just before you run out of time.
+  * You can make sure to be on time by regularly checking whether there is time left during the search process and stopping the search just before you run out of time, e.g., by throwing an exception that you catch where you call the search function the first time.
+  * To specify the port your agent is running on change the build.xml file as follows and use the command line ''ant -Darg0=PORT run'' with PORT being the port number:
+<file xml build.xml>
+      ...
+      <target name="run" depends="dist">
+              <java jar="${dist}/${projectname}.jar" fork="true">
+                      <arg value="${arg0}"/> <!-- add this line here! -->
+                      <jvmarg value="-Xmx500m" />
+              </java>
+              <antcall target="clean" />
+      </target>
+      ...
+</file>
 ===== Handing In =====
-Please hand in a zip file containing:
+Please hand in:
   * a short description of your heuristic
   * the results of the experiments and which conclusions you draw from them
   * the source code and an executable jar file for your agent
-To create the zip file you just edit the "student" property in the build.xml and call the "zip" target using ant (execute "ant zip" in the directory containing the build.xml).
+To create the zip file you just edit the "student" property in the build.xml and call the "zip" target using ant (execute "ant zip" in the directory containing the build.xml). Make sure to have all files that are to be in the zip file in the directory containing the build.xml or below.
+The deadline is Friday, 01.03.2013 for source code and executable player and Monday, 04.03.2013 for the report. We will have a tournament between your agents in the lab on Thursday, 07.03.2013. Extra points for the top players!
-The deadline is Sunday, 03.03.2013. We will have a tournament between your agents in the lab on Thursday, 07.03.2013. Extra points for the top players!
+You can watch the tournament [[http://130.208.241.192/ggpserver/public/view_tournament.jsp?tournamentID=ru_arti13_connect4|here]].
-/* You can watch the tournament [[http://130.208.241.192/ggpserver/public/view_tournament.jsp?tournamentID=ru-ai2012-connect4|here]].
-*/
 As with the first programming assignment, you can still hand in after the deadline (by email), but your grade will be lowered by 0.5 for each day your submission is late. Also, you can't get the extra points for being good in the tournament.