ordfilt2

Filtrado de orden estadístico 2D

Sintaxis

B = ordfilt2(A,order,domain)

B = ordfilt2(A,order,domain,S)

B = ordfilt2(___,padopt)

Descripción

B = ordfilt2(A,order,domain) sustituye cada elemento de A por el order-ésimo elemento en el conjunto ordenado de vecinos especificado por los elementos distintos de cero en domain.

B = ordfilt2(A,order,domain,S) filtra A, donde ordfilt2 utiliza los valores de S correspondientes a los valores distintos de cero de domain como desplazamientos aditivos. Puede utilizar esta sintaxis para implementar operaciones morfológicas en escala de grises, incluyendo la dilatación y la erosión en escala de grises.

B = ordfilt2(___,padopt) filtra A, donde padopt especifica la forma en la que ordfilt2 rellena los límites de la matriz.

Ejemplos

Filtrar una imagen con el filtro máximo

Lea una imagen en el área de trabajo y muéstrela.

A = imread('snowflakes.png');
figure
imshow(A)

Filtre la imagen y muestre el resultado.

B = ordfilt2(A,25,true(5));
figure
imshow(B)

Argumentos de entrada

A — Datos que se desea filtrar

Matriz numérica 2D | Matriz lógica 2D

Datos que se desea filtrar, especificados como matriz lógica 2D o matriz numérica 2D.

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

order — Elemento para reemplazar el píxel de destino

entero positivo

Elemento para reemplazar el píxel de destino, especificado como un entero escalar real.

Tipos de datos: double

domain — Entorno

Matriz numérica 2D | Matriz lógica 2D

Entorno, especificado como una matriz numérica o lógica que contiene valores 1 y 0. domain es equivalente al elemento estructurante utilizado para las operaciones de imagen binaria. Los elementos con valor 1 definen el entorno para la operación de filtrado. La tabla ofrece ejemplos de algunos filtros comunes.

Tipo de operación de filtrado	Código de muestra	Entorno	Datos de la imagen de muestra, indicando el elemento seleccionado
Filtro de mediana	B = ordfilt2(A,5,ones(3,3))
Filtro mínimo	B = ordfilt2(A,1,ones(3,3))
Filtro máximo	B = ordfilt2(A,9,ones(3,3))
Un mínimo de vecinos al norte, este, sur y oeste	B = ordfilt2(A,1,[0 1 0; 1 0 1; 0 1 0])

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

S — Desplazamientos aditivos

Matriz numérica

Desplazamientos aditivos, especificados como matriz numérica del mismo tamaño que domain.

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

padopt — Opción de relleno

"zeros" (predeterminado) | "symmetric"

Opción de relleno, especificada como uno de los siguientes valores:

Opción	Descripción	Ejemplo
"zeros"	Rellenar los límites del arreglo con el valor 0.	$$\left[\begin{array}{ccc}3& 1& 4\\ 1& 5& 9\\ 2& 6& 5\end{array}\right]\to \left[\begin{array}{ccccccc}0& 0& 0& 0& 0& 0& 0\\ 0& 0& 0& 0& 0& 0& 0\\ 0& 0& 3& 1& 4& 0& 0\\ 0& 0& 1& 5& 9& 0& 0\\ 0& 0& 2& 6& 5& 0& 0\\ 0& 0& 0& 0& 0& 0& 0\\ 0& 0& 0& 0& 0& 0& 0\end{array}\right]$$
"symmetric"	Rellenar el arreglo con reflejos de espejo de sí mismo.	$$\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]$$

Tipos de datos: char | string

Argumentos de salida

B — Datos filtrados

Matriz numérica 2D | Matriz lógica 2D

Datos filtrados, devueltos como una matriz numérica 2D o una matriz lógica 2D del mismo tipo de datos que los datos de entrada A.

Sugerencias

• Cuando se trabaja con matrices de dominios grandes que no contienen ningún elemento de valor cero, ordfilt2 puede lograr un mayor rendimiento si A está en un formato de datos enteros (uint8, int8, uint16, int16). La ganancia de velocidad es mayor para uint8 e int8 que para los tipos de datos de 16 bits. Para los formatos de datos de 8 bits, la matriz de dominios debe contener siete o más filas. Para los formatos de datos de 16 bits, la matriz de dominios debe contener tres o más filas y 520 o más elementos.

Referencias

[1] Haralick, Robert M., and Linda G. Shapiro, Computer and Robot Vision, Volume I, Addison-Wesley, 1992.

[2] Huang, T. S., G. J. Yang, and G. Y. Tang. "A fast two-dimensional median filtering algorithm.", IEEE transactions on Acoustics, Speech and Signal Processing, Vol ASSP 27, No. 1, February 1979.

Capacidades ampliadas

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

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

Notas y limitaciones de uso:

• ordfilt2 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, ordfilt2 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.

• A la hora de generar código, el argumento padopt debe ser una constante en 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:

• La generación de código GPU requiere que las entradas estén acotadas. Si la entrada es de dimensión variable, el software genera código C.

• A la hora de generar código, el argumento padopt debe ser una constante en tiempo de compilación.

• El código GPU generado no está optimizado si el valor domain que define el entorno para la operación de filtrado tiene un tamaño superior a 11 por 11.

  Para un mejor rendimiento, considere la posibilidad de establecer la opción StackLimitPerThread del objeto coder.gpuConfig (GPU Coder) en Inf.

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 antes de R2006a

R2022b: Compatibilidad con entornos basados en hilos

Ahora ordfilt2 es compatible con los entornos basados en hilos.

Consulte también

medfilt2

Temas

• Opciones de relleno de límites de imfilter