# ailab-hanyang/radar4motion architecture

> Architecture diagram of the GitHub repository ailab-hanyang/radar4motion, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ailab-hanyang/radar4motion
- Repository: https://github.com/ailab-hanyang/radar4motion

## Overview

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: [`src/core.cpp`](https://github.com/ailab-hanyang/radar4motion/blob/main/src/core.cpp) (Odometry coordinator), [`src/radar4motion/odometry.cpp`](https://github.com/ailab-hanyang/radar4motion/blob/main/src/radar4motion/odometry.cpp) (Radar odometry), [`include/radar4motion/ini_handler_cpp/c_ini.hpp`](https://github.com/ailab-hanyang/radar4motion/blob/main/include/radar4motion/ini_handler_cpp/c_ini.hpp) (INI configuration reader), [`include/radar4motion/kiss-icp/Registration.cpp`](https://github.com/ailab-hanyang/radar4motion/blob/main/include/radar4motion/kiss-icp/Registration.cpp) (RCS-weighted registration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["ROS runtime"]
  node_main["ROS entry point<br/>[main.cpp]"]
  node_runner["Odometry coordinator<br/>[core.cpp]"]
  node_outputs["Pose and map output<br/>[core.cpp]"]
end

subgraph group_input["Radar input"]
  node_vod_parser["VoD parser"]
end

subgraph group_estimation["Motion and odometry"]
  node_ego["Ego velocity estimate"]
  node_preprocess["Radar preprocessing<br/>[preprocessing.cpp]"]
  node_odometry["Radar odometry<br/>[odometry.cpp]"]
end

subgraph group_kiss["Registration internals"]
  node_registration["RCS-weighted registration<br/>[Registration.cpp]"]
  node_kiss_pre["Cloud preprocessing<br/>[Preprocessing.cpp]"]
  node_deskew["Scan deskew<br/>[Deskew.cpp]"]
  node_threshold["Adaptive threshold<br/>[Threshold.cpp]"]
  node_voxel_map["Voxel hash map<br/>[VoxelHashMap.cpp]"]
  node_voxel_utils["Voxel utilities<br/>[VoxelUtils.cpp]"]
end

subgraph group_settings["Configuration"]
  node_ini_wrapper["INI configuration reader<br/>[c_ini.hpp]"]
  node_ini_parser["INI parser<br/>[ini.h]"]
  node_odom_config["Odometry parameters"]
  node_ego_config["Ego parameters"]
end

node_ros_topic(("Radar topic"))
node_vod_files[("VoD files")]

node_main -->|"runs"| node_runner
node_ros_topic -.->|"supplies scans"| node_runner
node_vod_files -.->|"provides files"| node_vod_parser
node_runner -->|"converts scans"| node_vod_parser
node_runner -.->|"estimates velocity"| node_ego
node_runner -.->|"preprocesses points"| node_preprocess
node_runner -.->|"runs odometry"| node_odometry
node_runner -->|"publishes results"| node_outputs
node_odometry -.->|"registers scans"| node_registration
node_registration -->|"queries neighbors"| node_voxel_map
node_voxel_map -->|"uses voxel helpers"| node_voxel_utils
node_odometry -.->|"uses preprocessing"| node_kiss_pre
node_odometry -.->|"uses deskew"| node_deskew
node_odometry -.->|"uses threshold"| node_threshold
node_runner -->|"reads settings"| node_ini_wrapper
node_ini_wrapper -->|"parses values"| node_ini_parser
node_odom_config -.->|"configures odometry"| node_ini_wrapper
node_ego_config -.->|"configures estimator"| node_ego

click node_main "https://github.com/ailab-hanyang/radar4motion/blob/main/src/main.cpp"
click node_runner "https://github.com/ailab-hanyang/radar4motion/blob/main/src/core.cpp"
click node_outputs "https://github.com/ailab-hanyang/radar4motion/blob/main/src/core.cpp"
click node_vod_parser "https://github.com/ailab-hanyang/radar4motion/blob/main/include/vod_utils/vod_parse_utils.cpp"
click node_ego "https://github.com/ailab-hanyang/radar4motion/blob/main/include/ego_motion_estimator/ego_motion_estimator.cpp"
click node_preprocess "https://github.com/ailab-hanyang/radar4motion/blob/main/src/radar4motion/preprocessing.cpp"
click node_odometry "https://github.com/ailab-hanyang/radar4motion/blob/main/src/radar4motion/odometry.cpp"
click node_registration "https://github.com/ailab-hanyang/radar4motion/blob/main/include/radar4motion/kiss-icp/Registration.cpp"
click node_kiss_pre "https://github.com/ailab-hanyang/radar4motion/blob/main/include/radar4motion/kiss-icp/Preprocessing.cpp"
click node_deskew "https://github.com/ailab-hanyang/radar4motion/blob/main/include/radar4motion/kiss-icp/Deskew.cpp"
click node_threshold "https://github.com/ailab-hanyang/radar4motion/blob/main/include/radar4motion/kiss-icp/Threshold.cpp"
click node_voxel_map "https://github.com/ailab-hanyang/radar4motion/blob/main/include/radar4motion/kiss-icp/VoxelHashMap.cpp"
click node_voxel_utils "https://github.com/ailab-hanyang/radar4motion/blob/main/include/radar4motion/kiss-icp/VoxelUtils.cpp"
click node_ini_wrapper "https://github.com/ailab-hanyang/radar4motion/blob/main/include/radar4motion/ini_handler_cpp/c_ini.hpp"
click node_ini_parser "https://github.com/ailab-hanyang/radar4motion/blob/main/include/radar4motion/ini_handler_cpp/ini.h"
click node_odom_config "https://github.com/ailab-hanyang/radar4motion/blob/main/config/radar_point_cloud_odometry.ini"
click node_ego_config "https://github.com/ailab-hanyang/radar4motion/blob/main/config/radar_ego_motion_estimation.ini"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_runner,node_outputs toneBlue
class node_vod_parser,node_vod_files toneAmber
class node_ego,node_preprocess,node_odometry toneMint
class node_registration,node_kiss_pre,node_deskew,node_threshold,node_voxel_map,node_voxel_utils toneRose
class node_ini_wrapper,node_ini_parser,node_odom_config,node_ego_config,node_ros_topic toneIndigo
```

## Components

### ROS runtime

- [ROS entry point](https://github.com/ailab-hanyang/radar4motion/blob/main/src/main.cpp): `src/main.cpp`
- [Odometry coordinator](https://github.com/ailab-hanyang/radar4motion/blob/main/src/core.cpp): `src/core.cpp`
- [Pose and map output](https://github.com/ailab-hanyang/radar4motion/blob/main/src/core.cpp): `src/core.cpp`

### Radar input

- [VoD parser](https://github.com/ailab-hanyang/radar4motion/blob/main/include/vod_utils/vod_parse_utils.cpp): `include/vod_utils/vod_parse_utils.cpp`

### Motion and odometry

- [Ego velocity estimate](https://github.com/ailab-hanyang/radar4motion/blob/main/include/ego_motion_estimator/ego_motion_estimator.cpp): `include/ego_motion_estimator/ego_motion_estimator.cpp`
- [Radar preprocessing](https://github.com/ailab-hanyang/radar4motion/blob/main/src/radar4motion/preprocessing.cpp): `src/radar4motion/preprocessing.cpp`
- [Radar odometry](https://github.com/ailab-hanyang/radar4motion/blob/main/src/radar4motion/odometry.cpp): `src/radar4motion/odometry.cpp`

### Registration internals

- [RCS-weighted registration](https://github.com/ailab-hanyang/radar4motion/blob/main/include/radar4motion/kiss-icp/Registration.cpp): `include/radar4motion/kiss-icp/Registration.cpp`
- [Cloud preprocessing](https://github.com/ailab-hanyang/radar4motion/blob/main/include/radar4motion/kiss-icp/Preprocessing.cpp): `include/radar4motion/kiss-icp/Preprocessing.cpp`
- [Scan deskew](https://github.com/ailab-hanyang/radar4motion/blob/main/include/radar4motion/kiss-icp/Deskew.cpp): `include/radar4motion/kiss-icp/Deskew.cpp`
- [Adaptive threshold](https://github.com/ailab-hanyang/radar4motion/blob/main/include/radar4motion/kiss-icp/Threshold.cpp): `include/radar4motion/kiss-icp/Threshold.cpp`
- [Voxel hash map](https://github.com/ailab-hanyang/radar4motion/blob/main/include/radar4motion/kiss-icp/VoxelHashMap.cpp): `include/radar4motion/kiss-icp/VoxelHashMap.cpp`
- [Voxel utilities](https://github.com/ailab-hanyang/radar4motion/blob/main/include/radar4motion/kiss-icp/VoxelUtils.cpp): `include/radar4motion/kiss-icp/VoxelUtils.cpp`

### Configuration

- [INI configuration reader](https://github.com/ailab-hanyang/radar4motion/blob/main/include/radar4motion/ini_handler_cpp/c_ini.hpp): `include/radar4motion/ini_handler_cpp/c_ini.hpp`
- [INI parser](https://github.com/ailab-hanyang/radar4motion/blob/main/include/radar4motion/ini_handler_cpp/ini.h): `include/radar4motion/ini_handler_cpp/ini.h`
- [Odometry parameters](https://github.com/ailab-hanyang/radar4motion/blob/main/config/radar_point_cloud_odometry.ini): `config/radar_point_cloud_odometry.ini`
- [Ego parameters](https://github.com/ailab-hanyang/radar4motion/blob/main/config/radar_ego_motion_estimation.ini): `config/radar_ego_motion_estimation.ini`

### Other components

- **Radar topic**
- **VoD files**

## Connections

- ROS entry point → Odometry coordinator: runs (evidence: `src/main.cpp`)
- Radar topic → Odometry coordinator: supplies scans (evidence: `README.md`)
- VoD files → VoD parser: provides files (evidence: `README.md`)
- Odometry coordinator → VoD parser: converts scans (evidence: `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 (evidence: `src/core.cpp`)
- Radar odometry → RCS-weighted registration: registers scans
- RCS-weighted registration → Voxel hash map: queries neighbors (evidence: `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 (evidence: `src/core.cpp`)
- INI configuration reader → INI parser: parses values (evidence: `include/radar4motion/ini_handler_cpp/c_ini.hpp`)
- Odometry parameters → INI configuration reader: configures odometry (evidence: `README.md`)
- Ego parameters → Ego velocity estimate: configures estimator (evidence: `README.md`)
