Installing the testbed is relatively easy with Eclipse and Java 1.5 or better. The current iteration of the project was developed for an classroom exercise where students wrote their own policies for a team forming agent. The only contest-specific portion is the reporting of the best and worst agents when the simulation halts. Everything else is general and extensible.
Below are step by step instructions for getting started. They assume you have a current version of Eclipse and Java 1.5 installed (If you do not there are instructions at the bottom of the page to acquire them).
- Start up eclipse, choose a workspace.
- Download the project archive.
- Choose file -> import...
- In the import dialog, choose "existing projects into workspace"
- Select the option "select archive file"
- Browse to the archive file you downloaded.
- Click Finish
- The project should import and build automatically. If not, choose Project->clean . Select 'clean all projects' and 'start build immediately.' I usually leave Project->buildAutomatically selected.
- When it compiles, there are a large number of errors. They should all be within ESRIRaster.java . The Repast instructions said to ignore these errors. Everything runs fine, if you ignore these 81 errors, and there are no other errors present. There should not be errors in any other file.
- If you have more than the 81 errors, make sure you have java 1.5 support turned on in Eclipse: window -> preferences. Choose Java. Choose compiler. Change the default compliance setting to 5.0. If you do not want to make 5.0 the default setting, you can do the same thing, through the project's preferences.
- Open the file named AgentStub.java and follow the instructions there for creating an agent and adding it to the simulator. Re-compile the project.
- In the package explorer, expand the BasicTeamForm project. Expand the edu.umbc.cs.maple.autumn.basicTeamForm package.
- Right click on TeamFormationModel.java . Select "Run As" and select Java Application. It will warn you there are errors in the repast3 project. Select Continue.
- The simulation should launch at this point.
Here are quick instructions for downloading Java 1.5 and Eclipse
- Download Java 5
- After the file is downloaded, read the installation instructions and then install Java 1.5
- Download the version of Eclipse Classic that fits your operating system (by clicking on the links to the right of the Eclipse Classic package)
- When the file completes downloading, extract it to a location of your choice. The zip file should contain a folder entitled eclipse
- Open the extracted eclipse folder, and open the file entitled eclipse.exe
- Eclipse should start up and prompt you to select a workspace. You can either select okay, or select a specific location and name for your workspace. At this point you have completed step 1 from the primary directions and can now follow from step 2.