FreeDOM

KO | EN

gitlite — search

#javascript #hacktoberfest #golang #machine-learning #rust #linux #docker #macos #java #windows #awesome #cli #kubernetes #security

(★ 227)

FreeDOM: Online Dynamic Object Removal Framework for Static Map Construction Based on Conservative Free Space Estimation [RA-L 25]

FreeDOM Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# FreeDOM

[![arXiv](https://img.shields.io/badge/arXiv-2504.11073-b31b1b?logo=arxiv&logoColor=b31b1b)](https://arxiv.org/abs/2504.11073)
[![Video](https://img.shields.io/badge/Video-Youtube-ff0000?logo=youTube&logoColor=ff0000)](https://youtu.be/5w5p5S4NJ4E)
[![Video](https://img.shields.io/badge/Video-Bilibili-00a1d6?logo=bilibili&logoColor=00a1d6)](https://www.bilibili.com/video/BV1tg5vzeE8d/?share_source=copy_web&vd_source=3ece63e96c4dbae46c3c2b13028ec6c8)

![Overview of FreeDOM](https://raw.githubusercontent.com/LC-Robotics/FreeDOM/main/images/framework.png)

**FreeDOM** is an online dynamic object removal framework for static map construction based on conservative free space estimation. With FreeDOM, you can create static voxel and pointcloud map in real-time, free from dynamic object interference.

## 1. Build

Clone source code:
```bash
mkdir -p ./Freedom_ws/src
cd ./Freedom_ws/src
git clone https://github.com/LC-Robotics/FreeDOM.git
```
Build:
```bash
cd ..
catkin build
```

## 2. Run
Run experiments on the SemanticKITTI dataset:
```bash
source devel/setup.bash
roslaunch freedom run_freedom.launch
rosbag play DATASET.bag
```
All rosbags can be found [here](https://drive.google.com/drive/folders/1fIDHxXvzVftwmE3uOejQGbytoBfeMTMA?usp=sharing). To run experiments on other datasets (HeLiMOS, Indoor), modify the `yaml` file path in `run_freedom.launch` and play the corresponding rosbag.

- When running KITTI seq.01 (high-speed scenario), `counts_to_free` should be set to 3 to enable faster free space estimation.

- It is recommended to use `run_freedom_indoor.launch` for Indoor datasets for better visualization.

Save the generated static map:
```bash
rostopic pub /save_map std_msgs/Empty "{}" -1
```
The static map will be saved by default at `./generated_pcd`.

## 3. Evaluation
Generate ground truth:
```bash
roslaunch freedom ground_truth_generate.launch
rosbag play DATASET.bag
```
Save the generated ground truth:
```bash
rostopic pub /save_map std_msgs/Empty "{}" -1
```
The ground truth file will be saved by default at `./generated_pcd`.

- Alternatively, you can directly download the ground truth file [here](https://drive.google.com/drive/folders/1fIDHxXvzVftwmE3uOejQGbytoBfeMTMA?usp=sharing).

Evaluation:
```bash
roslaunch freedom static_map_evaluate.launch
```
- Make sure the `ground_truth_path` and `static_map_path` in `static_map_evaluate.launch` are correct.

- Note that we use a voxel size of 0.2m for outdoor datasets and 0.1m for indoor datasets, which can be modified in `ground_truth_generate.launch` and `static_map_evaluate.launch`.

## 4. Citation
Please cite this paper if you find our work useful for your research.
```
@article{Li2025FreeDOM,
  author={Li, Chen and Li, Wanlei and Liu, Wenhao and Shu, Yixiang and Lou, Yunjiang},
  journal={IEEE Robotics and Automation Letters}, 
  title={FreeDOM: Online Dynamic Object Removal Framework for Static Map Construction Based on Conservative Free Space Estimation}, 
  year={2025},
  volume={10},
  number={6},
  pages={5577-5584},
  doi={10.1109/LRA.2025.3560881}
}
```

FreeDOM

FreeDOM Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

FreeDOM

FreeDOM Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README