How ailab-hanyang/radar4motion works
Radar4Motion is a ROS-based, IMU-free 4D radar odometry and mapping application. Its main workflow accepts radar scans either from a ROS topic or from View-of-Delft files, estimates radar ego velocity, preprocesses radar points, performs RCS-weighted scan-to-submap odometry, and publishes poses and map visualizations; offline mode can also parse and publish dataset ground truth. The graph includes the documented KISS-ICP registration and voxel-map support. Several implementation calls are not visible in the excerpts, so those relationships are marked unverified rather than asserted.
Main entry points: core.cpp Odometry coordinator · odometry.cpp Radar odometry · c_ini.hpp INI configuration reader · Registration.cpp RCS-weighted registration
Components 19
ROS runtime
- ROS entry point
src/main.cpp - Odometry coordinator
src/core.cpp - Pose and map output
src/core.cpp
Radar input
- VoD parser
include/vod_utils/vod_parse_utils.cpp
Motion and odometry
- Ego velocity estimate
include/ego_motion_estimator/ego_motion_estimator.cpp - Radar preprocessing
src/radar4motion/preprocessing.cpp - Radar odometry
src/radar4motion/odometry.cpp
Registration internals
- RCS-weighted registration
include/radar4motion/kiss-icp/Registration.cpp - Cloud preprocessing
include/radar4motion/kiss-icp/Preprocessing.cpp - Scan deskew
include/radar4motion/kiss-icp/Deskew.cpp - Adaptive threshold
include/radar4motion/kiss-icp/Threshold.cpp - Voxel hash map
include/radar4motion/kiss-icp/VoxelHashMap.cpp - Voxel utilities
include/radar4motion/kiss-icp/VoxelUtils.cpp
Configuration
- INI configuration reader
include/radar4motion/ini_handler_cpp/c_ini.hpp - INI parser
include/radar4motion/ini_handler_cpp/ini.h - Odometry parameters
config/radar_point_cloud_odometry.ini - Ego parameters
config/radar_ego_motion_estimation.ini
Other components
- Radar topic
- VoD files
Connections 18
- ROS entry point → Odometry coordinator: runs
src/main.cpp - Radar topic → Odometry coordinator: supplies scans
README.md - VoD files → VoD parser: provides files
README.md - Odometry coordinator → VoD parser: converts scans
src/core.cpp - Odometry coordinator → Ego velocity estimate: estimates velocity
- Odometry coordinator → Radar preprocessing: preprocesses points
- Odometry coordinator → Radar odometry: runs odometry
- Odometry coordinator → Pose and map output: publishes results
src/core.cpp - Radar odometry → RCS-weighted registration: registers scans
- RCS-weighted registration → Voxel hash map: queries neighbors
include/radar4motion/kiss-icp/Registration.cpp - Voxel hash map → Voxel utilities: uses voxel helpers
- Radar odometry → Cloud preprocessing: uses preprocessing
- Radar odometry → Scan deskew: uses deskew
- Radar odometry → Adaptive threshold: uses threshold
- Odometry coordinator → INI configuration reader: reads settings
src/core.cpp - INI configuration reader → INI parser: parses values
include/radar4motion/ini_handler_cpp/c_ini.hpp - Odometry parameters → INI configuration reader: configures odometry
README.md - Ego parameters → Ego velocity estimate: configures estimator
README.md