imgaussfilt3

Filtrado gaussiano 3D de imágenes 3D

Sintaxis

B = imgaussfilt3(A)

B = imgaussfilt3(A,sigma)

B = imgaussfilt3(___,Name=Value)

Descripción

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

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

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

Ejemplos

Suavizado del volumen de una resonancia magnética con filtrado gaussiano 3D

Cargue los datos de resonancia magnética y muéstrelos.

vol = load('mri');
figure
montage(vol.D)
title('Original image volume')

Suavice las imágenes con un filtrado gaussiano 3D.

siz = vol.siz;
vol = squeeze(vol.D);   
sigma = 2;
 
volSmooth = imgaussfilt3(vol, sigma);
  
figure
montage(reshape(volSmooth,siz(1),siz(2),1,siz(3)))
title('Gaussian filtered image volume')

Argumentos de entrada

A — Imagen que se desea filtrar

Arreglo numérico 3D

Imagen que se desea filtrar, especificada como arreglo numérico 3D.

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

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

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

Desviación estándar de la distribución gaussiana, especificada como número positivo o vector de 3 elementos de números positivos. Si sigma es un escalar, imgaussfilt3 utiliza un núcleo gaussiano cúbico.

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: volSmooth = imgaussfilt3(vol,sigma,Padding="circular"); especifica el relleno circular.

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

Ejemplo: volSmooth = imgaussfilt3(vol,sigma,"Padding","circular");

FilterSize — Tamaño del filtro gaussiano

entero positivo impar | Vector de 3 elementos de enteros positivos impares

Tamaño del filtro gaussiano, especificado como entero positivo impar o vector de 3 elementos de enteros positivos impares. Si se especifica un escalar, imgaussfilt3 utiliza un filtro cúbico. 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) | "circular" | "symmetric" | Escalar numérico

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) | "frequency" | "spatial"

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

Dominio del filtro	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 un arreglo numérico del mismo tipo de datos y tamaño que la imagen de entrada.

Sugerencias

• Si la imagen A contiene valores Inf o NaN, el comportamiento de imgaussfilt3 para el filtrado en el dominio de la frecuencia se encuentra indefinido. Esto puede ocurrir si se establece el argumento FilterDomain como "frequency" o si se establece como "auto" e imgaussfilt3 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, considere establecer el argumento FilterDomain como "spatial".

• Si establece el argumento FilterDomain como "auto", imgaussfilt3 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 para 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 Padding, imgaussfilt3 utiliza por defecto el relleno de "replicate", que es diferente del que utiliza imfilter.

Capacidades ampliadas

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 imgaussfilt3 es compatible con los entornos basados en hilos.

Consulte también

imgaussfilt | imfilter

Temas

• Opciones de relleno de límites de imfilter