Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Implements a Complementary Filter for intelligently fusing yaw from multiple sources #3

Open
wants to merge 22 commits into
base: master
Choose a base branch
from

Conversation

nanospork
Copy link
Collaborator

This PR implements a complementary filter (a straightforward introduction here: http://www.pieter-jan.com/node/11) that allows for intelligent fusion of yaw data from a "fast" source with data from an "accurate" source.

The complementary filter is more or less equivalent to one of the most basic implementations of the Kalman filter (http://www.olliw.eu/2013/imu-data-fusing/). The complementary filter high-passes data from the "fast" source while low-passing data from the "accurate" source, creating a signal that is responsive in the short term while remaining accurate in the long term.

The complementary filter is tuned with a simple "alpha" parameter. I've added an example to the readme that shows what terms to add to the orientation object within the server config file.

A recenterButton object can also be added to the orientation object. This object points to a semantic path such as a controller button. The FilteredOrientationReader then listens for a button press on this path and if one is detected and there is significant error between the last filter input and the current input, the filter will instantly backfill to the new input. In short, this is an attempt to detect external yaw recentering in the "accurate" yaw source and provide the user with a "snappy" recentering experience, rather than allowing the filter to slowly recenter the device (and cause nausea if used with an HMD).

I've been working on this as part of a larger project I'm (tentatively) calling NOFC - the Nolo OSVR Fusion Configuration, which takes advantage of the Nolo-OSVR plugin, the OSVR-Fusion plugin, and an update to the SteamVR-OSVR plugin for much better performance using Nolo hardware with OSVR.

I think you'll find that this new filter is right at home in OSVR-Fusion, and that it will allow users to improve their yaw performance not just with Nolo and the HDK, but with a number of other hardware configurations as well.

Let me know if you have any questions about how the filter works, or if there are any changes you would like to see or discussion you would like to have before merging!

@simlrh
Copy link
Owner

simlrh commented Aug 18, 2017

Looks good. Can't review code until late September (sorry) so talk then.

@simlrh
Copy link
Owner

simlrh commented Dec 2, 2017

Do you want maintainer on OSVR-fusion? I’m working full time and can’t make it to my workshop often

… working in FilteredOrientationReader. Still needs cleanup.
@nanospork
Copy link
Collaborator Author

Sure! I’m in the same situation, but I suppose two of us getting to it infrequently is better than one? ;)

@simlrh
Copy link
Owner

simlrh commented Dec 3, 2017

Ok, you have push access, go nuts!

Got manual 'soft' yaw reset (ignores translational coordinate system)…
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants