Draws a 3D representation of an IMU's orientation. Developed for Raspberry Pi and OpenGL ES. Works with minimu9-ahrs.
C++ C Python Emacs Lisp
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 20 commits behind DavidEGrayson:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
assets
model_board
.dir-locals.el
.gitignore
LICENSE.txt
Makefile
README.textile
ahrs-visualizer.1
ahrs-visualizer.cpp
mock_ahrs.py
png_texture.cpp
png_texture.h
version.h

README.textile

ahrs-visualizer reads orientation data on its standard input and uses that to display a 3D representation of the orientation.

Currently, the presence of GPU-specific code means that it only works on the Raspberry Pi but it can probably be ported to other boards. It uses OpenGL ES 2.0.

This program runs fine from the console; you do not need to run X.

This program is meant to be used with minimu9-ahrs, a separate utility that reads data from the Pololu MinIMU-9 and computes its orientation. To pipe direction cosine matrix (DCM) data from minimu9-ahrs to ahrs-visualizer, simply run the following command:

minimu9-ahrs | ahrs-visualizer

For documentation of the input data format that ahrs-visualizer expects, please see the documentation of the output format of minimu9-ahrs in its man page.

Understanding the visualization:

  • The 3D model is a Pololu MinIMU-9 v2.
  • The X axis is drawn as a red line.
  • The Y axis is drawn as a green line.
  • The Z axis is drawn as a blue line.
  • The acceleration vector is drawn as a cyan line.
  • The magnetic field vector is drawn as a yellow line.

For help getting started, please see: https://github.com/DavidEGrayson/ahrs-visualizer/wiki.

Building From Source

Just run:

sudo apt-get install libpng-dev libboost-program-options-dev
make
sudo make install_assets