Grabación y Exportación de Datos de Mirada

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

Configuración Automática de Eventos

En el momento en que marcas Enable Eye-Tracking: en el editor de tareas, aparece un diálogo de "Configuración de Seguimiento Ocular", ofreciéndote crear estos eventos automáticamente:

• 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 fue establecido en No Fixation Detection, aceptar esta opción lo activa automáticamente.

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

Esto cubre el caso más común: grabar cada muestra de mirada y fijación a lo largo de un ensayo. En su lugar, 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 activador, 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 pueda almacenarse junto)
   • Tipo de Registro: All changes / time series, para que cada actualización de mirada se registre, no solo el valor final al final de un ensayo
4. En el menú de selección de valores, elige Coord. + Time + Confidence [X,Y,T,C] Array de las opciones Trigger (Eyetracking Gaze). Esto registra las coordenadas X e Y, un timestamp preciso, y un valor de confianza en un único array.

También hay un activador Eyetracking Fixation, que informa las fijaciones de un participante (donde su mirada se detiene, en lugar de cada muestra individual de mirada) utilizando 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 activadores Eyetracking Gaze como Eyetracking Fixation pueden restringirse para que solo se activen cuando el participante esté mirando objetos de estímulo específicos, en lugar de en cualquier lugar del fotograma. Para hacer esto, selecciona la opción para activar solo en elementos específicos, y luego añade 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 fotograma.

Grabación de Calibración y Error de Ensayo

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

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

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

Exportación de Datos de Mirada

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

• Datos Normales: registrados una vez por ensayo, como respuestas, condiciones y error de calibración/ensayo si elegiste registrarlos. Cada variable es su propia columna, cada ensayo su propia fila.
• Datos de Series Temporales: registrados continuamente a lo largo de un ensayo, 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 columna times separada compartida entre todas las variables de series temporales.

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

• Basa tus mediciones de tiempo en T en lugar de la columna times separada. T es el timestamp ajustado de cuando la cámara realmente capturó la imagen, mientras que times refleja cuando Labvanced registró el valor, lo cual está ligeramente retrasado respecto al 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 a partir de T. En general, tasas de muestreo superiores a 30Hz no son alcanzables, debido a las limitaciones de hardware de la mayoría de las webcams disponibles comercialmente.

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

Preguntas Frecuentes

Lectura Adicional