Fedora
The most easy way on Fedora systems to install simspark, is to open a terminal and type "yum install rcssserver3d" (if you want to develop agents using rcssserver3d's libraries, "run yum install rcssserver3d rcssserver3d-devel" instead). Thanks to the community members, the simspark packages have been included in Fedora's repositories as a part of Fedora Robotics SIG activities, as an effort to allow for easy development of robotics applications on Fedora.
In case you wanted to do the hard way (compile the simulator from source), continue reading:
- Install dependencies:
There are dependencies for the simulator, ie. other libraries that simulator uses. These are:
boost: A collection of (currently) 58 libraries for multiple purposes. This is a giant library...
boost-devel: Development files for using boost library
FreeType (which should be installed by default for X Window System)
FreeType-devel
ruby: A dynamic, open source programming language with a focus on simplicity and productivity. It has an elegant syntax that is natural to read and easy to write.
ruby-devel: Development files for using ruby language
SDL: (A multimedia library, installed by default): Preferably all the SDL packages
SDL-devel: Development files for using SDL
DevIL: (Developers Image library)
DevIL-devel: Development files for using DevIL
ode: Open Dynamics Engine, A physics engine
ode-devel: Development files to use for developing applications to use ode
If you have a ready internet connection, you can have it done like this with yum:$ sudo yum -y install boost boost-devel freetype freetype-devel freeglut freeglut-devel ruby ruby-devel SDL* DevIL DevIL-devel ode ode-devel
Otherwise, the best option is to download the packages from one of Fedora mirrors. This link points to the list of all Fedora mirrors, Pick one of the mirrors, and search and download the packages listed above, then install it.
If there was error installing them, check these two: 1) Are you root? or at least doing it with sudo? 2) Does the package need any other dependency? you can guess it by rpm output- I forgot to say to newbies: installation is like this: If you are in graphic mode (X Window System), find the package on installation media, double click it, otherwise, login to a terminal, go to installation media's directory, and type rpm -ivh <filename>
- Now its the time for simulator itself:
Get the latest simspark package (take a look at downloading page if you don't know where to get it) and extract it. There are 4 folders, which currently they need to be built seperately. The building process is described below, it is the same for all the packages. First you should open a terminal and change to spark folder, and execute these commands:
$ mkdir build $ cd build $ cmake .. $ make $ sudo make install
Then change folder to rcssserver3d, execute the commands. Next is the simspark-utilitis, and last is optional, rsgedit.
- Note for newbies: DO NOT TYPE THE $ SIGN! It is indicator of shell prompt.
Congratulations, your build is complete!
OpenSuse
NOTICE: OpenSuse repository is outdated. For now, you can install from the source code.
This is the easiest way for installing the simulator. Currently these linux distributions are supported with this method:
OpenSuse 10.2
OpenSuse 10.3
To enable installation and update support for simspark on your linux Visit the Repository WebSite, select your linux distribution and copy 'home:hedayat.repo'
to /etc/yum.repos.d/
Now you can use any yum frontend to install/update simspark.
- The command for installing simulator using command line yum is:
yum install rcssserver3d
- and for rsg-edit is:
yum install rcssserver3d-rsgedit
- Updating is done with this:
yum update rcssserver3d
- and for rsg-edit
yum update rcssserver3d-rsgedit
Ubuntu
I. Easiest way to install simspark and rcssserver3d is using the ubuntu robocup repository. You can simply install the server using following instructinos:
[ You should enable the Universe and Multiverse repositories before! ] $ sudo apt-add-repository ppa:gnurubuntu/rubuntu $ sudo apt-get update $ sudo apt-get install rcssserver3d
rcssserver3d-dev and simspark-dev are also available at the repository. If the new version of simspark & server has been released, you can upgrade them by:
$ sudo apt-get update && sudo apt-get install rcssserver3d
II. Another way is to get the sources of the server and compile them. This small HowTo explains how to install the Robocup 3D simspark simulation server on Ubuntu (so not the old spheres server using spades). This work Hardy Heron (8.04) and Intrepid Ibex (8.10). The steps should be similar on other debian based distributions especially Debian itself, so hopefully it's also useful for other people.
Requirement
- Enable Universe and Multiverse repositories:
$ sudo gedit /etc/apt/sources.list [ Follow instructions in the file to enable the Universe and Multiverse repositories, save and exit ] $ sudo apt-get update
- Install dependencies:
$ sudo apt-get install g++ subversion cmake libfreetype6-dev libode0-dev libsdl-dev ruby1.8 ruby1.8-dev libdevil-dev libboost-dev libboost-thread-dev libboost-regex-dev
- Download the latest simspark and rcssserver3d packages as described here, or if you want to use latest code in SVN repository, check out the source from the source forge SVN repository:
$ svn co https://simspark.svn.sourceforge.net/svnroot/simspark simspark
- Configure the package, generate build files and install the package:
Simspark:
$ cd simspark/trunk/spark $ mkdir build $ cd build $ cmake .. $ make $ sudo make install $ sudo ldconfig
- Note: type 'make uninstall' to uninstall the package
Rcssserver3D:
[ set to the rcssserver3d directory (trunk/rcssserver3d) ] $ mkdir build $ cd build $ cmake .. $ make $ sudo make install $ sudo ldconfig
- Note: type 'make uninstall' to uninstall the package
- Make sure the linker can find your shared libraries:
$ sudo gedit /etc/ld.so.conf [ add the line '/usr/local/lib' if it isn't already there, save and close ] $ sudo ldconfig
- Run the simulation:
$ simspark
- Run test agent:
$ rcssagent3d
Optional
Documentations
- Install dependencies:
$ sudo apt-get install tetex-extra latex2html imagemagick [ for developers manual ] $ sudo apt-get install doxygen [ for API documentations ]
- Create documentations:
[ in build directories of spark and rcssserver3d type ] $ make pdf $ make doc [ to create user (user-manual.pdf) and developer (devel.pdf) manual and API documentations ]
Rsgedit
- Install dependencies:
$ sudo apt-get install libwxgtk2.8-dev
- Configure the package, generate build files and install the package:
[ set to the rsgedit direcditory (trunk/rsgedit) ] $ mkdir build $ cd build $ cmake .. $ make $ sudo make install
- Run rsgedit:
$ rsgedit
Simspark-utilities
- Configure the package, generate build files and install the package:
[ set to the simspark-utilities directory (trunk/simspark-utilities) ] $ mkdir build $ cd build $ cmake .. $ make $ sudo make install
- Run utilities:
$ gendot $ monitorspark $ sampleagent $ samplesim
Arch Linux
- Install yaourt to use aur. See Archlinux wiki for details
- Install server with the following command and follow instructions
$ yaourt -S rcssserver3d
Generic Linux Instructions
Installing Ruby
Download Ruby version 1.8.0 or newer (tested and working with versions 1.8.6 and 1.9) and then configure with parameter --enable-shared
.
Installing Boost
Download Boost version 1.30.2, 1.31.0 or 1.3x.x. Extract the package and copy folder boost_1_33_1/boost to /usr/local/include/boost. (No configuration is required)
Installing ODE
Download and install any of the working versions.(0.5 or higher, 0.9 strongly recommended). For better stability, configure with option --enable-double-precision. For 64-bit system, configure with CFLAGS and CXXFLAGS set to "-g -O2 -fPIC".
Running the simulation
Configure Simspark by
./configure
Debug mode might be disbaled as well to speed up the configuration process.
./configure --disable-debug
Next you have to add the rcssserver3d library path to your environment variables using
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib/rcssserver3d
In SUSE 10.0 you should either edit the make file or link the required libraries by entering the following lines into console command window :
cd /usr/lib ln -s /usr/X11R6/lib/libXi.so.6.0 libXi.so ln -s /usr/X11R6/lib/libXmu.so.6.2 libXmu.so
For running simspark go to [Server3dDIR]/app/simspark and run simspark with
./simspark
Click on the Kerosin window that appears and drag the mouse on the window to change your view of field. Then go to agentsapark directory ( [Server3dDIR]/app/agentspark ) and run agentspark:
./agentspark
You should see the humanoid agent behind the ball.