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

画像セグメンテーションのための JSON Lines の定義

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

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

  2. インポートする画像ごとに JSON Lines を追加します。各 JSON Lines は以下のようになります。

    {"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 Lines

このセクションでは、画像のセグメンテーションおよび分類の情報を含む JSON Lines を作成する方法について説明します。

次の JSON Lines は、セグメンテーションと分類の情報を含む画像を示しています。 anomaly-label-metadata は分類情報を含みます。anomaly-mask-refanomaly-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 Lines のキーと値

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

ソースレファレンス

(必須) 画像の 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

(オプション) 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

(必須) マップへのキー。エントリ 0 には、画像上の異常以外の領域を表す class-name である BACKGROUND が含まれている必要があります。

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" を使用します。