JKnights commited on
Commit
e0d183a
·
verified ·
1 Parent(s): f504bb3

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +11 -41
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
- ![](./utils/docs/nov2025_wildplaces_benchmarking_results.png)
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
- ## Thanks
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
+ ![](https://raw.githubusercontent.com/csiro-robotics/Wild-Places/refs/heads/main/utils/docs/teaser_image.png)
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)