readme.txt

浙江大学 RoboCup3D 2006 源代码

===============================================================================================================
Copyright (C) 2004 - 2006 by ZJUBase
                             National Lab of Industrial Control Technology
                             Zhejiang University, China
===============================================================================================================

1. File Lists

|
|- debug_agent.dsp  ---| -----> Visual C++ project files. The project includes DebugAgent/ and ZJUBase/
|- debug_agent.dsw  ---|
|
|- 3DMonitor.exe        A simplified version of DebugServer which can be used as a single monitor under Windows.
|
|- DebugServer/         The Debug Server, with a compiled binary (DebugagentController.exe) provided.
|
|- DebugAgent/          The Debug Agent, which wrapped the input/output of 3D agent and keep consistent with
|                       DebugServer while offline.
|
|- ZJUBase/             The agent source file of ZJUBase in 3D Simulation League. (Makefile not provided, you
                        can generate it yourself)


===============================================================================================================

2. How to use the DebugServer

----- Online mode: (better to use the simplified version 3DMonitor.exe)

  * similar operations with rcssmonitor3d-lite.
    For example, 1) 'W', 'A', 'S', 'D' to move the view point.
                 2) '+'/'-' to raise/drop
                 3) 'C' to focus on the ball; '2' to open/close the 2D view on the left-top side.
                 4) 'P'/'R' to pause/resume the game
                 5) click down left button of the mouse and then change the view while moving the mouse

  * You can change the server IP you are going to connect, in the text box, and then click the button
    "Connect".

  * Click right button of the mouse in the field area and then you can edit and send a monitor command to the
    server. (removed in the simplified version)

----- Offline mode:

  * You can replay a monitor.log after clicking "ReadFile" and choose a single file monitor.log.
    While replay, the control buttons are able to operate.

  * You can debug the agent with DebugServer. Firstly after "ReadFile" and choose the monitor.log and all the
    agent logfiles (keep consistent with our agent, in LogWM() of ZJUBase/main.cpp)

  * You can switch the focused player in the "Active Player" area. Click "ShowReal" to display or not the real
    position of that agent at this moment.

  * 1) Run the DebugAgent in debug mode. 2) In DebugServer, choose a specified scene and send it to the agent through
    "SendWM". 3) In DebugAgent, you can debug the agent code for repeating this scene.

  * While debugging the agent, some painting command can be sent to DebugServer, which draws some objects on monitor
    to help the debugging. For instance, (in ZJUBase/Situation.cpp)
        #ifdef WIN32
           ShowCircle(global.wm.myPos.x,global.wm.myPos.y,1.5,"255 0 0 2");
           ShowPie(global.wm.myPos.x,global.wm.myPos.y,1,ang2goal-95,ang2goal+95,"255 100 0 2");
           ShowPie(global.wm.myPos.x,global.wm.myPos.y,1,ang2ball-95,ang2ball+95,"255 100 0 2");
           ShowCircle(p0,0.5,"255 255 0 2");
           ShowCircle( p0, 4.8, "255 0 0 2");
        #endif
    The painting functions are defined in DebugAgent/DebugAgent.cpp.


===============================================================================================================

3. About ZJUBase 3D agent

  * We also release the source code of our 3D agent, in the directory ZJUBase/.
    We have done some cleaning jobs for the code, however it still looks dirty. Some codes are not in a pretty style.
    Some useless codes haven't been removed yet. Some offline results (especially in RunToForce.cpp && Predictor.cpp)
    are not explained. And many codes are lack of documentation.
    We're very sorry for this. This release submission is just to reach the deadline (July 16). We will proceed the cleaning work after
    it and update this release.

  * Achievements of ZJUBase in RoboCup Soccer 3D Simulation League:
      In RoboCup championship,
        - June 2006 - 3rd place in RoboCup 2006, Bremen, Germany (lost the semi-final with a coin toss)
        - July 2005 - 3rd place in RoboCup 2005, Osaka, Japan (share the 3rd place with team Caspian)
      In RoboCup local events,
        - April 2006 - 2nd place in RoboCup Iran Open 2006, Tehran, Iran (lost the final with a coin toss)
        - December 2005 - 2nd place in AI Games 2005, Isfahan, Iran
        - July 2005 - champion in China Robot Competition 2005, Changzhou, China
        - October 2004 - champion in China Soccer Robot Competition 2004, Guangzhou, China

  * Our Team manager is Ms Rong XIONG ([e-mail]). We are from National Lab of Industrial Control
    Technology, Zhejiang University, China.

  * Team members:

      Currently the team leader is,                Hao JIANG ([e-mail]; [e-mail])
      In the next season, the leader will be       Yifeng ZHANG ([e-mail])
      ZJUBase 3D agent is created by               Dijun LUO ([e-mail])
      All the members who has ever contributed:    Jun JIANG
                                                   Xinfeng DU ([e-mail])
                                                   Yang ZHOU ([e-mail])
                                                   Zhipeng YANG
                                                   Xiang FAN

  * If you met any problems or you have something to discuss about ZJUBase. Please feel free to contact us through
    EMails given below.