The new simulator

This page is intended to give some preliminary support for the new simulator of IRIDIA and coordination among developers.

Getting the sources

You can retrieve the files from a CVS repository located on iridia server. Of course you need an account to be able to retrieve the files. People of IRIDIA can easily have an acces by asking to the sysadmin. For anybody else interested, you should write us. First login like this (just replace <username> by your login name)

$cvs -d:pserver:<username>@iridia.ulb.ac.be/home/cvsroot login

Then retrieve files :

$cvs -d:pserver:<username>@iridia.ulb.ac.be/home/cvsroot co newSimulator

Once files are retrieved, cvs has a memory of the location of the repository, so you just have to work inside the same directories and each time you finish a coding session, ar reach a crucial step, do a

$cvs commit

and do also an update before starting to code, so you retrieve on your local copy the modifications brought by anybody else to the files of the cvs. Command for the update :

$cvs update

If you don't want to get bored using CVS, you can use the GUI Cervisia. If you want to learn more about CVS commands, branches, tags, releases and so on, you can read this CVS reference for example : http://www.wincvs.org/howto/cvsdoc/

Compiling

In the tgz, we have ODE, Dyna and OK. First of all, compile ODE. Assuming that the directory where you checked out the simulator is called simulator and that you already cd into it, do:

~simulator$ cd ode
~ode$ make
~ode$ cd ..

Now you need to install FMOD. You can download it from http://www.fmod.org/files/fmodapi374linux.tar.gz. Uncompress it into your simulator directory:

~simulator$ tar xfz fmodapi374linux.tar.gz
~simulator$ cd fmodapi374linux/api
~api$ ln -s inc/ fmod
~api$ cd -

If you use Debian, you have to install the package libxml2-dev (if it is not installed).

Once this is done, you can compile ok10. Move to the directory and type make clean. then run ./clean.sh and eventually type make. If you have installed all the dependencies, it should work. Otherwise you can report the problems in the bugs'n problems section :-)

Bugs'n problems

All the reported problems are reported using the syntax : [date of discovery] [date of fixing] [author] : name Followed optionnally by a short description.

Open ones

[2005-03-21] [] [Alex] : I have ODE on my computer, but it won't work with the simulator. I had to compile the provided version of ODE. Did David make any modification to the ODE lib ? If yes we need to discuss about it. I should not be forced to install a modified lib, since it could contain bugs or be different from the original one and disturb the behaviour of other programs.

TODO

I suggest we use the same syntax as above : [date of discovery] [date of fixing] [author] : name Followed optionnally by a short description.

Open ones

[2005-03-21] [] [Alex] : INSTALL file to write

[2005-03-21] [] [Alex] : configure script to provide

[2005-03-21] [] [Alex] : problem with libxml headers ? In debian libxml2 headers are located in /usr/include/libxml2/libxml

[2005-03-21] [] [Alex] : REMOVE FMOD.

[2005-03-30] [] [Alex] : We need to give a name to this simulator. Maybe it is dyna ?

2005/04/14 - 5 - David - fix all the parameters in the sensors and sample files

2005/04/14 - 5 - David - unit rescaling

2005/04/14 - 5 - David - create all the models

2005/04/14 - 5 - David - camera sensor (with fast raytracing + memory)

2005/04/14 - 5 - David - improve ODE speed (many ideas ode documentation)

2005/04/14 - 5 - David - create the documentation

2005/04/14 - 3 - David - benchmarks

2005/04/14 - 2 - David - other @todo that are in the source files / doxygen

2005/04/14 - 2 - David - double wrappers for drawing functions

2005/04/18 - 2 - David - fix timing bug under linux (framerate not correct)

2005/04/18 - 1 - David - automatic OOBB calculation

2005/04/14 - 1 - Alex - make it easier to install (ode etc)

2005/04/14 - 1 - David - no collision between capped cylinder and cylinder! (add it)

2005/04/14 - 1 - David - frame interpolation for real time rendering

2005/04/14 - 1 - David - improve the TODO system

2005/04/14 - 1 - David - someone remove (empty?) newSimulator folder

2005/04/14 - 0 - David - use GSL for random numbers

Closed ones

2005/04/14 - 5 - David - basic sensors

2005/04/14 - 5 - David - basic controllers

2005/04/14 - 5 - David - material table / contact matrix

2005/04/14 - 5 - David - transform geom (to create composite objects)

2005/04/14 - 5 - David - object hierarchy

2005/04/14 - 5 - David - xml support

2005/04/14 - 5 - David - compiles perfectly on windows and linux

2005/04/14 - 5 - David - 0 global variable

2005/04/14 - 5 - David - disable collisions using collide/category bits in the XML

2005/04/14 - 5 - David - ray model

2005/04/14 - 5 - David - switching on/off objects (like lights)

2005/04/14 - 5 - David - able to disable rendering

2005/04/14 - 5 - David - material system

2005/04/14 - 5 - David - file search

2005/04/14 - 5 - David - user input with SDL

2005/04/14 - 5 - David - 3d rendering + fonts

2005/04/14 - 5 - David - noise

2005/04/18 - 4 - David - norender => shouldn't even create a window, no opengl/sdl

2005/04/14 - 4 - David - extended command line

2005/04/14 - 4 - David - timing of any important function (rendering, simulation, controls)

2005/04/14 - 4 - David - breakable joints

2005/04/14 - 4 - David - non templated list system (NodeList)

2005/04/18 - 3 - David - trimesh support (can load asc,msh,ms3d currently)

2005/04/14 - 3 - David - console allowing binds for easy debugging

2005/04/14 - 1 - David - 3d audio, now contains a define to enable/disable fmod

Meetings and reports

Report of the meeting held on friday 1st april 2005 : MISS Meeting 2005-04-01