# ExtractHistogram

Extrae una estructura de Histograma de una región de la imagen.

## ExtractHistogram Descripción general

La función Histogram devuelve una representación unidimensional de los valores de los píxeles en la región de interés. Un histograma está formado por un conjunto de números enteros en el que cada elemento del conjunto, denominado cajón (o intervalo), contiene una determinada cantidad de píxeles de la región, siendo la cantidad que contiene el cajón n el número de píxeles de la región que tienen el valor n. El suma total de las cantidades de los distintos cajones del conjunto es igual al número total de píxeles en la región.

## ExtractHistogram Entradas

Parámetro | Descripción
Imagen | Este parámetro ha de utilizar Referencias de celda contenidas en una celda de la hoja de cálculo que contiene una estructura de datos Imagen; por defecto, este parámetro hace referencia a A0, la celda que contiene la estructura de datos Image devuelta por la función . Este parámetro puede hacer también referencia a otras estructuras de datos Image, como las devueltas por las Funciones Image del conjunto Vision Tools.
Elemento posicionador | 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. 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 | 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.
Ángulo | La orientación en coordenadas del elemento posicionador.
Curva | La desviación angular entre el eje X de la región y la línea limítrofe del lado opuesto.
Nota: Para que se incluya un píxel en el recuento para el histograma, es necesario que el píxel esté completamente dentro de la región de la imagen, es decir, los píxeles que sólo están parcialmente dentro de la región no se incluyen en el histograma. 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 dará #ERR.
Región externa | Este parámetro utiliza Referencias de celda a una herramienta o función de control Annulus, Circle, Region, EditAnnulus, EditCircle, EditCompositeRegion, EditPolygon, EditRegion. Cuando se utiliza este parámetro, la función ignora los ajustes de Región y Elemento e inspecciona el área de imagen especificada por la región a la que se hace referencia. Si se hace referencia a un control de EditCompositeRegion, el área de inspección puede consistir en una combinación de formas. Cada forma de la región combinada puede definirse como una forma añadida al área de inspección o una sustraída (enmascaramiento) de la misma. 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.
Mostrar | Especifica el modo de visualización de los gráficos de ExtractHistogram sobre la imagen.
0 = ocultar todo (por defecto) | Se ocultarán todos los gráficos, excepto cuando la celda que contiene la función ExtractHistogram es la celda activa en la hoja de cálculo.
2 = sólo gráficos de entrada | Se visualizará en todo momento la región de la imagen de entrada.
3 = mostrar todo: entrada y gráfico | Se visualizarán en todo momento la región de la imagen de entrada y el gráfico del histograma. Nota: El gráfico de histograma es una ventana acoplable. Para más información, consulte el tema Editor de hojas de cálculo - Gráficos.

## ExtractHistogram Salidas

Devuelve | Una estructura de datos Hist que contiene la distribución de frecuencias para la imagen en escala de grises o #ERR si alguno de los parámetros de entrada no es válido.
Resultados | Cuando se inserta inicialmente la función ExtractHistogram en una celda, se crea una tabla de resultados en la hoja de cálculo. Las siguientes funciones Hist 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
Thresh | HistThresh(Hist, 0, 255) | El umbral binario.
Contrast | HistContrast(Hist, 0, 255) | El contraste de la imagen en escala de grises.
DarkCount | HistCount(Hist, 0, Umbral-1) | El número de píxeles por debajo del Umbral.
BrightCount | HistCount(Hist, Umbral, 255) | El número de píxeles por encima del Umbral.
Average | HistMean(Hist, 0, 255) | El valor medio en escala de grises.