Variables

Qu'est-ce qu'une variable expérimentale dans OpenSesame ?

Les variables expérimentales dans OpenSesame sont celles qui :

• Peuvent être mentionnées dans l'interface utilisateur avec la syntaxe '{variable_name}'.
• Sont disponibles en tant que variables globales dans un inline_script Python.
• Sont disponibles en tant que variables globales dans un inline_javascript JavaScript.
• Contiennent des éléments tels que :
  • Les variables que vous avez définies dans un élément loop.
  • Les réponses que vous avez collectées.
  • Diverses propriétés de l'expérience.
  • Etc.

L'inspecteur de variables

L'inspecteur de variables (Ctrl+I) fournit un aperçu des variables disponibles (Figure 1). Lorsque l'expérience n'est pas en cours, cet aperçu est basé sur une meilleure estimation des variables qui deviendront disponibles au cours de l'expérience. Cependant, lorsque l'expérience est en cours, l'inspecteur de variables montre un aperçu en direct des variables et de leurs valeurs. Ceci est utile pour déboguer votre expérience.

Figure 1. L'inspecteur de variables fournit un aperçu de toutes les variables qu'OpenSesame connaît.

Définition des variables

La façon la plus simple de définir une variable est via l'élément loop. Par exemple, Figure 2 montre comment définir une variable nommée gaze_cue. Dans cet exemple, l'élément trial_sequence est appelé quatre fois alors que gaze_cue est 'left' et quatre autres fois alors que 'gaze_cue' est 'right'.

Figure 2. La façon la plus courante de définir des variables indépendantes est en utilisant la table loop.

Variables intégrées

Les variables suivantes sont toujours disponibles :

Variables d'expérience

Variables des éléments

Il existe également des variables qui suivent tous les éléments de l'expérience.

Variables de réponse

Lorsque vous utilisez les éléments de réponse standard, tels que keyboard_response et mouse_response, un certain nombre de variables sont définies en fonction de la réponse du participant.

Variables de feedback

Les variables de feedback maintiennent une moyenne mobile de la précision et des temps de réponse.

Utilisation des variables dans l'interface utilisateur

Partout où vous voyez une valeur dans l'interface utilisateur, vous pouvez remplacer cette valeur par une variable en utilisant la notation '{variable name}'. Par exemple, si vous avez défini une variable soa dans un élément loop, vous pouvez utiliser cette variable pour la durée d'un sketchpad comme indiqué dans Figure 3.

Figure 3.

Cela fonctionne dans toute l'interface utilisateur. Par exemple, si vous avez défini une variable my_freq, vous pouvez utiliser cette variable comme fréquence dans un élément synth, comme le montre Figure 4.

Figure 4.

Parfois, l'interface utilisateur ne vous permet pas de taper du texte arbitraire. Par exemple, les éléments d'un sketchpad sont affichés visuellement et vous ne pouvez pas changer directement une coordonnée X en une variable. Cependant, vous pouvez cliquer sur le bouton Select view → View script en haut à droite et modifier directement le script.

Par exemple, vous pouvez changer la position d'un point de fixation du centre :

draw fixdot x=0 y=0

... vers une position définie par les variables xpos et ypos :

draw fixdot x={xpos} y={ypos}

Utilisation des expressions Python dans l'interface utilisateur

Lorsque vous faites référence aux variables en utilisant la notation {my_var}, vous utilisez en fait ce qu'on appelle une f-string, qui est un moyen d'intégrer du code Python dans des chaînes de texte. Vous pouvez également utiliser des f-strings pour évaluer du code Python arbitraire. Par exemple, vous pouvez multiplier les variables width et height et inclure le résultat dans un sketchpad, comme suit :

Figure 5.

Les f-strings sont du code Python et ne sont donc pris en charge que sur le bureau, mais voir ci-dessous pour une alternative JavaScript pour les expériences sur navigateur.

Utilisation des expressions JavaScript dans l'interface utilisateur

Lors de l'utilisation d'OSWeb, les expressions incluses entre accolades sont interprétées comme des modèles littéraux. Cela ressemble beaucoup aux f-strings en Python, avec la différence importante qu'il utilise JavaScript.

Dans le JavaScript normal, les expressions à l'intérieur des littéraux de modèle sont précédées d'un $, comme ceci : ${expression}. Ceci est autorisé dans OpenSesame, mais pas nécessaire : le préfixe est ajouté automatiquement pour améliorer la compatibilité entre les expériences de bureau et de navigateur. Dans la plupart des cas, comme sur la figure ci-dessous, la même expression exacte est valable sous forme de chaîne f en Python sur le bureau et de littéral de modèle en JavaScript dans le navigateur.

Figure 6. Vous pouvez intégrer des expressions JavaScript en utilisant des littéraux de modèle.

Utilisation de variables en Python

Dans un inline_script, les variables expérimentales sont disponibles en tant que variables globales. Par exemple, si vous avez défini exemple_variable dans une loop, alors le code suivant affichera la valeur exemple_variable dans la fenêtre de débogage :

print(example_variable)

Vous pouvez définir la variable expérimentale exemple_variable à la valeur 'some value' comme suit :

exemple_variable = 'some value'

Utilisation de variables en JavaScript

Dans un inline_javascript, les variables expérimentales sont disponibles en tant que variables globales. Par exemple, si vous avez défini exemple_variable dans une loop, alors le code suivant affichera la valeur exemple_variable dans la console du navigateur :

console.log(example_variable)

Vous pouvez définir la variable expérimentale exemple_variable à la valeur 'some value' comme suit :

exemple_variable = 'some value'

Utilisation des instructions conditionnelles ("if")

Les instructions conditionnelles, ou 'instructions if', permettent d'indiquer que quelque chose doit se produire uniquement dans des circonstances spécifiques, par exemple lorsqu'une variable a une valeur spécifique. Les instructions conditionnelles sont des expressions Python régulières.

L'instruction if la plus couramment utilisée dans OpenSesame est l'instruction run-if de la sequence, qui vous permet de spécifier les conditions dans lesquelles un élément particulier est exécuté. Si vous ouvrez un élément de sequence, vous pouvez voir que chaque élément de la séquence a une option 'Run if …'. La valeur par défaut est 'always', ce qui signifie que l'élément est toujours exécuté ; mais vous pouvez également entrer une condition ici. Par exemple, si vous voulez montrer un point de fixation vert après une réponse correcte et un point de fixation rouge après une réponse incorrecte, vous pouvez créer une sequence comme suit (cela suppose qu'un élément keyboard_response ajuste automatiquement la variable correct, comme discuté précédemment) comme indiqué dans Figure 7.

Important : Les instructions Run-if ne s'appliquent qu'à la phase Run des éléments. La phase Prepare est toujours exécutée. Voir également cette page.

Figure 7. 'Run if' peut être utilisé pour indiquer que certains éléments d'une sequence ne doivent être exécutés que dans des circonstances spécifiques.

Vous pouvez utiliser des conditions plus complexes. Voyons quelques exemples :

correct == 1 and response_time > 2000
correct != 1 or response_time > max_response_time or response_time < min_response_time

Le même principe s'applique aux champs 'Show if' dans les items sketchpad. Par exemple, si vous souhaitez dessiner une flèche pointant vers le haut à droite uniquement si la variable quadrant a été définie sur "upper right", il suffit de saisir la condition appropriée dans le champ 'Show if ...' et de dessiner la flèche, comme dans Figure 8. Assurez-vous de dessiner la flèche après avoir défini la condition.

Figure 8. 'Show if' peut être utilisé pour indiquer que certains éléments d'un item sketchpad ou feedback ne doivent être montrés que dans des circonstances spécifiques.

Important : Le moment auquel une instruction conditionnelle est évaluée peut affecter le fonctionnement de votre expérience. Ceci est lié à la stratégie prepare-run utilisée par OpenSesame, qui est expliquée ici :

• https://osdoc.cogsci.nl/4.0/fr/manual/prepare-run