# ExtractCalibrationPoints

La función ExtractCalibrationPoints extrae puntos de calibración de una imagen de un patrón de cuadrícula de calibración tipo damero. Estos puntos de calibración pueden ser utilizados por otras herramientas de calibración.

## ExtractCalibrationPoints Descripción general

Se utiliza una imagen de calibración, en particular, un patrón de damero con marca fiducial y escala conocida, para entrenar la función ExtractCalibrationPoints. Durante el análisis, encuentra las ubicaciones de los píxeles de las intersecciones de las líneas de la cuadrícula y, a continuación, establece una correspondencia entre estas intersecciones y las de un modelo de patrón de cuadrícula. La función devuelve una estructura de datos CalibPoints junto con el número de puntos encontrados en la cuadrícula. Este conjunto de puntos de calibración puede ser utilizado posteriormente por otras herramientas de calibración, como la función CalibratePoints, para corregir distorsiones, asignar coordenadas del sistema imagen a coordenadas del sistema mundo o viceversa.

Nota: Utilizar una cuadrícula de calibración tipo damero con marcas fiduciales. Por el momento, el equipo no admite la calibración mediante una cuadrícula sin marcas fiduciales.

## ExtractCalibrationPoints Entradas

Parámetro | Descripción
--- | ---
Imagen | Este argumento debe hacer referencia a una celda de la hoja de cálculo que contiene una estructura de datos Imagen válida. Por defecto, la celda a la que se hace referencia es la celda $A$0 que contiene la estructura de datos Image devuelta por .
Fixture | Define la región de interés (RDI) con relación a un Fixture entrado o al sistema de coordenadas de imagen proporcionado por una función de Vision Tools. Establecer la RDI con relación al un elemento posicionador permite asegurar 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.
X | El desplazamiento en X, en coordenadas de la imagen.
Y | El desplazamiento en Y, en coordenadas de la imagen.
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 | El tamaño de la región en la dirección del eje X.
Altura | El tamaño de la región en la dirección del eje Y.
Evento de extracción | Pulse para extraer puntos de calibración de la imagen.
Unidades de espaciado de la cuadrícula | Especifica la unidad de medida utilizada para el espaciado de la cuadrícula de calibración.
Micras = 0 | µm
Milímetros = 1 (por defecto) | mm
Centímetros = 2 | cm
Pulgadas = 3 | in
Espaciado en X de la cuadrícula | La distancia efectiva, en la dirección X, entre dos rectas de la cuadrícula de calibración.
Espaciado en Y de cuadrícula | La distancia efectiva, en la dirección X, entre dos rectas de la cuadrícula de calibración.
Margen angular | Seleccione para habilitar el parámetro Buscar tolerancias y restringir el intervalo angular a utilizar en la búsqueda de la cuadrícula. (Por defecto = 0, sin marcar) Consejo: Si se conoce bien la orientación de la cuadrícula con respecto a la cámara, se puede disminuir el intervalo de ángulos a considerar y, por tanto, acelerar la extracción de puntos.
Buscar tolerancias | Ángulos entre el ángulo inicial y el final utilizados para el establecimiento de la cuadrícula.
Ángulo inicial | Ángulo mínimo posible entre el eje horizontal de la cuadrícula y el eje horizontal de la cámara. (Mín. = -180, Máx. = 180, por defecto = -180)
Fin de ángulo | Ángulo máximo posible entre el eje horizontal de la cuadrícula y el eje horizontal de la cámara. (Mín. = -180, Máx. = 180, por defecto = +180)
Nota: Por defecto, el intervalo de ángulos no tiene límites. La casilla de verificación de Intervalo de ángulos debe estar seleccionada para poder definir un límite inicial y final en el parámetro Find Tolerances.
Tiempo de espera | Especifica un período de tiempo (en milisegundos) para la ejecución de la función en el ExtractCalibrationPoints. La ejecución de la función se detiene a la que se supera el tiempo de espera especificado. (Mínimo = 0, Máximo = 9999999, Predeterminado = 120000) Nota: El tiempo de espera se utiliza como una medida de protección para evitar que procesos de ejecución potencialmente muy largos se prolonguen demasiado, interrumpiéndolos cuando superen el tiempo de espera especificado. El tiempo de espera no es un lapso exacto ya que la ejecución puede prolongarse y durar unos segundos más que el tiempo especificado.
Mostrar | Especifica el modo de visualización de las superposiciones gráficas de ExtractCalibrationPoints sobre la imagen.
0 = ocultar todo (por defecto) | Se ocultarán todos los gráficos, excepto cuando está seleccionada la celda de la hoja de cálculo que contiene la función ExtractCalibrationPoints.
1 = solo gráficos de resultados | Visualiza las ubicaciones de los puntos extraídos, superpuestas sobre la imagen de entrada
2 = gráficos de entrada y resultado | Visualiza las ubicaciones de los puntos extraídos y la región de búsqueda.

## ExtractCalibrationPoints Salidas

Devuelve | Una estructura de datos CalibPoints o #ERR si alguno de los parámetros entrados no es válido. Las siguientes funciones Calibrate Vision Data Access functions se insertan automáticamente en la hoja de cálculo para crear la tabla de resultados:
Etiqueta | Función | Descripción
Points | GetNFound() | Devuelve el número de puntos encontrados en la imagen de la cuadrícula de calibración.