roifilt2

Filtrar una región de interés (ROI) en una imagen en escala de grises

Sintaxis

J = roifilt2(h,I,BW)

J = roifilt2(I,BW,fun)

Descripción

J = roifilt2(h,I,BW) filtra regiones de interés (ROI) en la imagen 2D en escala de grises I utilizando el filtro lineal 2D h. La máscara binaria BW define las ROI en I. roifilt2 devuelve una imagen que consta de valores filtrados para los píxeles de las ubicaciones en las que BW contiene 1 y valores no filtrados para los píxeles de las ubicaciones en las que BW contiene 0.

J = roifilt2(I,BW,fun) procesa los datos en las ROI de I utilizando la función fun.

Ejemplos

Filtrar una imagen usando una máscara poligonal

Lea una imagen en el área de trabajo.

I = imread("eight.tif");

Defina los vértices del polígono para la máscara.

c = [222 272 300 270 221 194];
r = [21 21 75 121 121 75];

Cree la imagen de máscara binaria.

BW = roipoly(I,c,r);

Filtre la región de la imagen I especificada por la máscara BW.

H = fspecial("unsharp");
J = roifilt2(H,I,BW);

Muestre la imagen original y la imagen filtrada.

imshow(I)

imshow(J)

Argumentos de entrada

h — Filtro lineal

Matriz numérica 2D

Filtro lineal, especificado como matriz numérica 2D.

Tipos de datos: double

I — Imagen en escala de grises

Matriz numérica 2D

Imagen en escala de grises, especificada como matriz numérica 2D.

• Si especifica un filtro h, I puede ser de cualquiera de los tipos de datos indicados.

• Si especifica un identificador de función fun, I puede ser de cualquier tipo de datos admitido por fun.

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

BW — Máscara

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

Máscara, especificada como matriz lógica 2D o matriz numérica 2D del mismo tamaño que I. En la entrada numérica, cualquier píxel distinto de cero se considera 1 (true).

fun — Identificador de función

Identificador

Identificador de función, especificado como identificador. Para obtener más información sobre los identificadores de función, consulte Crear un identificador de función.

Argumentos de salida

J — Imagen filtrada

Matriz 2D

Imagen filtrada, devuelta como una matriz 2D.

• Si especifica un filtro h, J es del mismo tipo de datos que la imagen de entrada I.

• Si especifica un identificador de función fun, el tipo de datos de J está determinado por fun.

Algoritmos

Si especifica un filtro h, roifilt2 llama a imfilter para implementar el filtro.

Capacidades ampliadas

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

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

Notas y limitaciones de uso:

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

• Si genera código utilizando la función coder con fun como argumento, especifique fun como una cadena constante o un vector de caracteres. Por ejemplo, para utilizar la función adaptthresh, especifique fun como la cadena "adaptthresh" y convierta la cadena en una constante utilizando la función coder.Constant.

  codegen roifilt2 -args {I,BW,coder.Constant("adaptthresh")}

  Si genera código para una función wrapper, fun puede ser un identificador de función dentro de la función wrapper. Por ejemplo, este comando genera código para una función wrapper denominada myFunction.

  codegen myFunction -args {I,BW,coder.Constant("adaptthresh")}

  Aquí tiene una definición de muestra de la función wrapper myFunction, que incluye una llamada a la función roifilt2. Dentro de la función wrapper, convierta fun de una cadena constante a un identificador de función utilizando la función str2func.

  function out = myFunction(I,BW,fun) %#codegen
        fun1 = str2func(fun); % This will become fun1 = @adaptthresh
        out = roifilt2(I,BW,fun1);
  end

Historial de versiones

Introducido antes de R2006a

R2023b: Soporte para la generación de código C

Ahora roifilt2 es compatible con la generación de código C (requiere MATLAB Coder).

Consulte también

imfilter | filter2 | roipoly

Temas

• Apply Custom Filter to Region of Interest in Image
• Mejorar la nitidez de una región de interés en una imagen