Differences

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

--- icypc_instructions [2010/11/11 13:18] – jtkorb
+++ icypc_instructions [2011/11/08 11:54] (current) – jtkorb
@@ Line 7: / Line 7: @@
     * ''~/icypc/planter''
     * etc
+  - Naming convention: Please do not use ''-'' or ''.'' characters in your script names (just alphanumerics).
   - Be sure to make them executable (again, ''chmod 755'' will do it)
-  - Register program(s) at ladder website: [[http://pc2.cs.purdue.edu:8000/ladder]]
+  - Register program(s) at ladder website: [[https://pc.cs.purdue.edu/icypc]]
+  - To help with some automation to locate competitors, please ensure that the only executable files in ''~/icypc'' are competitor scripts.
 A quick way to ensure that your icypc directory and all files are world-readable and (where appropriate) world-executable:
@@ Line 17: / Line 19: @@
 Note that this command makes everything in your ''icypc'' directory readable, including source code if it is there.
+You might find it useful to create subdirectories in ''~/icypc'' (or elsewhere) to contain your source code and a working copy of your binaries (e.g., .class files for Java).  Then, when you've sufficiently debugged your competitor and want to take on other players on the ladder, copy your binaries to the ''~/icypc'' directory for execution by your competitor script.
+====== Ladder Rules ======
+  - Any time a challenger beats a defender, the two competitors swap positions in the ladder.
+  - If a challenger scores 0 points in a match, that competitor is //benched//, making it unavailable for future matches until it has been //readied// again for competition (e.g., by resubmitting it by the original author).
 ====== Script Examples ======
 **''hunter''**
-  #!/bin/bash
+  #!/bin/sh
   cd /homes/YOUR-LOGIN-ID/icypc
   /p/java-1.6/bin/java java_example.Hunter
 **''camper''**
-  #!/bin/bash
+  #!/bin/sh
   cd /homes/YOUR-LOGIN-ID/icypc
   c++_example/camper
-====== To Play a "Friendly" Competition with One Another ======
+====== Viewing Instructions ======
-  - Use setup as above.
+You can view a replay of any ladder match. (Trace files are kept in ''/homes/cs390cp/traces''.)
-  - Example (with assumed student/player names)...
-  % java -jar icypc.jar -player pipe 1 /homes/li400/icypc/hunter -player pipe 1 /homes/wzhang/icypc/planter
+  * To view a match in 2D (''NNN'' is the match number):
-There is an example "battle" script in /homes/jtk/icypc/battle, which takes four arguments:
+  % /homes/cs390cp/bin/view2d NNN
-  % /homes/jtk/icypc/battle li400 hunter wzhang planter
+  * To view a match in 3D (''NNN'' is the match number):
-Also, see the "hunter" and "camper" scripts in that directory for examples of running Java and C++ competitors.  There is also a "twoer" script that uses a two hunter plus two planter strategy.
-====== Viewing Instructions ======
+  % /homes/cs390cp/bin/view3d NNN
-  * To view in 2D (''NNN'' is the match number):
+  * To view the stdout from the match:
-  % /homes/cs390cp/bin/view NNN
+  % /homes/cs390cp/bin/viewso NNN
-  * To view in 3D (''NNN'' is the match number):
+  * To view the stderr from the match:
-  % /homes/cs390cp/bin/view3d NNN
+  % /homes/cs390cp/bin/viewse NNN
+====== To Play a "Friendly" Competition with One Another ======
+  - Use setup as above.
+  - Example (with assumed student/player names)...
+  % java -jar icypc.jar -player pipe 1 /homes/li400/icypc/hunter -player pipe 1 /homes/wzhang/icypc/planter
+There is an example "battle" script in ''/homes/cs390cp/bin/battle'', which takes four arguments:
+  % /homes/cs390cp/bin/battle li400 hunter wzhang planter
-Note that 3D viewing works in the Linux lab (LWSN B158), but not (currently) in the Solaris lab (LWSN B146).
+Also, see the "hunter" and "camper" scripts in /homes/jtk/icypc for examples of running Java and C++ competitors.  There is also a "twoer" script that uses a two hunter plus two planter strategy.