> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/datasets/ja/bjon/dataset-versions.md).

# データセットバージョン

学習前に前処理と拡張を行った時点のスナップショットとして、データセットバージョンを作成します。

## 概要

バージョンは、データセット内の画像とラベルの時点スナップショットです。Version を作成すると、前処理ステップや拡張をデータセットに適用できます。

Roboflow でモデルを学習するには、データセットのバージョンを作成する必要があります。

このドキュメントのこのセクションでは、モデル学習の準備方法を説明します。必要な手順は次のとおりです。

{% stepper %}
{% step %}
**Versions ページを開き、新しいバージョンを作成します**

ガイドに従って、 [データセットのバージョンを作成できるページへ進みます](https://docs.roboflow.com/datasets/ja/bjon/dataset-versions/create-a-dataset-version.md).
{% endstep %}

{% step %}
**前処理ステップを選択する**

選択する [前処理ステップ](https://docs.roboflow.com/datasets/ja/bjon/dataset-versions/image-preprocessing.md) モデル学習に必要なものです。
{% endstep %}

{% step %}
**拡張を適用する**

[データセットに必要な拡張を適用します](https://docs.roboflow.com/datasets/ja/bjon/dataset-versions/image-augmentation.md)。さまざまなユースケースに対してどの拡張が適切かを説明するガイドがあります。
{% endstep %}

{% step %}
**バージョンを確認する**

バージョンが作成され、モデル学習に使用できるようになります。
{% endstep %}

{% step %}
**モデルを学習する**

次を参照してください [モデル学習のドキュメント](https://docs.roboflow.com/models) で学習ジョブを設定します。

また、 [データセットのバージョンをエクスポートする](https://docs.roboflow.com/datasets/ja/bjon/dataset-versions/exporting-data.md).
{% endstep %}
{% endstepper %}

## HTTP API

### バージョンを表示

Python SDK、REST API、CLI を使って Roboflow のバージョンに関する情報を取得できます。

#### バージョン ID

Roboflow で生成された各バージョンには、連番の数値 ID が割り当てられます。アプリのバージョンページで確認するか、API でプロジェクトのバージョン一覧を取得して確認できます。

取得したいプロジェクトとバージョンがすでにわかっている場合は、 `/:workspace/:project/:version` エンドポイントを使用できます。プロジェクトのエンドポイントと同様の情報を返しますが、プロジェクトの他のすべてのバージョンは列挙しません。

プロジェクトに関する情報を取得するには、次のエンドポイントに GET リクエストを送信します。

```url
https://api.roboflow.com/roboflow/chess-sample-4ckfl/1?api_key=$ROBOFLOW_API_KEY
```

このエンドポイントは次のレスポンスを返します。

```bash
{
    "workspace": {
        "name": "Roboflow",
        "url": "roboflow",
        "members": 7
    },
    "project": {
        "id": "roboflow/chess-sample-4ckfl",
        "type": "object-detection",
        "name": "チェスのサンプル",
        "created": 1630335544.592,
        "updated": 1630335741.988,
        "images": 12,
        "unannotated": 3,
        "annotation": "pieces",
        "public": false,
        "splits": {
            "test": 1,
            "valid": 2,
            "train": 9
        },
        "classes": {
            "black-knight": 11,
            "black-queen": 4,
            "black-king": 8,
            "white-king": 8,
            "white-pawn": 34,
            "black-bishop": 8,
            "white-rook": 10,
            "black-pawn": 37,
            "white-knight": 10,
            "white-bishop": 11,
            "black-rook": 10,
            "white-queen": 7
        }
    },
    "version": {
        "id": "roboflow/chess-sample-4ckfl/1",
        "name": "拡張済み",
        "created": 1630335698.746,
        "images": 30,
        "splits": {
            "valid": 2,
            "test": 1,
            "train": 27
        },
        "model": {
            "id": "chess-sample-4ckfl/1",
            "endpoint": "https://serverless.roboflow.com/infer/chess-sample-4ckfl/1",
            "start": 1630335799.682,
            "end": 1630337523.889,
            "fromScratch": false,
            "tfjs": true,
            "oak": true,
            "map": "62.87",
            "recall": "85.29",
            "precision": "23.44"
        },
        "preprocessing": {
            "resize": {
                "height": 416,
                "width": 416,
                "format": "Stretch to",
                "enabled": true
            },
            "auto-orient": {
                "enabled": true
            },
            "grayscale": {
                "enabled": true
            }
        },
        "augmentation": {
            "rotate": {
                "degrees": "5",
                "enabled": true
            },
            "brightness": {
                "darken": true,
                "enabled": true,
                "brighten": true,
                "percent": "25"
            },
            "noise": {
                "percent": "2",
                "enabled": true
            },
            "crop": {
                "enabled": true,
                "min": 0,
                "percent": 30
            },
            "flip": {
                "horizontal": true,
                "vertical": false,
                "enabled": true
            },
            "image": {
                "versions": "3",
                "enabled": true
            },
            "exposure": {
                "enabled": true,
                "percent": "25"
            }
        },
        "exports": [
            "yolov5pytorch"
        ],
        "train": {
            "status": "finished",
            "results": {
                "class_map": {
                    "valid": [
                        {
                            "images": "20",
                            "map95": "0.29",
                            "precision": "0.795",
                            "recall": "0.48",
                            "map50": "0.547",
                            "class": "all",
                            "targets": "82"
                        },
                        ...
                    ],
                    "test": [
                        {
                            "images": "10",
                            "map95": "0.478",
                            "precision": "0.846",
                            "recall": "0.759",
                            "map50": "0.844",
                            "class": "all",
                            "targets": "29"
                        },
                        ...
                    ]
                }
            }
        },
        "models": {
            "roboflow-train": {
                "epochs": [
                    {
                        "mAP": "0.5624740875589795",
                        "epoch": "0",
                        "precision": "0.848007354583702",
                        "recall": "0.4796292117720689",
                        "box_loss": "0.04430354",
                        "obj_loss": "0.023823218",
                        "class_loss": "0.012277425",
                        "mAP_50_95": "0.3004394102727502"
                    },
                    {
                        "mAP": "0.5576528999996365",
                        "epoch": "1",
                        "precision": "0.8477760345230224",
                        "recall": "0.47967238365789094",
                        "box_loss": "0.041422606",
                        "obj_loss": "0.020020777",
                        "class_loss": "0.010422977",
                        "mAP_50_95": "0.2943194093111112"
                    },
                    ...
                ]
            }
        },
        "classes": [
            "black-knight",
            "black-queen",
            "black-king",
            "white-king",
            "white-pawn",
            "black-bishop",
            "white-rook",
            "black-pawn",
            "white-knight",
            "white-bishop",
            "black-rook",
            "white-queen"
        ]
    }
}
```

#### キーポイント検出のスケルトン

キーポイント検出プロジェクトのバージョンには、 `スケルトン` フィールドが含まれ、このフィールドには各クラスのバージョンスケルトンが入ります。たとえば、クラスが `人物` には、次のスケルトンが含まれる場合があります。

```json
{
...
"skeletons": {
    "person": {
        "vertices": [
            {
                "color": "#FF8000",
                "id": 0,
                "name": "鼻",
                "x": 0.4546,
                "y": 0.18859999999999996
            },
            {
                "color": "#FF00FF",
                "id": 1,
                "name": "左目"
                "x": 0.478,
                "y": 0.1606
            },
            ...
        ],
        "edges": [
            {
                "color": "#00FFCE",
                "from": 13,
                "to": 15
            },
            ...
        ],
        "symmetries": [
            {
                "direction": "horizontal",
                "points": [1, 2]
            },
            ...
        ]
    }
}
```

注意: vertices は推論予測でインデックスを使ってアクセスしてください `class_id`。その後、vertex `id` を使って、edge（from/to）および symmetries（points）を参照できます。

## Python SDK

### バージョンを表示

バージョン情報を取得するには、プロジェクトを取得して、必要なバージョンをリクエストします。

```python
import roboflow

rf = roboflow.Roboflow(api_key="YOUR_API_KEY")

# プロジェクトを取得
project = rf.workspace().project("PROJECT_ID")

model = project.version("1").model
```

その `model` 変数には、次の JSON 値が含まれます。

```json
{
  "id": "mug-detector-eocwp/12",
  "name": "マグ検出器",
  "version": "12",
  "classes": null,
  "overlap": 30,
  "confidence": 40,
  "stroke": 1,
  "labels": false,
  "format": "json",
  "base_url": "https://serverless.roboflow.com/infer/"
}
```

バージョンの一覧表示と反復処理については、 [ワークスペースとプロジェクトの一覧表示](https://docs.roboflow.com/platform/workspaces/list-workspaces-and-projects#list-projects-and-versions)を参照してください。バージョンをエクスポートするには、 [データセットのバージョンをエクスポート](https://docs.roboflow.com/datasets/ja/bjon/dataset-versions/exporting-data.md#python-sdk).

## CLI

コマンドラインからデータセットのバージョンを一覧表示、確認、エクスポートできます。

### バージョンを一覧表示

```bash
roboflow version list -p <project>
```

例:

```bash
roboflow version list -p my-detector
```

```
ID                              名前              画像数  作成日
my-workspace/my-detector/1      raw               100     2024-01-15
my-workspace/my-detector/2      augmented-640     300     2024-01-20
my-workspace/my-detector/3      augmented-416     250     2024-02-01
```

### バージョンの詳細を取得

```bash
roboflow version get -p <project> <version-number>
```

またはリソースの省略形を使用します:

```bash
roboflow version get my-detector/3
roboflow version get my-workspace/my-detector/3
```

### バージョンをエクスポート

特定の形式でバージョンの非同期エクスポートを開始します:

```bash
roboflow version export -p <project> <version-number> -f <format>
```

例:

```bash
roboflow version export -p my-detector 3 -f yolov8
```

### JSON 出力

すべてのバージョンコマンドは `--json`:

```bash
roboflow version list -p my-detector --json
```

```json
[
  {
    "id": "my-workspace/my-detector/1",
    "name": "生データ",
    "images": 100,
    "created": "2024-01-15T00:00:00"
  }
]
```

## MCP サーバー

AI エージェントを [MCP サーバー](https://docs.roboflow.com/agents/mcp-server) に接続すると、次のツールでデータセットのバージョンを管理できます。

<table data-search="false"><thead><tr><th width="290">ツール</th><th>説明</th></tr></thead><tbody><tr><td><code>versions_generate</code></td><td>任意の前処理と拡張を指定してバージョンを作成します。</td></tr><tr><td><code>versions_get</code></td><td>分割情報と学習情報を含むバージョン情報を取得します。</td></tr><tr><td><code>versions_export</code></td><td>バージョンのデータセットエクスポートを確認または開始します。</td></tr><tr><td><code>versions_delete</code></td><td>バージョンを削除し、ワークスペースのゴミ箱に移動します。</td></tr></tbody></table>

## 次のステップ

* バージョンを使ってモデルを学習します。参照 [モデルを学習する](https://docs.roboflow.com/models).
* 学習可能な形式でバージョンをエクスポートします。参照 [データセットのバージョンをエクスポート](https://docs.roboflow.com/datasets/ja/bjon/dataset-versions/exporting-data.md).
