> 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. 開始角と終了角のパラメータを使って、全楕円または部分的な楕円弧のいずれかを描画します
8. 元の画像の上に楕円形の輪郭を重ねた、注釈付き画像を返します
このブロックは通常、各検出のバウンディングボックスに適合する楕円を描画し、オブジェクトのアスペクト比に合わせた楕円形の輪郭を作成します（常に円形である円とは異なります）。楕円は、円よりも柔軟な幾何学表現を提供し、丸いオブジェクトと細長いオブジェクトの両方をより正確に表現できます。開始角と終了角のパラメータにより、完全な楕円（360度）または部分的な円弧を描画でき、追加の視覚スタイルの選択肢を提供します。円の可視化（常に完全な円を描画）とは異なり、楕円の可視化では部分円弧を描画できるため、オブジェクトの位置を明確に示しながら、特徴的な視覚マーカーを作成できます。
## 一般的な使用例
* **楕円形および細長いオブジェクトの強調表示**: オブジェクトが楕円形または細長い場合（例: 車両、細長い製品、楕円体オブジェクト）、円形や長方形よりも楕円がより適しているときに、楕円形の輪郭で検出オブジェクトを強調表示します
* **柔軟な幾何学的視覚化**: 円やバウンディングボックスよりも幾何学的に柔軟な代替として楕円形を使用し、オブジェクトのアスペクト比に合わせて、より正確な視覚表現を実現します
* **部分円弧の注釈**: 開始角と終了角を使って部分的な楕円弧を描画し、オブジェクトの位置を独自の視覚スタイルで示す、特徴的でスタイライズされた視覚マーカーを作成します
* **美的な視覚化の代替手段**: 標準的なバウンディングボックスや円と比べて視覚的に異なる注釈を作成し、デザイン目的、芸術的な可視化、または楕円形がデザインの美学により合う場合に使用します
* **オブジェクト形状への適応**: 円形の輪郭では不正確になりやすい非正方形のアスペクト比を持つオブジェクトに楕円を使用し、長方形や細長いオブジェクトに対してより良い視覚的適合を提供します
* **デザインおよび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` | バウンディングボックスの色をどのように割り当てるかを選択します。 | ✅ |
| `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度 = 上）.. | ✅ |
この **参照** 列は、で利用可能な動的値を使用してプロパティをパラメータ化できる可能性を示します `ワークフロー` 実行時。参照 *バインディング* 詳細情報
### 入出力バインディング
利用可能な接続は、そのバインディング種別によって異なります。どのバインディング種別が `楕円の可視化` のバージョン `v1` 持つか確認してください。
入出力バインディング
* 入力
* `画像` ([*`画像`*](/workflows/ja/gaido/developer-guide/kinds/image.md)）：可視化対象の画像。
* `copy_image` ([*`boolean`*](/workflows/ja/gaido/developer-guide/kinds/boolean.md)）：このオプションを有効にすると、可視化用に入力画像のコピーを作成し、元画像を保持します。複数の可視化を重ねる場合に使用します。
* `predictions` (*Union\[*[*`instance_segmentation_prediction`*](/workflows/ja/gaido/developer-guide/kinds/instance-segmentation-prediction.md)*,* [*`keypoint_detection_prediction`*](/workflows/ja/gaido/developer-guide/kinds/keypoint-detection-prediction.md)*,* [*`object_detection_prediction`*](/workflows/ja/gaido/developer-guide/kinds/object-detection-prediction.md)*,* [*`rle_instance_segmentation_prediction`*](/workflows/ja/gaido/developer-guide/kinds/rle-instance-segmentation-prediction.md)*]*): 可視化するモデル予測。。
* `color_palette` ([*`string`*](/workflows/ja/gaido/developer-guide/kinds/string.md)）：可視化要素のカラーパレットを選択します。
* `palette_size` ([*`integer`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)）：パレット内の色数を指定します。カスタムパレットまたはMatplotlibパレットを使用する場合に適用されます。
* `custom_colors` ([*`list_of_values`*](/workflows/ja/gaido/developer-guide/kinds/list-of-values.md)）：バウンディングボックス用のカスタムカラーのリストをHEX形式で定義します。
* `color_axis` ([*`string`*](/workflows/ja/gaido/developer-guide/kinds/string.md)）：バウンディングボックスの色をどのように割り当てるかを選択します。
* `thickness` ([*`integer`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)): 楕円の輪郭の太さ（ピクセル単位）。値が大きいほど、太くて見やすい楕円形の輪郭になります..
* `start_angle` ([*`integer`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)): 楕円弧を描画する開始角度（度）。end\_angle と併用して、完全な楕円（360度）か部分円弧かを制御します。角度は正の x 軸を基準に測定されます（0度 = 右、90度 = 下、180度 = 左、270度 = 上）..
* `end_angle` ([*`integer`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)): 楕円弧を描画する終了角度（度）。start\_angle と併用して、完全な楕円（360度）か部分円弧かを制御します。完全な楕円を描画するには、end\_angle = start\_angle + 360（または同等）に設定します。角度は正の x 軸を基準に測定されます（0度 = 右、90度 = 下、180度 = 左、270度 = 上）..
* 出力
* `画像` ([`画像`](/workflows/ja/gaido/developer-guide/kinds/image.md)）：ワークフロー内の画像。
JSON 定義の例
```json
{
"name": "",
"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
}
```