翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
DetectAnomalies
提供された画像の異常を検出します。
DetectAnomalies
からのレスポンスには、画像に1つ以上の異常が含まれているというブーリアン予測と、その予測に対する信頼度の値が含まれる。モデルがセグメンテーションモデルの場合、応答には以下が含まれます。
各異常タイプを独自の色でカバーするマスク画像。
DetectAnomalies
マスクイメージを共有メモリに保存することも、マスクをイメージバイトとして返すこともできます。アノマリータイプがカバーする画像のパーセンテージ領域。
マスク画像上のアノマリータイプの 16 進数カラー。
DetectAnomalies
使用するモデルは実行中である必要があります。DescribeModel を呼び出すことで、現在のステータスを取得できます。モデルの実行を開始するには、を参照してくださいStartModel。
DetectAnomalies
インターリーブ RGB888 形式のパックビットマップ (画像) をサポートします。最初のバイトは赤のチャネル、2 番目のバイトは緑のチャネル、3 番目のバイトは青のチャネルを表します。BGR などの別の形式で画像を提供すると、 DetectAnomalies からの予測は正しくありません。
デフォルトでは、OpenCV は画像ビットマップにBGR形式を使用します。OpenCV を使用して分析用の画像をキャプチャする場合はDetectAnomalies
、画像をに渡す前に画像を RGB888 形式に変換する必要がありますDetectAnomalies
。
サポートされている画像の最小サイズは 64 x 64 ピクセルです。サポートされている画像の最大サイズは 4096 x 4096 ピクセルです。
イメージは protobuf メッセージまたは共有メモリセグメントを介して送信できます。大きな画像を protobuf メッセージにシリアル化すると、への呼び出しの待ち時間が大幅に長くなる可能性がありますDetectAnomalies
。待ち時間を最小限に抑えるため、共有メモリの使用をお勧めします。
rpc DetectAnomalies(DetectAnomaliesRequest) returns (DetectAnomaliesResponse);
DetectAnomaliesRequest
の入力パラメーターDetectAnomalies
。
message Bitmap { int32 width = 1; int32 height = 2; oneof data { bytes byte_data = 3; SharedMemoryHandle shared_memory_handle = 4; } }
message SharedMemoryHandle { string name = 1; uint64 size = 2; uint64 offset = 3; }
message AnomalyMaskParams { SharedMemoryHandle shared_memory_handle = 2; }
message DetectAnomaliesRequest { string model_component = 1; Bitmap bitmap = 2; AnomalyMaskParams anomaly_mask_params = 3; }
ビットマップ
分析するイメージDetectAnomalies
。
幅
イメージの幅 (ピクセル単位)。
height
イメージの高さ (ピクセル単位)。
バイトデータ
protobuf メッセージで渡されたイメージバイト数。
共有メモリハンドル
共有メモリセグメントに渡された画像バイト数。
SharedMemoryHandle
POSIX 共有メモリセグメントを表します。
name
POSIX メモリセグメントの名前。共有メモリーの作成については、shm_open
size
オフセットから始まるイメージバッファーサイズ (バイト単位)。
offset
共有メモリセグメントの先頭から画像バッファの先頭までのオフセット (バイト単位)。
AnomalyMaskParams
アノマリーマスクを出力するためのパラメーター。(セグメンテーションモデル)。
共有メモリハンドル
マスクの画像バイトが含まれます (shared_memory_handle
指定されていない場合)。
DetectAnomaliesRequest
モデル_コンポーネント
AWS IoT Greengrass V2使用するモデルを含むコンポーネントの名前。
ビットマップ
分析するイメージDetectAnomalies
。
アノマリー_マスク_パラメータ
マスクを出力するためのオプションパラメータ。(セグメンテーションモデル)。
DetectAnomaliesResponse
からの応答DetectAnomalies
。
message DetectAnomalyResult { bool is_anomalous = 1; float confidence = 2; Bitmap anomaly_mask = 3; repeated Anomaly anomalies = 4; }
message Anomaly { string name = 1; PixelAnomaly pixel_anomaly = 2;
message PixelAnomaly { float total_percentage_area = 1; string hex_color = 2; }
message DetectAnomaliesResponse { DetectAnomalyResult detect_anomaly_result = 1; }
アノマリー
画像で見つかった異常を表します。(セグメンテーションモデル)。
name
画像で見つかった異常タイプの名前。 name
トレーニングデータセットの異常タイプにマップします。 DetectAnomaliesサービスはバックグラウンドアノマリータイプを応答フォームに自動的に挿入します。
ピクセル・アノマリー
アノマリータイプをカバーするピクセルマスクに関する情報。
PixelAnomaly
アノマリータイプをカバーするピクセルマスクに関する情報。(セグメンテーションモデル)。
合計パーセンテージエリア
アノマリータイプがカバーする画像のパーセンテージ領域。
hex_color
画像の異常タイプを表す 16 進数のカラー値。この色は、トレーニングデータセットで使用される異常タイプの色にマップされます。
DetectAnomalyResult
is_anomalous
画像に異常が含まれているかどうかを示します。 true
画像に異常が含まれている場合 false
画像が正常であれば。
confidence
DetectAnomalies
予測の精度を示す信頼度。 confidence
は 0~1 の間の浮動小数点値をとります。
アノマリーマスク
shared_memory_handle が提供されていない場合は、マスクのイメージバイトが含まれます。(セグメンテーションモデル)。
異常
入力画像内で見つかった 0 個以上の異常のリスト。(セグメンテーションモデル)。
ステータスコード
コード | 数値 | 説明 |
---|---|---|
OK |
0 |
|
UNKNOWN |
2 |
不明なエラーが発生しました。 |
引数が無効です |
3 |
1 つ以上の入力パラメータが無効です。詳細については、エラーメッセージを参照してください。 |
見つからない |
5 |
指定された名前のモデルが見つかりませんでした。 |
リソース_枯渇した |
8 |
この操作を実行するためのリソースが不足しています。たとえば、The Lookout for Vision Edge エージェントは、へのコールレートに追いつけません |
前提条件が失敗しました |
9 |
|
内部 |
13 |
内部エラーが発生しました。 |