Link to this sectionTT100K データセット#
Tsinghua-Tencent 100K (TT100K) データセットは、物体検出のための交通標識ベンチマークであり、ZhuらによってCVPR 2016の論文『Traffic-Sign Detection and Classification in the Wild』のために作成されました。UltralyticsのTT100K構成では、221の交通標識カテゴリにわたる 16,817枚の画像(学習用6,105枚 / 検証用7,641枚 / テスト用3,071枚)が提供されており、元のベンチマークでは30,000以上の標識インスタンスが報告されています。名称にある「100K」は、ベンチマーク作成元となった約10万枚のTencentストリートビュー画像を指すものであり、ダウンロードして学習に使用する画像の数ではありません。元の論文では最低100個の学習インスタンスを持つカテゴリのみが保持されているため、一般的に使用される45クラスのサブセットが存在しますが、Ultralyticsの構成では注釈付きの全221カテゴリが保持されています(その多くはスパースです)。
高解像度のストリートビュー画像は、照明、天候、視野角、距離に大きなばらつきがあり、TT100Kを現実の運転シーンにおける小物体検出のための困難なベンチマークにしています。
Link to this section主な特徴#
- マルチクラス検出: 中国の速度制限、禁止、警告、高さ/幅制限、および情報標識を網羅する221の交通標識カテゴリ。
- 高解像度: 2048×2048ピクセルの画像であり、大きなクローズアップから微細な検出を必要とする遠方の小さなマーカーまで、標識の範囲が広がります。
- 現実の条件: 天候、照明、視野角、遮蔽における大きな変化。
- バウンディングボックス注釈: 各標識には、自動変換後のYOLO形式でのクラスとバウンディングボックスがラベル付けされています。
- 定義済みスプリット: 一貫した評価のための固定された学習/検証/テストスプリット(6,105 / 7,641 / 3,071枚の画像)。
Link to this sectionデータセットの構造#
Ultralytics TT100K構成は3つのサブセットに分割されており、すべて同じ221カテゴリを共有しています。
| 分割 | 画像 | 説明 |
|---|---|---|
| トレーニング | 6,105 | 検出器の学習に使用されるラベル付き交通シーン画像 |
| バリデーション | 7,641 | 評価に使用されるデータセットの元の「その他」のスプリット |
| テスト | 3,071 | 学習済みモデルの最終評価のために保持された画像 |
221のカテゴリは、いくつかの主要なグループに整理されています。
- 速度制限標識 — 禁止制限
pl*(例: pl5–pl120)および最低速度pm*(例: pm5–pm55)。 - 禁止標識 — 一般的な禁止
p1–p29、進入禁止/駐車禁止pn/pne、および制限pr*(pr10–pr100)。 - 警告標識 — 交差点、急カーブ、滑りやすい道路、工事などの道路上の危険に対する
w1–w67。 - 高さ/幅制限標識 — 高さ制限
ph*(例: ph2–ph5.5)および幅制限pb/pw*。 - 情報標識 — 一般情報
i1–i15、速度制限情報il*(il50–il110)、その他io、および補助情報板ip。
Link to this sectionアプリケーション#
TT100Kは、現実の条件下での交通標識認識の構築およびベンチマーク作成に広く使用されています。一般的なアプリケーションには以下が含まれます。
- 自動運転認識システム
- 先進運転支援システム (ADAS)
- 交通監視および道路インフラ分析
- 都市計画および交通流研究
- 高解像度画像における小物体のコンピュータビジョン研究
Link to this sectionデータセット YAML#
TT100K.yaml ファイルは、データセットの構成(データセットパス、クラス名、および自動ダウンロードと変換スクリプト)を定義します。これは https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/datasets/TT100K.yaml のUltralyticsリポジトリで管理されています。
# Ultralytics 🚀 AGPL-3.0 License - https://ultralytics.com/license
# Tsinghua-Tencent 100K (TT100K) dataset https://cg.cs.tsinghua.edu.cn/traffic-sign/ by Tsinghua University
# Documentation: https://cg.cs.tsinghua.edu.cn/traffic-sign/tutorial.html
# Paper: Traffic-Sign Detection and Classification in the Wild (CVPR 2016)
# License: CC BY-NC 2.0 license for non-commercial use only
# Example usage: yolo train data=TT100K.yaml
# parent
# ├── ultralytics
# └── datasets
# └── TT100K ← downloads here (~18 GB)
# Train/val/test sets as 1) dir: path/to/imgs, 2) file: path/to/imgs.txt, or 3) list: [path/to/imgs1, path/to/imgs2, ..]
path: TT100K # dataset root dir
train: images/train # train images (relative to 'path') 6105 images
val: images/val # val images (relative to 'path') 7641 images (original 'other' split)
test: images/test # test images (relative to 'path') 3071 images
# Classes (221 traffic sign categories, 45 with sufficient training instances)
names:
0: i1
1: i10
2: i11
3: i12
4: i13
5: i14
6: i15
7: i2
8: i3
9: i4
10: i5
11: il100
12: il110
13: il50
14: il60
15: il70
16: il80
17: il90
18: io
19: ip
20: p1
21: p10
22: p11
23: p12
24: p13
25: p14
26: p15
27: p16
28: p17
29: p18
30: p19
31: p2
32: p20
33: p21
34: p22
35: p23
36: p24
37: p25
38: p26
39: p27
40: p28
41: p3
42: p4
43: p5
44: p6
45: p7
46: p8
47: p9
48: pa10
49: pa12
50: pa13
51: pa14
52: pa8
53: pb
54: pc
55: pg
56: ph1.5
57: ph2
58: ph2.1
59: ph2.2
60: ph2.4
61: ph2.5
62: ph2.8
63: ph2.9
64: ph3
65: ph3.2
66: ph3.5
67: ph3.8
68: ph4
69: ph4.2
70: ph4.3
71: ph4.5
72: ph4.8
73: ph5
74: ph5.3
75: ph5.5
76: pl10
77: pl100
78: pl110
79: pl120
80: pl15
81: pl20
82: pl25
83: pl30
84: pl35
85: pl40
86: pl5
87: pl50
88: pl60
89: pl65
90: pl70
91: pl80
92: pl90
93: pm10
94: pm13
95: pm15
96: pm1.5
97: pm2
98: pm20
99: pm25
100: pm30
101: pm35
102: pm40
103: pm46
104: pm5
105: pm50
106: pm55
107: pm8
108: pn
109: pne
110: po
111: pr10
112: pr100
113: pr20
114: pr30
115: pr40
116: pr45
117: pr50
118: pr60
119: pr70
120: pr80
121: ps
122: pw2
123: pw2.5
124: pw3
125: pw3.2
126: pw3.5
127: pw4
128: pw4.2
129: pw4.5
130: w1
131: w10
132: w12
133: w13
134: w16
135: w18
136: w20
137: w21
138: w22
139: w24
140: w28
141: w3
142: w30
143: w31
144: w32
145: w34
146: w35
147: w37
148: w38
149: w41
150: w42
151: w43
152: w44
153: w45
154: w46
155: w47
156: w48
157: w49
158: w5
159: w50
160: w55
161: w56
162: w57
163: w58
164: w59
165: w60
166: w62
167: w63
168: w66
169: w8
170: wo
171: i6
172: i7
173: i8
174: i9
175: ilx
176: p29
177: w29
178: w33
179: w36
180: w39
181: w4
182: w40
183: w51
184: w52
185: w53
186: w54
187: w6
188: w61
189: w64
190: w65
191: w67
192: w7
193: w9
194: pax
195: pd
196: pe
197: phx
198: plx
199: pmx
200: pnl
201: prx
202: pwx
203: w11
204: w14
205: w15
206: w17
207: w19
208: w2
209: w23
210: w25
211: w26
212: w27
213: pl0
214: pl4
215: pl3
216: pm2.5
217: ph4.4
218: pn40
219: ph3.3
220: ph2.6
# Download script/URL (optional) ---------------------------------------------------------------------------------------
download: |
import json
import shutil
from pathlib import Path
from PIL import Image
from ultralytics.utils import TQDM
from ultralytics.utils.downloads import download
def tt100k2yolo(dir):
"""Convert TT100K annotations to YOLO format with images/{split} and labels/{split} structure."""
data_dir = dir / "data"
anno_file = data_dir / "annotations.json"
print("Loading annotations...")
with open(anno_file, encoding="utf-8") as f:
data = json.load(f)
# Build class name to index mapping from yaml
names = yaml["names"]
class_to_idx = {v: k for k, v in names.items()}
# Create directories
for split in ["train", "val", "test"]:
(dir / "images" / split).mkdir(parents=True, exist_ok=True)
(dir / "labels" / split).mkdir(parents=True, exist_ok=True)
print("Converting annotations to YOLO format...")
skipped = 0
for img_id, img_data in TQDM(data["imgs"].items(), desc="Processing"):
img_path_str = img_data["path"]
if "train" in img_path_str:
split = "train"
elif "test" in img_path_str:
split = "test"
else:
split = "val"
# Source and destination paths
src_img = data_dir / img_path_str
if not src_img.exists():
continue
dst_img = dir / "images" / split / src_img.name
# Get image dimensions
try:
with Image.open(src_img) as img:
img_width, img_height = img.size
except Exception as e:
print(f"Error reading {src_img}: {e}")
continue
# Copy image to destination
shutil.copy2(src_img, dst_img)
# Convert annotations
label_file = dir / "labels" / split / f"{src_img.stem}.txt"
lines = []
for obj in img_data.get("objects", []):
category = obj["category"]
if category not in class_to_idx:
skipped += 1
continue
bbox = obj["bbox"]
xmin, ymin = bbox["xmin"], bbox["ymin"]
xmax, ymax = bbox["xmax"], bbox["ymax"]
# Convert to YOLO format (normalized center coordinates and dimensions)
x_center = ((xmin + xmax) / 2.0) / img_width
y_center = ((ymin + ymax) / 2.0) / img_height
width = (xmax - xmin) / img_width
height = (ymax - ymin) / img_height
# Clip to valid range
x_center = max(0, min(1, x_center))
y_center = max(0, min(1, y_center))
width = max(0, min(1, width))
height = max(0, min(1, height))
cls_idx = class_to_idx[category]
lines.append(f"{cls_idx} {x_center:.6f} {y_center:.6f} {width:.6f} {height:.6f}\n")
# Write label file
if lines:
label_file.write_text("".join(lines), encoding="utf-8")
if skipped:
print(f"Skipped {skipped} annotations with unknown categories")
print("Conversion complete!")
# Download
dir = Path(yaml["path"]) # dataset root dir
urls = ["https://cg.cs.tsinghua.edu.cn/traffic-sign/data_model_code/data.zip"]
download(urls, dir=dir, curl=True, threads=1)
# Convert
tt100k2yolo(dir)Link to this section使用方法#
TT100Kは、初めて学習を実行する際に自動的にダウンロードされ、約18 GBの空きディスク容量が必要です。初回使用時には、ダウンロードスクリプトが元のデータを取得し、注釈をYOLO形式に変換します。これには数分かかる場合があります。
TT100Kデータセットで画像サイズ640を使用してYOLO26nモデルを100エポック学習するには、以下のコードスニペットを使用できます。利用可能な引数の包括的なリストについては、モデルの学習ページを参照してください。
from ultralytics import YOLO
# Load a model
model = YOLO("yolo26n.pt") # load a pretrained model (recommended for training)
# Train the model - dataset will auto-download on first run
results = model.train(data="TT100K.yaml", epochs=100, imgsz=640)追加の交通標識画像にラベルを付け、ブラウザでTT100Kの学習実行を管理するには、Ultralytics Platformを使用してください。
Link to this sectionサンプルデータとアノテーション#
TT100Kの画像は、交通標識がフレームのほんの一部しか占めない2048×2048のストリートシーンです。1枚の画像には、異なるスケールや距離で複数の標識が含まれることがあり、一部は車両、植生、または構造物によって部分的に隠れていたり、昼夜や晴れ/雨といった条件下で撮影されていたりします。この小物体の混在と挑戦的な条件が、このデータセットを検出器の堅牢性を試す強力なテストにしています。
Link to this section引用と謝辞#
研究や開発作業で TT100K データセットを使用する場合は、以下の論文を引用してください。
@InProceedings{Zhu_2016_CVPR,
author = {Zhu, Zhe and Liang, Dun and Zhang, Songhai and Huang, Xiaolei and Li, Baoli and Hu, Shimin},
title = {Traffic-Sign Detection and Classification in the Wild},
booktitle = {The IEEE Conference on Computer Vision and Pattern Recognition (CVPR)},
month = {June},
year = {2016}
}コンピュータビジョンおよび自動運転コミュニティのためにこの貴重なリソースを作成・維持してくださった清華大学とTencentのコラボレーションに感謝いたします。TT100K データセットの詳細については、公式データセットウェブサイトをご覧ください。
Link to this sectionよくある質問 (FAQ)#
Link to this sectionTT100K データセットは何に使用されますか?#
Tsinghua-Tencent 100K (TT100K) データセットは、現実の条件下での交通標識の検出および分類に使用されます。その221のカテゴリと高解像度のストリートビュー画像は、自動運転認識、先進運転支援システム (ADAS)、および小物体検出研究のための共通ベンチマークとなっています。
Link to this sectionTT100Kデータセットには何枚の画像が含まれていますか?#
Ultralytics TT100K構成には16,817枚の画像が含まれています:学習用に6,105枚、検証用に7,641枚(データセットの元の「その他」スプリット)、テスト用に3,071枚です。詳細な内訳については、データセット構成セクションを参照してください。
Link to this section約16,800枚しかないのになぜ100Kと呼ばれるのですか?#
「100K」は、元のベンチマークの作成元となった約10万枚のTencentストリートビュー画像を指しています。Ultralytics検出構成では、そのうち16,817枚がYOLO形式のラベル付きで提供されており、その名称は学習セットのサイズではなく、ソースコレクションを反映しています。
Link to this sectionTT100Kには何種類の交通標識カテゴリがありますか?#
TT100Kは、速度制限、禁止、警告、高さ/幅制限、および情報標識にわたる221のカテゴリを定義しています。元の論文では最低100個の学習インスタンスを持つ45カテゴリのみが保持されていますが、Ultralytics構成では全221カテゴリが保持されています。グループの内訳についてはデータセット構成を参照してください。
Link to this sectionTT100Kデータセットのダウンロードサイズはどれくらいですか?#
TT100Kは約18 GBあり、data="TT100K.yaml" で学習を初めて実行する際に自動的にダウンロードされるため、手動ダウンロードは不要です。スクリプトは、初回実行時に元の注釈をYOLO形式に変換します。
Link to this sectionTT100KデータセットでYOLO26モデルを学習するにはどうすればよいですか?#
TT100KでYOLO26nモデルを画像サイズ640で100エポック学習します:
from ultralytics import YOLO
# Load a model
model = YOLO("yolo26n.pt") # load a pretrained model (recommended for training)
# Train the model
results = model.train(data="TT100K.yaml", epochs=100, imgsz=640)詳細な設定については、学習ページおよびモデル学習のヒントを参照してください。
Link to this sectionTT100Kの大きな2048×2048画像をどのように扱えばよいですか?#
初期実験には imgsz=640 から始め、十分なGPUメモリがある場合は imgsz=1280 に上げてください(その際 batch を小さくします)。高解像度の方が、小さくて遠くにある標識の復元に役立つためです。
model.train(data="TT100K.yaml", imgsz=1280, batch=4) # higher resolution for small signsまた、データ拡張を調整したり、非常に小さな物体に対してはタイリング戦略を検討したりすることも可能です。詳細についてはモデル学習のヒントを参照してください。