Setzen / Aufzeichnen von Variablenaktionen

Die Set / Record Variable Aktion schreibt einen Wert in eine Variable, sobald das Ereignis, das sie enthält, ausgelöst wird. Sie gehört zur Variable Actions Kategorie des Ereignissystems und ist die häufigste Aktion in Labvanced: Fast jede aufgezeichnete Verhaltensmessung und nahezu jede variablengetriebene Bedingung in einer Studie läuft irgendwann durch sie.

Übersicht

Sobald eine Variable existiert, Set / Record Variable ist, wie sie tatsächlich einen Wert erhält: eine Reaktionszeit, die Wahl eines Teilnehmers, ein laufender Punktestand, ein Koordinatenpaar aus einer Mausbewegung. Ohne diese bleibt eine Variable während der gesamten Studie auf ihrem Startwert.

Häufige Anwendungsfälle

Set / Record Variable zeigt sich in nahezu jeder Kategorie von Studien, von einfachen Tastendruckaufgaben bis hin zu vollständigen physiologischen Aufzeichnungen.

• Aufzeichnen einer Verhaltensmessung: Speichern einer Reaktionszeit, eines Genauigkeitspunkts oder einer eingegebenen Antwort in einer Variablen, damit sie in den exportierten Daten erscheint.
• Aufbau eines Zählers: Erhöhen einer Variablen um 1 jedes Mal, wenn ein Trigger ausgelöst wird, um abgeschlossene Versuche, begangene Fehler oder Mausklicks zu zählen.
• Erfassen trigger-spezifischer Werte: Schreiben von Werten, die ein Trigger bereitstellt, wie X/Y-Koordinaten der Maus oder eine Blickposition, direkt in eine Variable.
• Steuern von bedingter Logik: Setzen einer Variablen, die ein späterer Requirement Action überprüft, um zu entscheiden, welcher Zweig der Studie als nächstes ausgeführt wird.

Erforderliches Hintergrundwissen

Bevor Sie in diese Aktion eintauchen, wird empfohlen, die grundlegenden Funktionen der Erstellung von Variablen und deren Eigenschaften zu verstehen, wie auf diesen Seiten beschrieben:

Funktionsweise

Um auf Set / Record Variable zuzugreifen, öffnen Sie das Ereignissystem im Aufgabeneditor und erstellen Sie ein neues Ereignis. Unter Add Action → Variable Actions wählen Sie Set / Record Variable aus.

Ein einfaches Dialogfeld erscheint mit zwei Teilen, die als Gleichung gelesen werden:

Das ist die gesamte Aktion: Wählen Sie eine Variable, definieren Sie ihren neuen Wert, fertig. Das Dialogfeld zeigt auch eine feste Zeile an: "Aufzeichnungen erfolgen am Ende des Versuchs": Der Wert der Variablen wird sofort beim Ausführen der Aktion auf dem Client aktualisiert, aber dieser Wert wird erst am Ende des Versuchs an den Server gesendet und aufgezeichnet, nicht bei jeder einzelnen Änderung.

Ein praktisches Szenario: Aufbau eines Zählers. In Labvanced gibt es keine spezielle "Zähler"-Variable, jede Variable kann als solche fungieren. Erstellen Sie eine numerische Variable mit einem beliebigen Namen, der zu Ihrer Studie passt (zum Beispiel trial_count oder error_count), und verwenden Sie dann die Arithmetic Option des Wertauswahlmenüs, um den neuen Wert dieser Variablen auf sich selbst plus eins zu setzen, jedes Mal, wenn der relevante Trigger ausgelöst wird. Dies ist derselbe Mechanismus, der hinter Versuchs-, Fehler- und Klickzählern in Labvanced-Aufgaben steht, sodass es wichtig ist, zu verstehen, wie ein solches Setup funktioniert, um ein Gefühl für die Möglichkeiten hinter dieser Aktion zu bekommen.

In einigen Fällen, während Sie Ihre Aufgabe aufbauen, wird ein Dialogfeld angezeigt, in dem Sie gefragt werden, ob Sie automatische Ereignisse erstellen möchten, um bestimmte Datentypen zu erfassen, wie zum Beispiel Augenverfolgung. Wenn Sie dies akzeptieren, wird sowohl der Trigger als auch eine Set / Record Variable Aktion für Sie erstellt, die bereits konfiguriert ist und die genau dieselbe Aktion und das Dialogfeld abdeckt, die oben beschrieben wurden.

Workflow-Tipps

• Planen Sie Ihre Variablen, bevor Sie bauen: Stellen Sie sicher, dass Sie vor dem Start der Erstellung alle Daten kennen, die in Ihrer Studie erfasst werden müssen, und eine allgemeine Vorstellung davon haben, welche Variablen erstellt werden müssen, um diese Daten zu speichern. Set / Record Variable ist der Ort, an dem dieser Plan umgesetzt wird. Wenn Sie also im Voraus entscheiden, vermeiden Sie es, Ereignisse während des Baus umstrukturieren zu müssen.
• Wiederverwenden einer ähnlichen Aktion anstatt sie neu zu erstellen: Wenn Sie bereits eine ähnliche Set / Record Variable Aktion unter demselben Trigger oder an anderer Stelle in der Studie haben, verwenden Sie Copy to Clipboard und fügen Sie sie dort ein, wo sie benötigt wird, und bearbeiten Sie dann die Zielvariable oder den Wert leicht, anstatt über Select und das Wertauswahlmenü erneut von Grund auf anzuklicken.
• Gruppieren Sie zusammengehörende Aktionen: Wenn mehrere Set / Record Variable Aktionen typischerweise zusammengehören, planen Sie Ihr Ereignisdesign rund um eine Action Group, die sie beherbergt. Das spätere Verschieben oder Kopieren des gesamten Sets ist schneller, als jede Aktion einzeln zu bearbeiten.
• Überprüfen Sie zuerst die automatische Ereigniseinrichtung: In einigen Fällen, wie bei Augenverfolgung, Emotionserkennung oder Herzfrequenz, kann Labvanced anbieten, den Trigger und seine Set / Record Variable Aktion für Sie zu erstellen. Überprüfen Sie, ob dieses Dialogfeld verfügbar ist, bevor Sie dasselbe manuell einrichten.

Studien & Beispiel-Szenarien

Zwei echte Beispiele aus veröffentlichten Labvanced-Aufgaben, eine zur Bewertung einer einzelnen Antwort und eine zur Aufzeichnung kontinuierlicher Bewegungen.

Genauigkeit im Flanker Task bewerten

Im Main_task_desktop_Flanker Task des Flanker Task, Frame 3 (Response Window), überprüft ein Requirement Action innerhalb des Response Recording & Progression Ereignisses, ob die gedrückte Taste mit der Zielrichtung übereinstimmt. Wenn dies der Fall ist, setzt Set / Record Variable die accuracy Variable auf 1.

Aufzeichnen von Mausbahn-Daten

Die Web Bridge Mausverfolgungseinrichtung verwendet Set / Record Variable, um den Mouse [Name, Info, X, Y] Array trigger-spezifischen Wert bei jeder Mausbewegung in eine Variable zu schreiben. Sie setzt Format auf Array, Aufzeichnungsart auf Time series, und Abtastmethode auf record all (allow repeated duplicates), sodass jede Bewegung erfasst wird, anstatt nur die letzte.

Weiterführende Literatur und offene Materialien

Ereignissystem

Die vollständige Referenz für jeden Trigger und jede Aktion in Labvanced.

Wertauswahlmenü

Wie man Konstanten, Variablen, trigger-spezifische Werte und Ausdrücke als den von dieser Aktion zugewiesenen Wert definiert.

Bedingungsaktion (Wenn... Dann... Sonst Wenn)

Der bedingte Logikblock, der am häufigsten die Setzen / Aufzeichnen von Variablen innerhalb seiner Dann- und Sonst-Zweige auslöst.

Variablen erstellen

Wie man eine Variable erstellt und ihre Datentypen, Format und Aufzeichnungsoptionen festlegt, bevor oder während dieser Aktion verwendet wird.