> 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` | このオプションを有効にすると、可視化用に入力画像のコピーを作成し、元の画像を保持します。複数の可視化を重ねる場合に使用してください。 | ✅ |
| `カラーパレット` | `str` | 可視化要素のカラーパレットを選択します。 | ✅ |
| `パレットサイズ` | `整数` | パレット内の色数を指定します。これはカスタムまたはMatplotlibのパレットを使用する場合に適用されます。 | ✅ |
| `カスタムカラー` | `List[str]` | バウンディングボックス用のカスタムカラーの一覧をHEX形式で定義します。 | ✅ |
| `色の割り当て` | `str` | バウンディングボックスの色をどのように割り当てるかを選択します。 | ✅ |
| `太さ` | `整数` | ピクセル単位の楕円輪郭の太さ。値を大きくすると、より太く、より見やすい楕円輪郭になります。 | ✅ |
| `start_angle` | `整数` | 楕円弧を描画する際の開始角度（度）です。end\_angle と併用して、完全な楕円（360度）を描画するか、部分的な弧を描画するかを制御します。角度は正の x 軸を基準に測定されます（0度 = 右、90度 = 下、180度 = 左、270度 = 上）。 | ✅ |
| `end_angle` | `整数` | 楕円弧を描画する際の終了角度（度）です。start\_angle と併用して、完全な楕円（360度）を描画するか、部分的な弧を描画するかを制御します。完全な楕円を描くには、end\_angle = start\_angle + 360（または同等の値）に設定します。角度は正の x 軸を基準に測定されます（0度 = 右、90度 = 下、180度 = 左、270度 = 上）。 | ✅ |
この **参照** 列は、で利用可能な動的値を使ってプロパティをパラメータ化できる可能性を示します `ワークフロー` 実行時。参照 *バインディング* 詳細は。
### 入力と出力のバインディング
利用可能な接続は、そのバインディング種別によって異なります。どのバインディング種別が `楕円の可視化` のバージョン `v1` あるか確認してください。
入力と出力のバインディング
* 入力
* `image` ([*`image`*](/workflows/ja/gaido/developer-guide/kinds/image.md)): 可視化対象の画像。
* `copy_image` ([*`boolean`*](/workflows/ja/gaido/developer-guide/kinds/boolean.md)): このオプションを有効にすると、可視化用に入力画像のコピーを作成し、元の画像を保持します。複数の可視化を重ねる場合に使用してください。
* `predictions` (*Union\[*[*`rle_instance_segmentation_prediction`*](/workflows/ja/gaido/developer-guide/kinds/rle-instance-segmentation-prediction.md)*,* [*`object_detection_prediction`*](/workflows/ja/gaido/developer-guide/kinds/object-detection-prediction.md)*,* [*`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)*]*): 可視化するモデル予測。
* `カラーパレット` ([*`string`*](/workflows/ja/gaido/developer-guide/kinds/string.md)）：可視化要素のカラーパレットを選択します。
* `パレットサイズ` ([*`整数`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)）：パレット内の色数を指定します。これはカスタムまたはMatplotlibのパレットを使用する場合に適用されます。
* `カスタムカラー` ([*`list_of_values`*](/workflows/ja/gaido/developer-guide/kinds/list-of-values.md)）：バウンディングボックス用のカスタムカラーの一覧をHEX形式で定義します。
* `色の割り当て` ([*`string`*](/workflows/ja/gaido/developer-guide/kinds/string.md)）：バウンディングボックスの色をどのように割り当てるかを選択します。
* `太さ` ([*`整数`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)): ピクセル単位の楕円輪郭の太さ。値を大きくすると、より太く、より見やすい楕円輪郭になります。
* `start_angle` ([*`整数`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)): 楕円弧を描画する際の開始角度（度）です。end\_angle と併用して、完全な楕円（360度）を描画するか、部分的な弧を描画するかを制御します。角度は正の x 軸を基準に測定されます（0度 = 右、90度 = 下、180度 = 左、270度 = 上）。
* `end_angle` ([*`整数`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)): 楕円弧を描画する際の終了角度（度）です。start\_angle と併用して、完全な楕円（360度）を描画するか、部分的な弧を描画するかを制御します。完全な楕円を描くには、end\_angle = start\_angle + 360（または同等の値）に設定します。角度は正の x 軸を基準に測定されます（0度 = 右、90度 = 下、180度 = 左、270度 = 上）。
* 出力
* `image` ([`image`](/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
}
```