Milestone 3: RoboViz
This milestone includes the GUI component of the project, allowing
visualization of the MAP and the AGENT's TRAJECTORY through the
environment.
The deliverables for this milestone are:
- GUI source code
- The complete Java source code for the
visualization component, as described in Section
,
including RoboVizand, optionally, GridWorldEditor.
- Other Java source files
- Any additional files necessary to
compile and run the full RoboVizprogram, including Java sources from
Milestones 1 and 2.
- Test code
- Any test code used in developing and testing RoboViz.
Note that testing GUI code is extremely difficult and there is no
commonly accepted methodology for it. (At least, using tools that are
available to us.) So you are not required to provide tests for the
GUI itself. However, you are still expected to provide tests for
other code in your delivery, and to manually test your GUI to ensure
that it is as bug-free as possible.
- API Documentation
- The submission MUST include the full,
compiled JavaDoc documentation for all submitted Java modules.
This documentation MUST include full descriptions of
every public or protected method, field, sub-class, enclosed class, or
constructor employed by these modules. This documentation
hierarchy MUST be included in a sub-directory named
documentation/ within the submission jar file. You MAY use
the @inheritDoc Javadoc tag to include some of the
documentation from the cs351_f05_p2_support-v1.jardocumentation, but you MUST
explicitly state in the API documentation any deviation from, addition
to, or different assumptions than the original specifications.
- User documentation
- The submission MUST include a
USERDOC document that describes how to run your RoboViz(and
possibly GridWorldEditor) tool(s). This documentation MUST describe how to
start each program, how to load/save an environment and a TRAJECTORY
file, how to replay a TRAJECTORY, etc. It MUST also describe the
expected results of running the program (screenshots are very helpful
here). This document MUST be named USERDOC.extension, but it
MAY be be a plain text, HTML, PDF, or PostScript document (with the
appropriate extension). It MUST NOT be a Microsoft Word or
other nonportable format document.
In addition, the handin MAY include any or all of the following:
- This file documents any updates to elements of
previous handins including what modules/files have changed, what substantial
functional changes were made to those modules/files, and whether the
instructors are asked to reevaluate those modules/files.
- This file documents any know missing features or
incomplete tests. It SHOULD also document what tests you would have
liked to include, but didn't, along with a description of why you did
not include them.
- This file includes any other notes or
documentation necessary to use or understand the submission that are
not already included in other documentation.
Terran Lane
2005-10-18