Update README.md
Browse files
README.md
CHANGED
|
@@ -1,4 +1,11 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
# Wild-Places: A Large-Scale Dataset for Lidar Place Recognition in Unstructured Natural Environments
|
|
|
|
| 2 |
<!-- ## [Website](https://csiro-robotics.github.io/Wild-Places/) | [Paper](https://arxiv.org/abs/2211.12732) | [Data Download Portal](https://data.csiro.au/collection/csiro:56372?q=wild-places&_st=keyword&_str=1&_si=1) -->
|
| 3 |
<div align="center">
|
| 4 |
<a href="https://arxiv.org/abs/2211.12732"><img src='https://img.shields.io/badge/arXiv-Wild Places-red' alt='Paper PDF'></a>
|
|
@@ -7,8 +14,7 @@
|
|
| 7 |
<a href='https://data.csiro.au/collection/csiro:56372?q=wild-places&_st=keyword&_str=1&_si=1'><img src='https://img.shields.io/badge/Download-Wild Places-blue' alt='Project Page'></a>
|
| 8 |
</div>
|
| 9 |
|
| 10 |
-
|
| 11 |
-
This repository contains the code implementation used in the paper *Wild-Places: A Large-Scale Dataset for Lidar Place Recognition in Unstructured Natural Environments*, which has been published at ICRA2023.
|
| 12 |
|
| 13 |
If you find this dataset helpful for your research, please cite our paper using the following reference:
|
| 14 |
```
|
|
@@ -22,35 +28,11 @@ If you find this dataset helpful for your research, please cite our paper using
|
|
| 22 |
}
|
| 23 |
```
|
| 24 |
|
| 25 |
-
## Contents
|
| 26 |
-
1. [Updates](#updates)
|
| 27 |
-
2. [Download Instructions](#download-instructions)
|
| 28 |
-
3. [Benchmarking](#benchmarking)
|
| 29 |
-
* [Checkpoints](#checkpoints)
|
| 30 |
-
* [Performance](#performance)
|
| 31 |
-
4. [Scripts](#scripts)
|
| 32 |
-
* [Loading Point Clouds](#loading-point-clouds)
|
| 33 |
-
* [Training](#training)
|
| 34 |
-
* [Evaluation](#evaluation)
|
| 35 |
-
4. [Thanks](#thanks)
|
| 36 |
-
|
| 37 |
-
## Updates
|
| 38 |
-
- **Oct 2022** Wild-Places v1.0 Uploaded
|
| 39 |
-
- **Jan 2023** Wild-Places is accepted to ICRA2023!
|
| 40 |
-
- **Jan 2023** Wild-Places v2.0 Uploaded. This update to the dataset integrates GPS into the SLAM solution to alleviate vertical drift in the larger loops of the traversal in both environments. NOTE: Sequence K-04 is currently unavailable for v2.0 due to a failed loop closure in the ground truth. We are currently working on remedying this, and will release the sequence as soon this issue is rectified.
|
| 41 |
-
- **Feb 2025** Fix the broken timestamps in the poses files.
|
| 42 |
-
- **Nov 2025** Wild-Places v3.0 Uploaded. This update to the dataset includes:
|
| 43 |
-
- Updated point clouds / trajectories using the latest version of WildCat to bring the dataset in line with the pointclouds available in the WildScenes and WildCross datasets
|
| 44 |
-
- Updated benchmarking results and instructions for training on LoGG3D-Net and MinkLoc3Dv2
|
| 45 |
-
- Updated dataset and repository file structure
|
| 46 |
-
|
| 47 |
-
|
| 48 |
## Download Instructions
|
| 49 |
|
| 50 |
Our dataset can be downloaded through [The CSIRO Data Access Portal](https://data.csiro.au/collection/csiro:56372?q=wild-places&_st=keyword&_str=1&_si=1). Detailed instructions for downloading the dataset can be found in the README file provided on the data access portal page.
|
| 51 |
|
| 52 |
-
|
| 53 |
-
## Benchmarking
|
| 54 |
Here we provided pre-trained checkpoints and results for benchmarking several state-of-the-art LPR methods on the Wild-Places dataset.
|
| 55 |
|
| 56 |
**Update Nov. 2025**: With the release of Wild-Places v3.0, we have also re-run training for two state-of-the-art methods (LoGG3D-Net, MinkLoc3Dv2) on the Wild-Places dataset using expanded batch sizes to provide new training checkpoints which better reflect the capabilities of recent state-of-the-art GPUs. We provide checkpoints and benchmarked results for both the recently trained models and the checkpoints released with the ICRA2023 paper.
|
|
@@ -62,19 +44,7 @@ Here we provided pre-trained checkpoints and results for benchmarking several st
|
|
| 62 |
|ICRA2023| MinkLoc3DV2 | [Link](https://huggingface.co/CSIRORobotics/Wild-Places/resolve/main/ICRA_2023_checkpoints/MinkLoc3Dv2.pth) |
|
| 63 |
|ICRA2023| LoGG3D-Net | [Link](https://huggingface.co/CSIRORobotics/Wild-Places/resolve/main/ICRA_2023_checkpoints/LoGG3D-Net.pth) |
|
| 64 |
|2025 Re-Training| MinkLoc3DV2 | [Link](https://huggingface.co/CSIRORobotics/Wild-Places/resolve/main/2025_updated_checkpoints/MinkLoc3Dv2.pth) |
|
| 65 |
-
|2025 Re-Training| LoGG3D-Net | [Link](https://huggingface.co/CSIRORobotics/Wild-Places/resolve/main/2025_updated_checkpoints/LoGG3D-Net.pth)
|
| 66 |
-
|
| 67 |
-
|
| 68 |
-
### Performance
|
| 69 |
-

|
| 70 |
|
| 71 |
-
## Scripts
|
| 72 |
-
### Loading Point Clouds
|
| 73 |
-
A code snippet to load a pointcloud file from our dataset can be found in `eval/load_pointcloud.py`
|
| 74 |
-
### Training
|
| 75 |
-
We provide instructions for how to add Wild-Places as a training dataset for two state-of-the-art LPR methods: [LoGG3D-Net](https://github.com/csiro-robotics/LoGG3D-Net) and [MinkLoc3Dv2](https://github.com/jac99/MinkLoc3Dv2). For more detailed instructions, please consult the `README.md` files in `training/LoGG3D-Net` and `training/MinkLoc3Dv2`.
|
| 76 |
-
### Evaluation
|
| 77 |
-
We provide generic evaluation code for evaluating performance on the Wild-Places dataset for both the inter and intra-sequence testing scenarios, as well as an implementation of ScanContext. For more details, please see the `README.md` file in the `eval` folder.
|
| 78 |
|
| 79 |
-
|
| 80 |
-
Special thanks to the authors of the [PointNetVLAD](https://github.com/mikacuy/pointnetvlad) and [MinkLoc3D](https://github.com/jac99/MinkLoc3D), whose excellent code was used as a basis for the generation and evaluation scripts used in this repository.
|
|
|
|
| 1 |
+
---
|
| 2 |
+
license: other
|
| 3 |
+
license_name: license
|
| 4 |
+
license_link: LICENSE
|
| 5 |
+
---
|
| 6 |
+
|
| 7 |
# Wild-Places: A Large-Scale Dataset for Lidar Place Recognition in Unstructured Natural Environments
|
| 8 |
+

|
| 9 |
<!-- ## [Website](https://csiro-robotics.github.io/Wild-Places/) | [Paper](https://arxiv.org/abs/2211.12732) | [Data Download Portal](https://data.csiro.au/collection/csiro:56372?q=wild-places&_st=keyword&_str=1&_si=1) -->
|
| 10 |
<div align="center">
|
| 11 |
<a href="https://arxiv.org/abs/2211.12732"><img src='https://img.shields.io/badge/arXiv-Wild Places-red' alt='Paper PDF'></a>
|
|
|
|
| 14 |
<a href='https://data.csiro.au/collection/csiro:56372?q=wild-places&_st=keyword&_str=1&_si=1'><img src='https://img.shields.io/badge/Download-Wild Places-blue' alt='Project Page'></a>
|
| 15 |
</div>
|
| 16 |
|
| 17 |
+
This repository contains pre-trained checkpoints for the dataset introduced in the paper *Wild-Places: A Large-Scale Dataset for Lidar Place Recognition in Unstructured Natural Environments*, which has been published at ICRA2023.
|
|
|
|
| 18 |
|
| 19 |
If you find this dataset helpful for your research, please cite our paper using the following reference:
|
| 20 |
```
|
|
|
|
| 28 |
}
|
| 29 |
```
|
| 30 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 31 |
## Download Instructions
|
| 32 |
|
| 33 |
Our dataset can be downloaded through [The CSIRO Data Access Portal](https://data.csiro.au/collection/csiro:56372?q=wild-places&_st=keyword&_str=1&_si=1). Detailed instructions for downloading the dataset can be found in the README file provided on the data access portal page.
|
| 34 |
|
| 35 |
+
## Training and Benchmarking
|
|
|
|
| 36 |
Here we provided pre-trained checkpoints and results for benchmarking several state-of-the-art LPR methods on the Wild-Places dataset.
|
| 37 |
|
| 38 |
**Update Nov. 2025**: With the release of Wild-Places v3.0, we have also re-run training for two state-of-the-art methods (LoGG3D-Net, MinkLoc3Dv2) on the Wild-Places dataset using expanded batch sizes to provide new training checkpoints which better reflect the capabilities of recent state-of-the-art GPUs. We provide checkpoints and benchmarked results for both the recently trained models and the checkpoints released with the ICRA2023 paper.
|
|
|
|
| 44 |
|ICRA2023| MinkLoc3DV2 | [Link](https://huggingface.co/CSIRORobotics/Wild-Places/resolve/main/ICRA_2023_checkpoints/MinkLoc3Dv2.pth) |
|
| 45 |
|ICRA2023| LoGG3D-Net | [Link](https://huggingface.co/CSIRORobotics/Wild-Places/resolve/main/ICRA_2023_checkpoints/LoGG3D-Net.pth) |
|
| 46 |
|2025 Re-Training| MinkLoc3DV2 | [Link](https://huggingface.co/CSIRORobotics/Wild-Places/resolve/main/2025_updated_checkpoints/MinkLoc3Dv2.pth) |
|
| 47 |
+
|2025 Re-Training| LoGG3D-Net | [Link](https://huggingface.co/CSIRORobotics/Wild-Places/resolve/main/2025_updated_checkpoints/LoGG3D-Net.pth)
|
|
|
|
|
|
|
|
|
|
|
|
|
| 48 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 49 |
|
| 50 |
+
For further instructions on training and evaluating these checkpoints on the Wild-Places dataset, please follow the instructions found at the [Wild-Places GitHub](https://github.com/csiro-robotics/Wild-Places)
|
|
|