Skip to content

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