> 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/ellipse-visualization.md).

# 楕円可視化

画像内の検出オブジェクトを強調する楕円を描画します。

検出されたオブジェクトの周囲に楕円状の輪郭を描画し、円形の可視化よりも柔軟な形状で、完全な楕円や部分的な円弧にカスタマイズできる楕円形の注釈を提供します。

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

このブロックは画像と検出予測を受け取り、各検出オブジェクトの周囲に楕円形（オーバル）の輪郭を描画します。このブロックは、

1. 画像と予測を入力として受け取ります
2. 各検出オブジェクトのバウンディングボックス座標を特定します
3. 各検出について、そのバウンディングボックスに基づいて中心点と寸法（幅と高さ）を計算します
4. 選択したカラーパレットに基づいて色を適用し、クラス、インデックス、またはトラックIDごとに色を割り当てます
5. SupervisionのEllipseAnnotatorを使用して、各検出オブジェクトの周囲に楕円形の輪郭を描画します
6. 楕円形の輪郭の線幅を制御するために、指定した太さを適用します
7. start\_angle と end\_angle パラメータを使用して、完全な楕円または部分的な楕円弧のいずれかを描画します
8. 元の画像の上に楕円形の輪郭を重ねた注釈付き画像を返します

このブロックは通常、各検出のバウンディングボックスに合わせて楕円を描画し、オブジェクトの縦横比に適応する楕円形の輪郭を生成します（円は常に丸いのとは異なります）。楕円は、丸いオブジェクトと細長いオブジェクトの両方をより正確に表現できるため、円よりも柔軟な形状を提供します。start\_angle と end\_angle パラメータを使うと、完全な楕円（360度）または部分的な円弧を描画でき、追加の視覚スタイルの選択肢が得られます。常に完全な円を描画する円の可視化とは異なり、楕円の可視化では部分的な円弧を描画できるため、オブジェクトの位置を明確に示しながら、個性的な視覚マーカーを作成できます。

## 一般的な使用例

* **楕円および細長いオブジェクトの強調表示**: オブジェクトが楕円形または細長い場合（例: 車、細長い製品、楕円形のオブジェクト）に、円形や長方形よりも楕円が適しているため、楕円形の輪郭で検出オブジェクトを強調表示します
* **柔軟な幾何学的可視化**: 円やバウンディングボックスのより幾何学的に柔軟な代替として楕円形を使用し、オブジェクトの縦横比に適応させて、より正確な視覚表現を実現します
* **部分円弧注釈**: start\_angle と end\_angle を使用して部分的な楕円弧を描画し、オブジェクトの位置を独自の視覚スタイルで示す、特徴的でスタイリッシュな視覚マーカーを作成します
* **美的な可視化の代替案**: 標準的なバウンディングボックスや円とは視覚的に異なる注釈を、デザイン目的、芸術的な可視化、または楕円形の方がデザインの美観に合う場合に作成します
* **オブジェクト形状への適応**: オブジェクトの縦横比が正方形でない場合には、円形の輪郭よりも楕円を使用します。これにより、長方形や細長いオブジェクトに対してより適した視覚的フィットが得られます
* **デザインおよびUIアプリケーション**: ユーザーインターフェース、ダッシュボード、またはインタラクティブアプリケーションに楕円形の輪郭を統合し、角張った長方形よりも柔らかく有機的な視覚スタイルを提供します

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

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

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

### タイプ識別子

ステップで次の識別子を使用してください `"type"` フィールド: `roboflow_core/ellipse_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 ラベル）は、中立的なグレーで描画されます..                                                                               | ✅  |
| `thickness`     | `int`       | ピクセル単位の楕円輪郭の太さ。値が大きいほど、より太く目立つ楕円形の輪郭になります。                                                                                                                                               | ✅  |
| `start_angle`   | `int`       | 楕円弧を描画し始める角度（度）。end\_angle と組み合わせて、完全な楕円（360度）を描くか、部分的な円弧を描くかを制御します。角度は正の x 軸を基準に測定されます（0度 = 右、90度 = 下、180度 = 左、270度 = 上）。                                                               | ✅  |
| `end_angle`     | `int`       | 楕円弧を描画し終える角度（度）。start\_angle と組み合わせて、完全な楕円（360度）を描くか、部分的な円弧を描くかを制御します。完全な楕円を描画するには、end\_angle = start\_angle + 360（または同等の値）に設定します。角度は正の x 軸を基準に測定されます（0度 = 右、90度 = 下、180度 = 左、270度 = 上）。 | ✅  |

この **参照** この列は、 `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)*,* [*`keypoint_detection_prediction`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/keypoint-detection-prediction.md)*,* [*`object_detection_prediction`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/object-detection-prediction.md)*,* [*`rle_instance_segmentation_prediction`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/rle-instance-segmentation-prediction.md)*]*): 可視化するモデル予測..
  * `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 ラベル）は、中立的なグレーで描画されます..
  * `thickness` ([*`integer`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/integer.md)): ピクセル単位の楕円輪郭の太さ。値が大きいほど、より太く目立つ楕円形の輪郭になります。
  * `start_angle` ([*`integer`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/integer.md)): 楕円弧を描画し始める角度（度）。end\_angle と組み合わせて、完全な楕円（360度）を描くか、部分的な円弧を描くかを制御します。角度は正の x 軸を基準に測定されます（0度 = 右、90度 = 下、180度 = 左、270度 = 上）。
  * `end_angle` ([*`integer`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/integer.md)): 楕円弧を描画し終える角度（度）。start\_angle と組み合わせて、完全な楕円（360度）を描くか、部分的な円弧を描くかを制御します。完全な楕円を描画するには、end\_angle = start\_angle + 360（または同等の値）に設定します。角度は正の x 軸を基準に測定されます（0度 = 右、90度 = 下、180度 = 左、270度 = 上）。
* 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/ellipse_visualization@v1",
	    "image": "$inputs.image",
	    "copy_image": true,
	    "predictions": "$steps.object_detection_model.predictions",
	    "color_palette": "DEFAULT",
	    "palette_size": 10,
	    "custom_colors": [
	        "#FF0000",
	        "#00FF00",
	        "#0000FF"
	    ],
	    "color_axis": "CLASS",
	    "thickness": 2,
	    "start_angle": -45,
	    "end_angle": 235
	}
```

</details>
