翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# 画像の分類
このチュートリアルでは、イメージに含まれるオブジェクト、シーン、概念を分類するモデルのプロジェクトとデータセットを作成する方法を説明します。このモデルはイメージ全体を分類します。例えば、このチュートリアルに従うと、リビングルームやキッチンなどの家庭の場所を認識するようにモデルをトレーニングできます。このチュートリアルでは、モデルを使用してイメージを分析する方法も説明します。
このチュートリアルを開始する前に、「[Amazon Rekognition Custom Labels について](understanding-custom-labels.md)」を読むことをお勧めします。
このチュートリアルでは、ローカルコンピュータからイメージをアップロードして、トレーニングデータセットとテストデータセットを作成します。後で、トレーニングおよびテストデータセットのイメージに画像レベルのラベルを割り当てます。
作成したモデルでは、トレーニングデータセットのイメージに割り当てたイメージレベルのラベルセットに属するものとしてイメージを分類します。例えば、トレーニングデータセット内のイメージレベルのラベルのセットが、`kitchen`、`living_room`、`patio`、および `backyard` の場合、モデルは 1 つのイメージ内のそれらのイメージレベルのラベルをすべて検出できる可能性があります。
**注記**
イメージ上のオブジェクトの位置を調べるなど、さまざまな目的でモデルを作成できます。詳細については、「[モデルタイプの決定](understanding-custom-labels.md#tm-intro-model-type)」を参照してください。
## ステップ 1: イメージを集める
2 セットのイメージが必要です。1 セットはトレーニングデータセットに追加します。もう 1 つのセットはテストデータセットに追加します。イメージは、モデルが分類するオブジェクト、シーン、概念を表している必要があります。イメージは、PNG または JPEG 形式であることが必要です。詳細については、「[イメージの準備](md-prepare-images.md)」を参照してください。
トレーニングデータセットには 10 枚以上、テストデータセットには 10 枚以上のイメージが必要です。
まだイメージがない場合は、*[ルーム]* サンプル分類プロジェクトのイメージを使用してください。プロジェクトを作成すると、トレーニングイメージとテストイメージは次の Amazon S3 バケットの場所に配置されます。
+ トレーニングイメージ - `s3://custom-labels-console-region-numbers/assets/rooms_version number_test_dataset/`
+ テストイメージ - `s3://custom-labels-console-region-numbers/assets/rooms_version number_test_dataset/`
`region` は、Amazon Rekognition Custom Labels コンソールを使用している AWS リージョンです。 `numbers`は、コンソールがバケット名に割り当てる値です。 `Version number`は、サンプルプロジェクトのバージョン番号で、1 から始まります。
以下の手順では、Rooms プロジェクトのイメージを、コンピュータ上の `training` および `test` という名前のローカルフォルダに保存します。
**Rooms サンプルプロジェクトのイメージファイルをダウンロードするには**
1. Rooms プロジェクトを作成します。詳細については、「[ステップ 1: プロジェクト例を選択する](gs-step-choose-example-project.md)」を参照してください。
1. コマンドプロンプトを開き、次のコマンドを入力してトレーニングイメージをダウンロードします。
```
aws s3 cp s3://custom-labels-console-region-numbers/assets/rooms_version number_training_dataset/ training --recursive
```
1. コマンドプロンプトで、次のコマンドを入力してテストイメージをダウンロードします。
```
aws s3 cp s3://custom-labels-console-region-numbers/assets/rooms_version number_test_dataset/ test --recursive
```
1. 2 つのイメージをトレーニングフォルダから任意の別のフォルダに移動します。このイメージを使用して、トレーニングしたモデルを [ステップ 9: モデルを使用してイメージを分析する](#tutorial-step-get-a-prediction) で試してみます。
## ステップ 2: クラスを決める
モデルで検索するクラスのリストを作成します。例えば、家の部屋を認識するようにモデルをトレーニングする場合、次のイメージを `living_room` として分類できます。
![\[暖炉、豪華なソファ、アームチェアが配置され、屋外を見渡せる窓のある居心地の良いリビングルーム。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/customlabels-dg/images/image-classification.jpg)
各クラスはイメージレベルのラベルにマップされます。後で、トレーニングおよびテストデータセットのイメージに画像レベルのラベルを割り当てます。
Rooms サンプルプロジェクトのイメージを使用している場合、イメージレベルのラベルは、*裏庭*、*浴室*、*寝室*、*クローゼット*、*entry\$1way*、*floor\$1plan*、*front\$1yard*、*kitchen*、*living\$1space*、および *パティオ*です。
## ステップ 3: プロジェクトを作成する
データセットとモデルを管理するには、プロジェクトを作成します。プロジェクトごとに、家の中の部屋を認識するなど、単一のユースケースに対応する必要があります。
**プロジェクトを作成するには (コンソール)**
1. まだ追加していない場合には、Amazon Rekognition Custom Labels コンソールを設定します。詳細については、「[Amazon Rekognition Custom Labels のセットアップ](setting-up.md)」を参照してください。
1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/rekognition/](https://console.aws.amazon.com/rekognition/) で Amazon Rekognition コンソールを開きます。
1. 左側のペインで、**[カスタムラベルを使用]** を選択します。Amazon Rekognition Custom Labels のランディングページが表示されます。
1. Amazon Rekognition Custom Labels のランディングページで、**[開始方法]** を選択します。
1. 左ナビゲーションペインで、**[プロジェクト]** を選択します。
1. [プロジェクト] ページで、**[プロジェクトを作成]** を選択します。
1. [**プロジェクト名**] にプロジェクトの名前を入力します。
1. **[プロジェクトを作成]** を選択してプロジェクトを作成します。
![\[新しいプロジェクトを作成するための UI フォーム。プロジェクト名の入力フィールドに「My-Project」と入力されている。キャンセルおよびプロジェクト作成のボタンがある。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/customlabels-dg/images/tutorial-create-project.jpg)
## ステップ 4: トレーニングデータセットおよびテストデータセットを作成する
このステップでは、ローカルコンピュータからイメージをアップロードして、トレーニングデータセットとテストデータセットを作成します。同時にアップロードできるイメージは、30 枚までです。アップロードするイメージがたくさんある場合は、Amazon S3 バケットからイメージをインポートしてデータセットを作成することを検討してください。詳細については、「[Amazon S3 バケットからの画像のインポート](md-create-dataset-s3.md)」を参照してください。
データセットの詳細については、「[データセットの管理](managing-dataset.md)」を参照してください。
**ローカルコンピュータ上の画像を使用してデータセットを作成するには (コンソール)**
1. プロジェクトの詳細ページで、**データセットを作成]** を選択します。
![\[モデルのトレーニングワークフローにおけるデータセットの作成ステップ: モデルトレーニング用の画像とラベルをアップロードするための [データセットを作成] ボタンがある。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/customlabels-dg/images/tutorial-create-dataset.jpg)
1. **[設定の開始]** セクションで、**[トレーニングデータセットとテストデータセットで開始する]** を選択します。
1. **[トレーニングデータセット詳細]** セクションで、**[コンピュータから画像をアップロード]** を選択します。
1. **[テストデータセット詳細]** セクションで、**[コンピュータから画像をアップロード]** を選択します。
1. **[データセットを作成]** を選択します。
![\[トレーニング用とテスト用のデータセットを作成するためのユーザーインターフェイス。[データセットの作成] ボタンと [キャンセル] ボタンが下部にある。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/customlabels-dg/images/tutorial-project-details-create-dataset.jpg)
1. データセットページが表示され、それぞれのデータセットの**[トレーニング]** タブと**[テスト]** タブが表示されます。
1. [データセット] ページで **[トレーニング]** タブを選択します。
1. **[アクション]** を選択し、**[トレーニングデータセットに画像を追加]** をクリックします。
![\[[データセット] ビューの [アクション] メニュー。画像をトレーニング用データセットに追加するオプションとテスト用データセットに追加するオプションが表示されている。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/customlabels-dg/images/tutorial-action-add-images.jpg)
1. **[トレーニングデータセットに画像を追加]** ダイアログボックスで、**[ファイルを選択]** を選択します。
![\[データセットトレーニング用の画像ファイルをアップロードするためのボタン。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/customlabels-dg/images/tutorial-dialog-choose-files.jpg)
1. データセットにアップロードする画像を選択します。同時にアップロードできるイメージは、30 枚までです。
1. **[画像をアップロード]** を選択します。Amazon Rekognition Custom Labels がデータセットにイメージを追加するまでに数秒かかることがあります。
![\[11 個の画像のサムネイルが表示されたグリッド。これらの画像はトレーニングデータセットへのアップロード準備完了になっている。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/customlabels-dg/images/tutorial-dialog-upload-images.jpg)
1. トレーニングデータセットに追加するイメージが他にもある場合は、ステップ 9～12 を繰り返します。
1. **[テスト]** タブを選択します。
1. ステップ 8～12 を繰り返して、テストデータセットにイメージを追加します。ステップ 8 で、**[アクション]** を選択します。**[テストデータセットに画像を追加]** をクリックします。
## ステップ 5: ラベルをプロジェクトに追加する
このステップでは、ステップ [ステップ 2: クラスを決める](#tutorial-classify-images-decide-categories) で特定した各クラスのラベルをプロジェクトに追加します。
**新しいラベルを追加するには (コンソール)**
1. データセットギャラリーページで、**[ラベル付けを開始]** を選択してラベル付けモードに入ります。
![\[画像のラベル付け手順が表示されたデータセットギャラリーインターフェイス: データセットの確認、ラベルの追加、境界ボックスで囲まれたオブジェクトのラベリング、モデルのトレーニングの各手順が説明されている。[ラベル付けを開始] ボタンが強調表示されている。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/customlabels-dg/images/tutorial-start-labeling.jpg)
1. データセットギャラリーの **[ラベル]** セクションで、**[ラベルを編集]** を選択し、**[ラベルを管理]** ダイアログボックスを開きます。
1. 編集ボックスに新しいラベル名を入力します。
1. **[新しいラベルを追加]** を選択します。
1. 必要なラベルがすべて作成されるまで、ステップ 3 と 4 を繰り返します。
1. **[保存]** を選択して、追加したラベルを保存します。
## ステップ 6: トレーニングデータセットとテストデータセットに画像レベルのラベルを割り当てる
このステップでは、トレーニングデータセットとテストデータセットの各イメージに 1 つのイメージレベルを割り当てます。イメージレベルのラベルは、各イメージが表すクラスです。
**画像レベルのラベルを画像に割り当てるには (コンソール)**
1. **[データセット]** ページで **[トレーニング]** タブを選択します。
1. **[ラベル付けを開始]** を選択してラベル付けモードに入ります。
1. ラベルを追加するイメージを 1 つ以上選択します。一度に選択できるのは 1 ページのイメージのみです。1 ページの連続した範囲のイメージを選択するには
1. 最初のイメージを選択します。
1. Shift キーを押したままにします。
1. 2 つ目のイメージを選択します。最初のイメージと 2 番目のイメージ間のイメージも選択されます。
1. Shift キーを放します。
1. **[画像レベルのラベルを割り当てる]** を選択します。
![\[住宅の裏庭を写した 3 つの画像が表示されたインターフェイス。[画像レベルラベルを割り当て] ボタンがある。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/customlabels-dg/images/tutorial-assign-image-level-labels.jpg)
1. **[画像レベルのラベルを選択した画像に割り当てる]** ダイアログボックスで、1 つ以上のイメージに割り当てるラベルを選択します。
1. **[割り当てる]** を選択して、イメージにラベルを割り当てます。
![\[選択した画像に画像レベルラベル「backyard」を [割り当て] ボタンで割り当てる方法を示すダイアログボックス。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/customlabels-dg/images/tutorial-dialog-assign-image-level-label.jpg)
1. すべてのイメージに必要なラベルが付けられるまで、ラベル付けを繰り返します。
1. **[テスト]** タブを選択します。
1. ステップを繰り返して、テストデータセットのイメージにイメージレベルのラベルを割り当てます。
## ステップ 7: モデルのトレーニング
以下のステップに従って、モデルをトレーニングします。詳細については、「[Amazon Rekognition Custom Labels モデルをトレーニングする](training-model.md)」を参照してください。
**モデルをトレーニングするには (コンソール)**
1. **[データセット]** ページで **[モデルをトレーニング]** を選択します。
![\[現在のプロジェクトのデータセットで機械学習モデルをトレーニングするための [モデルをトレーニング] ボタン。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/customlabels-dg/images/tutorial-train-model.jpg)
1. **[モデルをトレーニング]** ページで、**[モデルをトレーニング]** を選択します。プロジェクトの Amazon リソースネーム (ARN) は、**[プロジェクトを選択]** 編集ボックスにあります。
![\[[プロジェクト ARN] 入力フィールド、[空のタグ] セクション、[モデルをトレーニング] ボタンが表示された [モデルをトレーニング] 設定ページ。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/customlabels-dg/images/tutorial-train-model-page-train-model.jpg)
1. In the **Do you want to train your model?** dialog box, choose **Train model**.
![\[「モデルをトレーニングしますか?」という確認メッセージが表示されたダイアログボックス。[キャンセル] ボタンと [モデルをトレーニング] ボタンがある。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/customlabels-dg/images/tutorial-dialog-train-model.jpg)
1. プロジェクトページの **[モデル]** セクションには、トレーニングが進行中であることが表示されます。モデルバージョンの `Model Status` 列を表示して、現在のステータスを確認できます。モデルのトレーニングは、完了までに時間がかかります。
![\[モデルが現在トレーニング中であることを示す TRAINING_IN_PROGRESS ステータス。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/customlabels-dg/images/tutorial-training-progress.jpg)
1. トレーニングが完了したら、モデル名を選択します。モデルのステータスが **[TRAINING\$1COMPLETED]** になったらトレーニングは終了します。
![\[Rooms 19 モデルの情報。モデルが実行準備完了になったことを示す TRAINING_COMPLETED ステータスが表示されている。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/customlabels-dg/images/get-started-choose-model.jpg)
1. **[評価]** ボタンを選択すると、評価結果が表示されます。モデルの評価の詳細については、「[トレーニング済み Amazon Rekognition Custom Labels の改善](improving-model.md)」を参照してください。
1. **[テスト結果を表示]** を選択すると、個々のテストイメージの結果が表示されます。詳細については、「[モデルを評価するためのメトリクス](im-metrics-use.md)」を参照してください。
![\[10 個の画像ラベルに対する F1 スコア、平均適合率、全体再現率、ラベルごとのパフォーマンスメトリクスを示すモデル評価結果。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/customlabels-dg/images/get-started-training-results.jpg)
1. テスト結果を確認したら、モデル名を選択してモデルページに戻ります。
![\[裏庭と前庭の画像データセットに対するトレーニング済みモデルのテスト結果が表示されたインターフェイス: 予測ラベルと信頼スコアが示されている。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/customlabels-dg/images/get-started-image-test-results.jpg)
## ステップ 8: モデルをスタートする
このステップではモデルを開始します。モデルの開始後、モデルを使用してイメージを分析できます。
モデルの稼働時間に応じて課金されます。イメージを分析する必要がない場合は、モデルを停止してください。モデルは後で再起動できます。詳細については、「[トレーニング済み Amazon Rekognition Custom Labels の実行](running-model.md)」を参照してください。
**モデルを開始するには**
1. モデルページで **[モデルを使用]** タブを選択します。
1. **[モデルの開始または停止]** セクションで、次の操作を行います。
1. **[開始]** を選択します。
![\[[モデルを開始する] ボタンが表示されたユーザーインターフェイス。カスタムラベルを検出する機械学習モデルを開始するオプションと停止するオプションがある。スループット向上のために使用する推論ユニットの数を選択します。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/customlabels-dg/images/get-started-start-model.jpg)
1. **[モデルを開始]** ダイアログボックスで、**[開始]** を選択します。
![\[[開始] ボタンが表示された [モデルを開始する] ダイアログボックス。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/customlabels-dg/images/tutorial-start-model-dialog.jpg)
1. モデルが実行されるまで待ちます。**[モデルの開始または停止]** セクションのステータスが **[実行中]** の場合、モデルは実行中です。
![\[緑色の円でモデルが現在実行中であることを示す [実行中] ステータスインジケータ。モデルを停止するオプションと推論ユニット数を変更するオプションがある。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/customlabels-dg/images/get-started-start-model-running.jpg)
## ステップ 9: モデルを使用してイメージを分析する
イメージを分析するには、[DetectCustomLabels](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DetectCustomLabels) API を呼び出します。このステップでは、 `detect-custom-labels` AWS Command Line Interface (AWS CLI) コマンドを使用してサンプルイメージを分析します。 AWS CLI コマンドは、Amazon Rekognition Custom Labels コンソールから取得します。コンソールは、モデルを使用するように AWS CLI コマンドを設定します。Amazon S3 バケットに保存されているイメージを指定するだけです。
**注記**
コンソールには Python サンプルコードも用意されています。
`detect-custom-labels` からの出力には、イメージ内のラベルのリスト、境界ボックス (モデルがオブジェクトの位置を検出した場合)、予測の精度に対するモデルの信頼度が含まれます。
詳細については、「[トレーニングされたモデルによるイメージの分析](detecting-custom-labels.md)」を参照してください。
**イメージを分析するには (コンソール)**
1. まだ設定していない場合は、 をセットアップします AWS CLI。手順については、「[ステップ 4: AWS CLI と AWS SDKsを設定する](su-awscli-sdk.md)」を参照してください。
1. **[モデルを使用]** タブを選択し、**[API コード]** を選択します。
![\[モデルの詳細が表示されたインターフェイス。モデルの Amazon リソースネーム (ARN) とモデル使用のための API コードを表示するオプションがある。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/customlabels-dg/images/get-started-use-model-api-code.png)
1. **[AWS CLI コマンド]** を選択します。
1. **イメージの分析**セクションで、 を呼び出す AWS CLI コマンドをコピーします`detect-custom-labels`。
![\[カスタムモデルを使用して画像を分析するための AWS CLI コマンド。プロジェクト ARN とバケット名はプレースホルダーで表示されている。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/customlabels-dg/images/get-started-cli-code-analyze.png)
1. Amazon S3 バケットにイメージをアップロードします。手順については、[Amazon Simple Storage Service ユーザーガイド](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UploadingObjectsintoAmazonS3.html)の「*Amazon S3 へのオブジェクトのアップロード*」を参照してください。Rooms プロジェクトのイメージを使用している場合は、[ステップ 1: イメージを集める](#tutorial-classify-images-collect-images) 内の別のフォルダに移動したイメージの 1 つを使用してください。
1. コマンドプロンプトで、前のステップでコピーした AWS CLI コマンドを入力します。次の例のようになります。
`--project-version-arn` の値は、モデルの Amazon リソースネーム (ARN) になるはずです。`--region` の値は、モデルを作成した AWS リージョンであるはずです。
`MY_BUCKET` と `PATH_TO_MY_IMAGE` を前のステップで使用した Amazon S3 バケットとイメージに変更します。
[custom-labels-access](su-sdk-programmatic-access.md#su-sdk-programmatic-access-customlabels-examples) プロファイルを使用して認証情報を取得する場合は、`--profile custom-labels-access` パラメータを追加します。
```
aws rekognition detect-custom-labels \
--project-version-arn "model_arn" \
--image '{"S3Object": {"Bucket": "MY_BUCKET","Name": "PATH_TO_MY_IMAGE"}}' \
--region us-east-1 \
--profile custom-labels-access
```
AWS CLI コマンドの JSON 出力は次のようになります。`Name` はモデルが見つけたイメージレベルのラベルの名前です。`Confidence` (0-100) は予測の精度に対するモデルの信頼度です。
```
{
"CustomLabels": [
{
"Name": "living_space",
"Confidence": 83.41299819946289
}
]
}
```
1. 引き続きモデルを使用して他のイメージを分析してください。使用しなくなったモデルは停止してください。
## ステップ 10: モデルを停止する
このステップではモデルの実行を停止します。モデルの稼働時間に応じて課金されます。モデルの使用を終了した場合は、停止する必要があります。
**モデルを停止するには**
1. **[モデルの開始または停止]** セクションで、**[停止]** を選択します。
![\[現在実行中のモデルを停止し、推論ユニットを無効にするための [停止] ボタン。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/customlabels-dg/images/get-started-stop-model.jpg)
1. **[モデルを停止]** ダイアログボックスで、**[停止]** と入力し、モデルを停止することを確認します。
![\[「stop」と入力された入力フィールドと、モデルの停止を確認するための [停止] ボタン。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/customlabels-dg/images/get-started-stop-model-dialog.jpg)
1. **[停止]** を選択してモデルを停止します。**[モデルの開始または停止]** セクションのステータスが **[停止済み]** になると、モデルは停止します。
![\[モデルが実行されておらず、[開始] ボタンまたはコード例を使用して開始する必要があることを説明する [停止済み] ステータスインジケータ。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/customlabels-dg/images/get-started-stopped-model.jpg)