Variables

Description

Les variables peuvent être utilisées à différentes fins dans le processus de création d'expériences sur Labvanced. Les variables retiennent et mettent à jour des valeurs qui sont créées soit dans l'éditeur par l'expérimentateur, soit durant l'exécution de l'expérience par différents moyens. Il est important de noter que toutes les variables dans une étude sont définies et peuvent être utilisées globalement tout au long de l'expérience. Il y a un onglet "Variables" dans le panneau de navigation principal, où toutes les variables d'une étude sont listées.

Dans l'éditeur de tâches, les variables utilisées sur la frame actuellement sélectionnée sont listées sous l'onglet "Variables" dans le coin supérieur droit de l'écran. Ici, chaque variable est montrée avec ses propriétés les plus importantes : la catégorie principale, le type de données et le nom. Les variables peuvent être copiées, supprimées et sélectionnées pour inspecter et changer d'autres propriétés. Dans l'éditeur de tâches Labvanced, et notamment dans le système d'événements, il y a plusieurs endroits où une variable doit être sélectionnée afin d'atteindre une fonction souhaitée. Lorsque vous êtes invité à sélectionner une variable, vous pouvez généralement sélectionner une existante, mais vous pouvez aussi créer une nouvelle variable à ce moment-là. Vous pouvez également créer une nouvelle variable indépendamment de sa sélection / utilisation. Cela peut être fait en cliquant sur l'icône "Nouvelle Variable" dans l'onglet des variables.

Un changement apporté à une variable peut déclencher un événement, mais l'inverse est également vrai : des événements peuvent changer la valeur d'une variable. De plus, les variables peuvent changer directement l'état de certains objets. Les variables sont regroupées en 5 catégories principales : Variables Système, Variables Facteur, Variables Objet, Variables Personnalisées et Variables Non Utilisées.

Propriétés de la Variable

Pour chaque variable, les utilisateurs peuvent déterminer différentes propriétés et fournir une courte description textuelle qui résume à quoi la variable est utilisée. Les propriétés "nom" et "type de données" sont obligatoires, tandis que les autres propriétés sont optionnelles ou ne peuvent pas être modifiées en fonction du type de données. Voici une liste de toutes les propriétés, leurs valeurs et descriptions.

Nom

• Description : Le nom est utilisé comme identifiant pour la variable dans les événements, objets, lors de la copie des tâches, et plus tard aussi dans la vue des données. Le nom DOIT ÊTRE UNIQUE (il ne peut pas y avoir 2 variables avec le même nom). Sinon, des erreurs graves peuvent se produire ! La propriété nom peut être modifiée dans toutes les variables sauf les Variables Système.
• Valeurs Possibles : Toute chaîne ASCII.

Type de Données

• Description : Le type de données d'une variable détermine quel type de valeurs la variable peut avoir. Le type de données détermine également quels types d'opérations mathématiques peuvent être appliquées à une variable (la multiplication ne fonctionne qu'avec les variables numériques, etc.).
• Valeurs Possibles :
  • Chaîne : Tout texte peut être stocké dans la variable, y compris les nombres, caractères spéciaux, etc.
  • Numérique : Seules les valeurs numériques peuvent être stockées dans la variable.
  • Booléen : La variable peut seulement avoir les valeurs "vrai" ou "faux".
  • Catégorique : La variable a un ensemble de niveaux prédéfinis fixes et l'un des niveaux doit être la valeur de la variable. Cela est principalement utilisé pour les variables facteur.
  • Date : La variable ne peut contenir que des valeurs de date au format (aaaa/mm/jj).
  • Heure : La variable ne peut contenir que des valeurs d'heure au format (heures/minutes/secondes).
  • Fichier : La variable peut contenir des données de fichiers d'images, vidéos ou fichiers audio.

Échelle

• Description : L'échelle d'une variable détermine le "niveau de mesure" de la variable. Cette distinction est utile pour les variables avec un type de données numérique et définit la relation des valeurs de la variable. La propriété peut avoir d'autres utilisations dans une future extension de Labvanced, telle qu'un module d'analyse.
• Valeurs Possibles :
  • Indéfinie : Aucune sélection
  • Nominale : Valeur à Échelle Nominale (catégories).
  • Ordinale : Valeur à Échelle Ordinale (rangs).
  • Intervalle : Valeur à Échelle d'Intervalle (échelle sans point zéro vrai, ex : température).
  • Ratio : Valeur à Échelle de Ratio (échelle avec un point zéro vrai, ex : poids).

Format

• Description : Le format d'une variable détermine si la variable est une valeur unique (scalaire) ou un tableau de valeurs. Certaines opérations / actions ne peuvent être appliquées qu'aux tableaux et d'autres seulement aux variables scalaires.
• Valeurs Possibles :
  • Scalaire : La variable est une valeur unique.
  • Tableau : La variable contient une série de valeurs.
  • Cadre de Données : Il y a plusieurs variables intégrées dans un fichier CSV. Choisir Cadre de Données ouvre une boîte de dialogue pour spécifier les données CSV, où chaque colonne est une variable. Les utilisateurs peuvent choisir entre chaîne, numérique, booléen ou fichier comme type de variable.

Valeur de Départ

• Description : La valeur de départ d'une variable détermine la valeur par défaut / de réinitialisation de la variable. La valeur de départ peut être utilisée pour réinitialiser la valeur d'une variable au début de chaque essai à une certaine valeur. La valeur de départ peut également être utilisée pour stocker définitivement des informations dans une variable (ex : texte, image, vidéo ou données audio).
• Valeurs Possibles : Dépend du type de données. Utilisez l'icône de réinitialisation pour supprimer la valeur de départ.
  • Variables avec format de données "tableau" : Pour les variables "tableau", il est possible de définir non seulement une valeur de départ, mais de remplir un tableau complet avec des valeurs. Par exemple, l'utilisateur peut importer une liste de mots (fichier CSV), des images, des vidéos, des fichiers audio, etc. dans une variable tableau. La position des éléments / entrées dans le tableau peut également être ajustée.

Réinitialiser au Début de l'Essai

• Description : L'option "réinitialiser au début de l'essai" détermine si la variable sera réinitialisée à la valeur de départ pour chaque nouvel essai ou non. En général, cette option devrait être activée pour les variables qui enregistrent la réponse ou le temps de réaction d'un participant. Cependant, les variables qui accumulent des données au fil des essais (pour des retours d'informations ou d'autres motifs) ou les tableaux de données stockant des informations de manière persistante ne devraient pas être réinitialisées.
• Valeurs Possibles : Si activée (vrai), la variable sera réinitialisée à la valeur de départ. Si désactivée (faux), la variable ne sera pas réinitialisée.

Variable d'Enregistrement

• Description : L'option de variable d'enregistrement détermine si la variable sera enregistrée ou non. Toutes les variables où cette option est activée seront enregistrées à la fin de chaque essai.
• Valeurs Possibles : Si activée (vrai), la variable sera enregistrée. Si désactivée (faux), la variable ne sera pas enregistrée.

Type d'Enregistrement

• Description : Le type d'enregistrement d'une variable détermine si tous les changements de valeur d'une variable pendant un essai seront enregistrés, ou seulement la valeur finale de la variable dans chaque essai. Si tous les changements sont enregistrés, chaque changement de variable sera sauvegardé avec un timestamp. Cette option peut être utilisée pour enregistrer une série temporelle de données (ex : pour le suivi de souris ou d'yeux).
• Valeurs Possibles :
  • Tous les changements / série temporelle : Enregistre tous les changements d'une variable y compris les timestamps.
  • Valeur finale seulement : Enregistre seulement la dernière valeur d'une variable à la fin de l'essai.

Variables Système

Les variables système sont importantes pour l'exécution de l'expérience et l'exportation des données. Elles sont créées automatiquement et ne peuvent pas être modifiées ou supprimées. Les variables système sont également très utiles dans les exigences (ex : actions If-Else). Par exemple, elles peuvent être utilisées pour faire référence à un numéro d'essai spécifique, utiliser un compteur de sujets, ou séparer les événements pour des études multi-utilisateurs entre participants. Toutes les variables système sont affichées dans le menu principal des variables sur la plateforme Labvanced. En savoir plus sur les variables système ici.

Variables Facteur

Les variables facteur sont celles qui sont liées à un facteur dans le système d'essai. Chaque facteur a une variable liée avec un type de données catégorique. Les niveaux du facteur sont également des états de valeur possibles de la variable. Lors de la création d'un nouveau facteur, les utilisateurs peuvent choisir de créer une nouvelle variable (automatiquement) ou de réutiliser une variable existante. Lors de la liaison de variables facteur, il convient de noter que des changements aux niveaux de la variable / facteur modifieront la structure des essais dans toutes les tâches / groupes d'essai liés. Les variables facteur peuvent être utilisées dans le système d'événements, par exemple pour créer des événements qui ne sont exécutés que dans certaines conditions (ex : faire quelque chose uniquement si le facteur "catégorie d'image" est égal à "maison"). De plus, à chaque essai pendant l'exécution de l'expérience, chaque variable facteur aura toujours une nouvelle valeur de niveau stockée dans la vue des données. Ainsi, il est plus facile de reconstruire la condition de chaque essai enregistré lors de la visualisation de la sortie des données ou de la répétition de la procédure.

Variables Objet

Les variables objet sont créées automatiquement lorsqu'un objet est ajouté à l'image. La plupart de ces variables proviennent de l'ajout "d'éléments de questionnaire", comme les cases à cocher, échelles de Likert, listes déroulantes, etc. Lors de la création d'un tel objet, vous serez invité à entrer un nom pour la variable associée. Après avoir entré un nom valide (unique !), la variable sera créée automatiquement. Dans la vue des propriétés de l'objet, vous verrez la référence à la variable associée sous "variable liée". Ici, vous pouvez également changer le lien / l'association avec une autre variable. Cependant, nous suggérons d'utiliser cette option avec précaution. Lors de l'exécution de l'expérience, la réponse du participant sera stockée dans la variable. Les variables objet seront enregistrées par défaut et la plupart des propriétés des variables objet ne peuvent pas être modifiées pour garantir leur fonctionnalité.

Variables Personnalisées

Les variables personnalisées sont activement créées par l'utilisateur. Les raisons de créer des variables personnalisées peuvent être très diverses. Elles peuvent être utilisées pour enregistrer les décisions des participants (clics de souris ou frappes au clavier) ou les temps de réaction. Elles peuvent également être utilisées comme compteurs ou indices dans des boucles while ou actions de tableau, pour stocker des données de fichiers (image, vidéo, audio), et pour de nombreuses autres fins.

Lorsqu'une variable est créée sans être utilisée, ou lorsque son utilisation (objet ou événement) est supprimée, la variable sera listée comme non utilisée.

Variables de Tableau

Les tableaux sont très différents des variables scalaires discutées ci-dessus. Pensez à un tableau comme à une colonne dans une feuille de calcul : il contient des entrées dans un ordre spécifié. Lors de la création d'un tableau, vous pouvez cliquer sur le dossier à côté de "Utiliser fichier CSV" pour télécharger un fichier .csv avec une colonne d'informations, ou vous pouvez ajouter manuellement des entrées en utilisant l'icône plus.

Pour une liste des actions associées aux tableaux, voir Actions de Tableau

Variables de Cadre de Données

Les cadres de données sont différents des tableaux en ce sens que si un tableau est une colonne d'une feuille de calcul, un cadre de données est une feuille de calcul entière avec plusieurs colonnes. Les cadres de données peuvent contenir des valeurs de chaîne (texte), numériques, booléennes ou de fichiers, mais ne peuvent pas être directement modifiés dans la fenêtre de dialogue de cadre de données. Vous pouvez ajouter des colonnes et des fichiers, mais ne pouvez pas taper de texte ou de nombres :

Pour ajouter un nouveau cadre de données, cliquez sur Télécharger des Données CSV 2D. Lors de l'ajout d'informations à votre cadre de données, seuls les fichiers .csv sont acceptés. Après avoir choisi votre fichier, plusieurs options d'importation apparaîtront :

Choisissez toutes les options applicables :

• Mapper les chaînes aux fichiers vous permet d'inclure les noms de vos fichiers sous forme de chaînes, puis d'utiliser la fonction de mappage pour pointer vers le dossier où les fichiers sont stockés. Cela permettra à cette colonne de noms de fichiers de rechercher les fichiers correspondants dans un dossier, à condition que les valeurs dans le cadre de données correspondent exactement aux noms des fichiers souhaités. Cette fonction n'est disponible que si la colonne est peuplée par des valeurs de chaîne.
• Utiliser la première ligne comme en-tête prend les valeurs de la première ligne de votre cadre de données et les utilise comme noms de variables pour chacune des colonnes.
• Transposer les Données télécharge simplement le cadre de données tel quel. Cela est utile si votre cadre de données ne contient aucun nom de fichier.

Si votre cadre de données est entièrement composé de valeurs de chaîne qui correspondent aux noms des fichiers dans un dossier, vous pouvez mapper l'ensemble du cadre de données à un dossier en utilisant la fonction mapper toutes les chaînes aux fichiers.

Pour ajouter plus d'informations à un cadre de données existant, choisissez l'option Ajouter une variable/colonne en haut de la boîte de dialogue de Cadre de Données.

Pour une liste des actions associées aux cadres de données, voir Opérations de Cadre de Données

Références de Variables et Suppression de Variables

Pour fournir une meilleure vue d'ensemble de l'endroit où chaque variable est utilisée, il existe une liste appelée UTILISÉ DANS en bas du panneau de propriétés de la variable. Ici, toutes les utilisations de la variable sont listées, y compris une référence à la frame sur laquelle la variable est utilisée (nom), à quelle fin (Utilisé comme), et si l'utilisation est une opération de lecture (R), une opération d'écriture (W), ou les deux (RW). Pour chaque frame où une variable est utilisée, il y aura une entrée supplémentaire dans le tableau d'utilisation avec un "type d'utilisation" nommé "espace de travail local". Toutes les variables dans l'espace de travail local d'une frame seront alors affichées sous la section "variables locales" dans le menu de sélection des variables.

Lorsque vous souhaitez supprimer une variable, cela doit être fait avec une attention particulière. La suppression de variables qui sont encore utilisées comme facteurs, objets, ou utilisées dans des événements peut entraîner des problèmes graves et (dans le pire des cas) peut perturber la structure entière de l'expérience. Ainsi, dans l'onglet des variables, seules les variables qui n'ont pas d'utilisation référencée en plus d'être dans un (ou plusieurs) espaces de travail local peuvent être supprimées. Les variables qui ne sont définies que dans l'espace de travail local (sans autre utilisation) sont listées comme non utilisées et une icône de suppression est affichée à côté d'elles.

Menu de Sélection de Variables

L'utilisation contrôlée par l'utilisateur des variables est principalement basée sur la logique des événements. Dans le système d'événements, il y a 3 menus (visuellement) différents qui vous permettront de sélectionner une variable : le "Menu de Sélection de Valeurs", le "Bouton de Sélection Vert", et le "Menu de Références de Variables." Bien que ces menus soient visuellement différents, ils ouvrent tous le même menu (le Menu de Sélection de Variables) pour sélectionner une variable.

En tout, le Menu de Sélection de Variables contient trois onglets différents : "Variables Locales", "Toutes les Variables" et "Nouvelle Variable." Sous "Variables Locales," vous pouvez voir et sélectionner toutes les variables qui sont définies dans l'espace de travail local de la frame (déjà utilisées sur la frame). Sous "Toutes les Variables," toutes les variables de la liste globale de l'étude sont listées et peuvent être sélectionnées. Chacun de ces deux menus dispose d'une fonction de recherche pour trouver directement une variable souhaitée. L'onglet "Nouvelle Variable" peut être utilisé pour créer (et donc sélectionner) une nouvelle variable.

Enregistrement des Données

Pour chaque variable, les utilisateurs peuvent utiliser une case à cocher pour décider si la valeur de la variable sera enregistrée ou non. Pour les variables système, les variables facteur et les variables objet, les enregistrements sont activés par défaut. Ainsi, de nombreuses parties des enregistrements de données fonctionneront automatiquement. Lorsque vous souhaitez enregistrer une certaine propriété d'objet, une réponse du participant, ou autre chose qui n'est pas enregistrée par défaut, vous devez utiliser le système d'événements pour définir la valeur de la variable de manière appropriée. Voici un court exemple de logique d'événement pour enregistrer le temps de réaction :

1. Ajoutez une image à la frame.
2. Créez un nouvel événement et donnez-lui un nom.
3. Définissez le déclencheur qui détermine quand la valeur de la variable doit être définie. Par exemple, Sélectionner --> Entrée Utilisateur --> Déclencheur de Souris. Définissez l'action de déclenchement comme Clic et le Bouton comme Gauche. Cliquez sur le signe + à côté de Ajouter Cibles pour ajouter l'image comme cible cliquable. Cliquez sur Suivant en bas de la fenêtre.
4. Sélectionnez l'action Actions de Variables --> Définir / Enregistrer Variable. Cliquez ensuite sur le bouton "Sélectionner".
5. Cliquez sur l'icône de Sélection de Valeur (stylo) --> Déclencheur(Souris) --> Temps Depuis le Début de la Frame. Cliquez sur Terminer.

Maintenant, vous avez enregistré le temps de réaction pour un clic sur une image. Vous pouvez utiliser une procédure similaire pour enregistrer d'autres propriétés comme la décision (quelle image a été cliquée parmi une variété), etc.