Skip to content

Commit

Permalink
compress imu docs a bit, some tweaks for alpha labs article
Browse files Browse the repository at this point in the history
  • Loading branch information
rennis250 committed Sep 2, 2024
1 parent 57762e4 commit 4778197
Show file tree
Hide file tree
Showing 2 changed files with 3 additions and 9 deletions.
2 changes: 1 addition & 1 deletion alpha-lab/imu-transformations/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ This guide contains various transformation functions that can assist when workin

## IMU to World Coordinates

One of the key steps when dealing with the IMU is the transformation that takes coordinates in the local IMU coordinate system to their corresponding coordinates in [the world coordinate system](http://docs.pupil-labs.com/neon/data-collection/data-streams/#movement-imu-data). The quaternion values provided by the IMU can be used to convert between the two coordinate systems. The `transform_imu_to_world` function, defined below, will be used throughout this article.
One of the key steps when working with IMU data is the transformation that takes coordinates in the local IMU coordinate system to their corresponding coordinates in [the world coordinate system](http://docs.pupil-labs.com/neon/data-collection/data-streams/#movement-imu-data). The quaternion values provided by the IMU can be used to convert between the two coordinate systems. The `transform_imu_to_world` function, defined below, will be used throughout this article.

Note that the origin of the IMU coordinate system is the same as the origin of the world coordinate system.

Expand Down
10 changes: 2 additions & 8 deletions neon/data-collection/data-streams/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -82,15 +82,9 @@ Audio recording is disabled in the Neon Companion app by default and can be enab
## Movement (IMU Data)

<Badge>Real-time</Badge><Badge>Pupil Cloud</Badge><Badge>Neon Player</Badge>
The Neon module is equipped with a 9-DoF [inertial measurement unit](https://invensense.tdk.com/products/motion-tracking/9-axis/icm-20948/) (IMU) featuring an accelerometer, gyroscope, and magnetometer. The accelerometer and gyroscope measure linear acceleration and angular velocity, respectively, and are provided as raw values. Acceleration is reported in terms of [g-force](https://en.wikipedia.org/wiki/G-force), which differs from free-fall acceleration due to gravity. For instance, when standing upright on Earth, acceleration along the Z-axis would be +1g, with 0g on the X and Y axes.
The Neon module is equipped with a 9-DoF [inertial measurement unit](https://invensense.tdk.com/products/motion-tracking/9-axis/icm-20948/) (IMU) featuring an accelerometer, gyroscope, and magnetometer. The accelerometer and gyroscope measure linear acceleration and angular velocity, respectively, and are provided as raw values.

A fusion engine also combines these values with magnetometer readings to estimate the module's absolute orientation in the world coordinate system as a quaternion:

- World y-axis: Points towards magnetic north.
- World z-axis: Points upwards, opposite gravity.
- World x-axis: Points rightwards, defined by the cross-product of Y and Z.

Note that in order to obtain precise absolute yaw readings, the magnetometer needs to be [calibrated](/data-collection/calibrating-the-imu/).
A fusion engine also combines these values with magnetometer readings to estimate the module's absolute orientation relative to magnetic north (positive world y-axis), gravity (negative world z-axis), and a rightward pointing vector (positive world x-axis) as a quaternion. We refer to this as the world coordinate system. It is important to note that this is not the same as the local IMU coordinate system.

The IMU is located in the top bar of the module and is sampled at 110 Hz. Its local coordinate system is oriented with the x-axis pointing to the right, the y-axis pointing in front, and the z-axis pointing upwards.

Expand Down

0 comments on commit 4778197

Please sign in to comment.