Validación Facial

En esta sección encontrará la explicación de los principios básicos de la video analítica de validación facial. A diferencia de la analítica clásica de reconocimiento facial para control de acceso, la analítica de validación facial es mucho más avanzada en su operación.

Principio de Operación

Esta herramienta de análisis de video está diseñada para generar alertas específicas cuando individuos no registrados en una base de datos de reconocimiento facial cruzan una zona designada previamente. A diferencia de los sistemas tradicionales de reconocimiento facial, que activan eventos al identificar a personas ya registradas en la base de datos, este sistema opera de manera inversa. Es decir, las alertas se disparan cuando detecta a personas que no forman parte de la base de datos,

Apertura de Parámetros de Configuración

Para abrir el menú de configuración de la analítica, pare todas las analíticas que se estén ejecutando en el momento, y haga 1) click en el ícono de configuración de la analítica 2) seleccione el archivo de configuración de la analítica 3) click para expandir la analítica correspondiente a la cámara deseada.

Ubique el parámetro llamado face_validation_config_params y haga click para expandirlo,

Explicación Parámetros de Configuración

Al hacer click en el parámetro de face_validation_config_params se muestran los parámetros de configuración de la analítica,

enable: poner en 1 para activar la analítica (siempre dejar en 1)
show_positive_recognition: poner en 1 si se quiere que la analítica muestre los eventos de reconocimiento positivos cuando se reconoce a alguien en la base de datos. Si se pone en 0 la analítica no mostrará los eventos de reconocimiento facial positivos.
show_negative_recognition: poner en 1 si se quiere que la analítica muestre los eventos de reconocimiento facial negativos, es decir, cuando no se reconoció a una persona en la base de datos. Se recomienda dejar siempre en 1.
user_lost_for_negative: poner en 1 si se quiere que la analítica valide a las personas que no están en la base de datos cuando hayan desaparecido de la vista de la cámara. Poner en 0 si se quiere que la analítica valida a las personas que no están en la base de datos cuando todavía están en vista de la cámara.
bbox_min_size: mínima longitud en pixeles que un rostro debe tener para ser considerado en la validación. Se recomienda dejar en 30.
min_frames_in_zone_for_negative: numero de muestras que el rostro debe estar presente en el video para validarse como cara negativa. Este parámetro debe calibrarse dependiendo de la perspetiva de la cámara. Puede comenzar con un valor de XXXXX y observar el comportamiento. Si ve que las cáras cambian a color rojo demasiado rápido auméntelo hasta que vea que la cara cambia de amarillo a rojo en un tiempo suficiente. La idea es que este valor es que sea lo más grande posible sin que las caras salgan de vista de la cámara sin ser validadas en rojo o verde.
num_frames_lost_for_negative: número de muestras para que un rostro esté fuera de vista del video y genere alerta en caso de no ser validado. Se recomienda dejar este valor en 20.
similarity_match_percentage: porcentaje de similaridad mínimo que debe tener un rostro del video con un rostro de la base de datos para que sea considerado como un evento de reconocimiento facial. Se recomienda dejar en 50 y calibrar de acuerdo al lugar donde se instale la analítica. Entre más pequeño sea el valor, será más probable que el sistema haga reconocimientos positivos pero también es factible que haga asociaciones de personas equivocadas o falsos positivos. Entre más grande el valor, el sistema será más estricto para reconocer personas en la base de datos pero también es factible que personas que están en la base de datos no sean reconocidas.

Configurar Zona de Validación Facial

El parámetro face_validation_zone determina la zona donde deben estar los rostros para que sean analizados por el sistema. Haga click en el botón de Seleccionar Zona para abrir una vista del video de la cámara y poder configurar la zona,

La vista de video debe abrir en el costado derecho y de allí puede crear la zona de validación facial. Recuerde que esta zona es donde deben pasar los rostros que quiere que el sistema valide.

Si el video no abre, debe revisar los parámetros de configuración de la cámara porque hay un problema en la conexión con la cámara.

Abrir Base de Datos Existente

Si ya ha creado una base de datos de rostro, puede abrirla y editarla yendo a la sección de Editar Base de Datos, seleccionando la base de datos, y haciendo click en Abrir,

Dependiendo del número de rostros que tenga en la base de datos, el panel de la derecha puede demorar unos segundos en abrir los rostros registrados en el sistema. Para aprender a editar la base de datos, por favor vaya a la sección de Manejo del Editor de Base de Datos.

Si necesita crear una base de datos, esto puede hacerse de dos maneras:

Crear base de datos manualmente
Crear base de datos importando archivo xlsx

Las secciones a continuación explican estos procedimientos

Borrar Base de Datos Existente

Si desea borrar una base de datos existente, vaya a Editar Base de Datos, seleccione la base de datos que quiere borrar, escriba la clave en la sección Clave para borrar, y haciendo click en Borrar. Pregúntennos por la clave para borrar.

Si necesita crear una base de datos, esto puede hacerse de dos maneras:

Crear base de datos manualmente
Crear base de datos importando archivo xlsx

Las secciones a continuación explican estos procedimientos

Crear Base de Datos Manualmente

Para crear una base de datos manualmente, vaya a la sección de Crear base de datos nueva, escriba el nombre que le desea dar a su base de datos en la casilla blanca (o si quiere también puede dejar el que el sistema asigna por defecto) y haga click en el botón de Crear,

Esto abrirá una base de datos nueva en el editor del panel de la derecha. Puede empezar a agregar personas siguiendo las instrucciones de la sección de Manejo del Editor de Base de Datos.

La próxima vez que acceda al menu de configuración de la analítica, la base de datos creada debe aparecer en la sección de Editar base de datos y debe abrirla desde allí para editarla.

Crear Base de Datos Importando .XLSX

Para importar una base de datos almacenadas en un archivo de Excel, siga las siguientes instrucciones:

1. Cree una carpeta con el nombre de su base de datos, por ejemplo, ex_facedb Asegúrese que el nombre de la carpeta no tenga espacios.

2. Dentro de la carpeta ponga todas las fotos de los rostros de las personas. Las fotos deben cumplir con las siguientes características

La extensión .png es la recomendada pero también se puede .jpeg
El nombre de el archivo no debe tener espacios, por ejemplo, pedro_gomez.png o catalinaPerez.png
La imagen debe estar ajustada al rostro e idealmente debe tener unas dimensiones aproximadas de 400 px x 400 px. Esto no es una medida estricta, es decir puede usar imágenes de 300 px x 300 px o de 600 px x 650 px y tampoco tienen que ser exactamente cuadradas. Para mejor desempeño del sistema, la imagen del rostro debe ser frontal como se muestra en estos ejemplos:

3. Dentro de la carpeta cree o copie un archivo .xlsx con el mismo nombre de la base de datos, en este caso ex_facedb.xlsx Si está trabajando desde el pc servidor de analíticas en Ubuntu Linux, puede hacerlo con el programa LibreOfficeCalc. Sólo asegúrese que cuando grabe el archivo lo grabe con extensión XLSX. Otro tipo de extensiones no son compatibles con el sistema. En este momento su carpeta debe contener el archivo xlsx y las imágenes. Note que la carpeta y el archivo tienen el mismo nombre.

4. En el archivo de Excel, en la fila 1 cree el encabezado de las columnas con los siguientes nombres. Tenga cuidado que los nombres deben ser exactos

Name
Lastname
Identifier
Image 1
Image 2
Image 3
Image 4
Image 5

Para cada persona que desee agregar a la base de datos, escriba una fila con la información correspondiente.

La información de Name, Lastname y Identifier es opcional.
Identifier utilícelo como una palabra identificadora tipo Apto 305, Nombre de empresa, etc.
Es mandatorio que la fila tenga en Image 1 el nombre del archivo de la imagen de esa persona, por ejemplo pedro_gomez.png. Si esa persona tiene otras imágenes asociadas, puede agregarlas en Image 2, Image 3, etc. Si no tiene puede dejar estas en blanco.

El archivo debe verse de esta manera,

5. Si la carpeta con el archivo y las imágenes la creo en otro computador, cópiela en una USB, conéctela al mini-pc servidor y cópiela en la carpeta de Documents

6. Abra el Analizador de video y vaya a la sección de Importar base de datos desde archivo. En este punto, debe aparecer en el listado la carpeta que creo en los pasos anteriores. (Si no aparece, revise que el nombre de la carpeta y archivo xlsx sean iguales y que la carpeta esté en la carpeta de Documents. Si estaba en el menú de configuración de analíticas abierto cuando creo la carpeta, vuelva a abrir el menú de configuración de la analítica para refrescar los valores)

Haga click en Abrir, en el panel de la derecha debe importar la base de datos con los datos contenidos en su carpeta con el archivo de Excel y las imágenes. Dependiendo del número de personas en el archivo, esto puede demorar unos segundos,

Observe que en la parte superior del Editor de la base de datos se muestra el número de personas registradas en la base de datos. Es recomendable que compare este número con el número de personas en su archivo de Excel. Si observa que hay menos, lo más probable es que el sistema no lo logró importar porque el nombre del archivo imagen en la columna Imagen 1 es incorrecto, o la imagen no estaba en la carpeta.

IMPORTANTE: Después de este punto, la base de datos se encuentra ya importada y grabada dentro del sistema. Por lo tanto, si necesita editarla para agregar/quitar personas, debe abrirla como se explicó en la sección Abrir Base de Datos Existente. Si necesita, exportarla otra vez a un archivo, siga las instrucciones en Exportar Base de Datos a Archivo

IMPORTANTE: Después de importar la base de datos, como ya se encuentra grabada dentro del sistema, si lo desea, ya puede borrar la carpeta que creo en Documents y también de la papelera de reciclaje.

Exportar Base de Datos a Archivo

Si desea exportar una base de datos existente a un archivo de Excel, lo puede hacer desde el Editor de la Base de Datos. Seleccione un nombre y haga click en Exportar Archivo

Esto creará una carpeta en Documents con los datos de la base datos.

Manejo del Editor de Base de Datos

El editor de la base de datos le permite Agregar, Editar y Borrar persona de la base de datos de personas.

Agregar

Para agregar una nueva persona haga click en el botón de Agregar. Esto abrirá una nueva tarjeta con campos. Haga en click en Cargar Imagen y busque la imagen de la persona que desea agregar. Recuerde que idealmente se desea una imágen en PNG donde el rostro de la persona aparezca frontal y de dimensiones aproximadas de 400 px x 400 px. Después de agrega la imagen, complete los campos de Nombre, Apellido e Identificador con la información de la persona. Estos tres campos son opcionales. Si no asigna ninguno, el sistema lo registra como una persona sin nombre. Recuerde que en el campo de identificador puede agregar información como Apartamento, Empresa, etc.

Editar

Para editar a una persona en la base de datos, ubique a la casiila en el listado y haga click en la casilla para expandirla. Cambia la información que desea y haga click en el botón verde de Guardar. Note que si desea cambiar la imagen asociada, tiene que borrar a la persona y crear una nueva.

Eliminar

Para eliminar a una persona de la base de datos, ubique a la casiila en el listado y haga click en la casilla para expandirla. Haga click en el botón de naranja de Eliminar.

Nota: Si desea expandir todas las tarjetas de personas en la base de datos, haga click en el botón de Expandir. Sin embargo, no recomendamos hacer esto si tiene muchas personas en la base de datos porque puede demorarse varios segundos en cargar todas las imágenes. Recomendamos que siempre abra la tarjeta que quiere editar y después de editarla cerrarla.

Correr la Video Analítica

Después de hacer todos los cambios en los parámetros o en la base de datos, haga click en el botón verde inferior de Guardar.

Haga click en el botón inferior de Play, si el sistema está configurado correctamente debe ver la vista de la cámara con la zona Face de validación.

En este momento le recomendamos hacer las siguientes pruebas para verificar el correcto funcionamiento del sistema.

Haga que una persona con registro en la base de datos camine hacia la zona de validación. El sistema debe reconocerlo y cambiar su la caja del rostro de amarillo a verde. Si no lo reconoce, verifique lo siguiente:
- La imagen de la base de datos es frontal y con las especificaciones recomendadas.
- El porcentaje de match de similaridad no está en un valor demasiado alto. Esto lo puede verificar si la persona se para enfrente y cerca a la cámara. Si en ese caso si lo reconoce, puede que el porcentaje este alto. Sin embargo, no recomendamos bajarlo más de 50% porque aumenta la posibildad de falsos positivos.
Haga que una persona sin registro en la base de datos camine hacia la zona de validación. El sistema después de un tiempo debe cambiar la caja del rostro de amarillo a rojo.

Si tiene algún inconveniente, contacte a nuestro equipo de soporte técnico.