# ViDiELRead

La herramienta ViDiELRead sirve para identificar letras, números y símbolos en una de la cámara en directo.

## Para agregar la herramienta ViDiELRead:

1. Arrastrar y soltar ViDiELRead en la hoja de cálculo.

Nota: En este ejemplo, ya tenemos el elemento posicionador que se creó entonces. Para crear un elemento posicionador, consulte Entrenar la función TrainPatMaxRedLine y FindPatMaxRedLine.

Aparece visualizada la Hoja de propiedades.

2. Especifique la región del elemento posicionador (Fixture) por cualquiera de las dos siguientes posibilidades:
   1. Hacer clic sobre Insert Absolute Reference en la esquina superior izquierda del panel.

   2. Hacer doble clic sobre Fixture.

3. En la hoja de cálculo, seleccione las coordenadas del elemento posicionador y haga clic sobre Accept changes.

4. Haga doble clic sobre Region y posicione la región de búsqueda. Para cambiar el tamaño del cuadro de búsqueda, haga clic y arrastre las esquinas. Para girar el cuadro de búsqueda, haga clic y arrastre el botón de rotación.

   Nota: La región de búsqueda no debe sobrepasar los límites de la imagen. De lo contrario, la herramienta da #ERR.

5. Haga clic sobre el botón de edición situado junto a Character Size y desplace la región de búsqueda para que rodee uno de los caracteres que desea encontrar. Para cambiar el tamaño del cuadro de búsqueda, haga clic y arrastre las esquinas. Sitúe el cuadro delimitador bien ajustado alrededor del carácter. Para aceptar los cambios, haga clic sobre el icono de marca de verificación.

   Ahora puede entrenar la herramienta ViDiELRead. Por defecto, el Modo de entrenamiento está ajustado a User-Trained, es decir, para que el entrenamiento sea realizado por el usuario.

6. Haga clic sobre el botón de edición situado junto a Train. Escriba los caracteres que corresponden a las letras y números seleccionados en cada imagen. Etiquete y entrene con todos los caracteres previstos (A-Z, 0-9) en su aplicación. Para saltar a una nueva imagen, haga clic sobre Next Image. Debe entrenar con por lo menos 3 imágenes. Cuántas más imágenes y caracteres utilice para el entrenamiento, tanto mayor será la calidad del resultado obtenido.

7. Seleccione OK. La salida de la función se visualiza en la hoja de cálculo.

Para más información sobre las funciones y ajustes de ViDiELRead, consulte las secciones desplegables presentadas a continuación.

Ajustes básicos

Ajuste | Descripción
--- | ---
Imagen | Referencia a la celda que contiene una estructura de imagen. Valor predeterminado: $A$0.
Fixture | Origen del elemento posicionador (X, Y, Theta). Desplazamientos con respecto al origen de la imagen.
Region | Región de interés (X, Y, Ancho, Altura, Ángulo).
Training Mode | User-Trained: El usuario introduce manualmente los caracteres mientras está entrenando la herramienta. Se logran así lecturas más precisas. Pre-Trained: La herramienta predice automáticamente los caracteres mientras se está entrenando. Puede implicar lecturas menos precisas. Nota: Las opciones Train y Unique Characters in Samples sólo están disponibles en el modo User-Trained.
Show | Permite seleccionar el tipo de gráfico a superponer sobre la imagen.

Character Size

Ajuste el recuadro de búsqueda al tamaño del carácter. No se puede girar el recuadro de búsqueda. Sitúe el cuadro delimitador bien ajustado alrededor del carácter.

Fielding Match

Fielding Match permite configurar la herramienta para que acepte únicamente determinados caracteres o patrones. Dispone de dos ajustes básicos, Variable number of characters y Fixed number of characters.

1. Variable number of characters

   La herramienta lee todos los caracteres que contiene la imagen.

   Acceptable Characters: Especifica el tipo de caracteres que reconoce la herramienta ViDiELRead.

   - Any character: La herramienta busca letras, números y símbolos (por ejemplo, <, $,?).

   - Numerical character only: La herramienta busca únicamente números.

   - Alphabetical characters only: La herramienta busca únicamente letras.

   - Alphanumerical characters only: La herramienta busca números y letras.

   Number of lines: Marque la casilla junto a Specify number of lines si los caracteres que contiene su imagen están dispuestos en varias filas. Introduzca el número de filas en el campo de entrada Number of lines.

2. Fixed number of characters

   La herramienta lee un patrón de caracteres o patrones de caracteres en la imagen. La herramienta reconoce los caracteres que no se ajustan al patrón proporcionado, pero devuelve error.

   El patrón utiliza un estilo de expresión sencillo y regular formado por caracteres constantes (alfanuméricos y especiales) y metacaracteres.

   Se pueden utilizar los siguientes metacaracteres:

   - "\d": equivale a cualquier carácter numérico [0-9].

   - "\l": equivale a cualquier carácter alfabético [a-z, A-Z].

   - "\w": equivale a cualquier carácter alfanumérico [a-z, A-Z, 0-9].

   - "\.": equivale a cualquier carácter.

   Ejemplos de patrones válidos:

   - "\d\d\d\d": equivale a un número compuesto por cuatro dígitos.

   - "\l\l\l": equivale a una palabra de tres letras.

   - "\d\d:\d\d:\d\d": equivale a un periodo de tiempo en formato HH:MM:SS.

   - "N\d\d\d\l\l\l": se puede usar para representar un número de serie que comienza por 'N', seguido de 3 dígitos y 3 letras.

   Puede aplicar múltiples patrones a una sola configuración de herramienta de Lectura haciendo para ello clic sobre el botón Add Pattern. Si entra varios patrones, la herramienta devolverá el nombre del patrón coincidente mientras realiza la lectura.

   Fórmula utilizada: 1C4RJH\w\w\w\w\d\d\d\d\d\d\d | Fórmula utilizada: Z1\w06456\d\d\d\d\d

Train

Entrene la herramienta con letras, números y símbolos.

Por defecto, la herramienta identifica los posibles caracteres en la imagen colocando un cuadro delimitador alrededor de cada uno de ellos. Se pueden desplazar libremente estos cuadros delimitadores, pero su tamaño solo puede modificarse mediante el ajuste Character Size. Para añadir más cuadros delimitadores, haga clic sobre Label o en uno de los cuadros, seleccione el botón Add y haga clic sobre la imagen. Cuando no quiera añadir más cuadros delimitadores, haga clic sobre Done. Para eliminar un cuadro, selecciónelo y haga clic sobre Remove. Para eliminar todos los cuadros delimitadores, seleccione la opción Clear All. Para aceptar el entrenamiento configurado, haga clic sobre Accept All.

Nota: Cada carácter tiene que estar etiquetado en la región de búsqueda. Eliminar etiquetas de caracteres válidos tiene el efecto de que se entrena la herramienta a ignorarlos.
Unique Characters in Samples

Muestra el número de caracteres e imágenes de origen entrenados, así como el nivel de confianza de la herramienta para un carácter determinado. Cuanto menor sea el porcentaje, tanto menor es la probabilidad de que un resultado proporcionado sea correcto.

Puede ver este porcentaje pasando el ratón sobre la línea de color situada debajo del carácter. El color da también información sobre el nivel de confianza:

- Verde: nivel de certidumbre alto

- Amarillo: nivel de certidumbre medio

- Rojo: nivel de certidumbre bajo

Puede ordenar los datos entrenados por carácter o por imagen:

Puede saltar al reentrenamiento de un determinado carácter haciendo clic con el botón izquierdo sobre la imagen del carácter en la vista By Character (por carácter) o puede volver a entrenar todos los caracteres en una imagen haciendo clic sobre el icono de edición situado junto a la fila pertinente en la vista By Image (por imagen).

Puede buscar un determinado carácter escribiéndolo en la barra de búsqueda de cualquiera de las dos vistas. La herramienta distingue entre mayúsculas y minúsculas.

También puede eliminar muestras marcando la casilla junto a la fila correspondiente y haciendo clic sobre Delete Samples.

Salidas de ViDiELRead

Salida | Descripción
--- | ---
String | Todos los caracteres que la herramienta reconoce en la imagen, visualizados se visualizan como un valor de cadena.
Passed | Muestra si una lectura logra (Pase) o no (Fallo) una coincidencia Fielding. Pase: 1.000 Fallo: 0.000
Índice | El índice de lectura según ubicación del carácter en la imagen (de izquierda a derecha).
Char | Character. La mejor coincidencia de carácter.
Score | El nivel de confianza de la herramienta para el carácter. Cuanto menor sea el porcentaje, tanto menor es la probabilidad de que un resultado proporcionado sea correcto.
2nd Char | Second Character. La segunda mejor coincidencia de carácter.
2nd Score | El nivel de confianza de la herramienta para el carácter que presenta la segunda mejor coincidencia. Cuanto menor sea el porcentaje, tanto menor es la probabilidad de que un resultado proporcionado sea correcto.