Grabación y Exportación de Datos de Mirada

Una vez que el seguimiento ocular está habilitado y configurado para una tarea (ver Configurando el Seguimiento Ocular en una Tarea), necesitas eventos que realmente capturen los datos de mirada como variables grabadas.

Configuración de Evento Automatizada

En el momento en que marcas Enable Eye-Tracking: en el editor de tareas, aparece un diálogo de "Configuración de Seguimiento Ocular", ofreciendo crear estos eventos por ti:

• Record gaze timeseries [X,Y,T,C]: crea un evento de grabación de mirada, marcado por defecto
• Record fixation timeseries [X,Y,Dur,Start,End,Disp]: crea un evento de grabación de fijación, marcado por defecto. Si el modo de Detección de Fijación de tu tarea se configuró como No Fixation Detection, aceptar esta opción lo activa automáticamente.

También eliges el alcance: On all frames (el valor predeterminado) aplica los eventos de grabación a cada cuadro en la prueba, o Select a frame los restringe a un cuadro específico. Haciendo clic en Add Events se crean los eventos con estas elecciones; Skip cierra el diálogo sin crear nada.

Esto cubre el caso común: grabar cada muestra de mirada y fijación a lo largo de una prueba. Construye los eventos manualmente si omitiste este diálogo, necesitas restringir la grabación a objetos de estímulo específicos (ver más abajo), o estás agregando eventos de seguimiento ocular a una tarea que ya existe.

Grabación de Coordenadas de Mirada Manualmente

Para grabar una serie temporal de coordenadas de mirada:

1. Agrega un nuevo evento desde el editor de eventos.
2. Para el desencadenador, selecciona Physiological Signal Triggers → Eyetracking Gaze.
3. Para la acción, selecciona Variable Actions → Set / Record Variable, luego crea una nueva variable:
   • Formato: Array (recomendado, para que un par de coordenadas X/Y se almacenen juntas)
   • Tipo de Registro: All changes / time series, para que cada actualización de mirada se registre, no solo el valor final al final de una prueba
4. En el menú de selección de valor, elige Coord. + Time + Confidence [X,Y,T,C] Array de las opciones Trigger (Eyetracking Gaze). Esto registra las coordenadas X e Y, una marca de tiempo precisa y un valor de confianza en un solo array.

También hay un desencadenador Eyetracking Fixation, que informa las fijaciones de un participante (donde su mirada se asienta, en lugar de cada muestra individual de mirada) usando el modo de Detección de Fijación configurado en la configuración de la tarea. Actualmente está en beta.

Restringiendo la Grabación a Objetos de Estímulo Específicos

Tanto los desencadenadores Eyetracking Gaze como Eyetracking Fixation pueden restringirse a dispararse solo cuando el participante está mirando objetos de estímulo específicos, en lugar de en cualquier parte del cuadro. Para hacer esto, selecciona la opción de disparar solo en elementos específicos, luego agrega esos elementos como objetivos. Esto es útil cuando solo te importa si un participante miró una imagen o región particular, no su posición de mirada en cualquier otro lugar del cuadro.

Grabación de Calibración y Error de Prueba

Junto con las coordenadas de mirada, puedes grabar cuán preciso fue el seguimiento ocular para un participante dado:

1. Agrega otro evento, con On Frame Start como el desencadenador.
2. Para la acción, selecciona Variable Actions → Set / Record Variable.
3. En el menú de selección de valor, bajo Frame/Task/Object → Eyetracking, elige Error Trial para registrar el error de la prueba actual, o Error Calibration para registrar el error de la calibración original.

Ambos valores de error son distancias euclidianas medias, en unidades de cuadro, entre las coordenadas de mirada predichas y las ubicaciones de fijación de destino reales mostradas durante la calibración o entre pruebas. Grabar ambos te permite excluir participantes, o pruebas específicas, que caen por debajo de tu umbral de precisión durante el análisis.

Exportando Datos de Mirada

Navega a la pestaña Dataview & Export para acceder a tus datos grabados. Hay dos tipos de exportación:

• Datos normales: grabados una vez por prueba, como respuestas, condiciones y error de calibración/prueba si elegiste grabarlos. Cada variable es su propia columna, cada prueba su propia fila.
• Datos de serie temporal: grabados continuamente a lo largo de una prueba, que es lo que utilizan las coordenadas de mirada, ya que se actualizan muchas veces por segundo. Cada fila representa una muestra de mirada, junto a una times columna separada compartida entre todas las variables de serie temporal.

Algunas cosas a tener en cuenta al trabajar con estas columnas:

• Basa tus mediciones de tiempo en T en lugar de en la columna times separada. T es la marca de tiempo ajustada de cuando la cámara realmente capturó la imagen, mientras que times refleja cuando Labvanced registró el valor, que corre ligeramente detrás del momento real de captura ya que el algoritmo necesita unos milisegundos para procesar cada instantánea primero.
• C varía de 0 a 1. Un valor cercano a 1 indica una detección confiable; un valor cercano a 0 indica típicamente un parpadeo o que los ojos del participante no eran visibles para la cámara.
• La tasa de muestreo no es perfectamente constante y se puede determinar desde T. En general, no se pueden lograr tasas de muestreo superiores a 30Hz, debido a las limitaciones de hardware de la mayoría de las webcams comercialmente disponibles.

El repositorio de GitHub de Labvanced tiene scripts para el procesamiento adicional de los datos exportados de seguimiento ocular y WebSocket.

Preguntas Frecuentes

Lectura Adicional