# InspectEdgeForDefect

La función InspectEdgeForDefect [InspeccionarDefectosDeBorde] se utiliza para construir un modelo de borde y realizar con él un análisis avanzado de los bordes o pares de bordes devueltos por una función de inspección de bordes «InspectEdge». Estos datos se utilizan para desarrollar un encuadre de línea óptimo con el que comparar los bordes o pares de bordes encontrados y detectar defectos o brechas, como una separación con respecto al encuadre de la línea del borde.

## Descripción general de la exploración con la función InspectEdgeForDefect

Después de insertar la función en la hoja de cálculo, hay que hacer una referencia a una estructura de datos de Inspección creada por una función InspectEdge. Una vez establecida la referencia a la función de inspección de bordes, se crea el modelo de borde mediante la configuración de los parámetros de la función InspectEdgeForDefect. El modelo de borde implica definir lo siguiente:

- El tipo de encuadre de línea: recta o circular.
- El tipo de borde: sencillo o par de bordes.
- El tipo de transición en el borde: de blanco a negro o viceversa.
- Los criterios de puntuación de los bordes que han de utilizarse para filtrar los bordes no deseados.
- Los criterios de encuadro de línea que han de utilizarse para filtrar los bordes no deseados que se apartan del encuadre de línea.
- Las tolerancias a defectos y/o huecos que puedan encontrarse.

Una vez establecido el modelo de borde, la función comparará los candidatos a borde con dicho modelo de borde e informará de las diferencias con respecto al modelo encontradas.

Ejemplo - Borde conforme con el encuadre de línea recta

Ejemplo - Borde no conforme con el encuadre de línea recta

Ejemplo - Borde no conforme con el encuadre de línea circular

## InspectEdgeForDefect Entradas

Parámetro | Descripción
InspecciónDeBordes | Especifica una referencia a una celda de la hoja de cálculo que contiene una estructura de datos de Inspección válida devuelta por una función InspectEdge.
Encuadre de línea | Especifica el tipo de encuadre de línea a realizar a partir de los bordes detectados.
1 = Encuadre de línea recta | La función creará un encuadre de línea recta a partir de los bordes detectados.
2 = Encuadre de línea circular | La función creará un encuadre de línea circular a partir de los bordes detectados.
3 = Encuadre automático (por defecto) | La función crea automáticamente un encuadre de línea recta o circular sobre la base de la región referenciada.
InspeccionarParDeBordes | Especifica si la función debe detectar o no pares de bordes. Los pares de bordes se etiquetarán gráficamente en la imagen, indicándose el primer borde detectado como borde 0 y el segundo como borde 1.
0 = Desactivado (por defecto) | La función no detectará pares de bordes.
1 = Activado | La función intentará detectar pares de bordes según lo establecido mediante los parámetros de puntuación de bordes.
BuscarDirecciónBorde | Especifica la dirección y el sentido en los que la función hará la exploración para detectar bordes. Se visualizan adicionalmente unas flechas de color verde oscuro para ilustrar gráficamente el sentido y dirección y en los que se detectará el borde. Las líneas de ajuste se etiquetarán gráficamente dentro de la imagen, señalándose la primera línea de ajuste mediante la etiqueta 0 y la segunda línea de ajuste con la etiqueta 1. Nota: Si se comba la región de interés (RDI) de la función InspectEdge referenciada, la inspección se hará en relación con el centro de la curva creada. Si el parámetro BuscarDirecciónBorde se establece en Izquierda a derecha, la inspección se realiza hacia el centro de la curva y si se establece en Derecha a izquierda, la inspección se hace alejándose del centro de la curva.
0 = De izquierda a derecha (por defecto) | La función intentará detectar bordes explorando desde la izquierda hacia la derecha de la RDI. Ejemplo
1 = De derecha a izquierda | La función intentará detectar bordes explorando desde la derecha hacia la izquierda de la RDI. Ejemplo
3 = De centro hacia afuera | Esta función intentará detectar bordes desde el centro de la RDI hasta los límites superior e inferior de la misma (el orden de los bordes encontrados es en el sentido opuesto al de la flecha "X" visualizada en la RDI). Ejemplo Nota: El parámetro InspeccionarParDeBordes debe estar activado para que se habilite esta selección.
2 = De fuera hacia dentro | La función intentará detectar bordes explorando desde los límites superior e inferior de la RDI hasta el centro de la misma (el orden de los bordes encontrados es en el sentido opuesto al indicado por la flecha "X" visualizada en la RDI). Ejemplo Nota: El parámetro InspeccionarParDeBordes debe estar activado para que se habilite esta selección.
Borde: Primero | Especifica la transición de contraste del primer borde a detectar, tal como lo determina el parámetro Buscar dirección del borde.
1 = Negro a blanco | En el borde, la transición se realiza pasando de píxeles negros a píxeles blancos.
2 = Blanco a negro (por defecto) | En el borde, la transición se realiza pasando de píxeles blancos a píxeles negros.
3 = Cualquiera | La transición en el borde puede ser de negro a blanco o de blanco a negro, y esta función determina cuál es la transición adecuada. Al especificar el tipo de transición se mejora el rendimiento de la función.
Borde: Segundo | Especifica la transición de contraste del segundo borde a detectar, tal como lo determina el parámetro Buscar dirección del borde. Nota: El parámetro InspeccionarParDeBordes debe estar activado para que se habilite esta selección.
1 = Negro a blanco (por defecto) | En el borde, la transición se realiza pasando de píxeles negros a píxeles blancos.
2 = Blanco a negro | En el borde, la transición se realiza pasando de píxeles blancos a píxeles negros.
3 = Cualquiera | La transición en el borde puede ser de negro a blanco o de blanco a negro, y esta función determina cuál es la transición adecuada. Al especificar el tipo de transición se mejora el rendimiento de la función.
Puntuación del borde | Especifica el modo de puntuación de bordes que se utilizará para determinar si un borde cumple o no los criterios establecidos.
Umbral de puntuación | Especifica un umbral de puntuación para excluir todos los bordes cuyas puntuaciones (de 1 a 100; por defecto = 10) son inferiores a este valor umbral.
Reglas para bordes | Especifica el tipo de borde que se considera el más importante al determinar la puntuación.
1 = Primero | El primer borde detectado recibe la mayor de las consideraciones.
2 = Más marcado | El borde con transición de contraste más marcada es el que recibe la mayor de las consideraciones.
3 = Primer más marcado (por defecto) | El primer borde detectado que presenta la transición más marcada es el que recibe la mayor de las consideraciones.
4 = Tamaño del par de bordes | El par de bordes detectado que tiene el tamaño más próximo al especificado por el parámetro Tamaño del par será el que recibe la mayor de las consideraciones.
5 = Tamaño del primer par de bordes | El primer par de bordes detectado que tiene el tamaño más próximo al especificado por el parámetro Tamaño del par es el que recibe la mayor de las consideraciones.
6 = Tamaño del par de bordes más marcado | El par de bordes detectado que presenta la transición más marcada y tiene el tamaño más próximo al especificado por el parámetro Tamaño del par recibe la mayor de las consideraciones.
7 = Tamaño del primer par de bordes más marcado | El primer par de bordes que presenta la transición más marcada y tiene el tamaño más próximo al especificado por el parámetro Tamaño del par es el que recibe la mayor de las consideraciones.
Límite superior de contraste | Especifica el límite superior de la transición de contraste en un posible borde (de 2 a 255; por defecto = 255) para que este sea considerado efectivamente como borde; los bordes con una transición de contraste superior al valor especificado obtendrán esta misma puntuación más alta. Nota: El parámetro Reglas para bordes debe configurarse como Más marcado, Primer más marcado, Tamaño del par de bordes más marcado o Tamaño del primer par más marcado para que se habilite.
Tamaño del par | Especifica el tamaño del par de bordes que ha obtenido la máxima puntuación (el intervalo de valores válidos es de 1 a 3 veces la anchura de la imagen del sistema de visión In-Sight; por defecto = 5). Cuando este parámetro está habilitado, los pares de bordes que se detecten con un valor superior o inferior al presente valor se puntuarán proporcionalmente a este valor. Por ejemplo, si Tamaño del par se establece en 10 y se detectan dos candidatos a par de bordes, uno con un valor de 8 y el otro con un valor de 14, entonces el par de bordes que se seleccionaría es el que tiene el valor 8, ya que está más cerca del límite que el segundo par de bordes. Nota: El parámetro InspeccionarParDeBordes debe estar activado y el parámetro Reglas para bordes debe ponerse a Tamaño del par de bordes, Tamaño del primer par de bordes, Tamaño del par de bordes más marcado o Tamaño del primer par de bordes más marcado para activarlo.
Encuadre de línea avanzado | Define cómo debe realizar la función el encuadre de línea.
Filtrar atípicos | Especifica que la función descartará de la línea de mejor aproximación los puntos que se encuentran a una distancia superior a la especificada en el parámetro Filtro de distancia a encuadre.
0 = Desactivado (por defecto) | La función no tendrá en cuenta los puntos de borde atípicos (externos).
1 = Activado | La función tendrá en cuenta los puntos de borde atípicos en los cálculos que realiza.
Filtro de distancia para encuadre | Especifica la distancia, en píxeles (el intervalo de valores válidos es el de 1 a 3 veces la anchura de la imagen del sistema de visión In-Sight; por defecto = 2), a la que debe encontrarse un borde con respecto a la línea de mejor aproximación original para que sea utilizado en un cálculo de reaproximación. Este ajuste es útil para evitar que los defectos afecten al encuadre de línea. Elfiltro de valores atípicos debe estar activado para poder habilitar este ajuste.
Distancia del filtro de puntos más alejados | Especifica la distancia a la que puede estar un punto atípico con respecto al encuadre de línea para que se le considere aún parte integrante del encuadre de línea (el intervalo de valores válidos es de 1 a 3 veces la anchura de la imagen del sistema de visión In-Sight; el valor predeterminado es el de 3 veces la anchura de la imagen del sistema de visión); cualquier margen que sea mayor que este valor será ignorado.
Volver a puntuar | Especifica que se repuntuarán los bordes para seleccionar los que están más cerca del encuadre de línea.
0 = Desactivado (por defecto) | La función no volverá a puntuar los bordes para incluir también los puntos atípicos (externos).
1 = Activado | La función volverá a puntuar los bordes para incluir también los bordes atípicos (exteriores) en los cálculos.
Volver a encuadrar | Especifica que la función reajustará el encuadre de línea tras puntuar de nuevo los bordes. Al habilitar esta funcionalidad se mejora la precisión del encuadre de línea, sin embargo, se aumenta también el tiempo de procesamiento.
0 = Desactivado (por defecto) | La función no hará un reajuste del encuadre de línea.
1 = Activado | La función reajustará el encuadre de la línea tras puntuar de nuevo los bordes.
Núm. máx. de defectos/huecos | Especifica el número máximo de defectos y/o huecos que la función debe esperar detectar (1 a 4096; por defecto = 5). Este valor se aplica por separado tanto a defectos como a huecos; por ejemplo, si suponemos que el valor ajustado es 5, la función esperará encontrar como máximo 5 defectos y 5 huecos. Este ajuste se utiliza para construir la tabla de resultados de Acceso a Datos de Visión que presentará la hoja de cálculo.
Defectos | Especifica los parámetros para determinar los defectos en el borde utilizando el encuadre de línea.
Distancia mín. | Especifica la distancia mínima en píxeles (intervalo de valores válidos: 0.001 a 3 veces la anchura de la imagen del sistema de visión In-Sight; por defecto = 3 píxeles), medida entre el borde detectado y el encuadre de línea, para que haya defecto; una distancia inferior a la especificada no se considerará defecto.
Distancia máx. | Especifica la distancia máxima en píxeles (intervalo de valores válidos: 0.001 a 3 veces la anchura de la imagen del sistema de visión In-Sight; por defecto = 3 veces la anchura de la imagen del sistema In-Sight), medida entre el borde detectado y el encuadre de línea, para que haya defecto; una distancia mayor a la especificada no se considerará defecto. Nota: Si este valor es menor que el del parámetro Distancia mín., la función dará #ERR.
Tamaño habilitado | Especifica si la función tendrá o no en cuenta defectos de tamaño. Los defectos de tamaño se refieren a desviaciones con respecto a una determinada longitud medida a lo largo del borde. Nota: Si se han activado los dos parámetros Tamaño habilitado y Área habilitada, se notificarán únicamente los defectos que no cumplan ninguna de las dos condiciones.
0 = Desactivado | La función no tendrá en cuenta defectos en tamaño.
1 = Activado (por defecto) | La función tendrá en cuenta los defectos en tamaño sobre la base de los valores configurados en los parámetros Tamaño mín. y Tamaño máx.
Tamaño mín. | Especifica el tamaño mínimo en píxeles para que haya defecto (intervalo de valores válidos: 0.001 a 3 veces la anchura de la imagen del sistema de visión In-Sight; por defecto = 3 píxeles); las desviaciones continuas con especto al encuadre de línea que son inferiores al valor aquí especificado no se considerarán defecto.
Tamaño máx. | Especifica el tamaño máximo en píxeles para que haya defecto (intervalo de valores válidos: 0.001 a 3 veces la anchura de la imagen del sistema de visión In-Sight; por defecto = 3 veces la anchura de la imagen del sistema In-Sight); las desviaciones continuas con respecto al encuadre de línea que son superiores al valor aquí especificado no se considerarán defecto.
Área habilitada | Especifica si la función tendrá o no en cuenta defectos de área. Los defectos de área consideran la longitud a lo largo del encuadre de línea y la distancia del borde defectuoso con respecto al encuadre de línea. Nota: Si se han activado los dos parámetros Tamaño habilitado y Área habilitada, se notificarán únicamente los defectos que no cumplan ninguna de las dos condiciones.
0 = Desactivado | La función no tendrá en cuenta defectos de área.
1 = Activado (por defecto) | La función tendrá en cuenta defectos de área sobre la base de los valores configurados en los parámetros Área mín. y Área máx.
Área mín. | Especifica el área mínima en píxeles para que haya defecto (intervalo de valores válidos: 0.000 a 1000000; el valor predeterminado es 10); un área inferior al valor aquí especificado no se considerará defecto.
Área máx. | Especifica el área máxima en píxeles para que haya defecto (valores válido: 0.000 a 1000000; por defecto es 1000000); un área mayor que el valor aquí especificado no se considerará defecto.
Filtro de defectos para encuadre de línea | Especifica si se filtran o no defectos en función de su posición con respecto al encuadre de línea.
0 = Sin filtro (por defecto) | La función devolverá defectos estén a un lado o al otro del encuadre de línea.
1 = Ignorar izquierda del encuadre de línea | La función filtrará los defectos situados en el lado izquierdo y devolverá únicamente los defectos que encuentre a la derecha del encuadre de línea.
2 = Ignorar derecha del encuadre de línea | La función filtrará los defectos situados en el lado derecho y devolverá únicamente los defectos que encuentre a la izquierda del encuadre de línea.
Criterios de ordenación | Especifica cómo se ordenarán los defectos detectados.
Por tamaño (por defecto) | La función ordenará los defectos detectados por su tamaño, del más grande al más pequeño.
Por área | La función ordenará los defectos detectados por su área, de la más grande a la más pequeña.
Por posición | La función clasificará los defectos detectados por índice de calibre.
Huecos | Especifica los parámetros para determinar huecos en el borde.
Habilitado | Especifica si la función tendrá en cuenta o no los huecos en el borde encontrado.
0 = Desactivado | La función no tendrá en cuenta los huecos.
1 = Activado (por defecto) | La función tendrá en cuenta los huecos según los ajustes del parámetro Huecos.
Hueco mínimo | Especifica el tamaño mínimo, en píxeles, del espacio vacío para que se considere como hueco (intervalo de valores válidos: 0.001 a 3 veces la anchura de la imagen del sistema de visión In-Sight; por defecto = 3 píxeles); si el tamaño es inferior al valor aquí especificado, no se considerará como hueco.
Hueco máximo | Especifica el tamaño máximo, en píxeles, del espacio vacío para que se considere como hueco (intervalo de valores válidos: 0.001 a 3 veces la anchura de la imagen del sistema de visión In-Sight; el valor predeterminado es 3 veces la anchura de la imagen del sistema de visión); si el tamaño es superior al aquí especificado, no se considerará como hueco.
Desplazamiento máx. | Especifica el desplazamiento máximo en píxeles (intervalo de valores válidos: 1 a 3 veces la anchura de la imagen del sistema de visión In-Sight; el valor predeterminado es 3 veces la anchura de la imagen del sistema de visión) con respecto al encuadre de línea para que se considere como hueco; este ajuste actúa como un filtro con el que se eliminan los bordes detectados que no se encuentran a lo largo del encuadre de línea como los otros detectados. Nota: Si el parámetro InspeccionarParDeBordes está habilitado, el desplazamiento máximo se mide, en píxeles, desde el centro de la región hasta el centro del par de bordes. Si esta distancia es mayor que el valor indicado en el parámetro Desplazamiento máx., se considerará como hueco.
Ignorar huecos en límites | Especifica si la función tendrá en cuenta o no los huecos detectados al principio y al final de la RDI.
0 = Desactivado | La función no tendrá en cuenta los huecos detectados al principio y al final de la RDI.
1 = Activado (por defecto) | La función tendrá en cuenta los huecos detectados al principio y al final de la RDI.
Criterios de ordenación | Especifica cómo se ordenarán los huecos detectados.
Por tamaño (por defecto) | La función ordenará los huecos detectados por su tamaño, de mayor a menor.
Por posición | La función ordenará los huecos detectados por índice de calibre.
Índice de calibre | Especifica el calibre que se visualizará en la imagen (con trazos verdes); el calibre que se visualiza por defecto es 0.
Mostrar | Especifica el modo de visualización de las superposiciones gráficas de la función sobre la imagen.
0 = ocultar todo (por defecto) | Se ocultarán todos los gráficos, excepto cuando la celda que contiene la función InspectEdgeForDefect está resaltada en la hoja de cálculo.
1 = solo gráficos de resultados | Se visualizarán en todo momento el encuadre de línea, los defectos detectados, los puntos atípicos y/o huecos.
2 = gráfico de resultados y borde encontrado | Se visualizarán en todo momento el encuadre de línea, los defectos detectados, los puntos atípicos y/o huecos y los puntos del borde detectado.
3 = gráfico de resultados y detalles del calibre | Se visualizarán en todo momento el encuadre de línea, los defectos detectados, los puntos atípicos y/o huecos, los puntos del borde detectado y la ventana del calibre indexado.
4 = mostrar todo: gráficos de entrada y de resultados | Se visualizarán en todo momento la región de entrada, el encuadre de línea, los defectos detectados, los puntos atípicos y/o huecos y los puntos del borde detectado.

## InspectEdgeForDefect Salidas

Devuelve | Una estructura de datos Inspección que contiene los defectos, extremos y huecos detectados o #ERR si alguno de los parámetros de entrada no es válido.
Resultados | Cuando se inserta inicialmente la función InspectEdgeForDefect en una celda, se crea una tabla de resultados en la hoja de cálculo que corresponde al tipo de búsqueda que se está realizando. Nota: Si el valor del parámetro Núm. máx. de defectos/huecos es mayor que cero, la función InspectEdgeForDefect insertará automáticamente una tabla de resultados con un máximo de 10 entradas correspondientes a los 10 primeros defectos/huecos/bordes/pares de borde presentados en la estructura de datos. Si desea visualizar más entradas, puede ampliar la tabla copiando la última fila y pegando en filas adicionales al final de la tabla. Las siguientes funciones de InspectEdge Funciones de Vision Data Access se insertan automáticamente en la hoja de cálculo para crear la tabla de resultados basada en la estructura de datos de InspectEdgeForDefect y que se subdivide en las cuatro secciones tituladas Resumen, Defectos, Huecos y Extremos:
Nombre de la hoja de cálculo | Nombre de la función | Descripción
Resumen
Defectos/Huecos | GetDefectGapCount(Inspección, Defecto/Hueco, Tamaño/Área, Índice de par de bordes) | Devuelve el número de defectos o huecos según lo que se haya especificado. Defectos = 0, Hueco = 1; Tamaño = 0, Área = 1.
X 0/1 | GetFitEdgeX(Inspección, Índice de par de bordes, Índice de punto, Índice de borde) | Devuelve la coordenada X del punto especificado.
Y 0/1 | GetFitEdgeY(Inspección, Índice de par de bordes, Índice de punto) | Devuelve la coordenada Y del punto especificado.
Centro X | GetFitEdgeCenterX(Inspección, Índice de punto) | Se inserta cuando se especifica un encuadre de línea circular y devuelve la coordenada X del centro del encuadre de línea circular.
Centro Y | GetFitEdgeCenterY(Inspección, Índice de punto) | Se inserta cuando se especifica un encuadre de línea circular y devuelve la coordenada Y del centro del encuadre de línea circular.
Radio | GetFitEdgeRadius(Inspección, Índice de par de bordes, Índice de punto) | Se inserta cuando se especifica un encuadre de línea circular y devuelve la distancia medida desde el centro del encuadre de línea circular del par de bordes seleccionado.
Defectos/Huecos
Tamaño/Área | GetDefectGapValue(Inspección, Índice de defecto/hueco, Defecto/Hueco, Índice de par de bordes, Tamaño/Área/Ancho) | Devuelve el tamaño o el área del defecto o hueco. Defecto = 0, Hueco = 1; Tamaño = 0, Área = 1, Ancho = 2.
X | GetDefectGapBoundsX(Inspección, Índice de defecto/hueco, Defecto/Hueco, Índice de par de bordes) | Devuelve la coordenada X del rectángulo que delimita el defecto.
Y | GetDefectGapBoundsY(Inspección, Índice de defecto/hueco, Defecto/Hueco, Índice de par de bordes) | Devuelve la coordenada Y del rectángulo que delimita el defecto.
Altura | GetDefectGapBoundsHeight(Inspección, Índice de Defecto/Hueco, Defecto/Hueco, Índice de par de bordes) | Devuelve la altura del rectángulo que delimita el defecto.
Ancho | GetDefectGapBoundsWidth(Inspección, Índice de defecto/hueco, Defecto/Hueco, Índice de par de bordes) | Devuelve la anchura del rectángulo que delimita el defecto.
Ángulo | GetDefectGapBoundsAngle(Inspección, Índice de defecto/hueco, Defecto/Hueco, Índice de par de bordes) | Devuelve el ángulo del rectángulo que delimita el defecto.
Curva | GetDefectGapBoundsCurve(Inspección, Índice de defecto/hueco, Defecto/Hueco, Índice de par de bordes) | Devuelve la curva del rectángulo que delimita el defecto.
Inicio/Final | GetDefectGapCaliperIndex(Inspección, Índice de defecto/hueco, Defecto/Hueco, Índice de par de bordes, Inicio/Final de defecto) | Devuelve el calibre situado donde comienza o termina el defecto (Inicio = 0, Final = 1).
Extremos - Punto más lejano 1/2
Calibre | GetExtremePoints(Inspección, Índice de par de bordes, Cerca/Lejos) | Devuelve el índice del calibre que tiene el borde más alejado del encuadre de línea (Cerca = 0 y Lejos = 1).
X | GetEdgeX(Inspección, Índice de calibre, Índice de par de bordes o Índice de borde) | Devuelve la coordenada X del borde referenciado.
Y | GetEdgeY(Inspección, Índice de calibre, Índice de par de bordes o Índice de borde) | Devuelve la coordenada Y del borde referenciado.
Distancia | GetEdgeFromFit(Inspección, Índice de calibre, Índice de par de bordes) | Devuelve la distancia medida desde el borde del calibre referenciado hasta el encuadre de línea.
En todas las fórmulas para InspectEdgeForDefect se considera lo siguiente: Nota: Inspección = Una estructura de datos de Inspección generada por una función InspectEdgeForDefect Índice de calibre = 0 a N (el número total de calibres es igual al número de calibres que proporciona la función de inspección de bordes InspectEdge a la que hace referencia la función InspectEdgeForDefect) Índice del par de bordes = 0 o 1 Índice de borde = 0 a N Índice de punto = 0 a 1 Si el parámetro Inspect Edge Pairs (inspeccionar pares de bordes) está habilitado, se insertarán automáticamente filas adicionales de datos para el borde 1 en la hoja de cálculo. Cuando está habilitado, el índice 0 indica que se devolverá información sobre el borde 0, mientras que el índice 1 indica que se devolverá información sobre el borde 1.