Skip to content

Commit efa7e15

Browse files
committed
Add Dataset links
1 parent d58c683 commit efa7e15

1 file changed

Lines changed: 30 additions & 20 deletions

File tree

docs/_pages/datasets.md

Lines changed: 30 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -15,16 +15,17 @@ This page summarizes the dataset adapters available in PerceptionMetrics and the
1515
| --- | --- | --- | --- | --- |
1616
| GAIA | Segmentation | Image, LiDAR | `gaia` | CLI and library |
1717
| Generic | Segmentation | Image, LiDAR | `generic` | CLI and library |
18-
| GOOSE | Segmentation | Image, LiDAR | `goose` | CLI and library |
19-
| RELLIS-3D | Segmentation | Image, LiDAR | `rellis3d` | CLI and library |
20-
| RUGD | Segmentation | Image | `rugd` | CLI and library |
21-
| WildScenes | Segmentation | Image, LiDAR | `wildscenes` | Library adapter |
22-
| Cityscapes | Segmentation | Image | `cityscapes` | Library adapter |
23-
| COCO | Object detection | Image | `coco` | CLI and library |
24-
| YOLO | Object detection | Image | `yolo` | Library adapter |
25-
| nuImages | Segmentation, object detection | Image | `nuimages` | Library adapter |
26-
27-
The CLI currently constructs datasets through `perceptionmetrics.cli.get_dataset`. If a dataset appears in the library registry but is not handled by that CLI helper, use it from Python until CLI wiring is added.
18+
| [GOOSE](https://goose-dataset.de/) | Segmentation | Image, LiDAR | `goose` | CLI and library |
19+
| [RELLIS-3D](https://github.com/unmannedlab/RELLIS-3D) | Segmentation | Image, LiDAR | `rellis3d` | CLI and library |
20+
| [RUGD](http://rugd.vision/) | Segmentation | Image | `rugd` | CLI and library |
21+
| [WildScenes](https://github.com/csiro-robotics/WildScenes) | Segmentation | Image, LiDAR | `wildscenes` | CLI and library |
22+
| [Cityscapes](https://www.cityscapes-dataset.com/) | Segmentation | Image | `cityscapes` | CLI and library |
23+
| [SemanticKITTI](https://semantic-kitti.org/) | Segmentation | LiDAR | `semantickitti_lidar_segmentation` | CLI and library |
24+
| [COCO](https://cocodataset.org/#home) | Object detection | Image | `coco` | CLI and library |
25+
| [YOLO](https://docs.ultralytics.com/datasets/detect/) | Object detection | Image | `yolo` | CLI and library |
26+
| [nuImages](https://www.nuscenes.org/nuimages) | Segmentation, object detection | Image | `nuimages` | CLI and library |
27+
28+
The CLI constructs datasets through `perceptionmetrics.cli.get_dataset`, while the same adapters can also be used directly from Python.
2829

2930
## Common Concepts
3031

@@ -149,9 +150,9 @@ The default train, validation, and test split assignment is built into the adapt
149150

150151
## WildScenes
151152

152-
WildScenes supports image and LiDAR semantic segmentation through library adapters. The adapters expect official CSV split files and use ontology definitions embedded in the adapter source.
153+
WildScenes supports image and LiDAR semantic segmentation through the CLI and Python API. The adapters expect official CSV split files and use ontology definitions embedded in the adapter source.
153154

154-
Expected inputs in Python:
155+
Expected inputs:
155156

156157
- `dataset_dir`: root of the WildScenes data
157158
- `split_dir`: directory containing `train.csv`, `val.csv`, and `test.csv`
@@ -160,9 +161,9 @@ Use the 2D split files for `WildscenesImageSegmentationDataset` and the 3D split
160161

161162
## Cityscapes
162163

163-
Cityscapes supports image semantic segmentation through the Python API.
164+
Cityscapes supports image semantic segmentation through the CLI and Python API.
164165

165-
Expected inputs in Python:
166+
Expected inputs:
166167

167168
- One or more of `train_dataset_root`, `val_dataset_root`, `test_dataset_root`
168169
- Images under `leftImg8bit_trainvaltest/leftImg8bit/<split>/<city>/`
@@ -172,6 +173,18 @@ Expected inputs in Python:
172173

173174
The adapter can build either Cityscapes label-id ontologies or train-id ontologies. When using train IDs, provide train-id labels with `label_suffix="_gtFine_labelTrainIds.png"`.
174175

176+
## SemanticKITTI
177+
178+
SemanticKITTI supports LiDAR semantic segmentation through the CLI and Python API.
179+
180+
Expected inputs:
181+
182+
- `dataset_dir`: directory where SemanticKITTI has been extracted
183+
- `config_fname`: SemanticKITTI YAML config containing labels, colors, learning maps, and splits
184+
- `split`, optionally restricting the loaded samples to one split
185+
186+
The adapter reads point clouds from `velodyne` folders and labels from `labels` folders. It can build raw label-ID ontologies and train-ID ontology translations from the SemanticKITTI YAML config.
187+
175188
## COCO
176189

177190
COCO supports image object detection and is available from the CLI and Python API.
@@ -198,7 +211,7 @@ The CLI currently supports one COCO split at a time. The adapter looks for an im
198211

199212
## YOLO
200213

201-
YOLO supports image object detection through the Python API. The adapter reads an Ultralytics-style dataset YAML file.
214+
YOLO supports image object detection through the CLI and Python API. The adapter reads an Ultralytics-style dataset YAML file.
202215

203216
Expected YAML fields:
204217

@@ -216,13 +229,10 @@ The adapter expects labels in matching `labels/<split>` directories and converts
216229

217230
## nuImages
218231

219-
nuImages supports image object detection and image semantic segmentation through the Python API.
232+
nuImages supports image object detection and image semantic segmentation through the CLI and Python API.
220233

221-
Expected inputs in Python:
234+
Expected inputs:
222235

223236
- `dataset_dir`: nuImages root directory
224237
- `version`, defaulting to `v1.0-mini`
225238
- `split`, defaulting to `train`
226-
227-
228-

0 commit comments

Comments
 (0)