La traducción de esta página aún no se ha actualizado a la versión más reciente. Haga clic aquí para ver la última versión en inglés.

adaptthresh

Umbral adaptativo de la imagen utilizando estadísticas locales de primer orden

Sintaxis

T = adaptthresh(I)

T = adaptthresh(I,sensitivity)

T = adaptthresh(___,Name=Value)

Descripción

T = adaptthresh(I) calcula un umbral localmente adaptativo para una imagen 2D en escala de grises o un volumen 3D en escala de grises I. La función adaptthresh elige el umbral basándose en la intensidad media local (estadísticas de primer orden) en el entorno de cada píxel. El umbral T se puede usar con la función imbinarize para convertir una imagen en escala de grises en una imagen binaria.

T = adaptthresh(I,sensitivity) calcula un umbral localmente adaptativo usando un factor de sensibilidad para que más píxeles se consideren como primer plano al utilizar el umbral.

T = adaptthresh(___,Name=Value) calcula un umbral localmente adaptativo utilizando pares nombre-valor para controlar aspectos del uso de umbrales.

Ejemplos

Buscar umbral y segmentar granos de arroz claros contra un fondo oscuro

Lea una imagen en el área de trabajo.

I = imread('rice.png');

Utilice adaptthresh para determinar el umbral y utilizarlo en la operación de binarización.

T = adaptthresh(I, 0.4);

Convierta la imagen en una imagen binaria especificando el valor del umbral.

BW = imbinarize(I,T);

Muestre la imagen original junto con su versión binaria, una al lado de la otra.

figure
imshowpair(I, BW, 'montage')

Buscar umbral y segmentar texto oscuro contra un fondo claro

Lea una imagen en el área de trabajo.

I = imread('printedtext.png');

adaptthresh permite calcular el umbral adaptativo y muestra la imagen del umbral local. Esto representa una estimación de la iluminación de fondo promedia.

T = adaptthresh(I,0.4,'ForegroundPolarity','dark');
figure
imshow(T)

Binarice la imagen utilizando el umbral local adaptativo.

BW = imbinarize(I,T);
figure
imshow(BW)

Calcular el umbral de un volumen 3D

Cargue un volumen 3D en el área de trabajo.

load mristack;
V = mristack;

Muestre los datos.

figure
slice(double(V),size(V,2)/2,size(V,1)/2,size(V,3)/2)
colormap gray
shading interp

Calcule el umbral.

J = adaptthresh(V,'neigh',[3 3 3],'Fore','bright');

Muestre el umbral.

figure
slice(double(J),size(J,2)/2,size(J,1)/2,size(J,3)/2)
colormap gray
shading interp

Argumentos de entrada

I — Volumen o imagen en escala de grises

Matriz numérica 2D | Arreglo numérico 3D

Imagen o volumen en escala de grises, especificados como matriz numérica 2D o arreglo numérico 3D.

La función adaptthresh espera que las imágenes del tipo de datos double y single tengan valores en el intervalo [0, 1]. Si I tiene valores que se sitúan fuera del intervalo [0, 1], puede usar la función rescale para volver a escalar los valores al intervalo previsto.

Si la imagen contiene valores Inf o NaN, el comportamiento de adaptthresh se encuentra indefinido. La propagación de valores Inf o NaN puede no estar localizada alrededor del entorno de píxeles Inf o NaN.

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

sensitivity — Determina qué píxeles se umbralizan como píxeles de primer plano

0.5 (predeterminado) | Número en el intervalo [0, 1]

Determina qué píxeles se umbralizan como píxeles de primer plano, especificados como número en el intervalo [0, 1]. Unos valores de sensibilidad elevados llevan a que más píxeles se consideren como primer plano al utilizar el umbral, con el riesgo de incluir algunos de los píxeles del fondo.

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: T = adaptthresh(I,0.4,ForegroundPolarity="dark"); especifica que el primer plano es más oscuro que el fondo.

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

Ejemplo: T = adaptthresh(I,0.4,"ForegroundPolarity","dark"); especifica que el primer plano es más oscuro que el fondo.

NeighborhoodSize — Tamaño del entorno usado para calcular la estadística local alrededor de cada píxel

2*floor(size(I)/16)+1 (predeterminado) | entero positivo impar | Vector de 2 elementos de enteros positivos impares

Tamaño del entorno usado para calcular la estadística local alrededor de cada píxel, especificado como entero positivo impar o vector de 2 elementos de enteros positivos impares.

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

ForegroundPolarity — Determina qué píxeles se consideran píxeles de primer plano

"bright" (predeterminado) | "dark"

Determina qué píxeles se consideran píxeles de primer plano, especificados usando uno de los siguientes:

Valor	Significado
"bright"	El primer plano es más claro que el fondo.
"dark"	El primer plano es más oscuro que el fondo.

Tipos de datos: char | string

Statistic — Estadística empleada para calcular el umbral local

"mean" (predeterminado) | "median" | "gaussian"

Estadística empleada para calcular el umbral local en cada píxel, especificada como uno de los siguientes:

Valor	Significado
"mean"	La intensidad media local en el entorno. Esta técnica también se denomina método de Bradley [1].
"median"	La mediana local en el entorno. El cálculo de esta estadística puede ser lento. Considere el uso de un tamaño de entorno más pequeño para obtener resultados más rápidos.
"gaussian"	La media ponderada gaussiana en el entorno.

Tipos de datos: char | string

Argumentos de salida

T — Valores de intensidad normalizados

Matriz numérica | Arreglo numérico

Valores de intensidad normalizados, devueltos como matriz numérica o arreglo numérico del mismo tamaño que la imagen o el volumen de entrada I. Los valores se recortan al intervalo [0, 1].

Tipos de datos: double

Referencias

[1] Bradley, D., G. Roth, "Adapting Thresholding Using the Integral Image," Journal of Graphics Tools. Vol. 12, No. 2, 2007, pp.13–21.

Capacidades ampliadas

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

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

Notas y limitaciones de uso:

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

• Los argumentos ForegroundPolarity y Statistic deben ser constantes 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:

Los argumentos ForegroundPolarity y Statistic deben ser constantes en 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 un entorno basado en subprocesos.

Historial de versiones

Introducido en R2016a

R2022b: Generar código CUDA utilizando GPU Coder

Ahora adaptthresh es compatible con la generación de código optimizado CUDA^® (requiere GPU Coder™).

R2021b: Compatibilidad con entornos basados en hilos

Ahora adaptthresh es compatible con los entornos basados en hilos.

Consulte también

imbinarize | otsuthresh | graythresh