Variablen

Beschreibung

Variablen können für verschiedene Zwecke im Prozess der Erstellung von Experimenten auf Labvanced verwendet werden. Variablen halten und aktualisieren Werte, die entweder im Editor vom Experimentator oder während der Ausführung des Experiments auf verschiedene Weise erstellt werden. Wichtig ist, dass alle Variablen innerhalb einer Studie definiert sind und global im gesamten Experiment verwendet werden können. Im Hauptnavigationspanel gibt es einen Tab „Variablen“, in dem alle Variablen einer Studie aufgeführt sind.

Innerhalb des Task-Editors werden die Variablen, die im aktuell ausgewählten Frame verwendet werden, im Tab „Variablen“ in der oberen rechten Ecke 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. Innerhalb des Labvanced-Task-Editors und insbesondere im Ereignissystem gibt es mehrere Stellen, an denen eine Variable ausgewählt werden muss, um eine gewünschte Funktion zu erreichen. Wenn Sie aufgefordert werden, eine Variable auszuwählen, können Sie normalerweise eine vorhandene auswählen, aber Sie können zu diesem Zeitpunkt auch eine neue Variable erstellen. Sie können auch eine neue Variable unabhängig von ihrer Auswahl / Verwendung erstellen. Dies kann durch Klicken auf das Symbol „Neue Variable“ im Variablen-Tab erfolgen.

Eine Änderung an einer Variablen kann ein Ereignis auslösen, aber umgekehrt ist das auch wahr: Ereignisse können den Wert einer Variablen ändern. Darüber hinaus können Variablen direkt den Zustand bestimmter Objekte ändern. Variablen sind in 5 Hauptkategorien gruppiert: Systemvariablen, Faktorvariablen, Objektvariablen, benutzerdefinierte Variablen und ungenutzte Variablen.

Variablen-Eigenschaften

Für jede Variable können die Benutzer verschiedene Eigenschaften festlegen und eine kurze Textbeschreibung bereitstellen, die zusammenfasst, wofür die Variable verwendet wird. Die Eigenschaften „Name“ und „Datentyp“ sind obligatorisch, während die anderen Eigenschaften optional sind oder je nach Datentyp nicht geändert werden können. Im Folgenden finden Sie eine Liste aller Eigenschaften, ihrer 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 EINE EINZIGARTIGE BEZEICHNUNG HABEN (es darf keine zwei Variablen mit dem gleichen Namen geben). Andernfalls können schwere Fehler auftreten! Die Namens-Eigenschaft kann bei allen Variablen außer Systemvariablen geändert werden.
• Mögliche Werte: Jede ASCII-Zeichenfolge.

Datentyp

• Beschreibung: Der Datentyp einer Variablen bestimmt, welche Art von Werten die Variable haben kann. Der Datentyp bestimmt auch, welche Art von mathematischen Operationen auf eine Variable angewendet werden kann (Multiplikation funktioniert nur mit numerischen Variablen usw.).
• Mögliche Werte:
  • Zeichenfolge: Jede Art von Text kann in der Variablen gespeichert werden, einschließlich Zahlen, Sonderzeichen usw.
  • Numerisch: Es können nur numerische Werte in der Variablen gespeichert werden.
  • Boolesch: Die Variable kann nur die Werte „wahr“ oder „falsch“ haben.
  • Kategorisch: Die Variable hat eine Menge von festen vordefinierten Ebenen, und eine dieser Ebenen muss der Variablenwert sein. Dies wird hauptsächlich für Faktorvariablen verwendet.
  • Datum: Die Variable kann nur Datumswerte im Format (jjjj/mm/tt) speichern.
  • Zeit: Die Variable kann nur Zeitwerte im Format (Stunden/Minuten/Sekunden) speichern.
  • Datei: Die Variable kann Dateidaten von Bildern, Videos oder Audiodateien speichern.

Skala

• Beschreibung: Die Skala einer Variablen bestimmt die "Messstufe" der Variablen. Diese Unterscheidung ist nützlich für Variablen mit numerischem Datentyp und definiert die Relation der Variablenwerte. Die Eigenschaft kann in einer zukünftigen Labvanced-Erweiterung, wie z.B. einem Analysemodul, mehr Anwendungen haben.
• Mögliche Werte:
  • Unbestimmt: Keine Auswahl
  • Nominal: Nominal skalierter Wert (Kategorien).
  • Ordinal: Ordinal skalierter Wert (Ränge).
  • Intervall: Intervall skalierter Wert (Skala ohne einen echten Nullpunkt, z.B. Temperatur).
  • Verhältnis: Verhältnisskaliert (Skala mit einem echten Nullpunkt, z.B. Gewicht).

Format

• Beschreibung: Das Format einer Variablen bestimmt, ob die Variable ein einzelnes (skalare) Wert oder ein Array von Werten ist. 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 enthält eine Reihe von Werten.
  • Datenrahmen: Es gibt mehrere Variablen, die in einer CSV-Datei verschachtelt sind. Die Auswahl von Datenrahmen öffnet ein Dialogfeld, um die CSV-Daten anzugeben, wobei jede Spalte eine Variable ist. Benutzer können zwischen Zeichenfolge, numerisch, boolesch oder Datei als Variablentyp wählen.

Startwert

• Beschreibung: Der Startwert einer Variablen bestimmt den Standard-/Zurücksetz-Wert 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: Hängt vom Datentyp ab. Verwenden Sie das Reset-Symbol, 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. Zum Beispiel kann der Benutzer eine Liste von Wörtern (CSV-Datei), Bildern, Videos, Audiodateien usw. in eine Array-Variable hochladen. Die Position der Elemente/Eingaben innerhalb des Arrays kann ebenfalls angepasst werden.

Zurücksetzen zu Beginn des Versuchs

• Beschreibung: Die Option „Zurücksetzen zu Beginn des Versuchs“ bestimmt, ob die Variable für jeden neuen Versuch auf den Startwert zurückgesetzt wird oder nicht. In der Regel sollte diese Option für Variablen, die die Antwort oder Reaktionszeit eines Teilnehmers aufzeichnen, aktiviert werden. Variablen, die Daten über Versuche hinweg akkumulieren (z.B. für Feedback oder andere Zwecke) oder Datenarrays, die Informationen dauerhaft speichern, sollten jedoch nicht zurückgesetzt werden.
• Mögliche Werte: Wenn aktiviert (wahr), wird die Variable auf den Startwert zurückgesetzt. Wenn deaktiviert (falsch), wird die Variable nicht zurückgesetzt.

Aufzeichnen der Variable

• Beschreibung: Die Option „Aufzeichnen 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 deaktiviert (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 Variablen einschließlich Zeitstempeln auf.
  • Nur Endwert: Zeichnet nur den letzten Wert einer Variablen am Ende des Versuchs auf.

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). Beispielsweise können sie verwendet werden, um auf eine bestimmte Versuchsnummer zu verweisen, einen Subjektezähler zu verwenden oder Ereignisse für Multi-User-Studien zwischen Teilnehmern zu trennen. Alle Systemvariablen werden im Hauptvariablenmenü auf der Labvanced-Plattform angezeigt. Erfahren Sie mehr über Systemvariablen hier.

Faktorvariablen

Faktorvariablen sind jene Variablen, die mit einem Faktor im Versuchs-system verknüpft sind. Jeder Faktor hat eine verknüpfte Variable mit einem kategorialen Datentyp. Die Ebenen des Faktors sind auch mögliche Wertzustände der Variablen. Bei der Erstellung eines neuen Faktors können die Benutzer auswählen, ob sie eine neue Variable (automatisch) erstellen oder eine vorhandene Variable wiederverwenden möchten. Bei der Verknüpfung von Faktorvariablen sollte beachtet werden, dass Änderungen an den Variablen/Faktor-Ebenen die Versuchsstruktur in allen verknüpften Aufgaben/Versuchsgruppen ändern. Faktorvariablen 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 bei jedem Versuch, während der Durchführung des Experiments, jeder Faktorvariable immer ein neuer Ebenenwert im Datenansicht gespeichert. Auf diese Weise wird es einfacher, die Bedingungen jedes aufgezeichneten Versuchs beim Betrachten der Daten-Ausgabe oder beim Wiederholen des Verfahrens zu rekonstruieren.

Objektvariablen

Objektvariablen werden automatisch erstellt, wenn ein Objekt zum Frame hinzugefügt wird. Die meisten dieser Variablen entstehen durch das Hinzufügen von „Fragebogen-Elementen“, 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 erstellt. Im Eigenschaftenfenster des Objekts sehen Sie den Verweis auf die zugehörige Variable unter „verknüpfte Variable“. Hier können Sie auch die Verknüpfung / Zuordnung zu einer anderen Variablen ändern. Wir empfehlen jedoch, diese Option mit besonderer Sorgfalt zu verwenden. Während der Durchführung des Experiments wird die Antwort des Teilnehmers innerhalb der Variablen gespeichert. Objektvariablen werden standardmäßig aufgezeichnet, und die meisten Eigenschaften von Objektvariablen können nicht geändert werden, um ihre Funktionalität sicherzustellen.

Benutzerdefinierte Variablen

Benutzerdefinierte Variablen werden aktiv vom Benutzer erstellt. Die Gründe für die Erstellung benutzerdefinierter Variablen können sehr unterschiedlich 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 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 aufgelistet.

Array-Variablen

Arrays unterscheiden sich sehr von den oben besprochenen skalarvariablen. Denken Sie an ein Array wie an eine Spalte in einer Tabelle: Es enthält Einträge in einer festgelegten Reihenfolge. Bei der Erstellung eines Arrays können Sie auf den Ordner neben „CSV-Datei verwenden“ klicken, um eine .csv-Datei mit einer Informationsspalte hochzuladen, oder Sie können manuell Einträge mit dem Plus-Symbol 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, ein Datenrahmen jedoch eine gesamte Tabelle mit mehreren Spalten enthält. Datenrahmen können Zeichenfolgen (Text), numerische, boolesche oder Dateiwerten halten, 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 dürfen nur .csv-Dateien akzeptiert werden. Nachdem Sie Ihre Datei ausgewählt haben, erscheinen mehrere Importoptionen:

Wählen Sie alle anwendbaren Optionen aus:

• Zeichenfolgen auf Dateien abbilden ermöglicht es Ihnen, die Namen Ihrer Dateien als Zeichenfolgen einzuschließen und dann die Abbildungsfunktion zu verwenden, um auf den Ordner zu verweisen, in dem die Dateien gespeichert sind. Dies ermöglicht es, dass diese Spalte der Dateinamen nach den entsprechenden Dateien in einem Ordner sucht, 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 Zeichenfolgenwerten gefüllt ist.
• Erste Zeile als Kopfzeile verwenden nimmt die Werte in der ersten Zeile Ihres Datenrahmens und verwendet sie als Variablennamen für jede der Spalten.
• Daten transponieren lädt den Datenrahmen einfach so hoch, wie er ist. Dies ist nützlich, wenn Ihr Datenrahmen keine Dateinamen enthält.

Wenn Ihr Datenrahmen vollständig aus Zeichenfolgenwerten besteht, die den Namen von Dateien in einem Ordner entsprechen, können Sie den gesamten Datenrahmen auf einen Ordner abbilden, indem Sie die Funktion Alle Zeichenfolgen auf Dateien abbilden verwenden.

Um weitere Informationen zu einem bestehenden Datenrahmen hinzuzufügen, wählen Sie die Option Variable/Spalte hinzufügen oben im Dialogfeld des Datenrahmens.

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

Variablenverweise und Löschen von Variablen

Um einen besseren Überblick darüber zu erhalten, wo jede Variable verwendet wird, gibt es eine Liste namens VERWENDET IN am Ende des Panels für die Variablen-eigenschaften. Hier werden alle Verwendungen der Variablen aufgeführt, einschließlich des Verweises auf den Frame, auf 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 Frame, in dem eine Variable verwendet wird, gibt es einen zusätzlichen Eintrag in der Nutzungstabelle mit einem „Nutzungs-Typ“, der als „lokaler Arbeitsbereich“ bezeichnet wird. Alle Variablen im lokalen Arbeitsbereich eines Frames werden dann im Abschnitt „lokale Variablen“ im Variablenauswahlmenü angezeigt.

Wenn Sie eine Variable löschen möchten, muss dies mit besonderer Sorgfalt erfolgen. Das Löschen von Variablen, die noch als Faktoren, Objekte oder in Ereignissen verwendet werden, kann zu ernsthaften Problemen führen und (im schlimmsten Fall) die gesamte Experimentsstruktur stören. Daher können im Variablen-Tab nur jene Variablen gelöscht werden, die keinen anderen Verweis haben, abgesehen davon, dass sie sich innerhalb eines (oder mehrerer) lokalen Arbeitsbereiche befinden. Variablen, die nur im lokalen Arbeitsbereich definiert sind (ohne weitere Verwendung), werden als ungenutzt aufgelistet und ein Löschsymbol wird neben ihnen angezeigt.

Menü zur Variablenauswahl

Die benutzerkontrollierte Verwendung von Variablen basiert hauptsächlich auf Ereignislogik. Innerhalb des Ereignissystems gibt es 3 (visuell) unterschiedliche Menüs, die Ihnen die Auswahl einer Variable ermöglichen: das „Wert-Auswahlmenü“, die „Grüne Auswahl-Schaltfläche“ und das „Variablen-Referenzmenü“. Während diese Menüs visuell unterschiedlich sind, öffnen sie dasselbe Menü (das Menü zur Variablenauswahl), um eine Variable auszuwählen.

Insgesamt enthält das Menü zur Variablenauswahl 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 Frames definiert sind (bereits im Frame verwendet). Unter „Alle Variablen“ sind alle Variablen in der globalen Liste der Studie aufgeführt und können ausgewählt werden. Beide Menüs verfügen über eine Suchfunktion, um eine gewünschte Variable direkt zu finden. Der Tab „Neue Variable“ kann verwendet werden, um eine neue Variable zu erstellen (und anschließend auszuwählen).

Datenaufzeichnung

Für jede Variable können Benutzer ein Kontrollkästchen verwenden, um zu entscheiden, ob der Variablenwert aufgezeichnet werden soll oder nicht. Bei Systemvariablen, Faktorvariablen und Objektvariablen sind die Aufzeichnungen standardmäßig aktiviert. Daher funktionieren viele Teile der Datenaufzeichnungen automatisch. Wenn Sie versuchen, eine bestimmte Objekteigenschaft, 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. Hier ist ein kurzes Beispiel für die Ereignislogik zur Aufzeichnung der Reaktionszeit:

1. Fügen Sie ein Bild zum Frame hinzu.
2. Erstellen Sie ein neues Ereignis und benennen Sie es.
3. Definieren Sie den Auslöser, der bestimmt, wann der Variablenwert festgelegt werden soll. Beispielsweise Wählen Sie --> Benutzer-Eingabe --> Maus-Auslöser. Legen Sie die Auslöseraktion auf Klicken und die Schaltfläche als Links fest. Klicken Sie auf das +-Symbol neben „Ziele hinzufügen“, um das Bild als klickbares Ziel hinzuzufügen. Klicken Sie auf „Weiter“ am unteren Rand des Fensters.
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öser(Maus) --> Zeit Vom Frame-Beginn. Klicken Sie auf „Fertigstellen“.

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 geklickt wurde) usw. aufzuzeichnen.