JointLoc

KO | EN

gitlite — search

#hacktoberfest #react #llm #machine-learning #rust #deep-learning #macos #nodejs #java #awesome #awesome-list #security #mcp #open-source

(★ 80)

[IROS 2024] JointLoc: A Real-time Visual Localization Framework for Planetary UAVs Based on Joint Relative and Absolute Pose Estimation

JointLoc Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# JointLoc

[IROS 2024] JointLoc: A Real-time Visual Localization Framework for Planetary UAVs Based on Joint Relative and Absolute Pose Estimation

![JointLoc](https://raw.githubusercontent.com/LuoXubo/JointLoc/main/figs/pipeline.png)

## Update

### 2024.08.22

The installation and usage instructions are uploaded. You can refer to the `setup.md` to install and run the JointLoc.

### 2024.07.31

All the codes are uploaded. We are now preparing the installation and usage instructions.

### 2024.06.30

The paper has been accepted by IROS 2024. The the test dataset is uploaded. You can download the test dataset from [Google Drive](https://drive.google.com/drive/folders/1yAkHwNPdhbssDJqgm2Jvgculvo8pLQz6?usp=sharing) and extract it to the `JointLoc` directory.

We are preparing the main files (`vslam.cc` in RelLoc and `estimate.py` in AbsLoc) and will upload them soon.

### 2024.04.26

Most codes of the AbsLoc and RelLoc modules are uploaded. Meanwhile, the main files are deleted due to the privacy of the project. We will provide the main files and the test datset after the paper is accepted.

## Getting Started

### Installation

```bash
git clone https://github.com/LuoXubo/JointLoc.git
cd JointLoc
```

### Setup the environment

You can refer to the `setup.md` to install the required packages.

## Quick Demo

### Download the dataset

Download the test dataset from [Google Drive](https://drive.google.com/drive/folders/1yAkHwNPdhbssDJqgm2Jvgculvo8pLQz6?usp=sharing) and extract it to the `JointLoc` directory. The given dataset and your own dataset should have the following structure:

```
JointLoc
├── dataset
│   ├── [Terrain]_dataset
│   │   ├── uav
│   │   │   ├── images
│   │   │   │   ├── 000000.png
│   │   │   │   ├── 000001.png
│   │   │   │   ├── ...
│   │   │   ├── images.txt
│   │   │   ├── gt.txt
│   │   │   ├── ...
│   │   ├── satelite
│   │   │   ├── 0_x0_y0.png
│   │   │   ├── 0_x0_y1.png
│   │   │   ├── ...
│   │   ├── satelite.png
│   ├── ...
```

### Run the demo

```bash
cd JointLoc
sh RelLoc/redis.sh      # run redis server
sh AbsLoc/server.sh     # publish images to redis
sh RelLoc/relloc.sh     # run relative localization
sh AbsLoc/absloc.sh     # run absolute localization
```

This script will open 4 temrminals:

1. The first terminal will open redis-server.
2. The second terminal will publish the images to the redis-server.
3. The third terminal runs the relative localization (SLAM) system in /RelLoc/ directory.
4. The fourth terminal runs the absolute localization system in /AbsLoc/ directory.

## Evaluation

The estimated 6-DoF poses of JointLoc will be saved in `results/poses.txt`. You can evaluate the performance by running the following script:

```bash
evo_ape tum dataset/groundtruth.txt results/poses.txt -pv
```

## Compared with ORB-SLAM2 and ORB-SLAM3

We also provide the code to run ORB-SLAM2 and ORB-SLAM3 on the same dataset. You can run the following script:

```bash
sh run_orb_slam2.sh
sh run_orb_slam3.sh
```

### Visualization

## Acknowledgement

This work incorporates many open-source codes. We extend our gratitude to the authors of the software.

- [ORB-SLAM2](https://github.com/raulmur/ORB_SLAM2)
- [ORB-SLAM3](https://github.com/UZ-SLAMLab/ORB_SLAM3)
- [SuperPoint](https://github.com/rpautrat/SuperPoint)
- [LightGlue](https://github.com/cvg/LightGlue)

## Citation

If you find this repo useful for your research, please consider citing the paper

```
@misc{luo2024jointloc,
      title={JointLoc: A Real-time Visual Localization Framework for Planetary UAVs Based on Joint Relative and Absolute Pose Estimation},
      author={Xubo Luo and Xue Wan and Yixing Gao and Yaolin Tian and Wei Zhang and Leizheng Shu},
      year={2024},
      eprint={2405.07429},
      archivePrefix={arXiv},
      primaryClass={cs.RO}
}
```

## Star History

[![Star History Chart](https://api.star-history.com/svg?repos=LuoXubo/JointLoc&type=Date)](https://star-history.com/#LuoXubo/JointLoc&Date)

JointLoc

JointLoc Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

JointLoc

JointLoc Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README