> 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/workflows/ja/burokku/blocks/visualize-predictions/mask-visualization.md).

# マスク可視化

画像内の検出オブジェクトにマスクを適用します。

セグメンテーションマスクを半透明のカラーオーバーレイで塗りつぶし、インスタンスセグメンテーション予測から検出されたオブジェクトの形状に正確に沿った単色の塗りつぶしを作成します。

## このブロックの仕組み

このブロックは画像とインスタンスセグメンテーション予測（マスク付き）を受け取り、マスク領域をカラーオーバーレイで塗りつぶします。このブロックは次のことを行います：

1. 画像とインスタンスセグメンテーション予測（マスク付き）を入力として受け取る
2. 予測から検出された各オブジェクトのセグメンテーションマスクを抽出する
3. 選択したカラーパレットに基づいて各マスクに色付けを適用し、色はクラス、インデックス、またはトラックIDによって割り当てられます
4. Supervision の MaskAnnotator を使用して、マスク領域を単色で塗りつぶします
5. 指定された不透明度レベルを使用して、色付きのマスクオーバーレイを元の画像とブレンドします
6. マスク領域が半透明の色で塗りつぶされ、マスクされていない領域は変更されない注釈付き画像を返します

このブロックは各オブジェクトのセグメンテーションマスクの正確な形状を色付きオーバーレイで塗りつぶし、オブジェクトの境界に正確に沿った単色の塗りつぶしを作成します。輪郭を描くポリゴン可視化や、矩形領域を使用するバウンディングボックス可視化とは異なり、マスク可視化はマスク領域全体を色で塗りつぶすため、セグメント化された領域を明確に視覚化できます。不透明度パラメータはマスクオーバーレイの透明度を制御し、半透明のマスク（低い不透明度）を通して元の画像の詳細を見せたり、背景の詳細をより隠す不透明な塗りつぶし（高い不透明度）を作成したりできます。このブロックはマスクデータを含むインスタンスセグメンテーション予測を必要とし、セグメンテーションマスクを使って正確で形状追従型の色付き塗りつぶしを作成するために特化して動作します。

## 一般的な使用例

* **インスタンスセグメンテーションの可視化**: マスク領域を色で塗りつぶしてインスタンスセグメンテーション結果を可視化し、セグメント化されたオブジェクトを明確に示したり、セグメンテーション品質を検証したり、分析ワークフローで検出領域を強調表示したりします
* **形状に正確に追従するオーバーレイ**: 医用画像、品質管理、正確なオブジェクト識別など、正確な領域可視化を必要とする用途で役立つように、オブジェクトをセグメント化された形状に完全に一致する色で塗りつぶします
* **マスクベースのオブジェクト強調表示**: 物体の正確な境界に沿う色付きオーバーレイでセグメント化されたオブジェクトを強調表示し、異なるオブジェクトやオブジェクトクラスを明確に区別します
* **セグメンテーションモデルの検証**: セグメンテーション予測を色付きマスク塗りつぶしで可視化して、モデル性能を確認し、セグメンテーションエラーを特定し、モデル開発およびデバッグワークフローでマスク精度を検証します
* **医療・科学画像**: 医療画像、顕微鏡画像、または科学分析アプリケーションで、色付きマスクオーバーレイが組織境界、細胞領域、または測定領域の可視化に役立つ、セグメント化された領域を表示します
* **マスク品質の検査**: 色付きマスク塗りつぶしを使用してセグメンテーション品質を検査し、マスク境界を確認し、学習データやモデル出力でセグメンテーションの改善が必要な箇所を特定します

## 他のブロックへの接続

このブロックの注釈付き画像は次に接続できます：

* **他の可視化ブロック** (例: ラベル可視化、ポリゴン可視化、バウンディングボックス可視化) を使用して、マスク塗りつぶしと追加の注釈（ラベル、輪郭）を組み合わせ、包括的な可視化を行います
* **データ保存ブロック** (例: ローカルファイルシンク、CSVフォーマッター、Roboflowデータセットアップロード) を使用して、ドキュメント化、レポート作成、または分析のためにマスクオーバーレイ付き画像を保存します
* **Webhook ブロック** マスク塗りつぶし付きの可視化結果を外部システム、API、またはWebアプリケーションに送信し、ダッシュボードや監視ツールで表示します
* **通知ブロック** (例: メール通知、Slack通知) を使用して、アラートやレポート内の視覚的証拠として、マスクオーバーレイ付きの注釈画像を送信します
* **動画出力ブロック** マスク塗りつぶしを含む注釈付き動画ストリームや録画を作成し、ライブ監視、セグメンテーション可視化、または後処理分析に利用します

### タイプ識別子

ステップで次の識別子を使用してください `"type"` フィールド: `roboflow_core/mask_visualization@v1` を、ワークフローにステップとして追加します。

### プロパティ

| **名前**          | **型**       | **説明**                                                                                                                                                                                                           | 参照 |
| --------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -- |
| `name`          | `str`       | このステップの一意の識別子を入力してください。                                                                                                                                                                                          | ❌  |
| `copy_image`    | `bool`      | このオプションを有効にすると、可視化用に入力画像のコピーを作成し、元画像を保持します。複数の可視化を重ねる場合に使用してください..                                                                                                                                               | ✅  |
| `color_palette` | `str`       | 可視化要素のカラーパレットを選択します..                                                                                                                                                                                            | ✅  |
| `palette_size`  | `int`       | パレット内の色数を指定します。カスタムまたは Matplotlib のパレットを使用する場合に適用されます..                                                                                                                                                          | ✅  |
| `custom_colors` | `List[str]` | HEX形式でバウンディングボックス用のカスタムカラーのリストを定義します..                                                                                                                                                                           | ✅  |
| `color_axis`    | `str`       | バウンディングボックスの色をどのように割り当てるかを選択します。負のクラスまたはトラッカーIDを持つ検出結果（たとえば、class\_id = -1 の未一致 VLM ラベル）は、中立的なグレーで描画されます..                                                                                                       | ✅  |
| `不透明度`          | `float`     | マスクオーバーレイの不透明度。0.0（完全に透明）から1.0（完全に不透明）までの範囲です。色付きマスク塗りつぶしの透明度を制御します。低い値（例: 0.3〜0.5）は元の画像の詳細が透けて見える半透明のオーバーレイを作成し、高い値（例: 0.7〜1.0）は背景の詳細をより隠す不透明な塗りつぶしを作成します。一般的な値は、マスクと基になる画像の両方が見えるバランスの取れた可視化のために0.4〜0.7の範囲です。。 | ✅  |

この **参照** この列は、 `workflow` の実行時に利用可能な動的値でプロパティをパラメータ化できる可能性を示します。 *バインディング* の詳細を参照してください。

### 入力および出力バインディング

利用可能な接続は、そのバインディング種別に依存します。 `マスクの可視化` バージョン `v1` に、どのバインディング種別があるか確認してください。

<details>

<summary>入力と出力のバインディング</summary>

* input
  * `image` ([*`image`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/image.md)）：可視化する画像..
  * `copy_image` ([*`boolean`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/boolean.md)）：このオプションを有効にすると、可視化用に入力画像のコピーを作成し、元画像を保持します。複数の可視化を重ねる場合に使用してください..
  * `predictions` (*Union\[*[*`instance_segmentation_prediction`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/instance-segmentation-prediction.md)*,* [*`rle_instance_segmentation_prediction`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/rle-instance-segmentation-prediction.md)*,* [*`semantic_segmentation_prediction`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/semantic-segmentation-prediction.md)*]*): 検出されたオブジェクトのマスクを含むセグメンテーション予測です。このブロックはセグメンテーションマスクを使用して、オブジェクトまたはクラスの境界に正確に沿った色付き塗りつぶしを作成します。マスクデータを含むセグメンテーションモデルの出力が必要で、RLEエンコードされている場合があります。。
  * `color_palette` ([*`string`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/string.md)）：可視化要素のカラーパレットを選択します..
  * `palette_size` ([*`integer`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/integer.md)）：パレット内の色数を指定します。カスタムまたは Matplotlib のパレットを使用する場合に適用されます..
  * `custom_colors` ([*`list_of_values`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/list-of-values.md)）：HEX形式でバウンディングボックス用のカスタムカラーのリストを定義します..
  * `color_axis` ([*`string`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/string.md)）：バウンディングボックスの色をどのように割り当てるかを選択します。負のクラスまたはトラッカーIDを持つ検出結果（たとえば、class\_id = -1 の未一致 VLM ラベル）は、中立的なグレーで描画されます..
  * `不透明度` ([*`float_zero_to_one`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/float-zero-to-one.md)): マスクオーバーレイの不透明度。0.0（完全に透明）から1.0（完全に不透明）までの範囲です。色付きマスク塗りつぶしの透明度を制御します。低い値（例: 0.3〜0.5）は元の画像の詳細が透けて見える半透明のオーバーレイを作成し、高い値（例: 0.7〜1.0）は背景の詳細をより隠す不透明な塗りつぶしを作成します。一般的な値は、マスクと基になる画像の両方が見えるバランスの取れた可視化のために0.4〜0.7の範囲です。。
* output
  * `image` ([`image`](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/image.md)）：ワークフロー内の画像。

</details>

<details>

<summary>JSON定義の例</summary>

```json
{
	    "name": "<your_step_name_here>",
	    "type": "roboflow_core/mask_visualization@v1",
	    "image": "$inputs.image",
	    "copy_image": true,
	    "predictions": "$steps.instance_segmentation_model.predictions",
	    "color_palette": "DEFAULT",
	    "palette_size": 10,
	    "custom_colors": [
	        "#FF0000",
	        "#00FF00",
	        "#0000FF"
	    ],
	    "color_axis": "CLASS",
	    "opacity": 0.5
	}
```

</details>
