> 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/image-blur.md).

# 画像ぼかし

画像にぼかしを適用します。

平均、ガウシアン、メディアン、またはバイラテラルといったさまざまなぼかしアルゴリズムを使用して、設定可能なぼかしフィルターを画像に適用し、画像の細部を滑らかにしてノイズを低減し、ノイズ低減、プライバシー保護、前処理、画像強調のワークフロー向けにぼかし効果を作成します。

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

このブロックは、4種類のぼかしアルゴリズムのいずれかを使用して画像にぼかしフィルタリングを適用します。各アルゴリズムには異なる特性と用途があります。このブロックは:

1. ぼかしフィルタリングを適用する入力画像を受け取ります
2. blur\_type パラメータに基づいてぼかしアルゴリズムを選択します
3. 指定された kernel\_size を使用して、選択したぼかし方法を適用します:

   **平均ぼかしの場合:**

   * 各ピクセルを近傍の平均値に置き換えるシンプルなボックスフィルターを使用します
   * カーネル領域内のすべてのピクセルに均一なぼかしを作成します
   * 一般的な平滑化に適した、高速でシンプルなぼかしです
   * 基本的なノイズ低減と平滑化に適しています

   **ガウシアンぼかしの場合:**

   * 中心に近いピクセルほど重みを大きくするガウシアン重み付きカーネルを使用します
   * 中心から徐々に弱まる、滑らかで自然な見た目のぼかしを作成します
   * 平均ぼかしよりも画像構造をよりよく保持する高品質なぼかしを提供します
   * 一般用途のぼかし、ノイズ低減、前処理に適しています

   **メディアンぼかしの場合:**

   * 各ピクセルを近傍の中央値に置き換える非線形フィルターを使用します
   * エッジを保持しながら、塩胡椒ノイズの除去に特に効果的です
   * 線形ぼかし手法よりも鋭いエッジを保持するのに優れています
   * インパルスノイズ、スペックルノイズ、またはアーティファクトを含む画像のノイズ低減に適しています

   **バイラテラルぼかしの場合:**

   * エッジを保持しながらぼかしを行う非線形フィルターを使用します
   * 空間的な平滑化と強度の類似性を組み合わせます（似た色はぼかし、異なる色の間のエッジは保持します）
   * ノイズを低減し、テクスチャを滑らかにしながら、鋭いエッジと境界を維持します
   * エッジ保持が重要なノイズ低減、画像のノイズ除去、ディテールの平滑化に適しています
4. 元の画像のメタデータを保持します
5. ぼかしフィルタリングが適用されたぼかし画像を返します

kernel\_size パラメータはぼかしの強さを制御します。値が大きいほどぼかしが強くなり、小さいほど弱くなります。ぼかしの種類によって特性は異なります。Average と Gaussian は一般的な平滑化を提供し、Median はノイズ除去に非常に優れ、Bilateral はエッジを保持しながら平滑化します。ぼかしタイプの選択は、一般的な平滑化、ノイズ低減、エッジ保持、またはアーティファクト除去など、具体的な要件によって決まります。

## 一般的な使用例

* **ノイズ低減**: ぼかしフィルタリングを使用して画像のノイズやアーティファクトを低減します（例: カメラ画像のノイズ除去、圧縮アーティファクトの低減、画像の欠点の平滑化）。ノイズ低減ワークフローを可能にします
* **プライバシー保護**: 画像内の機密領域や顔にぼかしを適用します（例: プライバシー保護のために顔をぼかす、機密情報を隠す、画像コンテンツを匿名化する）。プライバシー保護ワークフローを可能にします
* **画像前処理**: 後続の処理や分析の前に画像を滑らかにします（例: 検出前に画像を前処理する、分析前に画像を滑らかにする、処理前にノイズを低減する）。前処理ワークフローを可能にします
* **ディテールの平滑化**: 画像の細かいディテールやテクスチャを滑らかにします（例: ポートレートの肌を滑らかにする、テクスチャのディテールを減らす、より柔らかな見た目を作る）。ディテール平滑化ワークフローを可能にします
* **アーティファクト除去**: 画像からアーティファクトや欠点を除去します（例: 圧縮アーティファクトの除去、JPEG アーティファクトの低減、画像の欠陥の平滑化）。アーティファクト除去ワークフローを可能にします
* **背景ぼかし**: 被写界深度効果を作成したり、背景をぼかしたりします（例: 背景をぼかしてフォーカス効果を出す、ボケ効果を作る、前景の被写体を強調する）。背景ぼかしワークフローを可能にします

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

このブロックは画像を受け取り、ぼかし画像を生成します:

* **画像入力ブロックの後に** 後続の処理の前に入力画像をぼかします（例: カメラフィードからの画像をぼかす、画像入力のノイズを低減する、ワークフロー用に画像を前処理する）。画像ぼかしワークフローを可能にします
* **検出または分類モデルの前に** ノイズ低減を伴う画像前処理を行います（例: 物体検出の前にノイズを低減する、分類前に画像を滑らかにする、モデル入力用に画像を前処理する）。前処理済みモデル入力ワークフローを可能にします
* **前処理ブロックの後に** 他の前処理ステップの後にぼかしを適用します（例: フィルタリング後にぼかす、強調後に平滑化する、処理後にアーティファクトを低減する）。多段階前処理ワークフローを可能にします
* **可視化ブロックの前** ぼかし画像を表示します（例: プライバシー保護された画像を可視化する、平滑化された画像を表示する、ぼかし効果を示す）。ぼかし画像の可視化ワークフローを可能にします
* **プライバシー保護ワークフローでは** 機密領域にぼかしが必要な場合（例: プライバシーワークフローで顔をぼかす、機密コンテンツを隠す、画像データを匿名化する）。プライバシー保護ワークフローを可能にします
* **ノイズ低減パイプラインでは** ぼかしがより大きなノイズ除去ワークフローの一部となっている場合（例: 多段階パイプラインでノイズを低減する、アーティファクト除去のためにぼかしを適用する、処理チェーン内で画像を平滑化する）。ノイズ低減パイプラインワークフローを可能にします

### タイプ識別子

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

### プロパティ

| **名前**      | **型** | **説明**                                                                                                                                                                                                                                                                                                                                                                                            | 参照 |
| ----------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -- |
| `name`      | `str` | このステップの一意の識別子を入力してください。                                                                                                                                                                                                                                                                                                                                                                           | ❌  |
| `blur_type` | `str` | 適用するぼかしアルゴリズムの種類: 'average' は単純なボックスフィルターを使用して均一なぼかしを行い（高速で基本的な平滑化）、'gaussian'（既定値）はガウシアン重み付きカーネルを使用して滑らかで自然なぼかしを行い（高品質で構造を保持）、'median' は非線形の中央値フィルターを使用してエッジを保持しながらノイズを除去し（インパルスノイズや塩胡椒ノイズに非常に有効）、'bilateral' はエッジを保持するフィルターを使用して似た色をぼかしながら鋭いエッジを維持します（エッジ保持を伴うノイズ除去に適しています）。既定値は 'gaussian' で、一般用途に良いぼかしを提供します。要件に応じて選択してください: 速度重視なら average、品質重視なら gaussian、ノイズ除去なら median、エッジ保持なら bilateral。 | ✅  |
| `カーネルサイズ`   | `int` | ぼかしカーネルのサイズ（正の奇数である必要があり、通常は奇数）。ぼかしの強さを制御します。値が大きいほどぼかしが強くなり、小さいほど弱くなります。平均ぼかしとガウシアンぼかしでは、これはカーネルの幅と高さです（例: 5 は 5x5 カーネルを意味します）。ガウシアンぼかしとメディアンぼかしでは、カーネルサイズは正の奇数整数でなければなりません。偶数または非正の値は自動的に次の正の奇数値に丸められます。バイラテラルぼかしでは、これはピクセル近傍の直径を制御します。一般的な値の範囲は 3～15 です。小さい値（3～5）はさりげないぼかし、中程度の値（5～9）は中程度のぼかし、大きい値（11～15）は強いぼかしを提供します。既定値は 5 で、中程度のぼかしを提供します。画像サイズと望ましいぼかし強度に応じて調整してください。                      | ✅  |

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

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

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

<details>

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

* input
  * `image` ([*`image`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/image.md)): ぼかしフィルタリングを適用する入力画像です。このブロックは、設定されたカーネルサイズで指定されたぼかしタイプを適用します。カラー画像にもグレースケール画像にも対応します。生成されるぼかし画像は、選択されたぼかしタイプとカーネルサイズに応じて、細部の低減、テクスチャの平滑化、ノイズ低減が行われます。元の画像のメタデータは出力に保持されます。
  * `blur_type` ([*`string`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/string.md)): 適用するぼかしアルゴリズムの種類: 'average' は単純なボックスフィルターを使用して均一なぼかしを行い（高速で基本的な平滑化）、'gaussian'（既定値）はガウシアン重み付きカーネルを使用して滑らかで自然なぼかしを行い（高品質で構造を保持）、'median' は非線形の中央値フィルターを使用してエッジを保持しながらノイズを除去し（インパルスノイズや塩胡椒ノイズに非常に有効）、'bilateral' はエッジを保持するフィルターを使用して似た色をぼかしながら鋭いエッジを維持します（エッジ保持を伴うノイズ除去に適しています）。既定値は 'gaussian' で、一般用途に良いぼかしを提供します。要件に応じて選択してください: 速度重視なら average、品質重視なら gaussian、ノイズ除去なら median、エッジ保持なら bilateral。
  * `カーネルサイズ` ([*`integer`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/integer.md)): ぼかしカーネルのサイズ（正の奇数である必要があり、通常は奇数）。ぼかしの強さを制御します。値が大きいほどぼかしが強くなり、小さいほど弱くなります。平均ぼかしとガウシアンぼかしでは、これはカーネルの幅と高さです（例: 5 は 5x5 カーネルを意味します）。ガウシアンぼかしとメディアンぼかしでは、カーネルサイズは正の奇数整数でなければなりません。偶数または非正の値は自動的に次の正の奇数値に丸められます。バイラテラルぼかしでは、これはピクセル近傍の直径を制御します。一般的な値の範囲は 3～15 です。小さい値（3～5）はさりげないぼかし、中程度の値（5～9）は中程度のぼかし、大きい値（11～15）は強いぼかしを提供します。既定値は 5 で、中程度のぼかしを提供します。画像サイズと望ましいぼかし強度に応じて調整してください。
* output
  * `image` ([`image`](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/image.md)）：ワークフロー内の画像。

</details>

<details>

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

```json
{
	    "name": "<your_step_name_here>",
	    "type": "roboflow_core/image_blur@v1",
	    "image": "$inputs.image",
	    "blur_type": "gaussian",
	    "kernel_size": 5
	}
```

</details>
