Variables

Description

Les variables peuvent être utilisées à différentes fins lors du processus de création d'expérience sur Labvanced. Les variables retiennent et mettent à jour des valeurs qui sont créées soit dans l'éditeur par l'expérimentateur, soit pendant l'exécution de l'expérience par différents moyens. Il existe plusieurs types de variables, notamment : variables système, variables de facteur, variables d'objet et variables personnalisées.

Comprendre comment les variables peuvent être utilisées est essentiel pour construire une expérience dans Labvanced. Les variables ont de nombreuses fonctionnalités, y compris :

1. Stocker / lire des données : Les données enregistrées, telles que les réponses des participants et les temps de réaction, sont stockées dans des variables.
2. Créer des données : Certains scénarios peuvent nécessiter de créer des variables sur place, comme l'ajout de scores ou la concaténation de chaînes en une plus longue.
3. Contrôler le flux de l'expérience : L'appel aux variables peut être utilisé pour contrôler le flux de l'expérience. Par exemple, si une variable de score est inférieure à un certain seuil, passez à une tâche spécifique.

Il est important de noter que toutes les variables d'une étude sont définies et peuvent être utilisées globalement tout au long de l'expérience. Pour voir toutes les variables qui ont été créées, vous pouvez aller à l'onglet Variables dans le panneau de navigation à gauche pour une étude particulière et toutes les variables d'une étude y seront répertoriées.

Découvrez cette vidéo d'environ 5 minutes présentant les variables et leur fonctionnement :

Localiser les Variables dans l'Éditeur de Tâches

Dans l'éditeur de tâches, les variables utilisées sur le cadre actuellement sélectionné sont répertorié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 modifier d'autres propriétés.

Création de Variables

Dans l'éditeur de tâches Labvanced, et en particulier dans le Système d'Événements, il existe plusieurs endroits où une variable doit être sélectionnée afin d'obtenir une fonction souhaitée.

Les variables peuvent être créées via :

1. L'Éditeur de Tâches :
   • Panneau des Variables : Comme montré dans l'image ci-dessus, le panneau en haut à gauche de l'éditeur contient un onglet Variable qui peut être accessible et offre plusieurs fonctionnalités, y compris la création d'une nouvelle variable.
   • Ajout de Certains Objets : Ajouter certains objets à l'éditeur, tels que l'Objet d'Entrée ou des objets liés à des questionnaires, vous incitera automatiquement à créer une variable afin que ces réponses puissent être stockées.
2. Le Système d'Événements : Créer des variables dans le Système d'Événements (pour enregistrer des données dynamiques et contrôler le comportement de l'expérience) est un concept essentiel à comprendre... et cela est exploré en détail dans la section suivante !

Variables et Événements

Un changement apporté à une variable peut déclencher un événement, mais l'inverse est également vrai : les événements peuvent changer la valeur d'une variable. De plus, les variables peuvent directement changer l'état de certains objets...

Par exemple, si la valeur d'une variable est égale à X, alors affichez l'image Y. Les variables et les événements peuvent également être utilisés pour contrôler le progrès de l'expérience. Par exemple, si un participant obtient un score de X (qui est une valeur de variable) dans la tâche A, alors passez à la tâche B, sinon passez à la tâche C.

Créer et Utiliser des Variables dans le Système d'Événements

L'utilisation contrôlée par l'utilisateur des variables repose principalement sur la logique d'événements. Dans le système d'événements, il existe deux menus principaux qui vous permettront de sélectionner/appeler/créer une variable, à savoir :

1. "Menu de Sélection de Valeur"
2. Bouton vert "Sélectionner"

Bien que ces menus soient visuellement différents, ils ouvrent le même menu (le Menu de Sélection de Variables) pour sélectionner ou créer une variable.

Menu de Sélection de Variables

Dans l'ensemble, 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 du cadre (déjà utilisées dans le cadre). Sous "Toutes les Variables," toutes les variables de la liste globale de l'étude sont répertoriées et peuvent être sélectionnées. Chacun de ces 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, par conséquent, 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 de facteur et les variables d'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.

Exemple : Enregistrer le Temps de Réaction et le Stocker dans une Variable

Voici un court exemple de logique d'événements pour enregistrer le temps de réaction :

1. Ajoutez une image au cadre.
2. Créez un nouvel Événement et nommez-le.
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 sur Clic et le Bouton sur Gauche. Cliquez sur le signe + à côté de Ajouter Cibles pour ajouter l'image comme cible cliquable. Cliquez sur Suivant au bas de la fenêtre.
4. Sélectionnez l'action Actions de Variables --> Définir / Enregistrer la Variable. Cliquez ensuite sur le bouton "Sélectionner".
5. Cliquez sur l'onglet "Nouvelle Variable" et créez une nouvelle variable en lui donnant un nom (type de données : numérique, réinitialiser = vrai, enregistrer = vrai). Cliquez sur "Ok."
6. Cliquez sur l'icône de Sélection de Valeur (stylo) --> Déclencheur (Souris) --> Temps Depuis le Début du Cadre. Cliquez sur Terminer.

Vous avez maintenant 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.

Propriétés de la Variable

Pour chaque variable, vous pouvez spécifier 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 (le Type de Format est également important à spécifier dans le cas de tableaux et cadres de données), tandis que les autres propriétés sont facultatives ou ne peuvent pas être modifiées selon le type de données.

Voici une liste de toutes les propriétés, de leurs valeurs et descriptions :

Nom

• Description : Le nom est utilisé comme identifiant pour la variable dans les événements, objets, lors de la copie de tâches, et plus tard également 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é du nom peut être modifiée dans toutes les variables sauf les Variables Système.
• Valeurs Possibles : Toute chaîne ASCII. Ne pas utiliser de points (.).

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 quel type d'opérations mathématiques peuvent être appliquées à une variable (la multiplication ne fonctionne qu'avec des variables numériques, etc.).
• Valeurs Possibles :
  • Chaîne : Tout texte peut être stocké dans la variable, y compris les chiffres, caractères spéciaux, etc.
  • Numérique : Seules les valeurs numériques peuvent être stockées dans la variable.
  • Booléen : La variable peut uniquement 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. Ceci est principalement utilisé pour les variables de facteur.
  • Date : La variable ne peut contenir que des valeurs de date au format (aaaa/mm/jj).
  • Temps : La variable ne peut contenir que des valeurs de temps 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 plus d'utilisations dans une future extension de Labvanced, comme un module d'analyse.
• Valeurs Possibles :
  • Indéfini : Aucune sélection
  • Nominal : Valeur à Échelle Nominale (catégories).
  • Ordinale : Valeur à Échelle Ordinale (rangs).
  • Intervalle : Valeur à Échelle d’Intervalle (échelle sans un véritable point zéro, ex. température).
  • Ratio : Valeur à Échelle de Ratio (échelle avec un véritable point zéro, 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 peuvent uniquement être appliquées aux tableaux et d'autres uniquement aux variables scalaires.
• Valeurs Possibles :
  • Scalaire : La variable est une valeur unique.
  • Tableau : La variable contient une gamme de valeurs.
  • Cadre de Données : Il y a plusieurs variables imbriqué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 de manière permanente des informations dans une variable (ex. texte, image, données vidéo ou 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 le format de données "tableau" : Pour les variables "tableau", il est possible non seulement de définir une seule valeur de départ, mais de remplir un tableau complet avec des valeurs. Par exemple, l'utilisateur peut télécharger une liste de mots (fichier CSV), d'images, de vidéos, de fichiers audio, etc. dans une variable de 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 doit être activée pour les variables qui enregistrent une réponse ou un temps de réaction du participant. Cependant, les variables qui accumulent des données au fil des essais (pour un retour d'information ou d'autres fins) ou des tableaux de données stockant des informations de manière persistante ne devraient pas être réinitialisées.
• Valeurs Possibles : Si cochée (vrai), la variable sera réinitialisée à la valeur de départ. Si non cochée (faux), la variable ne sera pas réinitialisée.

Enregistrer la Variable

• Description : L'option d'enregistrement de la variable 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 cochée (vrai), la variable sera enregistrée. Si non coché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 à chaque essai. Si tous les changements sont enregistrés, chaque changement de variable sera sauvegardé avec un horodatage. Cette option peut être utilisée pour enregistrer une série temporelle de données (ex. pour le suivi de la souris ou des yeux).
• Valeurs Possibles :
  • Tous les changements / série temporelle : Enregistre tous les changements d'une variable, y compris les horodatages.
  • Valeur finale seulement : Enregistre uniquement la dernière valeur d'une variable à la fin de l'essai.

Types de Variables

Variables Système

Les variables système sont importantes pour l'exécution de l'expérience et l'exportation de 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 Si-Alors). Par exemple, elles peuvent être utilisées pour se référer à un numéro d'essai spécifique, utiliser un compteur de sujet, ou séparer les événements pour des études multi-utilisateurs entre les 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 de Facteur

Les variables de 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 des variables de facteur, il convient de noter que les changements apportés aux niveaux de variable/facteur changeront la structure d'essai dans toutes les tâches / groupes d'essais liés. Les variables de facteur peuvent être utilisées dans le système d'événements, par exemple pour créer des événements qui sont exécutés uniquement 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 de facteur aura toujours une nouvelle valeur de niveau stockée dans la vue des données. De cette manière, 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 d'Objet

Les variables d'objet sont créées automatiquement lorsqu'un objet est ajouté au cadre. La plupart de ces variables proviennent de l'ajout d'"éléments de questionnaire", comme des cases à cocher, des échelles de Likert, des menus déroulants, 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 / association vers 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 d'objet seront enregistrées par défaut et la plupart des propriétés des variables d'objet ne peuvent pas être modifiées pour garantir leur fonctionnalité.

Variables Personnalisées

Les variables personnalisées sont créées activement 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 des actions de tableau, pour stocker des données de fichiers (image, vidéo, audio), et pour bien d'autres raisons.

Lorsqu'une variable est créée sans être utilisée, ou lorsque son utilisation (objet ou événement) est supprimée, la variable sera répertoriée comme inutilisé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 un 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 d'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, car 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 édités directement dans la fenêtre de dialogue du cadre de données. Vous pouvez ajouter des colonnes et des fichiers, mais ne pouvez pas taper du texte ou des chiffres :

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 celles qui s'appliquent :

• Mapper les Chaînes aux Fichiers vous permet d'inclure les noms de vos fichiers en tant que 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 du 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 qu'il est. 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 correspondant aux noms de fichiers dans un dossier, vous pouvez mapper l'ensemble du cadre de données vers 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 Cadre de Données.

Pour une liste d'actions associées aux cadres de données, voir Opérations sur les Cadres 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 au bas du panneau des propriétés de la variable. Ici, toutes les utilisations de la variable sont répertoriées, y compris une référence au cadre sur lequel 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 cadre 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'un cadre seront alors affichées dans la section "variables locales" dans le menu de sélection de variables.

Lorsque vous souhaitez supprimer une variable, cela doit être fait avec une attention particulière. Supprimer des 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 toute la structure de l'expérience. Ainsi, dans l'onglet des variables, seules les variables qui n'ont aucune utilisation référencée autre que d'être dans un (ou plusieurs) espaces de travail locaux peuvent être supprimées. Les variables qui ne sont définies que dans l'espace de travail local (sans autre utilisation) sont répertoriées comme inutilisées et une icône de suppression est affichée à côté d'elles.