imgaussfilt

Filtrado gaussiano 2D de imágenes

Sintaxis

B = imgaussfilt(A)

B = imgaussfilt(A,sigma)

B = imgaussfilt(___,Name=Value)

Descripción

B = imgaussfilt(A) filtra la imagen A con un núcleo de suavizado gaussiano 2D con desviación estándar de 0,5, y devuelve la imagen filtrada en B.

B = imgaussfilt(A,sigma) filtra la imagen A con un núcleo de suavizado gaussiano 2D con una desviación estándar que especifica sigma.

B = imgaussfilt(___,Name=Value) utiliza argumentos de nombre-valor para controlar aspectos del filtrado.

Ejemplos

Suavizado de imágenes con un filtro gaussiano

Lea la imagen que se desea filtrar.

I = imread("cameraman.tif");

Filtre la imagen con un filtro gaussiano con desviación estándar de 2.

Iblur = imgaussfilt(I,2);

Muestre la imagen original y la filtrada en un montaje.

montage({I,Iblur})
title("Original Image (Left) Vs. Gaussian Filtered Image (Right)")

Argumentos de entrada

A — Imagen que se desea filtrar

Arreglo numérico

Imagen que se desea filtrar, especificada como arreglo numérico de cualquier dimensión.

Tipos de datos: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32

sigma — Desviación estándar de la distribución gaussiana

0.5 (predeterminado) | número positivo | Vector de 2 elementos de números positivos

Desviación estándar de la distribución gaussiana, especificada como número positivo o vector de 2 elementos de números positivos. Si se especifica un escalar, imgaussfilt utiliza un núcleo gaussiano cuadrado.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Argumentos de par nombre-valor

Especifique pares de argumentos opcionales como Name1=Value1,...,NameN=ValueN, donde Name es el nombre del argumento y Value es el valor correspondiente. Los argumentos de nombre-valor deben aparecer después de otros argumentos. Sin embargo, el orden de los pares no importa.

Ejemplo: B = imgaussfilt(A,FilterSize=3); especifica un filtro de tamaño 3.

En las versiones anteriores a la R2021a, utilice comas para separar cada nombre y valor, y encierre Name entre comillas.

Ejemplo: B = imgaussfilt(A,"FilterSize",3);

FilterSize — Tamaño del filtro gaussiano

Entero positivo impar | Vector de 2 elementos de enteros positivos impares

Tamaño del filtro gaussiano, especificado como entero positivo impar o vector de 2 elementos de enteros positivos impares. Si se especifica un escalar, imgaussfilt utiliza un filtro cuadrado. El tamaño por defecto del filtro es 2*ceil(2*sigma)+1.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Padding — Relleno de imágenes

"replicate" (predeterminado) | Escalar numérico | "circular" | "symmetric"

Relleno de imágenes, especificado como uno de los siguientes valores de la tabla.

Valor	Descripción	Ejemplo
Escalar numérico, X	A los valores del arreglo de entrada que se encuentran fuera de los límites del arreglo se les asigna el valor X.	$$\left[\begin{array}{ccc}3& 1& 4\\ 1& 5& 9\\ 2& 6& 5\end{array}\right]\to \left[\begin{array}{ccccccc}2& 2& 2& 2& 2& 2& 2\\ 2& 2& 2& 2& 2& 2& 2\\ 2& 2& 3& 1& 4& 2& 2\\ 2& 2& 1& 5& 9& 2& 2\\ 2& 2& 2& 6& 5& 2& 2\\ 2& 2& 2& 2& 2& 2& 2\\ 2& 2& 2& 2& 2& 2& 2\end{array}\right]$$ muestra un relleno con el valor 2.
"symmetric"	Los valores del arreglo de entrada que se encuentran fuera de los límites del arreglo se calculan reflejando en espejo el arreglo a lo largo de su borde.	$$\left[\begin{array}{ccc}3& 1& 4\\ 1& 5& 9\\ 2& 6& 5\end{array}\right]\to \left[\begin{array}{ccccccc}5& 1& 1& 5& 9& 9& 5\\ 1& 3& 3& 1& 4& 4& 1\\ 1& 3& 3& 1& 4& 4& 1\\ 5& 1& 1& 5& 9& 9& 5\\ 6& 2& 2& 6& 5& 5& 6\\ 6& 2& 2& 6& 5& 5& 6\\ 5& 1& 1& 5& 9& 9& 5\end{array}\right]$$
"replicate"	Los valores del arreglo de entrada que se encuentran fuera de los límites del arreglo se asumen iguales que el valor de borde más cercano del arreglo.	$$\left[\begin{array}{ccc}3& 1& 4\\ 1& 5& 9\\ 2& 6& 5\end{array}\right]\to \left[\begin{array}{ccccccc}3& 3& 3& 1& 4& 4& 4\\ 3& 3& 3& 1& 4& 4& 4\\ 3& 3& 3& 1& 4& 4& 4\\ 1& 1& 1& 5& 9& 9& 9\\ 2& 2& 2& 6& 5& 5& 5\\ 2& 2& 2& 6& 5& 5& 5\\ 2& 2& 2& 6& 5& 5& 5\end{array}\right]$$
"circular"	Los valores del arreglo de entrada que se encuentran fuera de los límites del arreglo se calculan asumiendo implícitamente que el arreglo de entrada es periódico.	$$\left[\begin{array}{ccc}3& 1& 4\\ 1& 5& 9\\ 2& 6& 5\end{array}\right]\to \left[\begin{array}{ccccccc}5& 9& 1& 5& 9& 1& 5\\ 6& 5& 2& 6& 5& 2& 6\\ 1& 4& 3& 1& 4& 3& 1\\ 5& 9& 1& 5& 9& 1& 5\\ 6& 5& 2& 6& 5& 2& 6\\ 1& 4& 3& 1& 4& 3& 1\\ 5& 9& 1& 5& 9& 1& 5\end{array}\right]$$

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string

FilterDomain — Dominio en el que realizar el filtrado

"auto" (predeterminado) | "spatial" | "frequency"

Dominio en el que realizar el filtrado, especificado como uno de los siguientes valores:

Valor	Descripción
"auto"	Convolución en el dominio espacial o de la frecuencia basado en la heurística interna.
"frequency"	Convolución en el dominio de la frecuencia.
"spatial"	Convolución en el dominio espacial.

Tipos de datos: char | string

Argumentos de salida

B — Imagen filtrada

Arreglo numérico

Imagen filtrada, devuelta como arreglo numérico de la misma clase y tamaño que la imagen de entrada, A.

Sugerencias

• Si la imagen A contiene elementos con valores Inf o NaN, el comportamiento de imgaussfilt para el filtrado en el dominio de la frecuencia se encuentra indefinido. Esto puede ocurrir si se establece el argumento nombre-valor de FilterDomain como "frequency" o si se establece como "auto" y imgaussfilt utiliza el filtrado en el dominio de la frecuencia. Para restringir la propagación de Inf y NaN en la salida de forma similar a imfilter, plantéese establecer el argumento nombre-valor FilterDomain como "spatial".

• Si establece el argumento nombre-valor FilterDomain como "auto", imgaussfilt utiliza una heurística interna para determinar si el filtrado en el dominio espacial o en el de la frecuencia es más rápido. Esta heurística depende de la máquina y puede variar en función de las diferentes configuraciones. Para obtener un rendimiento óptimo, pruebe ambas opciones, "spatial" y "frequency", para determinar el mejor dominio de filtrado para su imagen y el tamaño del núcleo.

• Si no se especifica el argumento nombre-valor Padding, imgaussfilt utiliza por defecto el relleno de "replicate", que es diferente del que utiliza imfilter.

Capacidades ampliadas

Generación de código C/C++

Genere código C y C++ mediante MATLAB® Coder™.

Notas y limitaciones de uso:

• imgaussfilt es compatible con la generación de código C (requiere MATLAB^® Coder™). Tenga en cuenta que, si selecciona la plataforma objetivo genérica MATLAB Host Computer, imgaussfilt genera código que utiliza una biblioteca compartida precompilada específica de la plataforma. El uso de una biblioteca compartida mantiene las optimizaciones de rendimiento, pero limita las plataformas objetivo para las que se puede generar código. Para obtener más información, consulte Types of Code Generation Support in Image Processing Toolbox.

• imgaussfilt no es compatible con el argumento nombre-valor FilterDomain especificado como "frequency". El filtrado se realiza siempre en el dominio espacial del código generado.

• Cuando se genera código, todos los argumentos del vector de cadena y de caracteres de entrada deben ser constantes de tiempo de compilación.

Generación de código de GPU

Genere código CUDA® para GPU NVIDIA® mediante GPU Coder™.

Notas y limitaciones de uso:

• imgaussfilt no es compatible con el argumento nombre-valor FilterDomain especificado como "frequency". El filtrado se realiza siempre en el dominio espacial del código generado.

• Cuando se genera código, todos los argumentos del vector de cadena y de caracteres de entrada deben ser constantes de tiempo de compilación.

Entorno basado en subprocesos

Ejecute código en segundo plano con MATLAB® backgroundPool o acelere código con Parallel Computing Toolbox™ ThreadPool.

Esta función es totalmente compatible con los entornos basados en hilos. Para obtener más información, consulte Ejecutar funciones de MATLAB en entornos basados en subprocesos.

Arreglos GPU

Acelere código mediante la ejecución en una unidad de procesamiento gráfico (GPU) mediante Parallel Computing Toolbox™.

Esta función es totalmente compatible con los arreglos de GPU. Para obtener más información, consulte Procesamiento de imágenes en una GPU.

Historial de versiones

Introducido en R2015a

R2022b: Compatibilidad con entornos basados en hilos

Ahora imgaussfilt es compatible con los entornos basados en hilos.

Consulte también

imgaussfilt3 | imfilter | fspecial

Temas

• Opciones de relleno de límites de imfilter