画像セグメンテーションのJSON行の定義 - Amazon Lookout for Vision

サポート終了通知: 2025 AWS 年 10 月 31 日、 は Amazon Lookout for Vision のサポートを終了します。2025 年 10 月 31 日以降、Lookout for Vision コンソールまたは Lookout for Vision リソースにアクセスできなくなります。詳細については、このブログ記事を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

画像セグメンテーションのJSON行の定義

Amazon Lookout for Vision マニフェストファイルで使用するイメージごとに JSON 行を定義します。セグメンテーションモデルを作成する場合、JSON行には画像のセグメンテーションと分類情報が含まれている必要があります。マニフェストファイルは、インポートするイメージごとに 1 つ以上の JSON 行で構成されます。

セグメント化された画像のマニフェストファイルを作成するには
  1. 空のテキストファイルを作成します。

  2. インポートするイメージごとに JSON 行を追加します。各JSON行は次のようになります。

    {"source-ref":"s3://path-to-image","anomaly-label":1,"anomaly-label-metadata":{"class-name":"anomaly","creation-date":"2021-10-12T14:16:45.668","human-annotated":"yes","job-name":"labeling-job/classification-job","type":"groundtruth/image-classification","confidence":1},"anomaly-mask-ref":"s3://path-to-image","anomaly-mask-ref-metadata":{"internal-color-map":{"0":{"class-name":"BACKGROUND","hex-color":"#ffffff","confidence":0.0},"1":{"class-name":"scratch","hex-color":"#2ca02c","confidence":0.0},"2":{"class-name":"dent","hex-color":"#1f77b4","confidence":0.0}},"type":"groundtruth/semantic-segmentation","human-annotated":"yes","creation-date":"2021-11-23T20:31:57.758889","job-name":"labeling-job/segmentation-job"}}
  3. ファイルを保存します。

    注記

    .manifest 拡張機能を使用できますが、必須ではありません。

  4. 作成したマニフェストファイルを使用してデータセットを作成します。詳細については、「マニフェストファイルの作成」を参照してください。

セグメンテーションのJSON行

このセクションでは、イメージのセグメンテーションと分類情報を含む JSON 行を作成する方法について説明します。

次のJSON行は、セグメンテーションおよび分類情報を含む画像を示しています。 anomaly-label-metadataには分類情報が含まれています。 anomaly-mask-refと にはセグメンテーション情報anomaly-mask-ref-metadataが含まれています。

{ "source-ref": "s3://path-to-image", "anomaly-label": 1, "anomaly-label-metadata": { "class-name": "anomaly", "creation-date": "2021-10-12T14:16:45.668", "human-annotated": "yes", "job-name": "labeling-job/classification-job", "type": "groundtruth/image-classification", "confidence": 1 }, "anomaly-mask-ref": "s3://path-to-image", "anomaly-mask-ref-metadata": { "internal-color-map": { "0": { "class-name": "BACKGROUND", "hex-color": "#ffffff", "confidence": 0.0 }, "1": { "class-name": "scratch", "hex-color": "#2ca02c", "confidence": 0.0 }, "2": { "class-name": "dent", "hex-color": "#1f77b4", "confidence": 0.0 } }, "type": "groundtruth/semantic-segmentation", "human-annotated": "yes", "creation-date": "2021-11-23T20:31:57.758889", "job-name": "labeling-job/segmentation-job" } }

JSON行のキーと値

次の情報は、Amazon Lookout for Vision のJSON行のキーと値について説明します。

source-ref

(必須) 画像の Amazon S3 の場所。形式は "s3://BUCKET/OBJECT_PATH" です。インポートされたデータセット内の画像は、同じ Amazon S3 バケットに格納する必要があります。

anomaly-label

(必須) ラベル属性。anomaly-label キー、または選択した別のキー名を使用してください。キーバリュー (前の例では 1) は Amazon Lookout for Vision で必須ですが、使用されていません。Amazon Lookout for Vision が作成する出力マニフェストでは、異常画像の場合は値が 1 に、正常画像の場合は値が 0 に変換されます。class-name の値は、画像が正常か異常かを判断します。

末尾に -metadata が付いたフィールド名により特定される該当メタデータが必要です。例えば、"anomaly-label-metadata" と指定します。

anomaly-label-metadata

(必須) ラベル属性に関するメタデータ。分類情報を含みます。フィールド名は、末尾に -metadata が付いたラベル属性と同じでなければなりません。

confidence

(Optional) Currently not used by Amazon Lookout for Vision. 値を指定する場合は、1 の値を使用します。

job-name

(オプション) 画像を処理するジョブに対して選択した名前。

class-name

(必須) 画像に正常なコンテンツが含まれている場合は、normal を指定します。そうでない場合は、anomaly を指定します。class-name がそれ以外の値であれば、画像はラベルなしの画像としてデータセットに追加されます。画像にラベルを付けるには、「データセットへの画像の追加」を参照してください。

human-annotated

(必須) アノテーションが人によって完成されている場合、"yes" を指定します。それ以外の場合は、"no"を指定します。

creation-date

(オプション) ラベルが作成された協定世界時 (UTC) の日時。

type

(必須) 画像に適用する処理のタイプ。値 "groundtruth/image-classification" を使用します。

anomaly-mask-ref

(必須) Amazon S3 におけるマスク画像の場所。キー名用の anomaly-mask-ref を使用するか、任意のキー名を使用してください。キーは -ref で終わる必要があります。マスク画像は、異常タイプ internal-color-map ごとに色付きのマスクを含む必要があります。形式は "s3://BUCKET/OBJECT_PATH" です。インポートされたデータセット内の画像は、同じ Amazon S3 バケットに格納する必要があります。マスクイメージは、ポータブルネットワークグラフィックス (PNG) 形式のイメージである必要があります。

anomaly-mask-ref-metadata

(必須) 画像のセグメンテーションメタデータ。キー名用の anomaly-mask-ref-metadata を使用するか、任意のキー名を使用してください。キー名は -ref-metadata で終わる必要があります。

internal-color-map

(必須) 個々の異常タイプにマップする色のマップ。色はマスク画像 (anomaly-mask-ref) 内の色と一致する必要があります。

key

(必須) マップへのキー。エントリには、イメージの異常以外の領域を表すクラス名 BACKGROUND が含まれている0必要があります。

class-name

(必須) 傷やへこみなどの異常タイプの名前。

hex-color

(必須) 異常タイプに対するウェブカラー (#2ca02c など)。色は anomaly-mask-ref の色と一致する必要があります。異常タイプ BACKGROUND の値は常に #ffffff です。

confidence

(必須) 現在、Amazon Lookout for Vision で使用されてませんが、浮動小数点値が必要です。

human-annotated

(必須) アノテーションが人によって完成されている場合、"yes" を指定します。それ以外の場合は、"no"を指定します。

creation-date

(オプション) セグメンテーション情報が作成された協定世界時 (UTC) の日時。

type

(必須) 画像に適用する処理のタイプ。値 "groundtruth/semantic-segmentation" を使用します。