> 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/classical-computer-vision/size-measurement.md).

# サイズ測定

この **サイズ測定ブロック**

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

youtube.com/watch?v=FQY7TSHfZeI) は、参照オブジェクトに対するオブジェクトの寸法を計算します。1つのモデルで参照オブジェクトを検出し、別のモデルで測定対象のオブジェクトを検出します。このブロックは、参照オブジェクトを基準にしたオブジェクトの寸法を出力します。

* **参照オブジェクト**: これは測定の基準として使用される既知のオブジェクトです。その寸法は既知であり、他のオブジェクトの測定値をスケーリングするために使用されます。
* **測定対象オブジェクト**: これは寸法を計算しているオブジェクトです。このブロックは、これらの寸法を参照オブジェクトに対して相対的に測定します。

### ブロックの使用方法

サイズ測定ブロックを使用するには、次の手順に従ってください：

1. **モデルを選択**: 参照オブジェクトを検出するモデルと、測定したいオブジェクトを検出する別のモデルを選択します。
2. **入力を設定**: 両方のモデルの予測結果をブロックへの入力として指定します。
3. **参照寸法を設定**: 参照オブジェクトの既知の寸法を、'width,height' 形式またはタプル (width, height) で指定します。
4. **ブロックを実行**: ブロックを実行して、検出されたオブジェクトの寸法を参照オブジェクトに対して相対的に計算します。

### 例

キャリブレーションカードといくつかの荷物があるシーンを想像してください。キャリブレーションカードの既知の寸法は 5.0インチ × 3.0インチです。シーン内の荷物の寸法を測定したいとします。

* **参照オブジェクト**: 寸法が 5.0インチ（幅）× 3.0インチ（高さ）のキャリブレーションカード。
* **測定対象のオブジェクト**: シーンで検出された荷物。

このブロックは、キャリブレーションカードの既知の寸法を使用して各荷物の寸法を計算します。たとえば、ある荷物が幅100ピクセル、高さ60ピクセルで検出され、キャリブレーションカードが幅50ピクセル、高さ30ピクセルで検出された場合、このブロックは荷物の寸法を次のように計算します：

* **幅**: (100ピクセル / 50ピクセル) \* 5.0インチ = 10.0インチ
* **高さ**: (60ピクセル / 30ピクセル) \* 3.0インチ = 6.0インチ

これにより、参照オブジェクトの既知のサイズを基に、荷物の実世界の寸法を取得できます。

[動画チュートリアルを見る](https://www.youtube.com/watch?v=FQY7TSHfZeI)

### 型識別子

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

### プロパティ

| **名前**                  | **型**                                          | **説明**                                                                      | 参照 |
| ----------------------- | ---------------------------------------------- | --------------------------------------------------------------------------- | -- |
| `name`                  | `str`                                          | このステップの一意の識別子を入力してください。                                                     | ❌  |
| `reference_predictions` | `List[Any]`                                    | 指定されたオブジェクトの寸法を計算するために使用される参照オブジェクトです。複数のオブジェクトが指定された場合は、信頼度が最も高い予測が使用されます。 | ✅  |
| `reference_dimensions`  | `Union[List[float], Tuple[float, float], str]` | 参照オブジェクトの寸法を指定した単位（例：インチ）で表したものです。他のオブジェクトのピクセル寸法を実世界の単位に変換するために使用されます。     | ✅  |

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

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

利用可能な接続は、そのバインディング種別によって異なります。どのバインディング種別が `サイズ測定` のバージョン `v1` あるか確認してください。

<details>

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

* 入力
  * `object_predictions` (*Union\[*[*`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)*]*): 寸法を測定する対象のモデル予測結果。
  * `reference_predictions` (*Union\[*[*`object_detection_prediction`*](/workflows/ja/gaido/developer-guide/kinds/object-detection-prediction.md)*,* [*`list_of_values`*](/workflows/ja/gaido/developer-guide/kinds/list-of-values.md)*,* [*`instance_segmentation_prediction`*](/workflows/ja/gaido/developer-guide/kinds/instance-segmentation-prediction.md)*]*): 指定されたオブジェクトの寸法を計算するために使用される参照オブジェクトです。複数のオブジェクトが指定された場合は、信頼度が最も高い予測が使用されます。
  * `reference_dimensions` (*Union\[*[*`list_of_values`*](/workflows/ja/gaido/developer-guide/kinds/list-of-values.md)*,* [*`string`*](/workflows/ja/gaido/developer-guide/kinds/string.md)*]*): 参照オブジェクトの寸法を指定した単位（例：インチ）で表したものです。他のオブジェクトのピクセル寸法を実世界の単位に変換するために使用されます。
* 出力
  * `寸法` ([`list_of_values`](/workflows/ja/gaido/developer-guide/kinds/list-of-values.md))：任意の型の値のリスト。

</details>

<details>

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

```json
{
	    "name": "<your_step_name_here>",
	    "type": "roboflow_core/size_measurement@v1",
	    "object_predictions": "$segmentation.object_predictions",
	    "reference_predictions": "$segmentation.reference_predictions",
	    "reference_dimensions": [
	        4.5,
	        3.0
	    ]
	}
```

</details>