Textsegmentierungsobjekt
Das Textsegmentierungsobjekt teilt einen Satz in ein Bereichsübergreifendes Interessensgebiet pro Wort auf. Verlinken Sie einen CSV-Upload, einen bestehenden Datenrahmen oder eine Arrayvariable als Textquelle, einen Satz pro Versuch, und jedes Wort erhält automatisch seinen eigenen gemessenen Bereich, ohne manuelle AOI-Platzierung. Mit aktivierter Webcam-Blickverfolgung werden außerdem fünf Blickmetriken pro Wort aufgezeichnet.
Inhaltsverzeichnis
Hinzufügen des Textsegmentierungsobjekts
Öffnen Sie in der Aufgabeneditor-Symbolleiste die Text-Gruppe und wählen Sie Text Segmentation Object aus, um es zum aktuellen Frame hinzuzufügen. Es befindet sich neben Display Text, Display HTML und Display Variable.
Einrichtungsassistent für Textsegmentierung
Das Hinzufügen des Objekts öffnet einen Einrichtungsassistenten mit zwei Bildschirmen: Der erste legt die Textquelle fest, der zweite fragt, wie die Zeile ausgewählt wird und was aufgezeichnet werden soll.
Erster Bildschirm: Textquelle festlegen. Wählen Sie eine der drei Optionen:
| Option | Was es tut |
|---|---|
Upload a CSV file of sentences | Parsed die Datei in einen neuen Datenrahmen, eine Zeile pro Versuch. |
Assign text from a variable | Verlinkt einen bestehenden Datenrahmen oder ein Array, das die Wörter eines Versuchs enthält. |
Do not set the text source | Schließt den Assistenten, ohne etwas zu verlinken; stellen Sie später über Set Text Source… in den Objekteigenschaften einen ein. |
Die Auswahl einer Datei für die CSV-Option öffnet einen Additional Options-Dialog mit drei Kontrollkästchen, die standardmäßig alle nicht aktiviert sind: Map strings to files (hier irrelevant, da die Zellen reinen Text und keine Dateinamen enthalten), Use first row as header (dies nur aktivieren, wenn die erste Zeile die Spalten statt den ersten Satz benennt), und Transpose data (dies aktivieren, wenn Sätze über Spalten anstatt über Zeilen laufen).
Zweiter Bildschirm: Zeilenindex und Aufzeichnung. Dieser Bildschirm öffnet sich, sobald eine Quelle verlinkt ist, um sie unter Text is read from: zu bestätigen. Bei einer Datenrahmenquelle wird außerdem gefragt, wie die Zeile (Satz) pro Versuch ausgewählt wird:
| Option | Verhalten |
|---|---|
Verwenden Sie Trial_Id als Zeilenindex | Zufällige Reihenfolge, die durch die Randomisierung des Experiments bestimmt wird. |
Verwenden Sie Trial_Nr als Zeilenindex | Feste Reihenfolge, die mit der Versuchsreihenfolge übereinstimmt. |
| Wählen Sie eine Variable als Zeilenindex aus | Verwenden Sie jede benutzerdefinierte Variable, um zu steuern, welche Zeile angezeigt wird. |
Eine Arrayquelle überspringt diese Frage vollständig, da ein Array bereits die Wörter eines Versuchs direkt enthält. Der Bildschirm fragt dann, was aufgezeichnet werden soll. Siehe Ereignisintegration für das, was jedes Kontrollkästchen erzeugt und eine Vorschau der resultierenden Daten.
| Kontrollkästchen | Standard | Was es erzeugt |
|---|---|---|
Record the x, y, width and height of every word on each trial | Aktiviert | Eine Datenrahmen-Variable und ein Ereignis, das die AOI-Geometrie zu Beginn jedes Frames schreibt. |
Record eyetracking metrics for every word on each trial | Deaktiviert | Eine Datenrahmen-Variable und ein Ereignis, das die Verweildauer, Fixationszahlen und Timing am Ende jedes Frames schreibt. |
Hinweis
Das Aktivieren von Record eyetracking metrics for every word on each trial aktiviert auch die Fixationsdetektion für die gesamte Aufgabe und legt fest, dass Fixationen am Ende des Frames enden, sodass die letzte Fixation auf einem Wort abgeschlossen ist, wenn die Metriken aufgezeichnet werden. Beide Änderungen gelten rahmenweit, nicht nur für dieses Objekt, und der Assistent weist dies darauf hin, bevor Sie zustimmen.
Sobald es eingerichtet ist, rendert das Objekt ein Wort pro Zelle und beginnt automatisch mit der Aufzeichnung:
Objekteigenschaften
Alle untenstehenden Einstellungen finden Sie im Objekteigenschaften-Panel, wenn das Textsegmentierungsobjekt ausgewählt ist.
| Eigenschaft | Beschreibung |
|---|---|
Text Source | Die verlinkte CSV-, Datenrahmen- oder Arrayvariable. Klicken Sie auf Set Text Source…, um sie erneut zu verlinken. |
Row Index | Die Variable, die steuert, welche Zeile (Satz) im aktuellen Versuch angezeigt wird. |
Row Index Offset | Wird zum Zeilenindexwert hinzugefügt. Zeilennummern sind in Labvanced 1-basiert, sodass der Standardwert -1 den ersten Versuch der ersten Zeile zuordnet. Ändern Sie dies nur, wenn Ihre Zeilenvariable anders gezählt wird. |
Preview Row | Nur Datenrahmenquellen. Welchen Satz soll beim Bearbeiten auf die Leinwand gezeichnet werden; hat keinen Einfluss darauf, was die Teilnehmer sehen, da dies von der Randomisierung abhängt. |
Recorded Into | Die Datenrahmenvariable, die die eigenen verlinkten Daten des Objekts erhält. |
Split cells on whitespace | Standardmäßig deaktiviert, wenn die Tabelle bereits ein Wort pro Spalte enthält. Aktivieren, um den Text jeder Zelle automatisch in separate Wörter zu unterteilen. |
Layout | Flow umschließt Wörter in der Breite des Elements und zeichnet den eigenen Glyphenbox jedes Wortes auf. Grid platziert Wörter in gleichbreiten Spalten und zeichnet die gesamte Zelle auf, sodass AOIs das Element ohne Lücken oder Überlappungen abdecken. |
Max Rows | Die maximale Anzahl an umgebrochenen Zeilen, die das Element zulässt, bevor eine Warnung im Editor angezeigt wird. |
Columns | Nur Rasterlayout. Wörter pro Zeile. 0 verwendet so wenige Spalten, wie es dem Text innerhalb von Max Rows entspricht. |
Word Alignment | Nur Rasterlayout. Horizontale und vertikale Ausrichtung der Glyphen jedes Wortes innerhalb seiner Zelle. Ändert nicht das aufgezeichnete AOI, das immer die gesamte Zelle ist. |
Gap Between Cells / Margin Between Words | X- und Y-Abstand, in Frame-Einheiten. In Rasterlayout Gap Between Cells, im Flusslayout Margin Between Words. |
AOI Padding | Nur Flusslayout. Vergrößert die aufgezeichnete Box jedes Wortes über seine Glyphen hinaus, in Frame-Einheiten pro Seite. Nicht verfügbar im Rasterlayout, wo das Vergrößern der Box die Zelle des nächsten Wortes überlappen würde. |
Font | Schriftfamilie, Größe und Farbe für die gerenderten Wörter. |
Sentence Alignment | Nur Flusslayout. Horizontale und vertikale Ausrichtung des gesamten Satzes innerhalb des Elements. |
Show AOI boxes in player | Wenn aktiviert, wird das AOI-Box jedes Wortes während der Studie auf dem Bildschirm gezeichnet, nützlich zum Überprüfen der Abdeckung während des Aufbaus. |
Stimulus Info | Freitextfeld für Notizen über den aktuellen Stimulus, wird den Teilnehmern nicht angezeigt. |
Verlinken einer Textquelle
Der CSV-zu-Datenrahmen-Weg ist der schnellste Weg, ein bestehendes Stimulus-Set einzubringen, sei es durch den ersten Schritt des Einrichtungsassistenten oder später durch Set Text Source… in den Objekteigenschaften: eine Tabelle mit einem Satz pro Zeile und, mit Split cells on whitespace deaktiviert, ein Wort pro Spalte, wobei unregelmäßige Zeilenlängen unterstützt werden, kürzere Zeilen einfach weniger Wörter haben. Ein nachfolgendes Satzzeichen kann am letzten Wort des Satzes angehängt bleiben, als eigenen Zelle.
Das Verlinken eines bestehenden Datenrahmens funktioniert auf die gleiche Weise, sobald der Datenrahmen bereits im Experiment existiert, nützlich, wenn dasselbe Stimulus-Set mehrere Objekte speist. Eine Arrayvariable ist die einfachste Option für eine Studie mit einem einzelnen Satz, da sie den Datenrahmen-Schritt vollständig überspringt.
Ereigisintegration
Zwei spezielle Aktionen zeichnen die Daten des Objekts auf. Beide benötigen ein Target (das Rahmen-Element, das das Textsegmentierungsobjekt hält) und ein Variable (den Datenrahmen, der die Tabelle erhält). Beide Aktionen werden automatisch erstellt, wenn Sie das entsprechende Kontrollkästchen im Einrichtungsassistenten markieren.
| Aktion | Was sie aufzeichnet | Wann sie ausgelöst wird |
|---|---|---|
Record Text Segment AOIs | Wort-, Zeilen- und Position/Größengeometrie, eine Zeile pro Wort. | Typischerweise zu Beginn des Frames, misst erneut die gerenderten Wörter, sodass die Tabelle dem entspricht, was auf dem Bildschirm war. |
Record Text Segment Eyetracking Metrics | Verweildauer, Gesamtanzahl der Fixationen, Gesamtdauer der Fixationen, Zeit bis zur ersten Fixation und mittlere Fixationsdauer, eine Zeile pro Wort. | Am Ende des Frames, sobald die Fixationen des Frames endgültig sind. Benötigt aktivierte Webcam-Blickverfolgung. |
Ein Wort, das niemals fixiert wurde, behält seine Zeile in der Metriktabelle bei, mit Nullen in jeder Spalte, statt einer leeren Zelle. Filtern Sie auf total_fixations > 0, bevor Sie eine Zeitspalte durchschnittlich berechnen, da eine Null nicht zwischen "nie angesehen" und "genau bei Beginn des Frames fixiert" unterscheidet.
Ein Beispiel für die um die Lesestudie hinzugefügten Ereignisse unter Verwendung des Textsegmentierungsobjekts mit Webcam-Blickverfolgung, um zwischen den Versuchen voranzuschreiten, kann in Schritt 5: Einrichtung des Versuchsfortschritts des Begleit-Walkthroughs gesehen werden.
Datenvorschau
Die folgenden Bilder stellen die von diesen beiden automatisierten Ereignissen erfassten Daten dar.
Offene Materialien und Studienbeispiele
Sehen Sie das Textsegmentierungsobjekt in einer echten Studie: zehn Sätze, einer pro Versuch, mit automatisch aufgezeichneten AOI-Geometrien pro Wort und Blickverfolgemetriken.
Weiterführende Literatur
Übersicht über die Textsegmentierungstechnologie
Die Fähigkeit Übersicht: Mechanismus, Datenoutput und Nutzungsmöglichkeiten in der Forschung.
Eine Lesestudie erstellen
Eine echte Wortfrequenzlesestudie, die Schritt für Schritt mit diesem Objekt aufgebaut wurde.
Alle Objekte
Ein vollständiges Verzeichnis aller im Labvanced-Experimenteditor verfügbaren Objekte.