Variablen

Was ist eine experimentelle Variable in OpenSesame?

Experimentelle Variablen in OpenSesame sind solche Variablen, die:

• Im Benutzerinterface mit der '{variable_name}'-Syntax referenziert werden können.
• Als globale Variablen in einem Python inline_script verfügbar sind.
• Als globale Variablen in einem JavaScript inline_javascript verfügbar sind.
• Dinge enthalten wie:
  • Die Variablen, die Sie in einem loop-Element definiert haben.
  • Die gesammelten Antworten.
  • Verschiedene Eigenschaften des Experiments.
  • Usw.

Der Variableninspektor

Der Variableninspektor (Ctrl+I) bietet einen Überblick über verfügbare Variablen (Figure 1). Wenn das Experiment nicht läuft, basiert dieser Überblick auf einer besten Schätzung, welche Variablen während des Experiments verfügbar werden. Wenn das Experiment jedoch läuft, zeigt der Variableninspektor eine Live-Übersicht der Variablen und deren Werte. Dies ist nützlich zur Fehlersuche in Ihrem Experiment.

Figure 1. Der Variableninspektor bietet einen Überblick über alle Variablen, die OpenSesame kennt.

Variablen definieren

Der einfachste Weg, eine Variable zu definieren, ist über das loop-Element. Zum Beispiel zeigt Figure 2, wie man eine Variable namens gaze_cue definiert. In diesem Beispiel wird das trial_sequence-Element viermal aufgerufen, während gaze_cue 'left' ist und eine weitere viermal, während 'gaze_cue' 'right' ist.

Figure 2. Der häufigste Weg, unabhängige Variablen zu definieren, ist die Verwendung der loop-Tabelle.

Integrierte Variablen

Die folgenden Variablen sind immer verfügbar:

Experimentvariablen

Elementvariablen

Es gibt auch Variablen, die alle Elemente des Experiments verfolgen.

Antwortvariablen

Wenn Sie die standardmäßigen Antwortelemente verwenden, wie keyboard_response und mouse_response, werden eine Reihe von Variablen aufgrund der Reaktion des Teilnehmers festgelegt.

Feedback Variablen

Feedback-Variablen führen einen gleitenden Durchschnitt von Genauigkeit und Antwortzeiten.

Verwendung von Variablen in der Benutzeroberfläche

Überall dort, wo Sie in der Benutzeroberfläche einen Wert sehen, können Sie diesen Wert durch eine Variable ersetzen, indem Sie die '{variable_name}'-Notation verwenden. Wenn Sie beispielsweise in einem loop-Element eine Variable soa definiert haben, können Sie diese Variable für die Dauer eines Sketchpad verwenden, wie in Figure 3 gezeigt.

Figure 3. Die Dauer "{soa}" zeigt, dass die Dauer des sketchpad von der Variable soa abhängt.

Dies funktioniert in der gesamten Benutzeroberfläche. Wenn Sie beispielsweise die Variable my_freq definiert haben, können Sie diese Variable als Frequenz in einem synth-Element verwenden, wie in Figure 4 gezeigt.

Figure 4. Die Frequenz "{my_freq}" zeigt, dass die Frequenz des synth von der Variable my_freq abhängt.

Manchmal können Sie in der Benutzeroberfläche keinen beliebigen Text eingeben. Zum Beispiel sind die Elemente eines sketchpad visuell dargestellt, und Sie können eine X-Koordinate nicht direkt in eine Variable ändern. Sie können jedoch auf den Select view → View script-Button oben rechts klicken und das Script direkt bearbeiten.

Zum Beispiel können Sie die Position eines Fixationspunkts von der Mitte ändern:

draw fixdot x=0 y=0

… zu einer Position, die durch die Variablen xpos und ypos definiert wird:

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

Verwendung von Python-Ausdrücken in der Benutzeroberfläche

Wenn Sie auf Variablen mit der {my_var}-Notation verweisen, verwenden Sie tatsächlich einen sogenannten f-String, der eine Möglichkeit ist, Python-Code in Textzeichenketten einzubetten. Sie können f-Strings auch verwenden, um beliebigen Python-Code auszuwerten. Zum Beispiel können Sie die Variablen width und height multiplizieren und das Ergebnis in einem sketchpad einschließen, wie folgt:

Figure 5. Sie können Python-Ausdrücke mit f-Strings einbetten.

f-Strings sind Python-Code und werden daher nur auf dem Desktop unterstützt. Für Browser-Experimente gibt es jedoch eine JavaScript-Alternative.

Verwendung von JavaScript-Ausdrücken in der Benutzeroberfläche

Bei der Verwendung von OSWeb werden Ausdrücke, die zwischen geschweiften Klammern eingeschlossen sind, als Template-Literale interpretiert. Dies ist sehr ähnlich wie f-Strings in Python, mit dem wichtigen Unterschied, dass es JavaScript verwendet.

In normalem JavaScript werden Ausdrücke innerhalb von Template-Literale mit einem $ vorangestellt, so: ${expression}. Dies ist in OpenSesame erlaubt, aber nicht notwendig: Das Präfix wird automatisch hinzugefügt, um die Kompatibilität zwischen Browser- und Desktop-Experimenten zu verbessern. In den meisten Fällen, wie in der Abbildung unten, ist derselbe Ausdruck sowohl als Python f-String auf dem Desktop als auch als JavaScript-Template-Literal im Browser gültig.

Figure 6. Sie können JavaScript-Ausdrücke mit Template-Literalen einbetten.

Verwenden von Variablen in Python

In einem inline_script stehen experimentelle Variablen als globale Variablen zur Verfügung. Wenn Sie zum Beispiel in einer loop die example_variable definiert haben, wird der folgende Code den Wert von example_variable im Debug-Fenster anzeigen:

print(example_variable)

Sie können die experimentelle Variable example_variable wie folgt auf den Wert 'some value' setzen:

example_variable = 'some value'

Verwenden von Variablen in JavaScript

In einem inline_javascript stehen experimentelle Variablen als globale Variablen zur Verfügung. Bei der Definition von example_variable in einer loop wird der folgende Code den Wert von example_variable in der Browser-Konsole anzeigen:

console.log(example_variable)

Sie können die experimentelle Variable example_variable wie folgt auf den Wert 'some value' setzen:

example_variable = 'some value'

Verwenden von bedingten ("if") Anweisungen

Bedingte Anweisungen oder 'if-Anweisungen' bieten eine Möglichkeit, anzugeben, dass etwas nur unter bestimmten Umständen geschehen soll, z. B. wenn eine Variable einen bestimmten Wert hat. Bedingte Anweisungen sind reguläre Python-Ausdrücke.

Die am häufigsten verwendete if-Anweisung in OpenSesame ist die run-if-Anweisung der sequence, mit der Sie die Bedingungen angeben können, unter denen ein bestimmtes Element ausgeführt wird. Wenn Sie ein sequence-Element öffnen, sehen Sie, dass jedes Element aus der Sequenz eine 'Run if …''-Option hat. Der Standardwert ist 'always', was bedeutet, dass das Element immer ausgeführt wird; aber Sie können hier auch eine Bedingung eingeben. Wenn Sie zum Beispiel nach einer korrekten Antwort einen grünen Fixationspunkt und nach einer falschen Antwort einen roten Fixationspunkt anzeigen möchten, können Sie eine sequence erstellen wie folgt (dies macht sich zunutze, dass ein keyboard_response-Element automatisch die Variable correct setzt, wie oben besprochen) wie in Figure 7 gezeigt.

Wichtig: Die "Run if"-Anweisungen gelten nur für die Run-Phase von Elementen. Die Prepare-Phase wird immer ausgeführt. Siehe auch diese Seite.

Figure 7. 'Run if'-Anweisungen können verwendet werden, um anzugeben, dass bestimmte Elemente einer sequence nur unter bestimmten Umständen ausgeführt werden sollen.

Sie können auch komplexere Bedingungen verwenden. Hier sind einige Beispiele:

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

Dasselbe Prinzip gilt für die 'Show if'-Felder in sketchpad-Elementen. Wenn Sie zum Beispiel einen rechts aufwärts gerichteten Pfeil zeichnen möchten, aber nur, wenn die Variable quadrant auf 'upper right' gesetzt wurde, geben Sie einfach die entsprechende Bedingung in das Feld 'Show if ...' ein und zeichnen Sie den Pfeil, wie in Figure 8 gezeigt. Stellen Sie sicher, dass Sie den Pfeil zeichnen, nachdem Sie die Bedingung festgelegt haben.

Figure 8. 'Show if'-Anweisungen können verwendet werden, um anzugeben, dass bestimmte Elemente eines sketchpad- oder feedback-Elements nur unter bestimmten Umständen angezeigt werden sollen.

Wichtig: Der Zeitpunkt, zu dem eine bedingte Anweisung ausgewertet wird, kann sich auf die Funktionsweise Ihres Experiments auswirken. Dies hängt mit der Prepare-Run-Strategie zusammen, die von OpenSesame verwendet wird und hier erklärt wird:

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