labvanced logoLabVanced
  • Research
    • Publications
    • Researcher Interviews
    • Use Cases
      • Developmental Psychology
      • Linguistics
      • Clinical & Digital Health
      • Educational Psychology
      • Cognitive & Neuro
      • Social & Personality
      • Arts Research
      • Sports & Movement
      • Marketing & Consumer Behavior
      • Economics
      • HCI / UX
      • Commercial / Industry Use
    • Labvanced Blog
    • Services
  • Technology
    • Feature Overview
    • Code-Free Study Building
    • Eye Tracking
    • Mouse Tracking
    • Generative AI Integration
    • Multi User Studies
    • More ...
      • Reaction Time/Precise Timing
      • Text Transcription
      • Heart Rate Detection (rPPG)
      • Emotion Detection
      • Questionnaires/Surveys
      • Experimental Control
      • Data Privacy & Security
      • Desktop App
      • Mobile App
  • Learn
    • Guide
    • Videos
    • Walkthroughs
    • FAQ
    • Release Notes
    • Documents
    • Classroom
  • Experiments
    • Cognitive Tests
    • Sample Studies
    • Public Experiment Library
  • Pricing
    • Licenses
    • Top-Up Recordings
    • Subject Recruitment
    • Study Building
    • Dedicated Support
    • Checkout
  • About
    • About Us
    • Contact
    • Downloads
    • Careers
    • Impressum
    • Disclaimer
    • Privacy & Security
    • Terms & Conditions
    • Third-Party Licenses
  • Appgo to app icon
  • Logingo to app icon
Learn
Guide
Vidéos
Guides étape par étape
FAQ
Archives des newsletters
Documents
Salle de classe
  • 中國人
  • Deutsch
  • Français
  • Español
  • English
  • 日本語
Guide
Vidéos
Guides étape par étape
FAQ
Archives des newsletters
Documents
Salle de classe
  • 中國人
  • Deutsch
  • Français
  • Español
  • English
  • 日本語
  • Guide
    • COMMENCER

      • Éditeur de Tâches
      • Cadres
        • Cadre de Canvas
        • Cadre de Page
        • Cadre de Site Web
      • Chronologie des Essais
      • Présentation des Stimuli
      • Correction de la Réponse
      • Objets
      • Événements
      • Variables
      • Assistant de Tâche
      • Système d'Essai
      • Conception de l'Expérience
        • Créer une étude
        • Modèles de Data Frame
        • Conception d'expériences multi-utilisateurs
        • Conception d'Expérience Longitudinale
    • SUJETS EN VEDETTE

      • Randomisation & Équilibre
      • Suivi Oculaire
        • Présentation des Stimuli dans une Tâche de Suivi Oculaire
        • Comment Choisir les Paramètres de Calibration du Suivi Oculaire
        • Configurer le suivi oculaire dans une tâche
        • Enregistrement et exportation des données de regard
        • Utiliser des formes comme zones d'intérêt (AOI) pour le suivi oculaire
        • L'expérience de calibration des participants
      • Web Bridge
        • Sélectionner les AOI du site Web | Ancrer, ajuster et vérifier le suivi des AOI
        • Suivi du comportement de la souris sur un AOI de site Web | Guide Web Bridge
      • Questionnaires
      • Application de Bureau
      • Études Échantillons
      • Recrutement des Participants
      • Accès API
        • API REST
        • API Webhook
        • API WebSocket
      • Autres Sujets

        • Horodatages Précis des Stimuli
        • Études Multi-Utilisateurs
        • Suivi de la Tête dans Labvanced | Guide
    • ONGLETS PRINCIPAUX DE L'APPLICATION

      • Aperçu : Onglets Principaux
      • Tableau de Bord
      • Mes Études
      • Études Partagées
      • Mes Fichiers
      • Bibliothèque d'Expériences
      • Mon Compte
      • Licence & Services
    • ONGLETS D'ÉTUDE

      • Aperçu : Onglets Spécifiques à l'Étude
      • Conception de l'Étude
        • Tâches
        • Blocs
        • Sessions
        • Groupes
      • Éditeur de Tâches
        • Contrôles de Tâches
        • Le Système des Essais
        • Types de cadres
        • Objets
        • Tables de Propriétés des Objets
        • Variables
        • Table des Variables Système
        • Le système d'événements
        • Fonctions de l'Éditeur de Texte
        • Options de suivi oculaire dans l'éditeur de tâche
        • Suivi de la tête dans une tâche
        • Études Multi-Utilisateur
      • Paramètres
      • Variables
      • Médias
      • Textes & Traduction
      • Lancer & Participer
      • Gestion des Sujets
      • Vue des Données et Export
        • Vue des données et sélection des variables & des tâches (ancienne version)
        • Accéder aux Enregistrements (Version ANCIENNE)
  • Vidéos
    • Aperçu des vidéos
    • Commencer avec Labvanced
    • Création de tâches
    • Vidéos d'éléments
    • Événements et variables
    • Sujets avancés
  • Tutoriels
    • Introduction
    • Tâche de Stroop
    • Tâche de décision lexicale
    • Tâche de pointage de Posner
    • Paradigme de clignotement de cécité au changement
    • Étude d'exemple de suivi oculaire
    • Étude de suivi oculaire chez les nourrissons
    • Étude de capture attentionnelle avec suivi de la souris
    • Présentation visuelle séquentielle rapide
    • Étude ChatGPT
    • Démonstration de suivi oculaire : SVG en tant qu'AOIs
    • Démonstration multi-utilisateur : montrer les curseurs des sujets
    • Configuration de base du contrôleur Gamepad / Joystick
    • Étude d'application de bureau avec intégration EEG
    • Équilibrage de groupes entre sujets et configuration des variables
    • Construction d'une étude multi-utilisateur
    • Tutoriel de suivi oculaire dans le cadre d'un site web
    • Suivi oculaire par webcam conditionnel
  • FAQ
    • Fonctionnalités
    • Politique et directives de support
    • Sécurité et confidentialité des données
    • Licences
    • Précision de Labvanced
    • Utilisation programmatique et API
    • Utiliser Labvanced hors ligne
    • Dépannage
    • Questions sur la création d'études
  • Archive de la newsletter
  • Documents
  • Salle de classe
Illustration d'enregistrement et d'exportation de données de regard dans Labvanced

Enregistrement et exportation des données de regard

Une fois que le suivi oculaire est activé et configuré pour une tâche (voir Configuration du suivi oculaire dans une tâche), vous avez besoin d'événements qui capturent réellement les données de regard en tant que variables enregistrées.

Configuration automatique des événements

Au moment où vous cochez Enable Eye-Tracking: dans l'éditeur de tâches, une fenêtre de dialogue "Configuration Eyetracking" apparaît, vous proposant de créer ces événements :

Fenêtre de dialogue de configuration Eyetracking proposant de créer automatiquement des événements d'enregistrement de regard et de fixation

  • Record gaze timeseries [X,Y,T,C]: crée un événement d'enregistrement de regard, coché par défaut
  • Record fixation timeseries [X,Y,Dur,Start,End,Disp]: crée un événement d'enregistrement de fixation, coché par défaut. Si le mode de Détection de Fixation de votre tâche était réglé sur No Fixation Detection, accepter cette option l'active automatiquement.

Vous choisissez également le champ d'application : On all frames (par défaut) applique les événements d'enregistrement à chaque trame dans l'essai, ou Select a frame les limite à une trame spécifique. En cliquant sur Add Events, les événements sont créés avec ces choix ; Skip ferme la fenêtre de dialogue sans rien créer.

Ceci couvre le cas courant : enregistrer chaque échantillon de regard et de fixation au cours d'un essai. Créez les événements manuellement si vous avez sauté cette fenêtre de dialogue, avez besoin de restreindre l'enregistrement à des objets de stimulus spécifiques (voir ci-dessous), ou ajoutez des événements de suivi oculaire à une tâche qui existe déjà.

Enregistrement des coordonnées de regard manuellement

Pour enregistrer une série temporelle de coordonnées de regard :

  1. Ajoutez un nouvel événement à partir de l'éditeur d'événements.
  2. Pour le déclencheur, sélectionnez Physiological Signal Triggers → Eyetracking Gaze.
  3. Pour l'action, sélectionnez Variable Actions → Set / Record Variable, puis créez une nouvelle variable :
    • Format : Array (recommandé, afin qu'une paire de coordonnées X/Y puisse être stockée ensemble)
    • Type d'enregistrement : All changes / time series, afin que chaque mise à jour de regard soit enregistrée, pas seulement la valeur finale à la fin d'un essai
  4. Dans le menu de sélection de valeur, choisissez Coord. + Time + Confidence [X,Y,T,C] Array parmi les options Trigger (Eyetracking Gaze). Cela enregistre les coordonnées X et Y, un horodatage précis et une valeur de confiance dans un seul tableau.

Il existe également un déclencheur Eyetracking Fixation, qui rapporte les fixations d'un participant (où leur regard se fixe, plutôt que chaque échantillon de regard individuel) en utilisant le mode de Détection de Fixation configuré dans la configuration de la tâche. Il est actuellement en version beta.

Restreindre l'enregistrement à des objets de stimulus spécifiques

Les déclencheurs Eyetracking Gaze et Eyetracking Fixation peuvent être restreints pour ne se déclencher que lorsque le participant regarde des objets de stimulus spécifiques, plutôt que n'importe où sur la trame. Pour ce faire, sélectionnez l'option pour ne se déclencher que sur des éléments spécifiques, puis ajoutez ces éléments en tant que cibles. Cela est utile lorsque vous ne vous souciez que de savoir si un participant a regardé une image ou une région particulière, pas de sa position de regard partout ailleurs sur la trame.

Enregistrement de la calibration et de l'erreur d'essai

En plus des coordonnées de regard, vous pouvez enregistrer la précision du suivi oculaire pour un participant donné :

  1. Ajoutez un autre événement, avec On Frame Start comme déclencheur.
  2. Pour l'action, sélectionnez Variable Actions → Set / Record Variable.
  3. Dans le menu de sélection de valeur, sous Frame/Task/Object → Eyetracking, choisissez Error Trial pour enregistrer l'erreur pour l'essai actuel, ou Error Calibration pour enregistrer l'erreur provenant de la calibration d'origine.

Les deux valeurs d'erreur sont des distances euclidiennes moyennes, en unités de trame, entre les coordonnées de regard prédites et les emplacements de fixation cibles réels affichés lors de la calibration ou entre les essais. Enregistrer les deux vous permet d'exclure des participants ou des essais spécifiques qui tombent en dessous de votre seuil de précision lors de l'analyse.

Exportation des données de regard

Naviguez vers l'onglet Dataview & Export pour accéder à vos données enregistrées. Il y a deux types d'exportation :

  • Données normales : enregistrées une fois par essai, telles que les réponses, les conditions, et l'erreur de calibration/essai si vous avez choisi de les enregistrer. Chaque variable est sa propre colonne, chaque essai sa propre ligne.
  • Données de série temporelle : enregistrées en continu tout au long d'un essai, ce que les coordonnées de regard utilisent puisque celles-ci se mettent à jour plusieurs fois par seconde. Chaque ligne représente un échantillon de regard, avec une colonne times séparée partagée entre toutes les variables de série temporelle.

Aperçu des données collectées à l'aide du suivi oculaire par webcam de Labvanced.

Aperçu des données collectées à l'aide du suivi oculaire par webcam de Labvanced
X: Coordonnée X du regard ; Y: Coordonnée Y du regard ; T: Horodatage ; C: Intervalle de confiance

Quelques éléments à garder à l'esprit lorsque vous travaillez avec ces colonnes :

  • Basez vos mesures de temps sur T plutôt que sur la colonne times séparée. T est l'horodatage ajusté du moment où la caméra a réellement capturé l'image, tandis que times reflète le moment où Labvanced a enregistré la valeur, ce qui est légèrement en retard par rapport au moment réel de capture puisque l'algorithme nécessite quelques millisecondes pour traiter chaque instantané d'abord.
  • C varie de 0 à 1. Une valeur proche de 1 indique une détection confiante ; une valeur proche de 0 indique généralement un clignement ou que les yeux du participant n'étaient pas visibles par la caméra.
  • Le taux d'échantillonnage n'est pas parfaitement constant et peut être déterminé à partir de T. En général, des taux d'échantillonnage supérieurs à 30 Hz ne sont pas réalisables, en raison des contraintes matérielles de la plupart des webcams disponibles dans le commerce.

Le dépôt GitHub de Labvanced propose des scripts pour le traitement ultérieur des données de suivi oculaire et des données WebSocket exportées.

Questions fréquemment posées

Si je saute la fenêtre de dialogue de configuration automatisée d'Eyetracking, puis-je toujours enregistrer des données de regard ?
Oui. Créez les événements d'enregistrement manuellement plutôt, en utilisant un déclencheur `Eyetracking Gaze` ou `Eyetracking Fixation` avec une action `Set / Record Variable`, comme couvert ci-dessus. C'est également la voie à suivre si vous devez restreindre l'enregistrement à des objets de stimulus spécifiques, ou si vous ajoutez des événements de suivi oculaire à une tâche qui existe déjà.
Dois-je baser mon analyse temporelle sur la colonne `times` ou sur `T` ?
Utilisez `T`. `T` (`Camera Capture Time T`) est l'horodatage ajusté du moment où la caméra a réellement capturé l'image, tandis que `times` reflète le moment où Labvanced a enregistré la valeur, qui est légèrement en retard puisque l'algorithme nécessite quelques millisecondes pour traiter chaque instantané d'abord. La même distinction s'applique à `Camera Capture Time T` sous les valeurs du déclencheur de Détection d'Émotion dans le Menu de sélection de valeur.
Que signifie une valeur de Confiance (`C`) proche de 0 ?
Cela indique généralement un clignement ou que les yeux du participant n'étaient pas visibles par la caméra. Une valeur proche de 1 indique une détection confiante.
Pourquoi mes données de regard ne sont-elles pas échantillonnées à un taux parfaitement constant ?
Le taux d'échantillonnage n'est pas parfaitement constant et peut être déterminé à partir de `T`. En général, des taux d'échantillonnage supérieurs à 30 Hz ne sont pas réalisables, en raison des contraintes matérielles de la plupart des webcams disponibles dans le commerce.
Comment savoir si une calibration de mauvaise qualité ou un essai spécifique est responsable de mauvaises données de regard ?
Enregistrez à la fois `Error Calibration` et `Error Trial` en tant que variables. Les deux sont des distances euclidiennes moyennes, en unités de trame, entre les coordonnées de regard prédites et les emplacements de fixation cibles réels, vous permettant d'exclure des participants ou des essais spécifiques qui tombent en dessous de votre seuil de précision lors de l'analyse.
Puis-je enregistrer des données de regard uniquement pour des objets spécifiques, plutôt que pour toute la trame ?
Oui. Les déclencheurs `Eyetracking Gaze` et `Eyetracking Fixation` peuvent être restreints à se déclencher uniquement lorsque le participant regarde des objets de stimulus spécifiques ajoutés en tant que cibles, plutôt que n'importe où sur la trame.

Lectures complémentaires

Configurer le suivi oculaire dans une tâche Labvanced

Configurer le suivi oculaire dans une tâche

Activer le suivi oculaire et configurer la recalibration avant de créer les événements sur cette page.

Utilisation de formes en tant que Zones d'Intérêt pour le suivi oculaire

Utiliser des formes comme Zones d'Intérêt (AOI)

Définir des régions d'une trame que les déclencheurs de regard et de fixation peuvent cibler.

Technologie de suivi oculaire par webcam dans Labvanced

Technologie de suivi oculaire par webcam

Comment fonctionne la technologie de suivi oculaire par webcam de Labvanced.

Variables de séries temporelles

Les paramètres généraux de Type d'enregistrement et de Méthode d'échantillonnage qui contrôlent comment des données continues comme le regard sont captées.

Contrôles de tâche

La fenêtre de dialogue de configuration Eyetracking automatisée montrée ci-dessus, dans le contexte de la référence complète des contrôles de tâche.

Prev
Configurer le suivi oculaire dans une tâche
Next
Utiliser des formes comme zones d'intérêt (AOI) pour le suivi oculaire