Revision as of 13:00, 12 March 2011 by Keithcu (talk | contribs) (Steps after)

Jump to: navigation, search


OpenRacing is being ported to Python, renamed to PyTorcs, and moved to Github.

PyTorcs is a racing game, but it is also a simulator which aims to develop better artificial intelligence for human-driving assistance and driverless cars. The core is based on the Torcs codebase, which is widely considered the best FOSS racing game and which already has autonomous cars. However, the codebase contains a lot of cruft.

So, it is being methodically re-written into Python, ported to leverage the graphics engine Ogre, the physics engine ODE, the input system OIS, the widget API MyGui, OpenAL, and extended with a more general track model.

Then, there will be a clean and 10x smaller codebase for simulating autonomous vehicles which can handle the complexities of urban scenarios, and can eventually navigate via the use of a vision recognition engine and simulated sensors like Lidar and GPS.

Python Port

  • Port the Swig wrapping tools to generate Python
  • Do mechanical port of C# code (
  • Build work to support a Python OpenRacing including debugging
  • Port APIs to Python-Ogre, PyODE, etc.
  • Debug
  • Remove C#
  • Port simuv3 to Python (low priority, isolated task)

Steps after

  • Extra data attached to map model
  • Get basic autocar driving (waypoints, lanes)
  • Networking
  • Simulate Lidar
  • Faster than realtime simulation runs (turn off graphics, optimize physics)
  • Port over automatic transmission, wheels, etc. from Torcs
  • OpenStreetMap augmented-reality visual annotations
  • Better weather conditions
  • Port over a car model from Speed-Dreams and discuss the current set of difficulties in using their data with Ogre
  • Find / modify a big urban map with highway exit
  • Plug into vision engine
  • Port simuv3 to Python (low priority, isolated task)
  • Define, record, and replay simulations
  • Etc.

Last status reports

The work in progress is here.

Achieving UTI


Everything below is Obsolete

OpenRacing hosted in Launchpad / Bzr

Source, etc. is here: Launchpad

Old Wiki

More old stuff here [1]

Install the dependencies

These instructions assume Ubuntu. If you are running something else, your steps will vary slightly. Instructions here

Compile OpenRacing

Go into openracing's directory.


The script installs a few missing files and generate the usual configure script.

Then launch configure.

$ ./configure --with-ogredotnet=/full/path/to/ogredotnet-read-only/bin \
  --with-myguinet=/full/path/to/mygui-or/Bin/Debug --with-tao=/full/path/to/tao/bin
$ cd monodevelop-project/bin
$ ln -s /full/path/to/ogredotnet/bin/Math3D.dll
$ ln -s /full/path/to/ogredotnet/bin/OgreDotNet.dll
$ ln -s /full/path/to/taoframework-2.1.0/bin/Tao.Ode.dll
$ ln -s /full/path/to/taoframework-2.1.0/bin/Tao.OpenAl.dll
$ ln -s /full/path/to/MyGUI-OR/Bin/Debug/MyGUI.dll
$ cd ..
$ make

If everything got right, an openracing script should have been generated. You can launch it immediately or install OpenRacing into the system.

$ sudo make install

And launch!


If it doesn't work, please complain to us so we can fix the bugs!


It occurs that for some mysterious reasons, mono can't load OR's libsimulator native library. Simple work-around:

Go to the data/ directory. Create the following link:

 $ ln -s ../src/libsimulator/.libs/

That should work!

Using the Monodevelop project

For developers, a monodevelop project is now available, allowing to edit and launch C# parts of OpenRacing from a nice all-integrated GUI.

First, you must compile openracing as shown above. The compilation process generated for you a script.

But before to launch it there is a little hack to do...

Go to the src/ directory. A create link to Ode, OgreDotNet and MyGUI's DLLs. This is what I did on my system, please adapt it to yours:

$ ln -s /home/jeko/Sources/deps/taoframework-2.1.0/bin/Tao.Ode.dll
$ ln -s /home/jeko/Sources/deps/ogredotnet/bin/Math3D.dll   
$ ln -s /home/jeko/Sources/deps/ogredotnet/bin/OgreDotNet.dll
$ ln -s /home/jeko/Sources/deps/MyGUI-OR/Bin/Debug/MyGUI.dll

This makes sure monodevelop will find the necessary references needed to compile OpenRacing. (I tried hard to make this better, but it seems impossible)..

Then you can launch:


The scripts sets some environment variables (so that uninstalled shared libraries from OgreDotNet and MyGUI can be found for execution). Last hack before you're done: you must edit Config.cs file (which appears at the end of the file list):


public static string OPENRACING_DATA_PATH = "/home/jeko/Sources/openracing/data";


public static string OPENRACING_DATA_PATH = "/full/path/to/openracing/data";

You're done, make sure the Debug configuration is enabled to enjoy executing OpenRacing inside a nice visual debugger.

Happy hacking!

Last email

from Keith Curtis <>


date Thu, Dec 10, 2009 at 12:01 AM

subject OpenRacing post-mortem

I've been meaning to send this for many months.

Jeko and I have decided to abandon OpenRacing. We consider it unlikely that:

  1. Our code would ever be put into Torcs-NG.
  2. That Torcs-NG will ever develop a more general track model. (The current one is 10 years old.)
  3. That Torcs-NG will be suitable for true driving AI research without this.
  4. That Torcs-NG will start moving towards more open data formats, shared components like
     ODE and Ogre, and better programming languages.

I'm probably naive but I think if we had approached you as soon as you started, and offered to do much of the heavy lifting, it is more likely we could have convinced you to fixup the codebase in various ways before you make a long-term commitment to it. But I think it is very difficult and unlikely now.

It is a little sad that our interesting work is likely dead, but Source Forge is filled with that ;-) Torcs-NG might not ever become much of a research platform, but it is a fun game and that isn't too bad of a place to be.