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:
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
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.
Congratulations, your build is complete!
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.
yum install rcssserver3d
yum install rcssserver3d-rsgedit
yum update rcssserver3d
yum update rcssserver3d-rsgedit
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.
$ 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
$ 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
$ svn co https://simspark.svn.sourceforge.net/svnroot/simspark simspark
Simspark:
$ cd simspark/trunk/spark $ mkdir build $ cd build $ cmake .. $ make $ sudo make install $ sudo ldconfig
Rcssserver3D:
[ set to the rcssserver3d directory (trunk/rcssserver3d) ] $ mkdir build $ cd build $ cmake .. $ make $ sudo make install $ sudo ldconfig
$ sudo gedit /etc/ld.so.conf [ add the line '/usr/local/lib' if it isn't already there, save and close ] $ sudo ldconfig
$ simspark
$ rcssagent3d
$ sudo apt-get install tetex-extra latex2html imagemagick [ for developers manual ] $ sudo apt-get install doxygen [ for API 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 ]
$ sudo apt-get install libwxgtk2.8-dev
[ set to the rsgedit direcditory (trunk/rsgedit) ] $ mkdir build $ cd build $ cmake .. $ make $ sudo make install
$ rsgedit
[ set to the simspark-utilities directory (trunk/simspark-utilities) ] $ mkdir build $ cd build $ cmake .. $ make $ sudo make install
$ gendot $ monitorspark $ sampleagent $ samplesim
$ yaourt -S rcssserver3d
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
.
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)
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".
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.