> 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` | ぼかしカーネルのサイズ（正の値で、通常は奇数である必要があります）。ぼかしの強さを制御します。値が大きいほどぼかしは強くなり、値が小さいほどぼかしは弱くなります。average と gaussian のぼかしでは、これはカーネルの幅と高さです（例: 5 は 5x5 カーネルを意味します）。median ぼかしでは、奇数の整数である必要があります（自動的に処理されます）。bilateral ぼかしでは、ピクセル近傍の直径を制御します。一般的な値は 3〜15 の範囲で、小さい値（3〜5）は控えめなぼかし、中程度の値（5〜9）は適度なぼかし、大きい値（11〜15）は強いぼかしを提供します。デフォルトは 5 で、適度なぼかしを提供します。画像サイズと希望するぼかし強度に応じて調整してください..                              | ✅  |

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

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

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

<details>

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

* 入力
  * `画像` ([*`画像`*](/workflows/ja/gaido/developer-guide/kinds/image.md)): ぼかしフィルタリングを適用する入力画像。ブロックは、設定されたカーネルサイズで指定のぼかし種類を適用します。カラー画像とグレースケール画像の両方で動作します。ぼかし画像は、選択したぼかし種類とカーネルサイズに応じて、ディテールの低減、テクスチャの平滑化、ノイズ低減が行われます。元の画像のメタデータは出力に保持されます..
  * `blur_type` ([*`string`*](/workflows/ja/gaido/developer-guide/kinds/string.md)): 適用するぼかしアルゴリズムの種類: 'average' は均一なぼかしのための単純なボックスフィルターを使用し（高速、基本的な平滑化）、'gaussian'（デフォルト）は滑らかで自然なぼかしのためのガウス重み付きカーネルを使用し（高品質、構造を保持）、'median' はエッジを保持しながらノイズを除去する非線形メディアンフィルターを使用し（インパルスノイズ、塩胡椒ノイズに最適）、'bilateral' はエッジ保持フィルターを使用して似た色をぼかしながら鋭いエッジを維持します（エッジ保持を伴うノイズ除去に適しています）。デフォルトは汎用のぼかしに適した 'gaussian' です。要件に応じて選択してください: 速度重視なら average、品質重視なら gaussian、ノイズ除去なら median、エッジ保持なら bilateral..
  * `カーネルサイズ` ([*`integer`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)): ぼかしカーネルのサイズ（正の値で、通常は奇数である必要があります）。ぼかしの強さを制御します。値が大きいほどぼかしは強くなり、値が小さいほどぼかしは弱くなります。average と gaussian のぼかしでは、これはカーネルの幅と高さです（例: 5 は 5x5 カーネルを意味します）。median ぼかしでは、奇数の整数である必要があります（自動的に処理されます）。bilateral ぼかしでは、ピクセル近傍の直径を制御します。一般的な値は 3〜15 の範囲で、小さい値（3〜5）は控えめなぼかし、中程度の値（5〜9）は適度なぼかし、大きい値（11〜15）は強いぼかしを提供します。デフォルトは 5 で、適度なぼかしを提供します。画像サイズと希望するぼかし強度に応じて調整してください..
* 出力
  * `画像` ([`画像`](/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>