Skip to content

Commit 5bf295a

Browse files
committed
method: update submodule on all our methods.
* metric discussion attached. * octomap more friendly dependencies * beautymap bug fixed on over range.
1 parent 4923a4c commit 5bf295a

7 files changed

Lines changed: 38 additions & 46 deletions

File tree

README.md

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,8 @@ A Dynamic Points Removal Benchmark in Point Cloud Maps
77
[![video](https://img.shields.io/badge/video-YouTube-FF0000?logo=youtube&logoColor=white)](https://youtu.be/pCHsNKXDJQM?si=nhbAnPrbaZJEqbjx)
88
[![poster](https://img.shields.io/badge/Poster-6495ed?style=flat&logo=Shotcut&logoColor=wihte)](https://hkustconnect-my.sharepoint.com/:b:/g/personal/qzhangcb_connect_ust_hk/EQvNHf9JNEtNpyPg1kkNLNABk0v1TgGyaM_OyCEVuID4RQ?e=TdWzAq)
99
[![Built with Material for MkDocs](https://img.shields.io/badge/Material_for_MkDocs-526CFE?logo=MaterialForMkDocs&logoColor=white)](https://kth-rpl.github.io/DynamicMap_Benchmark/)
10-
10+
[![blog](https://img.shields.io/badge/Blog%7C%E7%9F%A5%E4%B9%8E%E4%B8%AD%E6%96%87-1772f6?style=flat&logo=Shotcut)](https://zhuanlan.zhihu.com/p/662096274)
11+
1112
Here is a preview of the readme in codes. Task detects dynamic points in maps and removes them, enhancing the maps:
1213

1314
<center>
@@ -41,7 +42,7 @@ Here is a preview of the readme in codes. Task detects dynamic points in maps an
4142

4243
Feel free to pull a request if you want to add more methods or datasets. Welcome! We will try our best to update methods and datasets in this benchmark. Please give us a star 🌟 and cite our work 📖 if you find this useful for your research. Thanks!
4344

44-
- **2024/04/29** [BeautyMap](https://arxiv.org/abs/2405.07283) is accepted by RA-L'24. Updated benchmark: BeautyMap and DeFlow submodule instruction in the benchmark. Added the first data-driven method [DeFlow](https://github.com/KTH-RPL/DeFlow/tree/feature/dynamicmap) into our benchmark. Feel free to check.
45+
- **2024/04/29** [BeautyMap](https://arxiv.org/abs/2405.07283) is accepted by RA-L'24. Updated benchmark: BeautyMap and DeFlow submodule instruction in the benchmark. Added the first data-driven method [DeFlow](https://github.com/KTH-RPL/DeFlow/tree/feature/dynamicmap) into our benchmark. Feel free to check. And [a discussion](https://github.com/KTH-RPL/DynamicMap_Benchmark/discussions/15) for why metric different than previous works.
4546
- **2024/04/18** [DUFOMap](https://arxiv.org/abs/2403.01449) is accepted by RA-L'24. Updated benchmark: DUFOMap and dynablox submodule instruction in the benchmark. Two datasets w/o gt for demo are added in the download link. Feel free to check.
4647
- **2024/03/08** **Fix statements** on our ITSC'23 paper: KITTI sequences pose are also from SemanticKITTI which used SuMa. In the DUFOMap paper Section V-C, Table III, we present the dynamic removal result on different pose sources. Check discussion in [DUFOMap](https://arxiv.org/abs/2403.01449) paper if you are interested.
4748
- **2023/06/13** The [benchmark paper](https://arxiv.org/abs/2307.07260) Accepted by ITSC 2023 and release five methods (Octomap, Octomap w GF, ERASOR, Removert) and three datasets (01, 05, av2, semindoor) in [benchmark paper](https://arxiv.org/abs/2307.07260).
@@ -124,11 +125,11 @@ Please cite our works if you find these useful for your research:
124125
@article{jia2024beautymap,
125126
author={Jia, Mingkai and Zhang, Qingwen and Yang, Bowen and Wu, Jin and Liu, Ming and Jensfelt, Patric},
126127
journal={IEEE Robotics and Automation Letters},
127-
title={BeautyMap: Binary-Encoded Adaptable Ground Matrix for Dynamic Points Removal in Global Maps},
128+
title={{BeautyMap}: Binary-Encoded Adaptable Ground Matrix for Dynamic Points Removal in Global Maps},
128129
year={2024},
129-
volume={},
130-
number={},
131-
pages={1-8},
130+
volume={9},
131+
number={7},
132+
pages={6256-6263},
132133
doi={10.1109/LRA.2024.3402625}
133134
}
134135
@article{daniel2024dufomap,

methods/BeautyMap

methods/DeFlow

methods/README.md

Lines changed: 26 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@ Demo Image, results you can have after reading this README:
66
<img src="../assets/imgs/octomap_gf_00.png" style="width: 70%;" alt="Octomap Image">
77

88
All of them have same dependencies [PCL, Glog, yaml-cpp], we will show how to install and build:
9+
910
## Install & Build
1011

1112
Test computer and System:
@@ -14,6 +15,7 @@ Test computer and System:
1415
- System setting: Ubuntu 20.04 [ROS noetic-full installed in system]
1516

1617
Dependencies listed following if you want to install them manually, or you can use docker to build and run if you don't like trash your env.
18+
1719
### Docker
1820
If you want to use docker, please check [Dockerfile](../Dockerfile) for more details. This can also be a reference for you to install the dependencies.
1921
```
@@ -25,36 +27,22 @@ docker run -it --rm --name dynamicmap -v /home/kin/data:/home/kin/data zhangkin/
2527
- If it's hard to build, you can always use `docker pull zhangkin/dynamic_map` to pull the image from docker hub.
2628

2729

28-
### PCL / OpenCV
29-
Normally, you will directly have PCL and OpenCV library if you installed ROS-full in your computer.
30-
OpenCV is required by Removert only, PCL is required by Benchmark.
31-
32-
Reminder for ubuntu 20.04 may occur this error:
33-
```bash
34-
fatal error: opencv2/cv.h: No such file or directory
35-
```
36-
ln from opencv4 to opencv2
37-
```bash
38-
sudo ln -s /usr/include/opencv4/opencv2 /usr/include/opencv2
39-
```
30+
### PCL
31+
Normally, you will directly have PCL and OpenCV library if you installed ROS-full in your computer. Otherwise
4032

41-
### glog gflag [for print]
42-
or you can install through `sudo apt install`
4333
```sh
44-
sh -c "$(wget -O- https://raw.githubusercontent.com/Kin-Zhang/Kin-Zhang/main/Dockerfiles/latest_glog_gflag.sh)"
34+
sudo apt update && sudo apt install -y libpcl-dev
4535
```
4636

47-
### yaml-cpp [for config]
48-
Please set the FLAG, check this issue if you want to know more: https://github.com/jbeder/yaml-cpp/issues/682, [TOOD inside the CMakeLists.txt](https://github.com/jbeder/yaml-cpp/issues/566)
49-
50-
If you install in Ubuntu 22.04, please check this commit: https://github.com/jbeder/yaml-cpp/commit/c86a9e424c5ee48e04e0412e9edf44f758e38fb9 which is the version could build in 22.04
37+
### glog gflag [for print]
5138

39+
You can install them manually or use the script to install them.
5240
```sh
53-
cd ${Tmp_folder}
54-
git clone https://github.com/jbeder/yaml-cpp.git && cd yaml-cpp
55-
env CFLAGS='-fPIC' CXXFLAGS='-fPIC' cmake -Bbuild
56-
cmake --build build --config Release
57-
sudo cmake --build build --config Release --target install
41+
# option 1:
42+
sudo apt install -y libgoogle-glog-dev libgflags-dev
43+
44+
# option 2:
45+
sh -c "$(wget -O- https://raw.githubusercontent.com/Kin-Zhang/Kin-Zhang/main/Dockerfiles/latest_glog_gflag.sh)"
5846
```
5947

6048
### Build
@@ -68,35 +56,38 @@ cmake -B build && cmake --build build
6856

6957
Check each methods config file in their own folder `config/*.yaml` or `assets/*.yaml`
7058
```bash
71-
./build/${methods_name}_run ${data_path} ${config.yaml} -1
59+
./build/${methods_name}_run ${data_path} ${config.yaml/toml} -1
7260
```
7361

7462
For example, if you want to run octomap with GF
7563

7664
```bash
77-
./build/octomap_run /home/kin/data/00 assets/config_fg.yaml -1
65+
./build/octomap_run /home/kin/data/00 assets/config_fg.toml -1
7866
```
7967

80-
Then you can get a time table with clean map result from Octomap w GF like top image shows. Or ERASOR on semindoor dataset:
68+
Then you can get a time table with clean map result from Octomap w GF like top image shows.
69+
70+
<!-- Or ERASOR on semindoor dataset:
8171
8272
```bash
8373
./build/erasor_run /home/kin/data/semindoor config/seq_semindoor.yaml -1
8474
```
8575
86-
![ERASOR Image](../assets/imgs/erasor_semindoor.png)
87-
88-
All Running commands, `-1` means all pcd files in the `pcd` folder, if you only want to run `10` frames change to `10`.
76+
![ERASOR Image](../assets/imgs/erasor_semindoor.png) -->
77+
All Running commands, `-1` means all pcd files in the `pcd` folder, otherwise the default is `10`/`1` frames.
8978

9079
```
91-
./build/removert_run ${data_path} ${config.yaml} -1
92-
./build/octomap_run ${data_path} ${config.yaml} -1
93-
./build/erasor_run ${data_path} ${config.yaml} -1
80+
./build/octomap_run ${data_path} ${config.toml} -1
81+
python BeautyMap/main.py --data_dir ${data_path} --run_file_num -1
82+
./build/dufomap_run ${data_path} ${config.toml}
9483
```
9584

96-
Then maybe you would like to have quantitative and qualitative result, check [scripts/py/eval](../scripts/py/eval).
85+
<!-- ./build/removert_run ${data_path} ${config.yaml} -1
86+
./build/erasor_run ${data_path} ${config.yaml} -1 -->
9787

9888
## Quick view on results
9989

10090
Both with quantitative table and qualitative result
10191

102-
TODO
92+
- Quantitative result print out the table: [scripts/py/eval/evaluate_all.py](../scripts/py/eval/evaluate_all.py)
93+
- Qualitative result automatically compare and merge: [scripts/py/eval/figure_plot.ipynb](../scripts/py/eval/figure_plot.ipynb)

scripts/py/eval/evaluate_all.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@
2121

2222
# TODO: Change the parameters below to your own settings ====>>
2323
Result_Folder = "/home/kin/data/Dynamic_Papers_assets/BenchmarkPaper"
24-
algorithms = ["removert", "erasor", "octomap", "octomapg", "octomapfg"]
24+
algorithms = ["octomap", "octomapg", "octomapfg", "beautymap", "dufomap"]
2525
all_seqs = ["00", "05", "av2", "semindoor"]
2626
# TODO: Change the parameters below to your own settings <<===
2727

0 commit comments

Comments
 (0)