Skip to content

README.md

Latest commit

 

History

History
109 lines (73 loc) · 2.62 KB

README.md

File metadata and controls

109 lines (73 loc) · 2.62 KB

Sensor Fusion EKF Localizer

Overview

Integrate IMU, GNSS, and vehicle speed into an Extended Kalman Filter (EKF) to estimate the vehicle's global pose (position and orientation) with covariance.

Sensor Topics

  • IMU Data (sensor_msgs/Imu)
  • GNSS Position Data (1) (sensor_msgs/NavSatFix)
  • GNSS Position Data (2) (sensor_msgs/NavSatFix)
  • Twist Data (geometry_msgs/TwistWithCovarianceStamped)

GNSS Poser

Convert dual or single GNSS readings and MGRS grid zone (from Lanelet2) into a pose with covariance.

Inputs

  • /gnss1/fix (NavSatFix)
  • /gnss2/fix (NavSatFix) # (If you do not have second antenna, use single antenna option.)
  • /lanelet/mgrs_zone (MapProjectorInfo) # From map.launch.py

Output

  • /pose_with_covariance (PoseWithCovarianceStamped)

gyro_odometer

Estimate vehicle twist by fusing IMU angular velocity with measured speed from wheels.

Inputs

  • /vehicle/twist_with_covariance (TwistWithCovarianceStamped)
  • /imu (Imu)

Output

  • /twist_with_covariance (TwistWithCovarianceStamped)

ekf_localizer

Fuse pose and twist into a global pose estimate using EKF.

Inputs

  • /pose_with_covariance (PoseWithCovarianceStamped)
  • /twist_with_covariance (TwistWithCovarianceStamped)

Output

  • /ekf_pose_with_covariance (PoseWithCovarianceStamped)

Visuals

RVIZ visualization of EKF output

Why the GNSS-Only Pose Lags

In the GIF, the GNSS-only pose (the trailing marker) falls behind the EKF output because GNSS fixes arrive at 5 Hz (once every 0.2 s) while the EKF integrates sensor data continuously.

At a constant speed of 3.6 m/s (≈ 12.96 km/h), the vehicle covers: Distance = Speed × Interval
= 3.6 m/s × 0.2 s
= 0.72 m

between GNSS updates. Consequently, each new GNSS position is about 0.72 m behind the vehicle’s actual location, whereas the EKF estimate remains current.

Clone the Repository

Create a workspace

mkdir ros2_ws_localization
cd ros2_ws_localization

Clone the repo

git clone git@github.com:memre12/multi_sensor_fusion_localization.git
cd multi_sensor_fusion_localization/

Install dependencies

rosdep install --from-paths src --ignore-src -r -y

Build

cd ..
colcon build --symlink-install

Launch

ros2 launch gae_launch dual_antenna_gnss_loc.launch.py

Test with bags

source install/setup.bash
ros2 launch gae_launch dual_antenna_gnss_loc.launch.py 
ros2 bag play notf_nobaddata_drive --start-offset 100
python3 gnss_localization/gae_launch/scripts/retimer.py