Block-Map-Based-Localization

KO | EN

gitlite — search

#javascript #hacktoberfest #llm #golang #android #machine-learning #deep-learning #nodejs #java #windows #cli #awesome-list #ios #open-source

Block-Map-Based-Localization

(★ 261)

[ICRA'24] A localization system based on Block Maps (BMs) to reduce the computational load caused by maintaining large-scale maps

File Explorer

Download Latest Version (.zip)

- m2dgr_params.yaml
- nclt_params.yaml
- Cover.jpg
- m2dgr_street_01.png
- m2dgr_street_02.png
- - ndt_est.hpp
  - pose_estimator.hpp
  - pose_system.hpp
- utility.h
- run_m2dgr.launch
- run_nclt.launch
- cloud_info.msg
- block_localization.rviz
- block_localization_nodelet.cpp
- globalmap_server_nodelet.cpp
- points_preprocessing_nodelet.cpp
- queryMap.srv
CMakeLists.txt
LICENSE
nodelet_plugins.xml
package.xml
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<div align="center">
    <h1>BM-Loc</h1>
    <br />
    <a href=https://www.youtube.com/watch?v=jJhs0jK-uSI>🎬Video</a>
    <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
    <a href="https://github.com/YixFeng/Block-Map-Based-Localization/blob/main/README.md#Installation">🛠️Installation</a>
    <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
    <a href=https://arxiv.org/pdf/2404.18192>📑Paper</a>
  <br />
  <br />
</div>

![BMLoc_cover](https://raw.githubusercontent.com/YixFeng/Block-Map-Based-Localization/main/figs/Cover.jpg)

In this work, we propose a <strong>Block Map (BM)</strong> generation and maintenance method and the corresponding BM-based localization system. The main contributions are as follows:

- A BM-based localization system in a large-scale environment is proposed for the first time.
- A BM generation method and corresponding switching strategy is proposed which maintains the spatial continuity of adjacent BMs.
- A factor graph-based optimization method with the dynamic sliding window based on BMs is proposed to achieve accurate and reliable state estimation.
- We achieve the best performance on publicly available large-scale datasets [NCLT](https://robots.engin.umich.edu/nclt/) and [M2DGR](https://github.com/SJTU-ViSYS/M2DGR).

***
## Installation
### 1. Prerequisites
#### 1.1 Ubuntu and ROS
Ubuntu $\geq$ 18.04
#### 1.2 ROS Package
- [ndt_omp](https://github.com/koide3/ndt_omp)
- [fast_gicp](https://github.com/SMRT-AIST/fast_gicp)
- [hdl_global_localization](https://github.com/koide3/hdl_global_localization) (Can be replaced by our promoted global localization method; will release soon)

### 2. Build
```bash
cd <your workspace>/src
git clone https://github.com/koide3/ndt_omp
git clone https://github.com/SMRT-AIST/fast_gicp --recursive
git clone https://github.com/koide3/hdl_global_localization
git clone https://github.com/YixFeng/Block-Map-Based-Localization

cd ..
catkin_make
source devel/setup.bash
```

## Run
We provide some [Block Maps](https://drive.google.com/file/d/1Z2K56jTkMOouZhM4c9JhPvqyDxGFiXSY/view?usp=drive_link) (Google Drive) to make your tests easy.

- **M2DGR street_01**
  
![m2dgr_street_01](https://raw.githubusercontent.com/YixFeng/Block-Map-Based-Localization/main/figs/m2dgr_street_01.png)

- **M2DGR street_02**

![m2dgr_street_02](https://raw.githubusercontent.com/YixFeng/Block-Map-Based-Localization/main/figs/m2dgr_street_02.png)

### 1. NCLT
Download NCLT from [https://robots.engin.umich.edu/nclt/](https://robots.engin.umich.edu/nclt/)
```bash
roslaunch block_localization run_nclt.launch
```

### 2. M2DGR
Download M2DGR from [https://github.com/SJTU-ViSYS/M2DGR](https://github.com/SJTU-ViSYS/M2DGR)
```bash
roslaunch block_localization run_m2dgr.launch
```
*Remarks:*
Since BM-Loc is a map-based localization method, you need to provide the directory where maps are stored. Edit the parameter `globalmap_dir` in `config/*.yaml` files.

## Citation
If you use any of this code, please cite our [paper](https://arxiv.org/pdf/2404.18192).

```bibtex
@article{feng2024block,
  title={Block-Map-Based Localization in Large-Scale Environment},
  author={Feng, Yixiao and Jiang, Zhou and Shi, Yongliang and Feng, Yunlong and Chen, Xiangyu and Zhao, Hao and Zhou, Guyue},
  journal={arXiv preprint arXiv:2404.18192},
  year={2024}
}
```

## Acknowledgements
Thanks for the open-source projects [hdl_localization](https://github.com/koide3/hdl_localization), [hdl_global_localization](https://github.com/koide3/hdl_localization) and [LIO-SAM](https://github.com/TixiaoShan/LIO-SAM).

## Star History

[![Star History Chart](https://api.star-history.com/svg?repos=YixFeng/Block-Map-Based-Localization&type=Date)](https://www.star-history.com/#YixFeng/Block-Map-Based-Localization&Date)

Block-Map-Based-Localization

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Block-Map-Based-Localization

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README