Ilustración de encabezado sobre la grabación y exportación de datos de mirada en Labvanced

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 capturan datos de mirada como variables grabadas.

Configuración Automática de Eventos

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

Cuadro de diálogo de Configuración de Seguimiento Ocular ofreciendo crear automáticamente eventos de grabación de mirada y fijación

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

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

Esto cubre el caso común: grabar cada muestra de mirada y fijación a lo largo de un ensayo. Construye los eventos manualmente si omitiste este cuadro de diálogo, necesitas restringir la grabación a objetos de estímulo específicos (ver más abajo), o estás añadiendo 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 ser almacenado junto)
    • Tipo de Grabación: All changes / time series, para que cada actualización de mirada sea grabada, no solo el valor final al final de un ensayo
  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 graba las coordenadas X y Y, una marca de tiempo precisa y un valor de confianza en un solo array.

También hay un activador Eyetracking Fixation, que informa sobre 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 activadores Eyetracking Gaze como Eyetracking Fixation pueden ser restringidos 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 sobre 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 fotograma.

Grabación de Calibración y Error del Ensayo

Junto con las coordenadas de mirada, puedes grabar cuán precisa fue la detección ocular para un determinado participante:

  1. Agrega otro evento, con On Frame Start como activador.
  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 grabar el error del ensayo actual, o Error Calibration para grabar 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 a participantes o ensayos específicos que estén 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 grabados. Hay dos tipos de exportación:

  • Datos normales: grabados una vez por ensayo, como respuestas, condiciones y error de calibración/ensayo si elegiste grabarlos. Cada variable es su propia columna, cada ensayo su propia fila.
  • Datos de series temporales: grabados 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 con una columna times separada que se comparte entre todas las variables de series temporales.

Vista previa de los datos recopilados usando el seguimiento ocular con cámara web de Labvanced.

Vista previa de los datos recopilados usando el seguimiento ocular con cámara web de Labvanced
X: Coordenada X de la mirada; Y: Coordenada Y de la mirada; T: Marca de tiempo; C: Intervalo de confianza

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

  • Basar tus mediciones de tiempo en T en lugar de la columna times separada. T es la marca de tiempo ajustada cuando la cámara realmente capturó la imagen, mientras que times refleja cuando Labvanced grabó el valor, que se queda un poco detrás del momento real de captura, ya que el algoritmo necesita unos pocos 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 puede determinarse 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 cámaras web comercialmente disponibles.

El repositorio de GitHub de Labvanced tiene scripts para procesar más datos exportados de seguimiento ocular y WebSocket.

Preguntas Frecuentes

Si omito el cuadro de diálogo de Configuración Automática de Seguimiento Ocular, ¿todavía puedo grabar datos de mirada?
Sí. Construye los eventos de grabación manualmente, usando un `Eyetracking Gaze` o `Eyetracking Fixation` activador con una `Set / Record Variable` acción, como se cubrió anteriormente. Este es también el camino a seguir si necesitas restringir la grabación a objetos de estímulo específicos, o si estás agregando eventos de seguimiento ocular a una tarea que ya existe.
¿Debería basar mi análisis de tiempo en la columna `times` o en `T`?
Usa `T`. `T` (`Camera Capture Time T`) es la marca de tiempo ajustada de cuando la cámara realmente capturó la imagen, mientras que `times` refleja cuando Labvanced grabó el valor, que se queda ligeramente detrás, ya que el algoritmo necesita unos pocos milisegundos para procesar cada instantánea primero. La misma distinción se aplica a `Camera Capture Time T` bajo los valores del activador de Detección de Emociones en el Menú de Selección de Valor.
¿Qué significa un valor de Confianza (`C`) cerca de 0?
Típicamente indica un parpadeo o que los ojos del participante no eran visibles para la cámara. Un valor cerca de 1 indica una detección confiable.
¿Por qué no se muestrean mis datos de mirada a una tasa perfectamente constante?
La tasa de muestreo no es perfectamente constante y puede determinarse 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 cámaras web comercialmente disponibles.
¿Cómo sé si una calibración de baja calidad o un ensayo específico es responsable de malos datos de mirada?
Graba tanto `Error Calibration` como `Error Trial` como variables. Ambos son distancias euclidianas medias, en unidades de fotograma, entre las coordenadas de mirada predichas y las ubicaciones de fijación objetivo reales, lo que te permite excluir a participantes o ensayos específicos que estén por debajo de tu umbral de precisión durante el análisis.
¿Puedo grabar datos de mirada solo para objetos específicos, en lugar de todo el fotograma?
Sí. Tanto los activadores `Eyetracking Gaze` como `Eyetracking Fixation` pueden ser restringidos para activarse solo cuando el participante está mirando objetos de estímulo específicos añadidos como objetivos, en lugar de en cualquier lugar del fotograma.

Lectura Adicional

Configurando el seguimiento ocular en una tarea de Labvanced

Configurando el Seguimiento Ocular en una Tarea

Activa el seguimiento ocular y configura la recalibración antes de construir los eventos en esta página.

Usando formas como Áreas de Interés para el seguimiento ocular

Usando Formas como Áreas de Interés (AOI)

Define regiones de un fotograma que los activadores de mirada y fijación pueden apuntar.

Tecnología de seguimiento ocular con cámara web en Labvanced

Tecnología de Seguimiento Ocular con Cámara Web

Cómo funciona la tecnología de seguimiento ocular con cámara web de Labvanced.

Variables de Series Temporales

La configuración general del Tipo de Grabación y del Método de Muestreo que controlan cómo se capturan datos continuos como la mirada.

Controles de la Tarea

El cuadro de diálogo de Configuración Automática de Seguimiento Ocular mostrado arriba, en el contexto de la referencia completa de Controles de Tarea.