RoboJogger

From Robowiki
Revision as of 23:30, 14 December 2012 by Skotty (talk | contribs) (Added some more detailed version 0.9 notes)
Jump to navigation Jump to search

A user interface for RoboRunner currently being developed by Skotty. Once the user interface is complete, this page will provide details on it; until then, this page will provide information on development progress.

Version Support

RoboJogger 0.9

  • RoboRunner -- Packaged with custom RoboRunner 1.2.3.1. Will mostly work with RoboRunner 1.2.3 but requires some jar modifications.
  • Robocode -- Known to work with Robocode 1.7.3.x. Not yet tested on other versions, but likely works with many versions up to current.
  • Java -- Requires version 1.6+ for most platforms. On Mac, with the current build, RoboJogger may not work with any Java version other than 1.6. With 1.7, my understanding is that Apple turned Java over to Oracle, and I am unsure whether or not the Apple Java Extensions used in RoboJogger will function properly, or if they will need to be removed for 1.7+.

Development Progress

The RoboJogger UI is being built using Skotty's existing Swing codebase as a starting point. This means some of the background code may not be entirely clean or relevant, but it will speed development considerably.

At present, there is no licensing restrictions on any of the code, as it is all written entirely by Skotty and Skotty generally doesn't bother with licenses for his own code. However, some kind of open source license may be applied to RoboJogger before it is released, provided there is any desire for such.

An initial trial version is complete -- version 0.9 -- but it's features are reduced until an updated RoboRunner is released that provides a way to get on-the-fly battle results. Until then, version 0.9 uses a very slightly modified version of RoboRunner 1.2.3, where the only change is to allow RoboRunner to be interrupted mid-challenge.

The app is initially set up for using Robocode 1.7.3.0. If you switch Robocode versions when running Setup, you will have to manually copy the correct robocode.jar file into the robocode_jars folder that RoboJogger uses (you will be prompted about this in the program when you run Setup). Part of the issue is that the setup function is part of the application rather than a separate script as in RoboRunner, and I therefore cannot specify a classpath via the command line like RoboRunner itself does. Instead, RoboJogger uses robocode jars from a folder named robocode_jars. When setting up with a new version, most of the jars are automatically copied into this folder, but the robocode.jar file cannot be. When RoboJogger is running, robocode.jar is in use and cannot be automatically replaced. Thus the required manual copy.

One potential major problem right now has to do with reading and writing the score log files. They are not properly synchronized at the moment, so if you don't want to risk messing up a score log, it's best to avoid interrupting RoboRunner by clicking the Stop button or opening result summary windows while RoboRunner is still running. It's not a big deal -- I do these things frequently and haven't chanced on a messed up log file yet -- but just be aware it could happen.

As touched on earlier, until a new version of RoboRunner is released, there are no on-the-fly results. To see the latest results, you have to close any open results summary windows and reopen them, such that they pull the latest data from the RoboRunner score log files. Likewise, the status information for RoboRunner at the bottom of the main RoboJogger window currently does nothing. Also, RoboJogger calculates confidence values itself. Confidence values for individual robots will match what RoboRunner calculates, but confidence values for challenge groups and overall total will not be the same. The method RoboJogger uses is not the same as what RoboRunner uses. This will also hopefully be fixed after an update to both RoboRunner and RoboJogger.

Next progress update will be on or around 12/25/2012.

RoboJogger Version Notes

Version 0.9

  • Some features are not fully functional until a later update to RoboRunner is available. This includes:
    • On the fly battle results not yet available. Also, the RoboRunner progress and status area on the main window are not functional.
    • Completion percentages for challenge runs currently only update on program launch or when RoboRunner fully completes a challenge run.
    • Confidence values for groups and overall total will not match between RoboJogger and RoboRunner.
    • It may be possible for a score log to become corrupted under certain scenarios. While unlikley, if you wish to avoid this possibility, do not open challenge results windows while RoboRunner is running, and do not stop RoboRunner in the middle of a challenge.
    • Yes, I know the About menu icon is ridiculous. Sometimes I like ridiculous things. But I will replace it with something nicer for the finished 1.0 release.
  • On first run (or any time the robocodes folder is empty), the RoboRunner setup window will appear automatically on launch. However, you can run setup anytime by lauching it through the Tools menu.
  • Robocode version 1.7.3.0 is currently packaged with RoboJogger, and that version serves as the default when you run RoboRunner setup.
  • If you change the version of Robocode when running RoboRunner Setup, you will have to manually copy the robocode.jar file from the new version of Robocode into the robocode_jars folder. You will be prompted about this by the program.
  • All robots must be in the bots directory. When adding a new challenge, robots listed as part of the challenge must be in the bots directory, but the robot selected to participate in the challenge will be automatically copied into the bots directory if it is not already there.
  • Development robots are not currently supported.
  • Popup menus exist for the challenge run table on the main window and for the challenge result windows that show the score summary. This is particularly important to know for the challenge result windows, as at the moment the popup menu is the only way to access the challenge result detail window that shows results for every season.
  • When RoboRunner is running, incomplete challenges will be processed from the top of the challenge run table to the bottom, until RoboRunner is stopped or no incomplete challenges remain.

Sneak Peek

A sneak peek of the main RoboJogger UI window. Pretty basic at the moment, and it could see drastic changes depending on further development and feedback. (My skills are more in the area of bringing a design to life rather than coming up with the good design in first place). Ultimately, it will probably end up looking a lot like RoboResearch, as it is trying to accomplish basically the same thing. The table of challenges acts like a priority queue, with RoboRunner running whatever challenge is at (or nearest) the top that has not already been run. All functions for now are controlled by menu items or buttons, but before it's done, there will also be popup menus and at least some drag/drop ability. There are other dialog windows for basic options, adding new challenges, running setup, challenge results, and a few other things.

(Changed on 12/11/2012 -- button locations changed to be more like RoboResearch, which I think is better; added status message and progress bar for RoboRunner status at the bottom, though progress bar will not function until the next RoboRunner update is finished.)

RoboJoggerSneakPeak r3.png

Dialog for running RoboRunner setup. Currently accessed via menu: Tools -> Run Setup.

RoboJoggerSneakPeak2.png

Dialog for adding a new challenge (smart battles and force wiki output options not yet present). Currently accessed via menu: File -> New Challenge. Not sure if there will be a button for this anywhere, but it will be added to a popup menu for the main window, in addition to being avaiable via the File menu.

RoboJoggerSneakPeak3.png

Dialog (non-modal) showing summary of battle results. I welcome feedback on this. At present, it uses the top row to show scores, the second row to show confidence in the scores (although the dialog in the screenshot doesn't show data for this row yet), and I was also thinking of adding a third row showing battles run per opponent, which would be of interest on an opponent by opponent basis due to how RoboRunner smart battles works. Center data area is separate and scrollable to better handle huge challenges (suggested by Voidious).

RoboJoggerSneakPeak4 r2.png