KITTI深度データセット#
KITTIデータセットは、Karlsruhe市内および周辺を走行する車両から撮影された、実世界の屋外自動運転ベンチマークです。単眼深度推定では、Velodyne HDL-64 LiDARスキャナーから深度のグラウンドトゥルースを取得し、Uhrig et al. 2017の手法で密化しています。生成された深度マップは引き続きスパースで、有効な深度値を持つピクセルは約16~20%です。KITTIはYOLO26-Depthの事前学習データ構成における実世界の屋外走行データソースであり、KITTI Eigen評価ベンチマークとしても使用されます。
主な機能#
- 深度が最大約80 mに及ぶ、実世界の屋外走行シーンです。一般的な屋内の範囲を大きく超えています。
- Velodyne HDL-64 LiDARで取得した深度のグラウンドトゥルースを、Uhrig et al. 2017のSparsity Invariant CNNsアプローチで密化しています。
- 教師信号はスパースで、画像ごとに有効な深度値を持つピクセルは約16~20%のみです。無効なピクセルは損失とメトリクスの計算からマスクされます。
- ステレオ画像ペア(左
image_02、右image_03)は、トレーニングに追加の視点を提供します。 - 深度値は、メートルあたり256単位(
depth_scale: 256)のuint16 PNGとして保存され、Ultralytics深度データセット形式に準拠しています。
データセットの構成#
Ultralyticsが使用するKITTI深度データは、2つのサブセットに分割されています。
- トレーニング分割:55,198枚の画像(左
image_02、右image_03)。公平な評価を維持するため、KITTI Eigenのテスト走行28件はすべてトレーニングから除外されています。 - 評価分割:KITTI Eigenのテスト分割で、グラウンドトゥルースが改善された左カメラの652フレームです。評価では深度の上限を80 mとし、予測とグラウンドトゥルースの間で中央値による(スケールのみの)アライメントを行います。
深度範囲は約80 mに達し、データセットのYAML(depth-kitti.yaml)では、それに応じてmax_depth: 80が設定されています。初回使用時に、YAMLが改善されたグラウンドトゥルース(~14 GB)と対応する元データの走行データ(~175 GB)を自動的にダウンロードし、Ultralytics深度データセット形式に変換します。
YOLO26-Depthにおける役割#
KITTIはYOLO26-Depthの事前学習データ構成に実世界の屋外走行データを提供し、主に屋内データからなる他のデータソースを補完します。また、走行シーンの深度精度を報告するための標準的なKITTI Eigenベンチマークとしても使用されます。
KITTIは、深度ヘッドが上限のない(logモード)設計である理由を示す重要な例です。出力上限を10 mに固定すると、深度80 mの走行シーンを表現できません。ヘッドの出力範囲とmax_depthの処理については、深度タスクのページをご覧ください。
結果#
KITTI Eigenのdelta1精度をモデルサイズ別に示します(値が大きいほど良好です)。
| モデル | KITTI Eigen δ1 |
|---|---|
| YOLO26n-Depth | 0.878 |
| YOLO26s-Depth | 0.879 |
| YOLO26m-Depth | 0.913 |
| YOLO26l-Depth | 0.926 |
| YOLO26x-Depth | 0.932 |
imgsz=768とrect=Falseを使用し、652フレームの標準分割で測定しています。公開済みのKITTIの数値とは直接比較できず、valでは各画像をimgszサイズの正方形に引き伸ばし、スパースなグラウンドトゥルースを最近傍補間でそのサイズにリサンプリングしますが、参照評価ツールでは予測をグラウンドトゥルースの元の解像度に戻してリサイズします;DepthMetricsではグラウンドトゥルースをmax_depthに対してマスクしますが、改良グラウンドトゥルースプロトコルではgt > 0をマスクし、予測のみに上限を設定します;さらに、公開済みの重みは以前の分割でトレーニングされており、このテストフレームのうち72フレームがトレーニングセットに含まれていました。
データセットYAML#
データセットの設定にはYAMLファイルを使用します。YAMLファイルには、データセットのパス、クラス、最大深度などの関連情報が含まれます。
# Ultralytics 🚀 AGPL-3.0 License - https://ultralytics.com/license
# KITTI dataset for monocular depth estimation — real outdoor driving, Velodyne HDL-64 LiDAR (densified), sparse, up to ~80 m
# Documentation: https://docs.ultralytics.com/datasets/depth/kitti
# Example usage: yolo depth train data=depth-kitti.yaml model=yolo26n-depth.pt
# parent
# ├── ultralytics
# └── datasets
# └── depth-kitti ← downloads here (~190 GB archives, ~140 GB converted)
# ├── images/{train,val} # RGB images
# └── depth/{train,val} # paired 16-bit *.png depth maps (images/ -> depth/)
# If an interrupted download leaves a partial dataset, delete the depth-kitti dir and re-run to rebuild it.
# The download only runs when the val images are missing (train is never checked), so a depth-kitti dir
# built before this split fix keeps the old split until it is deleted and rebuilt.
path: depth-kitti # dataset root dir (relative to Ultralytics settings 'datasets_dir')
train: images/train # train images (relative to 'path') 55198 images
val: images/val # val images (relative to 'path') 652 images (KITTI Eigen test split, left camera)
max_depth: 80 # (m) maximum valid depth; GT beyond this is excluded from val metrics
nc: 1
names:
0: depth
channels: 3
depth_scale: 256 # KITTI PNG value 256 = 1 meter
# Download script/URL (optional)
download: |
import shutil
from pathlib import Path
from ultralytics.utils import TQDM
from ultralytics.utils.downloads import download
# The 28 KITTI Eigen test scenes as "<drive> <frame indices>" -> val; every other annotated drive -> train. val is
# the 697-frame Eigen et al. (NeurIPS 2014) test split restricted to frames with improved GT here: 652 left-camera.
EIGEN_TEST = """
2011_09_26_drive_0002 6 9 12 15 18 21 24 27 30 33 36 39 42 45 48 51 54 57 60 63 69
2011_09_26_drive_0009 16 32 48 64 80 96 112 128 144 160 176 196 212 228 244 260 276 292 308 324 340 356 372 388
2011_09_26_drive_0013 5 10 20 30 35 40 45 50 60 65 70 80 85 90 95 100 105 110 115 120 125 130 135
2011_09_26_drive_0020 6 9 12 15 18 21 27 33 36 42 45 48 51 54 57 60 63 66 69 72 75 78
2011_09_26_drive_0023 18 36 54 72 90 108 126 144 162 180 198 216 252 270 288 306 324 342 360 378 396 414 432 450 468
2011_09_26_drive_0027 7 14 21 28 35 42 49 56 63 70 77 84 91 98 112 119 126 133 140 147 161 168 175 182
2011_09_26_drive_0029 14 28 42 56 70 84 98 112 126 140 154 168 182 196 268 296 310 324 338 352 366 380 394 408
2011_09_26_drive_0036 32 64 96 128 160 192 224 256 288 320 352 384 416 448 480 512 544 576 608 640 672 704 768
2011_09_26_drive_0046 5 10 15 20 25 30 35 40 45 50 55 60 65 70 75 80 85 90 95 100 105 110 115
2011_09_26_drive_0048 5 6 7 8 9 10 11 12 13 14 15 16
2011_09_26_drive_0052 6 8 10 12 14 16 18 20 22 26 28 30 32 36 38 40 42 44 46 48 50 52
2011_09_26_drive_0056 11 22 33 44 55 66 77 88 99 110 121 143 154 165 176 187 198 209 220 231 242 253 264 275 286
2011_09_26_drive_0059 14 28 42 56 70 84 98 112 126 140 154 182 196 210 224 238 274 288 302 316 330 344 358
2011_09_26_drive_0064 22 44 66 88 110 154 176 198 220 242 264 286 308 330 352 374 396 418 440 462 484 506 528 550
2011_09_26_drive_0084 49 62 75 88 101 114 127 140 153 179 192 205 218 231 244 257 270 283 296 309 322 335 348 361 374
2011_09_26_drive_0086 7 34 61 88 115 142 169 196 223 250 277 304 331 358 385 412 439 466 493 520 574 601 628 655 682
2011_09_26_drive_0093 16 32 48 64 80 96 112 128 144 160 176 192 208 224 240 256 305 321 337 353 369 385 401 417
2011_09_26_drive_0096 19 38 57 76 95 114 133 152 171 190 209 228 247 266 285 304 323 342 361 380 399 418 437 456
2011_09_26_drive_0101 80 114 148 182 216 284 318 352 386 420 454 488 522 556 590 624 658 692 726 760 794 828 862 896 930
2011_09_26_drive_0106 15 35 43 51 59 67 75 83 91 99 107 115 123 131 139 147 155 163 171 179 187 195 203 211 219
2011_09_26_drive_0117 26 52 78 104 130 156 182 208 234 260 286 312 338 364 390 416 442 468 494 546 572 598 624 650
2011_09_28_drive_0002 6 9 12 18 21 24 30 33 36 39 45 48 51 54 57 60 63 72 78 81 84 87 90
2011_09_29_drive_0071 36 72 108 144 180 216 252 288 324 360 396 432 468 504 540 576 612 735 771 807 879 915 951
2011_09_30_drive_0016 11 22 33 44 55 66 77 88 110 121 132 143 154 165 176 187 198 209 220 231 242 253 264
2011_09_30_drive_0018 107 214 428 535 642 749 856 963 1070 1177 1284 1391 1498 1605 1712 1819 1926 2033 2140 2247 2419 2526 2633 2740
2011_09_30_drive_0027 41 82 123 164 205 246 287 328 369 410 451 492 533 574 615 656 753 794 835 876 917 958 1040 1081
2011_10_03_drive_0027 181 362 543 734 915 1096 1277 1458 1639 1820 2001 2363 2544 2725 2906 3087 3268 3449 3630 3811 3992 4173 4354 4535
2011_10_03_drive_0047 32 64 96 128 160 192 224 288 320 352 384 416 448 480 512 544 576 608 640 672 704 736 768 800"""
EIGEN_TEST = {ln.split()[0]: {int(i) for i in ln.split()[1:]} for ln in EIGEN_TEST.strip().splitlines()}
# Annotated drives excluded from the release training set (raw data was unavailable at build time)
SKIP_DRIVES = {"2011_09_28_drive_0104", "2011_09_28_drive_0135", "2011_09_28_drive_0177", "2011_09_28_drive_0214"}
# Download the improved sparse GT (~14 GB) and the raw recordings it covers (~175 GB)
dir = Path(yaml["path"]) # dataset root dir
base = "https://s3.eu-central-1.amazonaws.com/avg-kitti"
download([f"{base}/data_depth_annotated.zip"], dir=dir / "source", delete=True, exist_ok=True)
gt_drives = sorted(p for p in (dir / "source" / "data_depth_annotated").glob("*/*_sync") if p.name[:-5] not in SKIP_DRIVES)
urls = [f"{base}/raw_data/{p.name[:-5]}/{p.name}.zip" for p in gt_drives]
download(urls, dir=dir / "source" / "raw", delete=True, exist_ok=True, threads=4)
# Convert: GT PNGs are uint16 meters*256; RGB frames come from the matching raw drive
for split in ("train", "val"):
(dir / "images" / split).mkdir(parents=True, exist_ok=True)
(dir / "depth" / split).mkdir(parents=True, exist_ok=True)
for gt in TQDM(gt_drives, desc="Converting"):
drive = gt.name[:-5] # 2011_09_26_drive_0002
split = "val" if drive in EIGEN_TEST else "train"
# val is the canonical Eigen test split: left camera only, and only its 652 listed frames
for cam in ("image_02",) if split == "val" else ("image_02", "image_03"):
for png in sorted((gt / "proj_depth" / "groundtruth" / cam).glob("*.png")):
if split == "val" and int(png.stem) not in EIGEN_TEST[drive]:
continue
name = f"{drive}_{cam[-2:]}_{png.stem}"
png.replace(dir / "depth" / split / f"{name}.png")
raw = dir / "source" / "raw" / drive[:10] / gt.name / cam / "data" / png.name
raw.replace(dir / "images" / split / f"{name}.png")
shutil.rmtree(dir / "source")使用方法#
KITTIデータセットでYOLO26n-Depthモデルを100エポックトレーニングするには、以下のコードスニペットを使用できます。使用可能な引数の一覧については、モデルのトレーニングページをご覧ください。
from ultralytics import YOLO
# 事前学習済みの深度モデルを読み込む
model = YOLO("yolo26n-depth.pt")
# KITTIでモデルをトレーニングします
results = model.train(data="depth-kitti.yaml", epochs=100, imgsz=640)事前学習済みモデル#
事前学習済みYOLO26-Depthモデルは、名前で初めて参照されたときに、Ultralyticsのv8.4.0 assets releaseから自動ダウンロードされます。
引用と謝辞#
研究または開発でKITTIデータセットを使用する場合は、以下の論文を引用してください。
@article{geiger2013vision,
title={Vision meets Robotics: The KITTI Dataset},
author={Geiger, Andreas and Lenz, Philip and Stiller, Christoph and Urtasun, Raquel},
journal={The International Journal of Robotics Research},
year={2013},
publisher={SAGE Publications}
}
@inproceedings{uhrig2017sparsity,
title={Sparsity Invariant CNNs},
author={Uhrig, Jonas and Schneider, Nick and Schneider, Lukas and Franke, Uwe and Brox, Thomas and Geiger, Andreas},
booktitle={International Conference on 3D Vision (3DV)},
year={2017}
}KITTIデータセットを作成・維持しているKarlsruhe Institute of TechnologyおよびToyota Technological Institute at Chicagoと、高密度な教師信号を可能にする深度密化手法を開発したUhrig et al.に感謝いたします。
よくある質問#
KITTIはYOLO26-Depthの事前学習データ構成における実世界の屋外走行データソースであり、KITTI Eigen評価ベンチマークとしても使用されます。Velodyne LiDARの深度は約80 mに達するため、深度ヘッドには屋内向けの固定上限ではなく、上限のない設計が採用されています。
Ultralyticsの設定では、左右カメラの画像から55,198枚をトレーニングに使用し、KITTI Eigenのテスト走行28件をすべて除外します。評価には、グラウンドトゥルースが改善された左カメラのEigenテストフレーム652枚を使用します。深度PNGはメートルあたり256単位(
depth_scale: 256)で、YAMLではmax_depth: 80が設定されています。結果の値は、
imgsz=768とrect=Falseを使用するUltralyticsバリデーターによるものです。このバリデーターは、画像を正方形の入力サイズにリサイズし、max_depthに対してグラウンドトゥルースをマスクしたうえで、画像ごとにスケールをアライメントしてメトリクスを計算し、検証セット全体で平均します。KITTIの参照評価ツールでは異なるプロトコルを使用するため、数値を直接比較することはできません。