Getting Started
( 2 Articles )
Getting Started
Thank you for your interest in trying out our simulation engine software stack! Your feedback is very valuable to us. Please feel free to email
This e-mail address is being protected from spambots. You need JavaScript enabled to view it
for any questions or comments related to your installation experience.
Read this guide to get a quick start with testing and development of the Forssim simulator. For more information please read the reference manual or contact
This e-mail address is being protected from spambots. You need JavaScript enabled to view it
or
This e-mail address is being protected from spambots. You need JavaScript enabled to view it
at Forsslund Systems.
Background
To know more about the background of the Forssim project, read Jonas Forsslund's master thesis report. You can download your own copy of Jonas Forsslund's thesis from KTH.
New releases
There are two ways to download new releases. You can either download them from launchpad, or via Bazaar version control system. When you download them from launchpad, follow the standard procedure for installation of .tar files. To download via Bazaar you need to install the Bazaar application. The information on this page is based on the assumption that downloading and installing the applications is done via Bazaar.
See the main developer page for information about the latest releases.
Download and install dependencies
Download forssim_dependencies, among other files H3DAPI. Forssim_dependencies also include some scripts to help with the installation. ./setup_ubuntu installs the extra packages needed for the project.
To install Bazaar, type the following in the terminal window:
sudo apt-get install bzr
Continue with the installation of forssim_dependencies. A suggestion is to store all source code in a folder named e.g. bzr_forssim in your home directory.
mkdir ~/bzr_forssim
cd ~/bzr_forssim
bzr branch lp:~forsslundsystems/forssim/forssim_dependencies
cd forssim_dependencies
./setup_ubuntu
sudo ldconfig
Then, from forssim_dependencies, run
./make
to build all dependencies and locally install some shaders for the volume rendering.
HINT: You can build faster by running ./make -j3 for a dual-core and ./make -j5 for a quad-core.
That's it. You should now be able to build forssim.
Download and install forssim
This installation description assumes that the applications are downloaded and installed via Bazaar.
When all dependencies are installed, you need to checkout (branch) our latest release, compile, install and test it. A suggestion is to store all source code in a folder named e.g. bzr in your home directory.
cd ~/bzr_forssim
bzr branch lp:forssim
cd forssim
./makeAll
sudo ldconfig
Test now:
./run_one_cylinder
Run forssim examples
You can try some sample test cases in FsWisdom, the forssim simulator application, but to be able to download and run them you need to obtain a user name and a password from Forsslund Systems. Please contact
This e-mail address is being protected from spambots. You need JavaScript enabled to view it
or
This e-mail address is being protected from spambots. You need JavaScript enabled to view it
.
To start the application, type the following from any location in a terminal:
FsWisdom
Enter you user name and password and press Enter.
Select Remove Wisdom Tooth Mouse v1 and click Perform selected exercise.
Use Alt-Tab to switch between the settings and simulation screen. While in the simulation screen you can use your mouse to drill. Press space to turn drill on/off and h to switch between drill/elevator.
Move the drill in x/y-coordinates by pressing the left mouse button and in x/z-coordinates by pressing the middle mouse button.
Run X3D examples
Try X3D examples. The following example can be run without a haptic device:
cd forssim/examples/x3d
QtH3DLoad mousedrill_cylinder.x3d
Haptic device
If you have a haptic device, read about configuring the device in the detailed installation document that can be generated as described below.
Get reference manual and detailed installation document
Generate a reference manual and detailed information about how to install and configure a haptic device, how to run some X3D examples with the device etc. The documents are available in Bazaar, so that must be installed. You also need to have downloaded forssim and forssim_dependencies as described above.
Generate the full installation document and display it in Firefox.
cd forssim
./makedoc
firefox Doxygen/html/index.html &
Display the reference manual as a .pdf file.
evince Doxypaper/latex/refman.pdf &
Web site with statistics
It is possible to check statistics from performed exercises in FsWisdom on the Forssim web site. Log in by entering the user name and password you have used in FsWisdom. The web site is managed by
This e-mail address is being protected from spambots. You need JavaScript enabled to view it
and
This e-mail address is being protected from spambots. You need JavaScript enabled to view it
http://wisdom.forsslundsystems.se