DriveWorks SDK Reference 3.5.78 Release For Test and Development only
IMU Calibration Tool

Description

The NVIDIA® DriveWorks IMU Calibration tool calibrates the orientation of IMU with respect to the car ("Rig") coordinate system, and displays it on screen.

If the orientation is successfully calibrated, a new rig file containing this orientation is created in the same folder as the input rig file.
This new rig file is labelled <input_rig_filename>_calibrated.json.

Note
SW Release Applicability: This tool is available in both NVIDIA DriveWorks and NVIDIA DRIVE Software releases.

Prerequisites

This tool is available on the x86 Host System and NVIDIA DRIVE OS Linux.

This tool creates output files that are placed into the current working directory by default. Please ensure the following for your convenience:

• Write permissions are enabled for the current working directory.
• Include the tools folder in the binary search path of the system.
• Execute from your home directory.

To use this tool, you first must capture IMU and CAN data, with the vehicle performing a special calibration sequence. For more information, see how To Capture IMU and CAN Data.

For an example of a suitable input rig file, please navigate to path/to/data/tools/calibration_imu/rig.json.

Running the Tool

When you have obtained the IMU and CAN data, run the tool by executing:

./calibration_imu --rig=rig.json
--imu-sensor=[IMU sensor or name]
--can-sensor=[CAN sensor or name]
[--trigger=[float number]]
[--angleStdDev=[float number]]


Parameters

--rig=[path to vehicle rig file]
Description: The rig file must specify file paths to the IMU, CAN, and DBC files.
Example: --rig=rig.json

--imu-sensor=[IMU name or number]
Description: The IMU sensor name or number specified in the input rig file.
Example: --imu-sensor=imu:xsens

--can-sensor=[IMU name or number]
Description: The CAN sensor name or number specified in the input rig file.
Example: --can-sensor=can:vehicle

--trigger=[float number]
Description: Specifies a forward acceleration trigger to record in (m/s^2).
Heavy vehicles such as trucks may require a smaller acceleration trigger.
This parameter is optional.
Default value: 2.0
Example: --trigger=6.1

--angleStdDev=[float number]
Description: The angular standard deviation threshold in degrees.
This parameter is optional.
Default value: 10.0
Example: --angleStdDev=7.6


Example

Displaying the IMU Sensor's Orientation on Screen

./calibration_imu --rig=rig.json
--imu-sensor=imu:xsens
--can-sensor=can:vehicle