データセットをダウンロード

ローカルで学習するために、画像とアノテーションのデータセットを書き出します。

Web アプリ

参照してください Roboflow Universe データセットをダウンロードする Roboflow Universe からデータセットをダウンロードしたい場合は、ドキュメントを参照してください。

Roboflow からデータセットをダウンロードまたはエクスポートするには、まずプロジェクトのデータセットページに移動します。

画像検索バーの右側にある［Export］をクリックします。

データをどの形式でダウンロードするかを選べるモーダルが表示されます。Roboflow は 50 種類以上の異なるアノテーション形式.

データセットを zip ファイルとして直接ダウンロードすることも、データをローカルにダウンロードするためのコードスニペットを提供してもらうこともできます。

コードオプションを選ぶと、Python のコードスニペット、curl コマンド、またはデータセットへの直接ダウンロードリンクから選べます。

FAQ

なぜ zip 化した画像数が UI と一致しないのですか?

これには 2 つの可能性があります:

• それぞれのクラウドサービスで、画像のダウンロードにランダムな失敗が発生した。

• 画像が破損しているかサイズが大きすぎるため、いくつかのエラーが発生している。

当社のアプリケーションはエクスポート zip を 1 回だけ生成し、その後、同じ形式（例: COCO）が選択された場合は同じエクスポートを再ダウンロードします。ダウンロードで画像数がずれていることに気づいた場合は、いつでも新しいバージョンを作成して再ダウンロードできます。

\

ダウンロードされた画像は元の品質ですか?

いいえ。学習の遅延を防ぐため、学習速度と十分なモデル性能に必要な解像度のバランスを保つレベルで画像を圧縮しています。

単一の元画像品質の画像をダウンロードしたい場合は、データセット内の画像をクリックして［Download Image］を選択してください。

複数の元画像品質の画像をダウンロードしたい場合は、当社の CLI または当社の Image Search API.

Python SDK

プロジェクトに生成済みのバージョンがある場合、対応するエクスポート形式で画像とアノテーションをダウンロードできます。使用して Version.download() 同期的な「取得して解凍」フローでは、 Version.export() を使用して、ダウンロードせずに Roboflow にエクスポートを非同期で（再）生成するよう依頼します。

バージョンをダウンロードする

import roboflow

rf = roboflow.Roboflow(api_key="YOUR_API_KEY")
project = rf.workspace().project("my-detector")
version = project.version(3)

dataset = version.download(
    model_format="yolov8",      # または "voc", "coco", "darknet" など
    location="./my-detector-v3", # 任意、既定値は ./<project>-<version>
    overwrite=False,             # 任意、既存のディレクトリを再ダウンロードする場合は True に設定
)

print(dataset.location)  # ディスク上のパス

パラメータ

• model_format (str) - エクスポート形式。一般的な値: yolov8, yolov11, voc, coco, darknet, tfrecord, createml, multiclass。完全な一覧はプロジェクトタイプに依存します。無効な値を渡すと、エラーとして完全な一覧が返されます。

• location (str, optional) - 出力先ディレクトリ。既定値は ./<project-slug>-<version>.

• overwrite (bool, default False) - 対象ディレクトリが既に存在していても再ダウンロードします。

返される Dataset オブジェクトには .location 展開済みディレクトリを指す属性があります。

ダウンロードせずに新しいエクスポートを実行する

ok = version.export(model_format="coco")

これにより、サーバー側でエクスポートの再生成が開始されます。生成が完了すると呼び出しは戻り、失敗した場合は RuntimeError を発生させます。その後、続けて download() が新しく生成された成果物を取得します。

公開 Universe データセット

公開 Universe プロジェクトをダウンロードするのにワークスペースのメンバーである必要はありません。API キーに Universe へのアクセス権があれば十分です:

project = rf.workspace("roboflow-100").project("poker-cards-cxcvz")
project.version(1).download("yolov8", location="./poker-cards")

CLI

プロジェクトに保存済みのバージョンがある場合は、コマンドラインを使ってそのバージョンの画像とアノテーションをダウンロードできます。

コマンド

roboflow version download <workspace/project/version> -f <format> -l <location>

または短縮エイリアスを使用します:

roboflow download <workspace/project/version> -f <format> -l <location>

次のとおりです:

• <format> はサポートされているデータセット形式のいずれかです（ voc, yolov8, coco, darknetなど）。 roboflow version download --help を実行すると、完全な一覧を確認できます。

• <location> はダウンロード先のローカルパスです（任意、既定値は現在のディレクトリ）

• データセット URL では resource shorthand: workspace/project/version, project/versionを使うか、あるいは -p project とバージョン番号を指定します。

例

VOC 形式でデータセットのバージョンをダウンロード:

roboflow download -f voc -l ./my-dataset my-workspace/hand-gestures/1

プロジェクトの短縮表記を使ってダウンロード（既定のワークスペースを使用します）:

roboflow download -f yolov8 hand-gestures/1

から公開データセットをダウンロード Roboflow Universe:

roboflow download -f coco joseph-nelson/chess-pieces-new/25

JSON出力

スクリプトや自動化では --json を使って構造化された出力を取得します:

roboflow download hand-gestures/1 -f yolov8 --json

{
  "workspace": "my-workspace",
  "project": "hand-gestures",
  "version": 1,
  "format": "yolov8",
  "location": "./hand-gestures-1"
}