Forsslund Systems AB

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 Jonas Forsslund or Martin Flodin 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 Jonas Forsslund or Martin Flodin.

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 Jonas Forsslund and Martin Flodin.

http://wisdom.forsslundsystems.se