MUSIM Simulation Documentation
twm - 11/4/09
MUSIM is a suite of programs that simulate an experiment UAV control station. Experiments performed
with MUSIM vary greatly, so it is split into separate programs for maximum flexibility. For example,
you might want to run the sensor program on one computer and run the mapview and mfd programs on another
computer.
The network library provides a message passing interface so that all MUSIM programs can communicate
with one another. The guideline followed is to send high priority message via TCP, which is considered
reliable, and streams of messages (such as aircraft position updates or input device updates) via UDP,
which is considered unreliable.
Most directories contain informative README files.
Compile MUSIM from this directory by typing 'make'. MUSIM can be run from the bin/ directory.
OpenSceneGraph (openscenegraph.org)
At a minimum, obtain svn version 8524. Before compiling, be sure your computer
has the usual image development libraries: libjpeg-devel, libtiff-devel, and libpng-devel. Without these
you may see untextured areas in the simulation. Don't forget to run the configure script first, so that
OSG will compile optimized instead of debug.
CMAKE
You can get this at
www.cmake.org if your distro doesn't provide it.
FLTK 2.0.x
Make sure to get FLTK 2 - not FLTK 1. Try
www.fltk.org if your distro doesn't provide it.
libxml2
Don't forget to get the development lib as well. Try
www.xmlsoft.org if your distro
doesn't provide it.
Appropriate Hardware
A computer with 2GB RAM (the eastbay database will probably exhibit memory swapping slowdowns with only 1GB),
a graphics card with at least 512MB RAM and support for shaders. An NVidia GeForce 8800-series card is
probably the minimum that will provide a decent framerate. We are currently using Geforce GTX 285's
An input device for which there is a driver in the src/controls/ directory (a BG Systems FlyBox or a
3DConnexion SpaceBall 5000 or SpaceExplorer). To make this device work you will probably want to modify
your /etc/udev/rules.d/50-udev-default.rules file. See ~projects/MUSIM/src/controls/spaceEx/README for
more detail regarding the modification of 50-udev-default.rules. You will need root permissions.
Get the biggest and best monitor you can find. We use 30" diagonal Apple Cinemas monitors. They are
starting to look small...
V1.0
