# Filter

Proporciona una imagen de salida en la que cada píxel es el resultado de una técnica de mejora de imágenes aplicada a la imagen de entrada o a la región de interés (RDI) especificada.

## Filter Descripción general

La función Filter (filtro) es una función polivalente de tratamiento de imagen que se utiliza para mejorar imágenes de bajo contraste y/o resaltar elementos de una imagen. Esta función permite acentuar las características de interés y minimizar las que no son importantes en una serie de piezas. Cuando se utiliza de forma eficaz, es una función que hace que las aplicaciones de inspección sean más fiables y reproducibles.

La función Filter ofrece una gama completa de técnicas de mejora de la imagen, tanto en partes concretas como a nivel de toda la imagen, pudiéndose seleccionar la técnica de mejora de imagen más apropiada mediante la selección de un determinado tipo de filtro.

### Uso de la función Filter

Configurar la función Filter implica definir la técnica de tratamiento de imagen a utilizar seleccionando el tipo de filtro que se desea que se utilice para mejorar la imagen.

1. Para empezar, cargue primero una imagen. Inserte la función Filter en la hoja de cálculo y ajuste la Región para definir el área de la imagen a realzar. Cuando ajuste la Región, asegúrese de que abarca únicamente la zona de la imagen que necesita ser realzada. Incluir zonas que no requieren ser realzadas afecta tanto a cómo se aplica la técnica de realce de la imagen como al tiempo de ejecución del tratamiento de la imagen.
2. A continuación, seleccione el tipo de filtro apropiado. Con la selección del tipo de filtro se habilitarán los parámetros adicionales que han de ajustarse para definir la forma de aplicar la técnica elegida. Ajuste convenientemente los parámetros habilitados para conseguir el efecto de mejora de imagen deseado.

Nota:

- Si el área de la imagen a tratar puede estar sometida a movimientos, utilice un elemento posicionador para asegurar que la Región se mueva en consonancia con el área de la imagen.
- Una vez configurada la función, cargue las imágenes adicionales y ajuste los parámetros según sea necesario para asegurar que se aplique correctamente la técnica de tratamiento de imágenes a toda la serie de imágenes.

## Filter Entradas

Parámetro | Descripción
Imagen | Este parámetro debe utilizar Referencias de celda en una celda de la hoja de cálculo que contiene una estructura de datos de Imagen; por defecto, este parámetro hace referencia a A0, la celda que contiene la estructura de datos de imagen devuelta por la función. Este parámetro puede hacer también referencia a otras estructuras de datos de imagen, como las devueltas por las Funciones Image del conjunto Vision Tools.
Elemento posicionador | Define la región de interés (RDI) en relación con una entrada de Fixture [Elemento posicionador] o la salida del sistema de coordenadas de imagen de una función de Vision Tools. La configuración de la RDI con relación a un elemento posicionador hace que si se gira o desplaza el elemento posicionador, se girará o desplazará en consonancia la RDI, manteniéndose fija la relación entre ambos. El valor de configuración predeterminado es (0,0,0), la esquina superior izquierda de la imagen.
X | El desplazamiento en X, en coordenadas de la imagen.
Y | El desplazamiento en Y, en coordenadas de la imagen.
Theta | La rotación desde el eje X de la imagen, en el sistema de coordenadas de imagen. (+/-360 grados en el sentido de las agujas del reloj)
Región | También conocida como región de interés (RDI), especifica la región de la imagen que se somete a análisis. Haga doble clic sobre el parámetro Región para crear un Modo gráfico interactivo que permite transformar y girar. Seleccione este parámetro y pulse el botón «Maximizar región» en la barra de herramientas de edición de tareas de la hoja de propiedades a fin de expandir automáticamente la región hasta cubrir toda la imagen.
X | El desplazamiento en X del origen, en coordenadas del elemento posicionador.
Y | El desplazamiento en Y del origen, en coordenadas del elemento posicionador.
Ancho | La dimensión de la región en la dirección del eje X de la misma.
Altura | La dimensión de la región en la dirección del eje Y de la misma.
Ángulo | La orientación en coordenadas del elemento posicionador.
Nota: Los parámetros Elemento posicionador y Región deben estar definidos dentro de los límites de la imagen; de lo contrario, la función devolverá #ERR.
Región externa | Especifica Referencias de celda a una celda de la hoja de cálculo que contiene una estructura de datos de Funciones de control. Cuando se utiliza este parámetro, la función ignorará los ajustes de Región y Elemento posicionador e inspeccionará el área de la imagen especificada por la región a la que se hace referencia. Nota: Si este parámetro ha sido configurado como referencia a una región externa, entonces, para utilizar la Región interna de la función, habrá que poner manualmente este parámetro a cero introduciendo para ello el valor 0 en lugar de la referencia de celda. En caso contrario, la función seguirá haciendo referencia a la región externa.
Tipo de filtro | Especifica el tipo de técnica de realce de imagen a realizar; el resultado se visualiza en una imagen de salida en escala de grises.
0 = Binarizar (por defecto) | Especifica una operación de «binarización» en blanco y negro según umbral en la que se compara cada píxel de entrada con el nivel de umbral especificado para determinar si el píxel de salida ha de salir como blanco o negro. Los valores de píxel de entrada que son iguales o superiores al valor especificado en el parámetro Umbral saldrán como blancos, mientras que los que son menores saldrán como negros. Nota: Cuando se utilice una imagen de entrada en color, la imagen de salida será una imagen en escala de grises.
1 = Bottom Hat [Sombrero de copa de negros] | Especifica una operación de filtrado de «sombrero de copa de negros» en la que se filtra todo excepto los elementos oscuros que son más pequeños en tamaño que la vecindad en el kérnel. El resultado es una imagen de salida que presenta dichos elementos oscuros como píxeles claros sobre un fondo por lo demás oscuro. Nota: Esta operación habilita los parámetros Filas del kérnel y Columnas del kérnel. El kérnel debe construirse a partir de valores enteros impares.
2 = Clip [Recortar] | Especifica una operación de «recorte» con la que se eliminan los extremos del espectro en la escala de grises para que las características de la imagen de salida sean más uniformes. Esta operación compara el valor en escala de grises de cada píxel de entrada con los valores de los parámetros Mín. y Máx.: Si el valor del píxel de entrada es igual o superior al valor mínimo o máximo, el valor del correspondiente píxel de salida se transformará en el («se recortará al») valor mínimo o máximo, respectivamente. Si el valor del píxel de entrada está dentro del intervalo definido por los valores mínimo y máximo, no se hace ningún recorte y se asigna al píxel de salida el valor del píxel de entrada.
3 = Close [Cerrar] | Especifica una operación de «cierre» en la que se realiza una dilatación seguida de una erosión a fin de filtrar los elementos oscuros que son más pequeños en tamaño que la vecindad en el kérnel. Con la operación de cierre se reducen o eliminan por completo las zonas oscuras de una imagen. Nota: Esta operación habilita los parámetros Filas del kérnel y Columnas del kérnel. El kérnel debe construirse a partir de valores enteros impares.
4 = Dilate [Dilatar] | Especifica una operación de «dilatación» con la que se realzan los elementos claros de la imagen, mientras que se suprimen los más oscuros. El resultado es una imagen de salida con áreas más grandes de píxeles claros. Resulta útil para eliminar puntos oscuros. Nota: Esta operación habilita los parámetros Filas del kérnel y Columnas del kérnel. El kérnel debe construirse a partir de valores enteros impares.
5 = Edge Magnitude [Magnitud de borde] | Especifica una operación que visualiza la diferencia entre una dilatación y una erosión de la imagen de entrada. El resultado es una imagen de salida en la que los bordes están representados por píxeles claros. Aunque es similar a «Gradiente completo», esta operación es algo más compleja (y más lenta), ya que permite la representación de bordes en diagonal. Nota: Esta operación habilita los parámetros Filas del kérnel y Columnas del kérnel. El kérnel debe construirse a partir de valores enteros impares.
6 = Equalize [Igualar] | Especifica una operación de ecualización del histograma en la que se extrae el histograma de la imagen de entrada y se reparten los valores en escala de grises más frecuentes para crear una distribución más uniforme. El resultado es una imagen de salida con más contraste. Este tipo de filtro resulta útil cuando la iluminación puede variar ligeramente de una imagen a otra o cuando algún otro elemento del objeto inspeccionado pueden variar ligeramente de una imagen a otra.
7 = Erode [Erosionar] | Especifica una operación de «erosión» con la que se reducen los elementos claros de la imagen. El resultado es una imagen de salida con áreas más grandes de píxeles oscuros. Resulta útil para eliminar puntitos de luz, píxeles ruidosos y/o pequeños defectos. Nota: Esta operación habilita los parámetros Filas del kérnel y Columnas del kérnel. El kérnel debe construirse a partir de valores enteros impares.
8 = Fill Dark Holes [Rellenar huecos oscuros] | Especifica una operación de «relleno de píxeles» en la que los píxeles oscuros rodeados de píxeles claros se convierten en píxeles claros. El resultado es una imagen de salida en la que se han rellenado los huecos u orificios oscuros.
9 = Fill Light Holes [Rellenar huecos claros] | Especifica una operación de «relleno de píxeles» en la que los píxeles claros rodeados de píxeles oscuros se convierten en píxeles oscuros. El resultado es una imagen de salida en la que se han rellenado los huecos u orificios claros.
10 = Gradient Full [Gradiente completo] | Especifica una operación de «gradiente vertical y horizontal» que proporciona una imagen de salida en la que se representan los bordes verticales y horizontales mediante píxeles claros. Aunque es similar a la operación Magnitud de borde, esta es más sencilla (y rápida) y no se representan con ella los bordes diagonales.
11 = Gradient Horizontal [Gradiente horizontal] | Especifica una operación de "gradiente horizontal" que proporciona una imagen de salida en la que se resaltan los bordes horizontales mediante píxeles claros.
12 = Gradient Vertical [Gradiente vertical] | Especifica una operación de «gradiente vertical» que proporciona una imagen de salida en la que se resaltan los bordes verticales mediante píxeles claros.
13 = Greyscale Distance [Distancia en escala de grises] | Especifica el valor en escala de grises de cada píxel de salida como la diferencia entre el valor en escala de grises de cada píxel de entrada y el nivel de umbral especificado en el parámetro Umbral (por ejemplo, si el valor del píxel de entrada es 100 y el umbral es 25, entonces el valor del píxel de salida será 75).
14 = High Pass [Paso alto] | Especifica una operación de «paso alto» que da como resultado una imagen de salida en la que los bordes se han realzado con respecto a áreas que presentan un gradiente en escala de grises más uniforme. Este tipo de filtro es útil para acentuar detalles finos. Nota: Esta operación habilita los parámetros Filas del kérnel y Columnas del kérnel. El kérnel debe construirse a partir de valores enteros impares.
15 = Invert [Invertir] | Especifica una inversión de los valores de los píxeles basada en la escala de grises de 256 pasos y que da como resultado una imagen de salida que es un «negativo» de la imagen de entrada (por ejemplo, la inversión de un píxel de entrada de valor 10 da como resultado un píxel de salida de valor de 245).
17 = Local Median [Mediana local] | Especifica una operación que calcula el valor medio de los valores de los píxeles de la vecindad en el kérnel y, a continuación, utiliza el resultado del cálculo como el valor de píxel de la imagen de salida. Nota: Esta operación habilita los parámetros Filas del kérnel y Columnas del kérnel. El kérnel debe construirse a partir de valores enteros impares.
18 = Local Median Normalization [Normalización de mediana local] | Especifica un método para sustraer el fondo de una imagen; esta operación resta la mediana local de la imagen de entrada de la imagen de entrada, desplaza el resultado en una unidad hacia la derecha y, a continuación, suma 128 para generar el valor de píxel de salida. Nota: Esta operación habilita los parámetros Filas del kérnel y Columnas del kérnel. El kérnel debe construirse a partir de valores enteros impares.
19 = Low Pass [Paso bajo] | Especifica una operación de «paso bajo» que da como resultado una imagen de salida en la que los bordes se suavizan o difuminan. Nota: Esta operación habilita los parámetros Filas del kérnel y Columnas del kérnel. El kérnel debe construirse a partir de valores enteros impares.
20 = Max (Top Hat/Bottom Hat) | Especifica una operación que utiliza el máximo de la operación de transformación sombrero de copa de blancos y el de la de sombrero de copa de negros. Nota: Esta operación habilita los parámetros Filas del kérnel y Columnas del kérnel. El kérnel debe construirse a partir de valores enteros impares.
21 = Open [Abrir] | Especifica una operación de «apertura» en la que se realiza una erosión seguida de una dilatación a fin de extraer los elementos claros que son más pequeños en tamaño que la vecindad en el kérnel. El resultado es una imagen de salida con algo menos de luminosidad en general, en la que se han eliminado unos pocos píxeles claros y realzado los elementos claros restantes. Nota: Esta operación habilita los parámetros Filas del kérnel y Columnas del kérnel. El kérnel debe construirse a partir de valores enteros impares.
22 = Optical Density [Densidad óptica] | Especifica una inversión de los valores de los píxeles basada en el uso de logaritmos Valor del píxel de salida = 100 * log (255) - 100 * log (valor del píxel de entrada) El resultado es una imagen de salida que evidencia la densidad de los objetos y características de la imagen de entrada a través de la cantidad de luz que los atraviesa. Los objetos y características más densos se representan mediante píxeles más claros en la imagen de salida.
23 = Sharpen [Agudizar] | Especifica una operación de «aumento de nitidez» que se utiliza para realzar bordes. La operación evalúa el contraste entre los píxeles adyacentes y aumenta el contraste si el contraste es alto. Una diferencia de contraste elevada entre píxeles adyacentes suele indicar la presencia de un borde; no obstante, esta operación no sirve para la localización de bordes. Los efectos que produce esta operación dependen del contenido y de la resolución de la imagen. Los parámetros «Suavizado bajo» y «Suavizado alto» se utilizan para identificar los bordes mediante kérnels gaussianos. El dominio definido por estos dos parámetros debe abarcar el tamaño de la característica a realzar. Por defecto, el parámetro «Suavizado bajo» está ajustado a 0, por lo que se realzan por igual los bordes de todos los elementos, independientemente de sus tamaños. El parámetro de suavizado se utiliza para identificar los bordes mediante la creación de un kérnel gaussiano. El parámetro Ganancia impone la magnitud de la agudización, mientras que el parámetro Umbral se utiliza para reducir el ruido, ya que indica al filtro que ignore ciertas diferencias de valor entre píxeles durante la operación de agudización, evitándose así la excesiva agudización de zonas con texturas suaves.
24 = Stretch [Expandir] | Especifica una operación de estiramiento con la que se «aumentan» o «expanden» linealmente los valores en escala de grises (considerando los ajustes de los parámetros Mín. y Máx.) de la imagen de entrada a una escala de grises completa de 256 pasos, obteniéndose así una imagen de salida con más contraste. Si el valor de un píxel de entrada es igual o excede al valor mínimo o máximo, se asignará al píxel de salida el valor 0 o 255, respectivamente. A los píxeles de entrada con valores comprendidos entre dichos mínimo y máximo, se les aplicará el factor de ampliación lineal de manera que sus valores pasan a cubrir la gama de 0 a 255. Por ejemplo, si el valor Mín. es 50 y el Máx. es 180, esta operación restará 50 a la intensidad de cada píxel y el dominio de valores será de 0 a 130. A continuación, se multiplicará el nivel de cada píxel por 255/130, por lo que la gama pasará a ser de 0 a 255.
25 = Threshold Range [Intervalo de umbral] | Especifica una operación de umbral en blanco y negro («binaria») en la que se compara cada píxel de entrada con dos valores de umbral (Mín. y Máx.) para determinar si el píxel de salida será un píxel del fondo o del primer plano de la imagen. Si el valor del píxel de entrada está comprendido en el intervalo definido por los valores Mín. y Máx., el píxel de salida conservará su valor, de lo contrario, el píxel de salida pasará a tener el valor de fondo. Nota: Si el valor mínimo es mayor que el máximo, se invierte el color del fondo.
26 = Top Hat [Sombrero de copa] | Especifica la operación de filtrado «sombrero de copa de blancos» en la que se filtra todo excepto los elementos claros que son más pequeños en tamaño que la vecindad en el kérnel. El resultado es una imagen de salida que presenta dichos elementos claros como píxeles claros sobre un fondo por lo demás oscuro. Nota: Esta operación habilita los parámetros Filas del kérnel y Columnas del kérnel. El kérnel debe construirse a partir de valores enteros impares.
Kernel Rows [Filas del kérnel] | Especifica el número de filas (1–25; valor predeterminado = 3) del kérnel. Un kérnel es una matriz rectangular de números que define la vecindad del píxel a procesar y que se considera al realizar las operaciones de tratamiento de imagen en las ubicaciones de cada uno de los píxeles de una imagen. Los valores en escala de grises de los vecinos de un píxel definen el valor en escala de grises de la ubicación de dicho píxel en la imagen de salida. Nota: El kérnel no es un conjunto ponderado. El kérnel se construye a partir de un número impar de valores. Un kérnel típico es una matriz 3 x 3, pero su tamaño es de hecho arbitrario. El parámetro «Tipo de filtro» se habilita al establecerlo como uno de los siguientes filtros: Bottom Hat [Sombrero de copa de negros] Close [Cerrar] Dilate [Dilatar] Edge Magnitude [Magnitud de borde] Erode [Erosionar] Erode Minus Dilate [Erosión menos dilatación] High Pass [Paso alto] Local Mean Normalization [Normalización media local] Local Median [Mediana local] Local Median Normalization [Normalización mediana local] Low Pass [Paso bajo] Max (TopHat/BottomHat) [Máx.(Sombrero de copa de blancos/negros)] Open [Abrir] Top Hat [Sombrero de copa]
Kernel Columns [Columnas del kérnel] | Especifica el número de columnas (1–25; valor predeterminado = 3) del kérnel. Un kérnel es una matriz rectangular de números que define la vecindad del píxel a procesar y que se considera al realizar las operaciones de tratamiento de imagen en las ubicaciones de cada uno de los píxeles de una imagen. Los valores en escala de grises de los vecinos de un píxel definen el valor en escala de grises de la ubicación de dicho píxel en la imagen de salida. Nota: El kérnel no es un conjunto ponderado. El kérnel se construye a partir de un número impar de valores. Un kérnel típico es una matriz 3 x 3, pero su tamaño es de hecho arbitrario. El parámetro «Tipo de filtro» se habilita al establecerlo como uno de los siguientes filtros: Bottom Hat [Sombrero de copa de negros] Close [Cerrar] Dilate [Dilatar] Edge Magnitude [Magnitud de borde] Erode [Erosionar] Erode Minus Dilate [Erosión menos dilatación] High Pass [Paso alto] Local Mean Normalization [Normalización media local] Local Median [Mediana local] Local Median Normalization [Normalización mediana local] Low Pass [Paso bajo] Max (TopHat/BottomHat) [Máx.(Sombrero de copa de blancos/negros)] Open [Abrir] Top Hat [Sombrero de copa]
Auto Threshold [Umbral automático] | Especifica si la función determinará automáticamente o no un nivel de umbral cuando se ajusta el «Tipo de filtro» a «Binarizar», «Distancia en escala de grises» o «Intervalo de umbral». Nota: Este parámetro está habilitado por defecto. Para utilizar el parámetro Umbral , debe deshabilitar este parámetro. Cuando está habilitado y se ajusta «Tipo de filtro» a «Binarizar», la función calcula automáticamente el nivel de umbral a partir de los valores en escala de grises medidos dentro de la región especificada. Cuando está habilitado y se ajusta «Tipo de filtro» a «Distancia en escala de grises», la función calculará automáticamente el valor de umbral a partir del valor medio en escala de grises que se ha determinado en la región especificada. Cuando está habilitado y se ajusta «Tipo de filtro» a «Intervalo de umbral», se realiza automáticamente lo siguiente: Si los valores de los píxeles son menores que el valor ajustado en el parámetro Mín. o mayores que el ajustado en el parámetro Máx., entonces se asignará a dichos píxeles el valor correspondiente al fondo de imagen. Si los valores de los píxeles están dentro del intervalo definido por los ajustes de los parámetros Mín. y Máx., entonces dichos píxeles se pondrán en primer plano.
Threshold [Umbral] | Especifica los niveles de umbral (de 0 a 255; por defecto = 128) que se considerarán cuando el «Tipo de filtro» es «Binarizar», «Distancia en escala de grises», «Agudizar» o «Intervalo de umbral». Nota: El parámetro «Umbral automático» está habilitado por defecto; debe deshabilitarlo para habilitar el presente parámetro. Si se ha establecido «Tipo de filtro» en «Agudizar», este parámetro servirá para reducir el ruido, ya que indicará al filtro que ignore ciertas diferencias de valor entre píxeles durante la operación de agudización, evitándose así la excesiva agudización de zonas con texturas suaves.
Mín. | Especifica el valor mínimo en escala de grises (0–255; valor predeterminado = 128) cuando se ha establecido el «Tipo de filtro» en «Recortar», «Expandir» o «Intervalo de umbral».
Máx. | Especifica el valor máximo en escala de grises (0–255; valor predeterminado = 128) cuando se ha establecido el «Tipo de filtro» en «Recortar», «Expandir» o «Intervalo de umbral».
Ganancia | Especifica un valor de ganancia (0 a 10; valor predeterminado = 1) cuando «Tipo de filtro» está ajustado a «Agudizar». Este parámetro especifica la magnitud de la agudización que se llevará a cabo mediante un control del contraste en los bordes. Se pondrán los píxeles situados en la proximidad de un borde a valores mínimos o máximos creando así una imagen más nítida del borde.
Smoothness [Suavizado] | Especifica un valor de suavizado (1 a 4; valor predeterminado = 1) para el kérnel gaussiano cuando el tipo de filtro está ajustado a Agudizar. Con Suavizado se controla la desviación estándar del kérnel gaussiano; los valores de suavizado más altos implican una mayor «apertura» en la operación de suavizado, lo que ayuda a agudizar los detalles. Nota: El término gaussiano hace referencia a una curva acampanada que se aplica como media ponderada a los píxeles en la RDI.
Mostrar | Especifica qué superposiciones gráficas han de visualizarse sobre la imagen.
0 = ocultar todo (por defecto) | La región de la imagen de entrada estará oculta, excepto cuando la celda que contiene la función Filter está resaltada en la hoja de cálculo.
1 = solo gráficos de resultados | Se visualizará la imagen procesada en todo momento.
2 = sólo gráficos de entrada | Se visualizará en todo momento la región de la imagen de entrada.

## Filter Salidas

Devuelve | Una estructura de datos de Imagen que contiene la imagen procesada o #ERR si alguno de los parámetros de entrada no es válido. Nota: Los contenidos de la región procesada de la imagen que la función devuelve en la estructura de datos de Imagen no se guardan con la tarea. Se puede acceder a información adicional sobre los valores devueltos por la función por medio de las funciones de Imagen Funciones de Vision Data Access.