> 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/advanced-blocks/overlap-analysis.md).

# 重なり分析

2つの検出セット間のペアごとの幾何学的重なりを計算します。

から抽出された各ペア（reference, candidate）について `reference_predictions` x `candidate_predictions`、このブロックは `intersection_area / reference_polygon.area` を計算し、その比率が `min_overlap`.

検出にマスクが付いている場合、正確なポリゴンはそのマスクの最長輪郭です（shapelyで検証済み）。それ以外の場合はバウンディングボックスのポリゴンが使用されます。ベクトル化されたbbox-IoUの事前フィルタ（`supervision.box_iou_batch`）は、shapelyの交差計算を行う前に、接触していないペアを除外します。

この関係は意図的に **対称ではありません** 2つの入力間で: 分母は常にreference検出の面積です。もう一方のセットに対する重なりとして出力したい場合は、2つのセレクタを入れ替えてください。

出力は入力と同じ次元性に付随するdictのフラットなリスト（承認された各ペアにつき1件）です。このブロックは次元を増やしません。次の `detections_overlaps` kindのドキュメントで、レコードごとのスキーマを確認してください。

### 種別識別子

ステップで次の識別子を使用します `"type"` フィールド: `roboflow_core/overlap_analysis@v1` ワークフローにステップとしてブロックを追加するには。

### プロパティ

| **名前**        | **型**   | **説明**                                              | 参照 |
| ------------- | ------- | --------------------------------------------------- | -- |
| `name`        | `str`   | このステップの一意の識別子を入力してください。                             | ❌  |
| `min_overlap` | `float` | ペアを出力に含めるための最小 (intersection / reference\_area) 比率。 | ✅  |

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

### 入出力バインディング

利用可能な接続は、そのバインディング種別によって異なります。どのバインディング種別が `重なり分析` のバージョン `v1` 持つか確認してください。

<details>

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

* 入力
  * `reference_predictions` (*Union\[*[*`instance_segmentation_prediction`*](/workflows/ja/gaido/developer-guide/kinds/instance-segmentation-prediction.md)*,* [*`object_detection_prediction`*](/workflows/ja/gaido/developer-guide/kinds/object-detection-prediction.md)*]*): 重なり比の分母となる面積を持つ検出。各reference検出について、すべてのcandidateとの重なりが計算されます。〜を上回るペアは `min_overlap` 出力に表示されます。
  * `candidate_predictions` (*Union\[*[*`instance_segmentation_prediction`*](/workflows/ja/gaido/developer-guide/kinds/instance-segmentation-prediction.md)*,* [*`object_detection_prediction`*](/workflows/ja/gaido/developer-guide/kinds/object-detection-prediction.md)*]*): 各referenceに対して照合される検出。
  * `min_overlap` ([*`float_zero_to_one`*](/workflows/ja/gaido/developer-guide/kinds/float-zero-to-one.md)): ペアを出力に含めるための最小 (intersection / reference\_area) 比率。
* 出力
  * `重なり` ([`detections_overlaps`](/workflows/ja/gaido/developer-guide/kinds/detections-overlaps.md)): ペアごとの検出重なりレコードのリスト。

</details>

<details>

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

```json
{
	    "name": "<your_step_name_here>",
	    "type": "roboflow_core/overlap_analysis@v1",
	    "reference_predictions": "$steps.model_a.predictions",
	    "candidate_predictions": "$steps.model_b.predictions",
	    "min_overlap": 0.1
	}
```

</details>