> 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/transformations/detections-transformation.md).

# 検出変換

検出されたバウンディングボックスに変換を適用します。

UQL（Query Language）の操作チェーンを使用して検出予測にカスタマイズ可能な変換を適用し、構成可能な操作シーケンスによって、バウンディングボックスの柔軟な変更、検出のフィルタリング、プロパティの抽出、ボックスのリサイズ、その他の検出操作を実現し、高度な検出処理ワークフローを可能にします。

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

このブロックは、検出データを変更、フィルタリング、抽出、操作できるUQL操作のチェーンを適用して、検出予測を変換します。このブロックは：

1. 検出予測（オブジェクト検出、インスタンスセグメンテーション、またはキーポイント検出）と、適用するUQL操作の一覧を受け取ります
2. operations\_parameters に予約済みのパラメータ名が含まれていないことを検証します
3. 提供されたUQL操作定義から操作チェーンを構築し、順番に適用する変換シーケンスを作成します
4. operations\_parameters を、バッチパラメータ（予測結果に対応）と非バッチパラメータ（すべての予測に適用）に分割します
5. 各予測バッチに対して、操作チェーンを適用して処理します：
   * 予測をバッチパラメータと組み合わせ、各バッチ項目ごとにデータを対応付けます
   * 各予測について、バッチパラメータと非バッチパラメータを評価用パラメータにまとめます
   * 結合されたパラメータを使って、検出に操作チェーンを適用します
   * 出力が引き続き sv.Detections であることを検証します（操作は検出タイプを保持する必要があります）
6. 各入力バッチに対する変換後の検出を返します

このブロックは、フィルタリング（DetectionsFilter）、プロパティ抽出（ExtractDetectionProperty）、バウンディングボックス変換（リサイズ、スケーリング）、その他の検出操作を含む、さまざまなUQL操作をサポートします。操作は順次適用され、操作チェーンによる複雑な変換が可能です。このブロックは、変換が検出タイプを保持することを検証し、出力が他の検出処理ブロックと互換性を保つことを保証します。バッチパラメータと非バッチパラメータにより、柔軟な操作パラメータ化が可能になり、検出ごとの値とグローバルなパラメータ値の両方をサポートします。

## 一般的な使用例

* **高度な検出フィルタリング**: 条件文を使ってクラス名で検出をフィルタリングしたり、複数条件で信頼度しきい値によってフィルタリングしたり、検出プロパティに基づく独自のフィルタリング基準を適用したりして、検出予測に複雑なフィルタリングロジックを適用し、高度な検出選択ワークフローを実現します
* **バウンディングボックス変換**: バウンディングボックスのサイズ、位置、またはプロパティを変更します（例：バウンディングボックスを比例的にリサイズする、ボックスを割合でスケーリングする、ボックス座標を調整する、ボックス寸法を変換する）。これにより、柔軟なバウンディングボックス操作が可能になります
* **プロパティの抽出とフィルタリング**: 検出プロパティを抽出し、抽出した値に基づいてフィルタリングします（例：クラス名を抽出してクラス一覧でフィルタリングする、信頼度スコアを抽出してしきい値でフィルタリングする、条件付き処理のためにプロパティを抽出する）。これにより、プロパティベースの検出処理が可能になります
* **複数条件による処理**: 複数の検出条件に基づいて複雑な条件付き変換を適用します（例：クラスと信頼度の組み合わせに基づいて検出を変換する、異なる検出タイプごとに異なる操作を適用する、複数のプロパティに基づいて検出を条件付きで変更する）。これにより、高度な条件付き検出処理が可能になります
* **検出データの拡張**: 下流処理のために検出からプロパティを抽出して追加します（例：フィルタリング用にクラス名を抽出する、検出プロパティを計算する、検出にメタデータを追加する）。これにより、複雑なワークフロー向けに強化された検出データを利用できます
* **カスタム検出操作**: 専用ブロックでは利用できないカスタム変換を適用します（例：複雑な複数ステップの検出変更、カスタムなフィルタリングと変換の組み合わせ、特殊な検出処理ワークフロー）。これにより、柔軟なカスタム検出処理が可能になります

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

このブロックは検出予測を受け取り、変換後の検出を生成します：

* **検出ブロックの後に** （例：オブジェクト検出、インスタンスセグメンテーション、キーポイント検出）に対して、カスタム変換、フィルタリング、または変更を適用し、柔軟な検出処理ワークフローを可能にします
* **動的クロップブロックの前に** クロップ前に検出をフィルタリングまたは変更するために使用します（例：クロップ前にクラスで検出をフィルタリングする、クロップ前にボックスサイズを変換する、クロップ用に特定の検出を抽出する）。これにより、最適化された領域抽出ワークフローが可能になります
* **分類または分析ブロックの前に** カスタムなフィルタリングや変換によって検出を準備するために使用します（例：特定の分析向けに検出をフィルタリングする、互換性のためにボックスを変換する、独自の基準で検出を準備する）。これにより、カスタマイズされた検出準備が可能になります
* **複数段階の検出ワークフローでは** 段階間で検出にカスタム変換が必要な場合に使用します（例：二次処理の前に初期検出をフィルタリングして変換する、検出段階の間にカスタム変更を適用する、条件に基づいて検出を処理する）。これにより、高度な複数段階ワークフローが可能になります
* **可視化ブロックの前** 表示用に検出をフィルタリングまたは変換するために使用します（例：可視化用に検出をフィルタリングする、表示用にボックスを変換する、表示目的に合わせて検出をカスタマイズする）。これにより、最適化された視覚出力が可能になります
* **検出ブロックの後、他の変換ブロックの前に** 変換の間にカスタムロジックを適用するために使用します（例：検出後かつクロップ前にフィルタリングする、検出段階の間で変換する、条件付き変更を適用する）。これにより、カスタムロジックを含む複雑な変換パイプラインが可能になります

### タイプ識別子

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

### プロパティ

| **名前**       | **型**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | **説明**                                                                                                                                                                                                                                                                                                                                                         | 参照 |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -- |
| `name`       | `str`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | このステップの一意の識別子を入力してください。                                                                                                                                                                                                                                                                                                                                        | ❌  |
| `operations` | `List[Union[ClassificationPropertyExtract, ConvertDictionaryToJSON, ConvertImageToBase64, ConvertImageToJPEG, DetectionsFilter, DetectionsOffset, DetectionsPropertyExtract, DetectionsRename, DetectionsSelection, DetectionsShift, DetectionsToDictionary, Divide, ExtractDetectionProperty, ExtractFrameMetadata, ExtractImageProperty, LookupTable, Multiply, NumberRound, NumericSequenceAggregate, PickDetectionsByParentClass, RandomNumber, SequenceAggregate, SequenceApply, SequenceElementsCount, SequenceJoin, SequenceLength, SequenceMap, SortDetections, StringMatches, StringSubSequence, StringToLowerCase, StringToUpperCase, TimestampToISOFormat, ToBoolean, ToNumber, ToString]]` | 検出に対して順次適用するUQL（Query Language）操作の一覧です。操作は順番に実行され、各操作は前の操作の出力を受け取ります。サポートされる操作には、DetectionsFilter（条件による検出のフィルタリング）、ExtractDetectionProperty（検出からのプロパティ抽出）、バウンディングボックス変換（リサイズ、スケーリング）、および sv.Detections を受け取り、sv.Detections を返すすべてのUQL操作が含まれます。操作は operations\_parameters を使用してパラメータ化できます。操作チェーンは sv.Detections を sv.Detections に変換しなければなりません（型は保持される必要があります）.. | ❌  |

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

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

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

<details>

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

* input
  * `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)*]*): UQL操作を使用して変換する検出予測です。オブジェクト検出、インスタンスセグメンテーション、またはキーポイント検出の予測をサポートします。検出は operations フィールドで定義された操作チェーンによって変換されます。すべての変換は検出タイプを保持しなければなりません（出力は sv.Detections のままである必要があります）。このブロックはバッチ入力を処理し、バッチ項目ごとに変換を適用します..
  * `operations_parameters` ([*`*`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/wildcard.md)): 操作で使用されるパラメータ名をワークフローのデータソースまたは値に対応付ける辞書です。パラメータは操作内（例：条件文、フィルタリング操作）で参照され、実行時に提供されます。バッチパラメータ（予測結果に対応し、バッチ項目ごとに 1 つの値）と非バッチパラメータ（すべてのバッチ項目で同じ値）の両方をサポートします。パラメータはデータ構造に基づいて自動的にバッチと非バッチに分離されます。予約済みのパラメータ名は使用できません。これを使うと、操作を動的にパラメータ化できます（例：フィルタリング用のクラス一覧を渡す、条件用のしきい値を渡す、実行時パラメータを必要とする操作に値を供給する）..
* output
  * `predictions` (*Union\[*[*`object_detection_prediction`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/object-detection-prediction.md)*,* [*`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)*]*) : 検出されたバウンディングボックスをsv.Detections(...)オブジェクト形式で持つ予測、もし `object_detection_prediction` 、または検出されたバウンディングボックスとセグメンテーションマスクをsv.Detections(...)オブジェクト形式で持つ予測、もし `instance_segmentation_prediction` または、sv.Detections(...) オブジェクト形式の、検出されたバウンディングボックスとキーポイントを含む Prediction（もし `keypoint_detection_prediction`.

</details>

<details>

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

```json
{
	    "name": "<your_step_name_here>",
	    "type": "roboflow_core/detections_transformation@v1",
	    "predictions": "$steps.object_detection_model.predictions",
	    "operations": [
	        {
	            "filter_operation": {
	                "statements": [
	                    {
	                        "comparator": {
	                            "type": "in (Sequence)"
	                        },
	                        "left_operand": {
	                            "operations": [
	                                {
	                                    "property_name": "class_name",
	                                    "type": "ExtractDetectionProperty"
	                                }
	                            ],
	                            "type": "DynamicOperand"
	                        },
	                        "right_operand": {
	                            "operand_name": "classes",
	                            "type": "DynamicOperand"
	                        },
	                        "type": "BinaryStatement"
	                    }
	                ],
	                "type": "StatementGroup"
	            },
	            "type": "DetectionsFilter"
	        }
	    ],
	    "operations_parameters": {
	        "classes": "$inputs.classes"
	    }
	}
```

</details>
