Roboception Dynamics API

The rc_dynamics_api provides an API for easy handling of the dynamic-state data streams provided by Roboception's rc_visard stereo camera with self-localization.

Dynamic-state estimates of the rc_visard relate to its self-localization and ego-motion estimation. These states refer to rc_visard's current pose, velocity, or acceleration and are published on demand via several data streams. For a complete list and descriptions of these dynamics states and the respective data streams please refer to rc_visard's user manual.

Compiling and Installing

This package is based on some open source projects that are listed below. All dependencies are provided as submodules that are optionally used if the packages cannot be found on the system:

After cloning the git repository, the packages described above are cloned as submodules by:

git submodule update --init --recursive

Additionally this packages uses the single header file of


Building follows the standard cmake build flow.

cd <main-directory>
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=<install-directory> ..
make install

Windows and Visual Studio

Building is based on cmake. Therefore, cmake must be downloaded and installed according to the operating system from After starting the cmake-gui, the path to the main directory as well as the build directory must be specified. It is common to choose a sub-directory of the main directory and name it 'build' for the the temporary files that are created during the build process. After setting both paths, the 'Configure' button must be pressed. In the up-coming dialog, it can be chosen for which version of Visual Studio and which platform (e.g. Win64) the project files should be generated. The dialog is closed by pressing 'Finish'.

After configuration, the value of the key with the name 'CMAKE_INSTALL_PREFIX' may be changed to an install directory. By default, the install directory is set to a path like 'C:/Program Files/...'. The 'Generate' button leads to creating the project file. Visual Studio can be opened with this project by pressing the 'Open Project' button.

By default, a 'Debug' version will be compiled. This can be changed to 'Release' for compiling an optimized version. The package can then be created, e.g. by pressing 'F7'. For installing the compiled package, the 'INSTALL' target can be created in the project explorer.

After installation, the install directory will contain three sub-directories. The 'bin' directory contains the tools and DLLs. The 'include' sub-directory contains the sub-directories 'rc_dynamics_api' and 'roboception'. The former contains the main headers of the library to build own applications. The latter contains the protobuf headers of the rc_dynamics interface. There may be other include directories that may be created by the submodules. They can be ignored or deleted. Finally, the 'lib' sub-directories contains the rc_dynamics_api link library that is required for building own applications. Other link libraries may be installed by the submodules. They can be ignored or deleted.


Currently, the rc_dynamics_api comes with the following tool which is also meant as an example on how to use this API:


Author(s): Heiko Hirschmueller , Christian Emmerich , Felix Endres
autogenerated on Sat Mar 6 2021 03:53:19