IMU Overview
Accelerometer
The accelerometer detects the instantaneous acceleration of the camera. The data provided by the accelerometer determines whether the camera is getting faster or slower, in any direction, with a precise value in meters per second squared (m/s²).
When an accelerometer is static, it is still measuring an acceleration of 9.8 m/s², which corresponds to the reaction to the Earth’s gravity. This measurement is always aligned with the vertical axis, pointing away from the center of the Earth. Gravity allows us to compute the camera’s absolute inclination and detect events like free falls.
Gyroscope
A gyroscope measures the angular velocity of the camera in degrees per second (deg/s). When combined with the accelerometer, both sensors can estimate the orientation of the camera at a high frequency.
Output Data
The following information is accessible from the camera sensor stack:
IMU Configuration
Since ZED SDK 5.6, the IMU of the ZED X family (ZED X, ZED X Mini, ZED X Nano and the GMSL2 ZED X One models) can be configured when the camera opens, through InitParameters:
- A smaller range gives a finer resolution for slow, precise motion; a larger one avoids saturated readings under strong shocks or fast rotations.
HZ_400doubles the gyroscope rate, and so the rate of the IMU data, for applications that need more motion samples between frames. The accelerometer keeps its own rate.OFFopens the camera without its IMU: no IMU data, the motion sensors are reported unavailable, and positional tracking uses the images only.sensors_requiredmust then be false.getCameraInformation().sensors_configurationreports the ranges and rates in use.
The ranges and the 400 Hz rate require ZED X Driver 1.5.0 or newer. With an older driver, or another camera model, the camera keeps its defaults and a warning is logged.
Using the API
Accessing the IMU data can be done through the SensorsData class. Data is stored in the class SensorsData::IMUData which amongst others contains the accelerometer and gyroscope values.
You can retrieve IMU data with the following code:
Pose
One of the key reasons for having an accelerometer and gyroscope in the camera is that their data can be fused to estimate camera orientation. The accelerometer provides gravity orientation, while the gyroscope estimates the rotation applied to the camera. Fused at high frequency, the combination of both sensors provides a robust orientation estimation.
IMU pose can be retrieved in imu_data.pose.
Code Example
For a code example, check out the Getting Sensor Data tutorial.

