imboxfilt3

Filtrado de cuadro 3D de imágenes 3D

Sintaxis

B = imboxfilt3(A)

B = imboxfilt3(A,filterSize)

B = imboxfilt3(___,Name,Value)

Descripción

B = imboxfilt3(A) filtra la imagen 3D A con un filtro de cuadro 3D de un tamaño de 3 por 3 por 3.

B = imboxfilt3(A,filterSize) filtra la imagen 3D A con un filtro de cuadro de un tamaño filterSize.

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

Ejemplos

Calcular el filtro de media del volumen de una resonancia magnética

Cargue los datos de la imagen 3D en el área de trabajo.

volData = load('mri');
vol = squeeze(volData.D);

Filtre la imagen con un filtro de cuadro 3D.

localMean = imboxfilt3(vol,[5 5 3]);

Argumentos de entrada

A — Imagen que se desea filtrar

Arreglo numérico 3D

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

Si A contiene Infs o NaNs, el comportamiento de imboxfilt3 es indefinido. Esto puede suceder cuando se utiliza el filtrado integral basado en imágenes. Para restringir la propagación de Infs y NaNs en la salida, considere utilizar imfilter en su lugar.

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

filterSize — Tamaño del filtro de cuadro

3 (predeterminado) | Entero positivo impar | Vector de 3 elementos de enteros positivos impares

Tamaño del filtro de cuadro, especificado como entero positivo impar o vector de 3 elementos de enteros positivos impares. Si filterSize es escalar, el filtro es un cubo.

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.

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

Ejemplo: B = imboxfilt3(A,5,'padding','circular');

Padding — Patrón de relleno

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

Patrón de relleno, especificado como uno de los siguientes valores o como escalar numérico. Si especifica un valor escalar, se asume implícitamente que los píxeles de la imagen de entrada fuera de los límites de la imagen tienen el valor escalar.

Valor	Descripción
'circular'	Los valores de la imagen de entrada que se encuentran fuera de los límites de la imagen se calculan asumiendo implícitamente que la imagen de entrada es periódica.
'replicate'	Se asume que los valores de la imagen de entrada que se encuentran fuera de los límites de la imagen son iguales al valor de borde más cercano de la imagen.
'symmetric'	Los valores de la imagen de entrada que se encuentran fuera de los límites de la imagen se calculan reflejando en espejo el arreglo a lo largo de su borde.

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

NormalizationFactor — Factor de normalización aplicado al filtro de cuadro

1/filterSize.^3, si es escalar, y 1/prod(filterSize), si es vector (predeterminado) | Escalar numérico

Factor de normalización aplicado al filtro de cuadro, especificado como escalar numérico.

El valor predeterminado 'NormalizationFactor' tiene el efecto de un filtro de media: los píxeles de la imagen de salida son las medias locales de la imagen. Para obtener sumas de áreas locales, establezca 'NormalizationFactor' en 1. Para evitar el desbordamiento en tales circunstancias, considere utilizar imágenes de doble precisión convirtiendo la imagen de entrada a la clase double.

Ejemplo: 'NormalizationFactor',1

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

Argumentos de salida

B — Imagen filtrada

Arreglo numérico 3D

Imagen filtrada, devuelta como un arreglo numérico 3D.

Algoritmos

imboxfilt realiza el filtrado utilizando el filtrado basado en convolución o el filtrado de imagen integral, con una heurística interna para determinar qué enfoque de filtrado se utilizará.

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.

Historial de versiones

Introducido en R2015b

R2022b: Compatibilidad con entornos basados en hilos

Ahora imboxfilt3 es compatible con los entornos basados en hilos.

Consulte también

imboxfilt | imfilter | integralBoxFilter3