Variablen

Beschreibung

Variablen können für verschiedene Zwecke im Prozess der Experimenterstellung auf Labvanced verwendet werden. Variablen halten und aktualisieren Werte, die entweder im Editor vom Experimentator oder während der Experimentdurchführung auf verschiedene Weise erstellt werden. Wichtig ist, dass alle Variablen innerhalb einer Studie definiert sind und global im gesamten Experiment verwendet werden können. Es gibt einen Tab "Variablen" im Hauptnavigationspanel, in dem alle Variablen einer Studie aufgelistet sind.

Innerhalb des Aufgaben-Editors sind die Variablen, die im aktuell ausgewählten Rahmen verwendet werden, im Tab "Variablen" oben rechts auf dem Bildschirm aufgeführt. 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 inspizieren und zu ändern. Innerhalb des Labvanced-Aufgabeneditors und insbesondere innerhalb des Ereignisystems 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 auch zu diesem Zeitpunkt eine neue Variable erstellen. Sie können auch eine neue Variable unabhängig von der Auswahl / Verwendung erstellen. Dies kann geschehen, indem Sie auf das Symbol "Neue Variable" im Variablen-Tab klicken.

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

Eigenschaften der Variablen

Für jede Variable können Benutzer verschiedene Eigenschaften festlegen und eine kurze Textbeschreibung angeben, 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. Unten ist eine Liste aller Eigenschaften, ihrer Werte und Beschreibungen.

Name

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

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 kann (Multiplikation funktioniert nur mit numerischen Variablen usw.).
• Mögliche Werte:
  • String: Jeder Text kann in der Variable gespeichert werden, einschließlich Zahlen, Sonderzeichen usw.
  • Numeric: Nur numerische Werte können in der Variable gespeichert werden.
  • Boolean: Die Variable kann nur die Werte "true" oder "false" haben.
  • Categorical: Die Variable hat eine Menge fester vordefinierter Stufen und eine der Stufen muss der Variablenwert sein. Dies wird hauptsächlich für Faktorenvariablen verwendet.
  • Date: Die Variable kann nur Datumswerte im Format (jjjj/mm/tt) halten.
  • Time: Die Variable kann nur Zeitwerte im Format (stunden/minuten/sekunden) halten.
  • File: Die Variable kann Dateidaten von Bildern, Videos oder Audiodateien halten.

Skala

• Beschreibung: Die Skala einer Variable bestimmt das "Messniveau" der Variable. Diese Unterscheidung ist nützlich für Variablen mit numerischem Datentyp und definiert die Beziehung der Variablenwerte. Die Eigenschaft könnte in einer zukünftigen Erweiterung von Labvanced weitere Verwendungsmöglichkeiten haben, wie beispielsweise ein Analysemodul.
• Mögliche Werte:
  • Undefined: Keine Auswahl
  • Nominal: Nominal skalierter Wert (Kategorien).
  • Ordinal: Ordinal skalierter Wert (Ränge).
  • Interval: Intervallskalierter Wert (Skala ohne einen echten Nullpunkt, z.B. Temperatur).
  • Ratio: Verhältnis-skaliert Wert (Skala mit einem echten Nullpunkt, z.B. Gewicht).

Format

• Beschreibung: Das Format einer Variable bestimmt, ob die Variable ein einzelner (skalarer) Wert oder ein Array von Werten ist. Einige Operationen / Aktionen können nur auf Arrays angewendet werden, und andere nur auf skalarer Variablen.
• Mögliche Werte:
  • Scalar: Die Variable ist ein einzelner Wert.
  • Array: Die Variable hält eine Reihe von Werten.
  • Data Frame: Es gibt mehrere Variablen, die in einer CSV-Datei geschachtelt sind. Die Auswahl Data Frame öffnet ein Dialogfeld zur Spezifizierung der CSV-Daten, wobei jede Spalte eine Variable ist. Benutzer können zwischen String, Numeric, Boolean oder File 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 Zurücksetzen-Symbol, um den Startwert zu entfernen.
  • Variablen mit Datenformat "array": Für "array"-Variablen ist es möglich, nicht nur einen Startwert zu definieren, sondern ein vollständiges 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 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 zu dem Startwert bei jedem neuen Versuch zurückgesetzt wird oder nicht. Typischerweise sollte diese Option für Variablen aktiviert werden, die die Antwort oder Reaktionszeit eines Teilnehmers aufzeichnen. Variablen, die Daten über Versuche hinweg akkumulieren (für Feedback oder andere Zwecke) oder Datenarrays, die Informationen dauerhaft speichern, sollten jedoch nicht zurückgesetzt werden.
• Mögliche Werte: Wenn angekreuzt (true), wird die Variable auf den Startwert zurückgesetzt. Wenn nicht angekreuzt (false), wird die Variable nicht zurückgesetzt.

Variable aufzeichnen

• Beschreibung: Die Option "Variable aufzeichnen" 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 angekreuzt (true), wird die Variable aufgezeichnet. Wenn nicht angekreuzt (false), 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 Zeitstempel 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 bearbeitet oder gelöscht werden. Systemvariablen sind auch sehr nützlich in Anforderungen (z.B. If-Else-Aktionen). Sie können zum Beispiel verwendet werden, um auf eine bestimmte Versuchsnummer zu verweisen, um einen Subjektzähler zu verwenden oder um 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.

Faktorenvariablen

Faktorenvariablen sind die Variablen, die mit einem Faktor im Versuchssystem verknüpft sind. Jeder Faktor hat eine verknüpfte Variable mit einem kategorialen Datentyp. Die Stufen des Faktors sind auch mögliche Wertzustände der Variablen. Bei der Erstellung eines neuen Faktors können Benutzer wählen, ob sie entweder 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 Variable-/Faktorniveaus die Versuchstruktur 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. tue etwas nur, wenn der Faktor "Bildkategorie" gleich "Haus" ist). Darüber hinaus wird bei jedem Versuch während der Durchführung des Experiments jede Faktorenvariable immer einen neuen Stufenwert im Datenblick gespeichert haben. Auf diese Weise ist es einfacher, die Bedingung jedes aufgezeichneten Versuchs bei der Ansicht der Datenausgabe oder der Wiederholung des Verfahrens nachzuvollziehen.

Objektvariablen

Objektvariablen werden automatisch erstellt, wenn ein Objekt zum Rahmen hinzugefügt wird. Die meisten dieser Variablen entstehen durch das Hinzufügen von "Fragebogenelementen", wie 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 (eindeutigen!) Namen eingegeben haben, wird die Variable automatisch erstellt. In der Ansicht der Objekt-Eigenschaften sehen Sie den Verweis auf die zugehörige Variable unter "verknüpfte Variable". Hier können Sie ebenfalls die Verknüpfung / Assoziation zu einer anderen Variable ändern. Wir empfehlen jedoch, diese Option mit besonderer Sorgfalt zu verwenden. Bei 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, benutzerdefinierte Variablen zu erstellen, 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 Indices 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 diskutierten skalar Variablen. Denken Sie an ein Array als eine Spalte in einer Tabelle: es hä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 Einträge manuell mit dem Plus-Symbol hinzufügen.

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

Data Frame Variablen

Data Frames unterscheiden sich von Arrays insofern, als dass ein Array eine Spalte eines Blattes ist, ein Data Frame jedoch ein ganzes Blatt mit mehreren Spalten ist. Data Frames können String (Text), numeric, boolean oder file-Werte speichern, können aber nicht direkt im Dialogfenster des Data Frames bearbeitet werden. Sie können Spalten und Dateien hinzufügen, aber keinen Text oder Zahlen eingeben:

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

Wählen Sie alle zutreffenden Optionen:

• Zeichenfolgen den Dateien zuordnen ermöglicht es Ihnen, die Namen Ihrer Dateien als Zeichenfolgen einzuschließen und dann die Zuordnungsfunktion zu verwenden, um auf den Ordner zu verweisen, in dem die Dateien gespeichert sind. Dadurch kann diese Spalte von Dateinamen nach den entsprechenden Dateien in einem Ordner suchen, vorausgesetzt, die Werte im Data Frame 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 Header verwenden nimmt die Werte in der ersten Zeile Ihres Data Frames und verwendet sie als Variablennamen für jede der Spalten.
• Daten transponieren lädt einfach den Data Frame so hoch, wie er ist. Dies ist nützlich, wenn Ihr Data Frame keine Dateinamen enthält.

Wenn Ihr Data Frame vollständig aus Zeichenfolgenwerten besteht, die den Namen von Dateien in einem Ordner entsprechen, können Sie den gesamten Data Frame einem Ordner zuteilen, indem Sie die Funktion alle Zeichenfolgen den Dateien zuordnen verwenden.

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

Für eine Liste von Aktionen, die mit Data Frames verbunden sind, siehe Data Frame Operationen

Variablenreferenzen und Löschen von Variablen

Um einen besseren Überblick darüber zu geben, wo jede Variable verwendet wird, gibt es eine Liste namens VERWENDET IN am Ende des Variablen-Eigenschaftspanels. Hier werden alle Verwendungen der Variablen aufgelistet, einschließlich eines Verweises auf den Rahmen, in dem die Variable verwendet wird (Name), für welchen 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, gibt es einen zusätzlichen Eintrag in der Verwendungstabelle mit einem "Verwendungstyp", der als "lokaler Arbeitsbereich" bezeichnet wird. Alle Variablen im lokalen Arbeitsbereich eines Rahmens werden dann im Abschnitt "lokale Variablen" im Variablenauswahmenü 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 im Ereignis verwendet werden, kann zu ernsthaften Problemen führen und (im schlimmsten Fall) die gesamte Experimentstruktur stören. Daher können im Variablen-Tab nur diejenigen Variablen gelöscht werden, die keine bezogene Verwendung haben, abgesehen davon, dass sie sich in einem (oder mehreren) lokalen Arbeitsbereichen befinden. Variablen, die nur im lokalen Arbeitsbereich definiert sind (ohne weitere Verwendung), werden als ungenutzt aufgeführt, und ein Löschsymbol wird neben ihnen angezeigt.

Variablenauswahlmenü

Die benutzerkontrollierte Verwendung von Variablen basiert hauptsächlich auf Ereignislogik. Innerhalb des Ereignissystems gibt es 3 (visuell) verschiedene Menüs, die es Ihnen ermöglichen, eine Variable auszuwählen: 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 Variablen-Auswahlmenü), um eine Variable auszuwählen.

Insgesamt enthält das Variablen-Auswahlmenü 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" werden alle Variablen in der globalen Liste der Studie aufgelistet und können ausgewählt werden. Beide Menüs haben eine Suchfunktion, um direkt eine gewünschte Variable 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 Benutzer ein Kontrollkästchen 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 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 Ereignislogik zur Aufzeichnung der Reaktionszeit:

1. Fügen Sie ein Bild zum Rahmen 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. Beispielweise: Wählen Sie --> Benutzer-Eingabe --> Maus-Auslöser. Setzen Sie die Auslöseraktion als Klick und die Schaltfläche als Links. Klicken Sie auf das "+"-Zeichen neben Ziele hinzufügen, um das Bild als anklickbares Ziel hinzuzufügen. Klicken Sie auf Weiter am unteren Rand des Fensters.
4. Wählen Sie die Aktion Variablenaktionen --> Setzen / Aufzeichnen Variable. 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 = true, Aufzeichnen = true). Klicken Sie auf "Ok."
6. Klicken Sie auf das Wert-Auswahl (Stift)-Symbol --> Auslöser (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 die Entscheidung (welches Bild aus einer Auswahl angeklickt wurde) usw. aufzuzeichnen.