Variablen

Beschreibung

Variablen können im Prozess der Experimenterstellung auf Labvanced für verschiedene Zwecke verwendet werden. Variablen halten und aktualisieren Werte, die entweder im Editor vom Experimentator oder während der Durchführung des Experiments auf verschiedene Weise erstellt werden. Es gibt mehrere Typen von Variablen, darunter: Systemvariablen, Faktorenvariablen, Objektvariablen und benutzerdefinierte Variablen.

Zu verstehen, wie Variablen verwendet werden können, ist entscheidend für den Aufbau eines Experiments in Labvanced. Variablen haben viele Funktionen, darunter:

1. Daten speichern / lesen: Aufgezeichnete Daten, wie Teilnehmerantworten und Reaktionszeiten, werden in Variablen gespeichert.
2. Daten erstellen: Bestimmte Szenarien erfordern möglicherweise, dass Sie Variablen ad hoc erstellen, wie z.B. Punktzahlen hinzuzufügen oder Zeichenfolgen zusammenzufügen.
3. Den Ablauf des Experiments steuern: Der Einsatz von Variablen kann genutzt werden, um den Experimentablauf zu steuern. Zum Beispiel, wenn eine Punktevariable unter einem bestimmten Schwellenwert liegt, dann fahren Sie mit einer bestimmten Aufgabe fort.

Wichtig ist, dass alle Variablen innerhalb einer Studie definiert sind und global im gesamten Experiment verwendet werden können. Um alle erstellten Variablen zu sehen, können Sie im linken Navigationsbereich für eine bestimmte Studie zum Variablen-Tab gehen, wo alle Variablen einer Studie aufgelistet werden.

Schauen Sie sich dieses ~5-minütige Video zur Einführung in Variablen und deren Funktionsweise an:

Variablen im Aufgabeneditor lokalisieren

Im Aufgabeneditor sind die Variablen, die im derzeit ausgewählten Rahmen verwendet werden, unter dem Tab Variablen im oberen rechten Bereich des Bildschirms aufgelistet. Hier wird jede Variable mit ihren wichtigsten Eigenschaften angezeigt: der Hauptkategorie, dem Datentyp und dem Namen. Variablen können kopiert, gelöscht und ausgewählt werden, um weitere Eigenschaften zu überprüfen und zu ändern.

Variablen erstellen

Im Labvanced Aufgabeneditor, insbesondere im Ereignissystem, gibt es mehrere Stellen, an denen eine Variable ausgewählt werden muss, um eine gewünschte Funktion zu erreichen.

Variablen können erstellt werden über:

1. Den Aufgabeneditor:
   • Variablen-Panel: Wie im obigen Bild gezeigt, enthält das oben links im Editor befindliche Panel einen Variablen-Tab, der zugänglich ist und mehrere Funktionen bietet, einschließlich der Erstellung einer neuen Variable.
   • Hinzufügen bestimmter Objekte: Das Hinzufügen bestimmter Objekte zum Editor, wie das Eingabeobjekt oder fragebogenbezogene Objekte, wird Sie automatisch auffordern, eine Variable zu erstellen, damit diese Antworten gespeichert werden können.
2. Das Ereignissystem: Die Erstellung von Variablen im Ereignissystem (um Daten dynamisch aufzuzeichnen und das Verhalten des Experiments zu steuern) ist ein wesentlicher Konzept, das zu erfassen ist... und wird im nächsten Abschnitt näher erläutert!

Variablen und Ereignisse

Eine Änderung an einer Variable kann ein Ereignis auslösen, aber umgekehrt ist dies auch wahr: Ereignisse können den Wert einer Variablen ändern. Darüber hinaus können Variablen direkt den Zustand bestimmter Objekte ändern...

Zum Beispiel, wenn der Wert einer Variablen gleich X ist, dann zeigen Sie Bild Y an. Variablen und Ereignisse können auch verwendet werden, um den Fortschritt des Experiments zu steuern. Zum Beispiel, wenn der Teilnehmer Punkte X (was ein Variablenwert ist) in Aufgabe A erzielt, dann gehen Sie zu Aufgabe B, andernfalls gehen Sie zu Aufgabe C.

Variablen im Ereignissystem erstellen und verwenden

Die benutzerkontrollierte Verwendung von Variablen basiert hauptsächlich auf Ereignislogik. Innerhalb des Ereignissystems gibt es zwei Hauptmenüs, die es Ihnen ermöglichen, eine Variable auszuwählen/aufzurufen/zu erstellen, nämlich:

1. "Wert-Auswahl-Menü"
2. Grüner "Auswählen" Knopf

Obwohl diese Menüs visuell unterschiedlich sind, öffnen sie das gleiche Menü (das Variablen-Auswahl-Menü) zur Auswahl oder Erstellung einer Variablen.

Menü zur Variablen-Auswahl

Insgesamt enthält das Menü zur Variablen-Auswahl drei verschiedene Tabs: "Lokale Variablen", "Alle Variablen" und "Neue Variable." Unter "Lokale Variablen" können Sie alle Variablen sehen und auswählen, die im lokalen Arbeitsbereich des Rahmens definiert sind (bereits im Rahmen verwendet). Unter "Alle Variablen" sind alle Variablen in der globalen Liste der Studie aufgelistet und können ausgewählt werden. Beide dieser Menüs haben eine Suchfunktion, um eine gewünschte Variable direkt zu finden. Der Tab "Neue Variable" kann verwendet werden, um eine neue Variable zu erstellen (und folglich auszuwählen).

Daten aufzeichnen

Für jede Variable können die Benutzer eine Checkbox verwenden, um zu entscheiden, ob der Variablenwert aufgezeichnet wird oder nicht. Für Systemvariablen, Faktorenvariablen und Objektvariablen sind die Aufzeichnungen standardmäßig aktiviert. Daher funktionieren viele Teile der Datenaufzeichnung automatisch. Wenn Sie beabsichtigen, eine bestimmte Objekt-Eigenschaft, eine Antwort des Teilnehmers oder etwas anderes, das standardmäßig nicht aufgezeichnet wird, aufzuzeichnen, müssen Sie das Ereignissystem verwenden, um den Variablenwert entsprechend festzulegen.

Beispiel: Aufzeichnen der Reaktionszeit und Speichern in einer Variablen

Hier ist ein kurzes Beispiel für Ereignislogik zur Aufzeichnung der Reaktionszeit:

1. Fügen Sie ein Bild in den Rahmen ein.
2. Erstellen Sie ein neues Ereignis und benennen Sie es.
3. Definieren Sie den Auslöser, der bestimmt, wann der Variablenwert gesetzt werden soll. Zum Beispiel: Auswahl --> Benutzereingabe --> Mausklick auslösen. Setzen Sie die Auslöseaktion auf Klick und die Schaltfläche auf Links. Klicken Sie auf das + Zeichen neben "Ziele hinzufügen", um das Bild als klickbares Ziel hinzuzufügen. Klicken Sie auf "Weiter" unten im Fenster.
4. Wählen Sie die Aktion Variablenaktionen --> Setzen / Aufzeichnen der Variablen. Klicken Sie dann auf die Schaltfläche "Auswählen".
5. Klicken Sie auf den Tab "Neue Variable" und erstellen Sie eine neue Variable, indem Sie ihr einen Namen geben (Datentyp: numerisch, zurücksetzen = wahr, aufzeichnen = wahr). Klicken Sie auf "Ok."
6. Klicken Sie auf das Wert-Auswahl (Stift) Symbol --> Auslösen (Maus) --> Zeit seit Beginn des Rahmens. Klicken Sie auf "Fertig."

Jetzt haben Sie die Reaktionszeit für das Klicken auf ein Bild gespeichert. Sie können ein ähnliches Verfahren verwenden, um andere Eigenschaften wie Entscheidungen (welches Bild aus einer Vielzahl angeklickt wurde) usw. aufzuzeichnen.

Eigenschaften von Variablen

Für jede Variable können Sie die verschiedenen Eigenschaften angeben und eine kurze Textbeschreibung bereitstellen, die zusammenfasst, wofür die Variable verwendet wird. Die Eigenschaften Name und Datentyp sind verpflichtend (auch der Formattyp ist wichtig, um im Fall von Arrays und Datenrahmen anzugeben), während die anderen Eigenschaften optional sind oder je nach Datentyp nicht geändert werden können.

Nachfolgend eine Liste aller Eigenschaften, deren Werte und Beschreibungen:

Name

• Beschreibung: Der Name wird als Handle für die Variable in Ereignissen, Objekten, beim Kopieren von Aufgaben und später auch in der Datenansicht verwendet. Der Name MUSS EINFACH SEIN (es darf keine 2 Variablen mit dem gleichen Namen geben). Andernfalls können schwerwiegende Fehler auftreten! Die Namenseigenschaft kann in allen Variablen mit Ausnahme von Systemvariablen geändert werden.
• Mögliche Werte: Jeder ASCII-String. Verwenden Sie keine Punkte (.)

Datentyp

• Beschreibung: Der Datentyp einer Variable bestimmt, welche Art von Werten die Variable haben kann. Der Datentyp bestimmt auch, welche Art von mathematischen Operationen auf eine Variable angewendet werden können (Multiplikation funktioniert nur mit numerischen Variablen usw.).
• Mögliche Werte:
  • String: Es können beliebige Texte in der Variablen gespeichert werden, einschließlich Zahlen, Sonderzeichen usw.
  • Numeric: Es können nur numerische Werte in der Variablen gespeichert werden.
  • Boolean: Die Variable kann nur die Werte "wahr" oder "falsch" haben.
  • Categorical: Die Variable hat eine Menge fester vordefinierter Niveaus und eines der Niveaus muss der Variablenwert sein. Dies wird hauptsächlich für Faktorenvariablen verwendet.
  • Date: Die Variable kann nur Datumswerte im Format (jjjj/mm/tt) speichern.
  • Time: Die Variable kann nur Zeitwerte im Format (Stunden/Minuten/Sekunden) speichern.
  • File: Die Variable kann Dateidaten von Bildern, Videos oder Audiodateien speichern.

Skala

• Beschreibung: Die Skala einer Variablen bestimmt den "Messgrad" der Variablen. Diese Unterscheidung ist nützlich für Variablen mit einem numerischen Datentyp und definiert die Beziehung der Variablenwerte. Die Eigenschaft kann in einer zukünftigen Erweiterung von Labvanced mehr Anwendungen finden, wie z.B. ein Analyse-Modul.
• Mögliche Werte:
  • Undefiniert: Keine Auswahl
  • Nominal: Nominal skalierter Wert (Kategorien).
  • Ordinal: Ordinal skalierter Wert (Ränge).
  • Intervall: Intervall skalierter Wert (Skala ohne echten Nullpunkt, z.B. Temperatur).
  • Verhältnis: Verhältnis skalierter Wert (Skala mit einem echten Nullpunkt, z.B. Gewicht).

Format

• Beschreibung: Das Format einer Variablen bestimmt, ob es sich um einen einzelnen (Skalar-)Wert oder ein Array von Werten handelt. Einige Operationen / Aktionen können nur auf Arrays und andere nur auf skalaren Variablen angewendet werden.
• Mögliche Werte:
  • Skalar: Die Variable ist ein einzelner Wert.
  • Array: Die Variable hält eine Reihe von Werten.
  • Datenrahmen: In einem CSV-Dateiformat sind mehrere Variablen geschachtelt. Die Auswahl von Datenrahmen öffnet ein Dialogfeld, um die CSV-Daten anzugeben, wobei jede Spalte eine Variable darstellt. Benutzer können zwischen String, numerisch, boolean oder file als Variablentyp wählen.

Startwert

• Beschreibung: Der Startwert einer Variablen bestimmt den Standard-/Rücksetzungswert der Variablen. Der Startwert kann verwendet werden, um den Wert einer Variablen zu Beginn jedes Versuchs auf einen bestimmten Wert zurückzusetzen. Der Startwert kann auch verwendet werden, um Informationen dauerhaft in einer Variablen zu speichern (z.B. Text, Bild, Video oder Audiodaten).
• Mögliche Werte: Abhängig vom Datentyp. Verwenden Sie das Rücksetzsymbol, um den Startwert zu entfernen.
  • Variablen mit Datenformat "Array": Bei "Array"-Variablen ist es möglich, nicht nur einen Startwert zu definieren, sondern ein komplettes Array mit Werten zu füllen. Beispielsweise kann der Benutzer eine Liste von Wörtern (CSV-Datei), Bildern, Videos, Audiodateien usw. in eine Array-Variable hochladen. Die Position der Elemente / Einträge im Array kann ebenfalls angepasst werden.

Rücksetzen zu Versuchsbeginn

• Beschreibung: Die Option "Rücksetzen zu Versuchsbeginn" bestimmt, ob die Variable zu ihrem Startwert für jeden neuen Versuch zurückgesetzt wird oder nicht. Typischerweise sollte diese Option für Variablen aktiviert werden, die die Antwort oder Reaktionszeit eines Teilnehmers aufzeichnen. Allerdings sollten Variablen, die Daten über Versuche ansammeln (für Feedback oder andere Zwecke) oder Datenarrays, die Informationen dauerhaft speichern, nicht zurückgesetzt werden.
• Mögliche Werte: Wenn aktiviert (wahr), wird die Variable auf den Startwert zurückgesetzt. Wenn nicht aktiviert (falsch), wird die Variable nicht zurückgesetzt.

Variable aufzeichnen

• Beschreibung: Die Option zur Aufzeichnung der Variablen bestimmt, ob die Variable aufgezeichnet wird oder nicht. Alle Variablen, bei denen diese Option aktiviert ist, werden am Ende jedes Versuchs aufgezeichnet.
• Mögliche Werte: Wenn aktiviert (wahr), wird die Variable aufgezeichnet. Wenn nicht aktiviert (falsch), wird die Variable nicht aufgezeichnet.

Aufzeichnungsart

• Beschreibung: Die Aufzeichnungsart einer Variablen bestimmt, ob alle Wertänderungen einer Variablen während eines Versuchs aufgezeichnet werden oder nur der Endwert der Variablen in jedem Versuch. Wenn alle Änderungen aufgezeichnet werden, wird jede Variablenänderung zusammen mit einem Zeitstempel gespeichert. Diese Option kann verwendet werden, um eine Zeitreihe von Daten aufzuzeichnen (z.B. für Maus- oder Augenverfolgung).
• Mögliche Werte:
  • Alle Änderungen / Zeitreihe: Zeichnet alle Änderungen einer Variable einschließlich Zeitstempeln auf.
  • Nur Endwert: Zeichnet nur den letzten Wert einer Variablen am Ende des Versuchs auf.

Typen von Variablen

Systemvariablen

Systemvariablen sind wichtig für die Durchführung von Experimenten und den Datenexport. Sie werden automatisch erstellt und können nicht geändert oder gelöscht werden. Systemvariablen sind auch sehr nützlich in Anforderungen (z.B. Wenn-Dann-Aktionen). Sie können verwendet werden, um sich auf eine bestimmte Versuchsnummer zu beziehen, einen Probandenzähler zu verwenden oder Ereignisse für Mehrbenutzerstudien zwischen Teilnehmern zu trennen. Alle Systemvariablen werden im Hauptvariablenmenü auf der Labvanced-Plattform angezeigt. Erfahren Sie mehr über Systemvariablen hier.

Faktorenvariablen

Faktorenvariablen sind jene Variablen, die an einen Faktor im Versuchssystem gekoppelt sind. Jeder Faktor hat eine gekoppelte Variable mit einem kategorischen Datentyp. Die Niveaus des Faktors sind auch mögliche Werte für die Variable. Bei der Erstellung eines neuen Faktors können die Benutzer wählen, ob sie eine neue Variable (automatisch) erstellen oder eine vorhandene Variable wiederverwenden möchten. Bei der Verknüpfung von Faktorenvariablen sollte beachtet werden, dass Änderungen an den Variablen-/Faktorniveaus die Versuchsstruktur in allen verknüpften Aufgaben-/Versuchsgruppen ändern. Faktorenvariablen können im Ereignissystem verwendet werden, um beispielsweise Ereignisse zu erstellen, die nur unter bestimmten Bedingungen ausgeführt werden (z.B. etwas nur tun, wenn der Faktor "Bildkategorie" gleich "Haus" ist). Darüber hinaus wird während der Durchführung des Experiments jeder Faktorvariable immer ein neuer Niveawert in der Datenansicht gespeichert. So wird es einfacher, die Bedingung jedes aufgezeichneten Versuchs zu rekonstruieren, wenn man sich die Datenausgabe anschaut oder den Prozess wiederholt.

Objektvariablen

Objektvariablen werden automatisch erstellt, wenn ein Objekt in den Rahmen hinzugefügt wird. Die meisten dieser Variablen entstehen durch das Hinzufügen von "Fragebogenelementen", wie z.B. Kontrollkästchen, Likert-Skalen, Dropdowns usw. Bei der Erstellung eines solchen Objekts werden Sie aufgefordert, einen Namen für die zugehörige Variable einzugeben. Nachdem Sie einen gültigen (einzigartigen!) Namen eingegeben haben, wird die Variable automatisch erzeugt. In der Objekt-Eigenschaftsansicht sehen Sie den Verweis auf die zugehörige Variable unter "verknüpfte Variable". Hier können Sie auch die Verknüpfung / Assoziation zu einer anderen Variablen ändern. Wir empfehlen jedoch, diese Option mit besonderer Sorgfalt zu verwenden. Bei der Durchführung des Experiments wird die Antwort des Teilnehmers in der Variablen gespeichert. Objektvariablen werden standardmäßig aufgezeichnet und die meisten Eigenschaften von Objektvariablen können nicht geändert werden, um ihre Funktionalität zu gewährleisten.

Benutzerdefinierte Variablen

Benutzerdefinierte Variablen werden aktiv vom Benutzer erstellt. Die Gründe für die Erstellung benutzerdefinierter Variablen können recht vielfältig sein. Sie können verwendet werden, um die Entscheidungen der Teilnehmer (Mausklicks oder Tasteneingaben) oder Reaktionszeiten aufzuzeichnen. Sie können auch als Zähler oder Indizes in While-Schleifen oder Array-Aktionen verwendet werden, um (Bild-, Video-, Audio-)Dateidaten zu speichern, und für viele weitere Zwecke.

Wenn eine Variable erstellt wird, ohne verwendet zu werden, oder wenn ihre Verwendung (Objekt oder Ereignis) gelöscht wird, wird die Variable als ungenutzt aufgeführt.

Array-Variablen

Arrays sind sehr unterschiedlich von den oben besprochenen skalar Variablen. Denken Sie an ein Array als an eine Spalte in einer Tabelle: Es enthält Einträge in einer bestimmten Reihenfolge. Beim Erstellen eines Arrays können Sie auf den Ordner neben "CSV-Datei verwenden" klicken, um eine .csv-Datei mit einer Spalte von Informationen hochzuladen, oder Sie können manuell Einträge mithilfe des Plus-Icons hinzufügen.

Für eine Liste von Aktionen, die mit Arrays verbunden sind, siehe Array-Aktionen

Datenrahmenvariablen

Datenrahmen unterscheiden sich von Arrays insofern, als dass ein Array eine Spalte einer Tabelle ist, während ein Datenrahmen eine gesamte Tabelle mit mehreren Spalten ist. Datenrahmen können String- (Text), numerische, boolesche oder Dateiwert speichern, können jedoch im Dialogfenster des Datenrahmens nicht direkt bearbeitet werden. Sie können Spalten und Dateien hinzufügen, aber keinen Text oder Zahlen eingeben:

Um einen neuen Datenrahmen hinzuzufügen, klicken Sie auf 2D-CSV-Daten hochladen. Beim Hinzufügen von Informationen zu Ihrem Datenrahmen werden nur .csv-Dateien akzeptiert. Nach der Auswahl Ihrer Datei erscheinen mehrere Importoptionen:

Wählen Sie alles anwendbare:

• Strings zu Dateien zuordnen ermöglicht es Ihnen, die Namen Ihrer Dateien als Strings einzuschließen und dann die Zuordnungsfunktion zu verwenden, um auf den Ordner zu zeigen, in dem die Dateien gespeichert sind. Dadurch kann diese Spalte von Dateinamen nach den entsprechenden Dateien in einem Ordner suchen, vorausgesetzt, die Werte im Datenrahmen stimmen genau mit den Namen der gewünschten Dateien überein. Diese Funktion ist nur verfügbar, wenn die Spalte mit Stringwerten gefüllt ist.
• Erste Zeile als Kopfzeile verwenden nimmt die Werte in der ersten Zeile Ihres Datenrahmens und verwendet sie als Variablenamen für jede der Spalten.
• Daten transponieren lädt einfach den Datenrahmen so hoch, wie er ist. Dies ist nützlich, wenn Ihr Datenrahmen keine Dateinamen enthält.

Wenn Ihr Datenrahmen ausschließlich aus Stringwerten besteht, die den Namen von Dateien in einem Ordner entsprechen, können Sie den gesamten Datenrahmen mit der Funktion alle Strings zu Dateien zuordnen einer Ordner zuordnen.

Um mehr Informationen zu einem vorhandenen Datenrahmen hinzuzufügen, wählen Sie die Option Variable/Spalte hinzufügen oben im Dialogfeld für Datenrahmen.

Für eine Liste von Aktionen, die mit Datenrahmen verbunden sind, siehe Operationen mit Datenrahmen

Variablenreferenzen und Löschen von Variablen

Um einen besseren Überblick darüber zu geben, wo jede Variable verwendet wird, gibt es am Ende des Variablen-Eigenschaften-Panel eine Liste, die als VERWENDET IN bezeichnet wird. Hier werden alle Verwendungen der Variable aufgelistet, einschließlich eines Verweises auf den Rahmen, in dem die Variable verwendet wird (Name), zu welchem Zweck (Verwendet als) und ob die Verwendung eine Leseoperation (R), eine Schreiboperation (W) oder beides (RW) ist. Für jeden Rahmen, in dem eine Variable verwendet wird, wird es einen zusätzlichen Eintrag in der Verwendungstabelle mit einem "Verwendungstyp" namens "lokaler Arbeitsbereich" geben. Alle Variablen im lokalen Arbeitsbereich eines Rahmens werden dann im Abschnitt "lokale Variablen" im Variablenauswahlmenü angezeigt.

Wenn Sie eine Variable löschen möchten, muss dies mit besonderer Sorgfalt geschehen. Das Löschen von Variablen, die noch als Faktoren, Objekte oder in Ereignissen verwendet werden, kann zu schwerwiegenden Problemen führen und (im schlimmsten Fall) die gesamte Experimentstruktur stören. Daher können im Variablen-Tab nur solche Variablen gelöscht werden, die keine weiteren Verwendungen aufweisen, außer innerhalb eines (oder mehrerer) lokaler Arbeitsbereiche. Variablen, die nur im lokalen Arbeitsbereich definiert sind (ohne weitere Verwendung), sind als ungenutzt aufgeführt, und ein Löschsymbol wird neben ihnen angezeigt.