Variables de Data Frame

Une variable de data frame contient des données tabulaires dans une structure semblable à celle d'une feuille de calcul : les lignes sont des entrées et les colonnes sont des variables, chacune pouvant contenir des valeurs de type chaîne, numérique, booléenne ou fichier. Les data frames ne sont pas peuplés par les réponses des participants. Vous téléchargez un fichier .csv pour y charger des données, et l'expérience les lit en temps réel en utilisant le système d'événements.

Les data frames sont l'outil standard dans Labvanced pour gérer des entrées structurées : listes de stimuli, programmes de contrebalancement, mappages de fichiers à images, et tout autre scénario où vous devez fournir des lignes de données préparées à votre expérience un essai à la fois.

Quand utiliser un data frame

Utilisez un data frame chaque fois que votre expérience doit charger des données structurées préalablement préparées plutôt que de collecter des valeurs auprès des participants.

• Vous avez une liste de mots, phrases, images ou fichiers audio de stimuli qui doivent apparaître essai par essai
• Vous devez contrebalancer les conditions entre les participants
• Vous souhaitez mélanger l'ordre des essais au début d'une expérience, puis lire les entrées séquentiellement
• Vous chargez des invites OpenAI, des messages personnalisés ou d'autres données sous forme de chaîne depuis un fichier préparé

Configuration d'un data frame

Créer un data frame prend trois étapes : préparer votre CSV, créer la variable, et importer le fichier.

Formatage de votre CSV

Chaque colonne de votre CSV devient une variable (colonne) dans le data frame. Chaque ligne est une entrée. Si votre première ligne contient des noms de colonnes, activez Use first row as header lors de l'importation.

Pour les stimuli basés sur des fichiers (images, audio), mettez les noms de fichiers dans la colonne pertinente. Vous pouvez ensuite utiliser Map strings to files lors de l'importation pour lier ces noms aux fichiers téléchargés dans votre étude.

Création de la variable de data frame

1. Ouvrez votre étude et allez dans l'onglet Variables dans le panneau de gauche, ou ouvrez l'onglet Variables dans l'éditeur de tâche.
2. Cliquez sur + New Variable et définissez le Data Type sur Data Frame.
3. Cliquez sur Save. La boîte de dialogue Data Frame s'ouvre.

Téléchargement de votre CSV

Dans la boîte de dialogue Data Frame, cliquez sur Upload 2D CSV Data. Un sélecteur de fichiers s'ouvre. Après avoir sélectionné votre fichier, la boîte de dialogue Options d'importation apparaît.

Cliquez sur Ok pour importer. Le data frame est peuplé avec le contenu de votre CSV.

Modification d'un data frame

Une fois qu'un data frame est créé, vous pouvez l'étendre avec de nouvelles colonnes, modifier directement les valeurs des cellules individuelles, ou remplacer tout le contenu par un nouveau téléchargement de CSV.

Ajout de colonnes

Pour ajouter une nouvelle colonne après l'importation initiale, cliquez sur Add variable / Column en haut de la boîte de dialogue Data Frame. Cela ajoute une colonne vide que vous pouvez nommer et configurer. Si la nouvelle colonne contient des noms de fichiers, cliquez sur Map all strings to files dans la boîte de dialogue par la suite pour les lier aux fichiers téléchargés dans votre étude.

Modification des valeurs de cellules

Pour modifier directement les valeurs de cellules individuelles, activez la case Edit Values dans la boîte de dialogue Data Frame. Les cellules deviennent modifiables sur place. Désactivez la case pour revenir à la vue en lecture seule.

Utilisation des data frames dans le système d'événements

Les data frames sont lus et écrits via le système d'événements. Deux actions dans la catégorie Opérations sur Data Frame gèrent cela.

Action Lire depuis / Écrire dans le Data Frame

Utilisez cette action pour lire une ligne ou une colonne depuis le data frame dans une variable de tableau, ou pour écrire des valeurs en retour.

Paramètres clés :

Le schéma le plus courant est : maintenez une variable compteur numérique qui s'incrémente à chaque essai, utilisez-la comme variable d'index, et lisez la ligne correspondante dans un tableau. Chaque élément du tableau correspond alors à une colonne de cette ligne.

Action Mélanger les entrées du Data Frame

Utilisez cette action pour randomiser l'ordre des lignes ou des colonnes dans le data frame. Exécutez-la une fois au début de l'expérience (déclenchée par un événement de début de session) avant que les essais ne commencent.

Paramètres :

Un flux de travail courant : liste de stimuli par essai

Un paramétrage typique pour lire une ligne de stimuli par essai :

1. Téléchargez un CSV avec une ligne par essai et des colonnes pour chaque attribut de stimulus (par exemple, word, condition, correct_response).
2. Créez une variable numérique trial_index avec une valeur de départ de 0 et Reset at Trial Start désactivée.
3. Au début de l'expérience, ajoutez une action Shuffle Data Frame Entries sur votre data frame (par lignes).
4. Au début de chaque essai, ajoutez une action Read from / Write to Data Frame : lire par ligne, Variable d'index = trial_index, Variable de sortie = une variable de tableau (par exemple, current_trial_data).
5. Après lecture, incrémentez trial_index de 1 en utilisant une action arithmétique Set / Record Variable.
6. Utilisez les éléments de la variable de tableau pour définir les propriétés d'objet ou conduire la logique d'événement pour cet essai.

Lectures complémentaires