
Objet de Segmentation de Texte
L'Objet de Segmentation de Texte divise une phrase en une zone d'intérêt par mot. Liez un téléchargement CSV, un cadre de données existant ou une variable de tableau comme source de texte, une phrase par essai, et chaque mot obtient automatiquement sa propre boîte mesurée, sans placement manuel d'AOI. Avec le suivi oculaire via webcam activé, il enregistre également cinq métriques de regard par mot.
Table des Matières
Ajout de l'Objet de Segmentation de Texte
Dans la barre d'outils de l'éditeur de tâches, ouvrez le groupe Text et sélectionnez Text Segmentation Object pour l'ajouter au cadre actuel. Il se trouve à côté de Display Text, Display HTML, et Display Variable.

Assistant de Configuration de Segmentation de Texte
Ajouter l'objet ouvre un assistant de configuration avec deux écrans : le premier définit la source de texte, le second demande comment la ligne est sélectionnée et ce qu'il faut enregistrer.
Premier écran : définir la source de texte. Choisissez l'une des trois options :

| Option | Ce que cela fait |
|---|---|
Upload a CSV file of sentences | Analyse le fichier dans un nouveau cadre de données, une ligne affichée par essai. |
Assign text from a variable | Lien vers un cadre de données existant, ou un tableau contenant les mots d'un essai. |
Do not set the text source | Ferme l'assistant sans lier quoi que ce soit ; définissez-en un plus tard via Set Text Source… dans les Propriétés de l'Objet. |
Sélectionner un fichier pour l'option CSV ouvre une boîte de dialogue Additional Options avec trois cases à cocher, toutes décochées par défaut : Map strings to files (non pertinent ici, car les cellules contiennent du texte brut plutôt que des noms de fichiers), Use first row as header (cochez ceci uniquement si la première ligne nomme les colonnes au lieu de contenir la première phrase), et Transpose data (cochez ceci si les phrases s'étendent sur les colonnes plutôt que sur les lignes).
Deuxième écran : index de ligne et enregistrement. Cet écran s'ouvre une fois qu'une source est liée, la confirmant sous Text is read from:. Pour une source de cadre de données, il demande également comment la ligne (phrase) est sélectionnée par essai :
| Option | Comportement |
|---|---|
Utiliser Trial_Id comme index de ligne | Ordre aléatoire, déterminé par la randomisation de l'expérience. |
Utiliser Trial_Nr comme index de ligne | Ordre fixe, correspondant à la séquence des essais. |
| Sélectionner une variable comme index de ligne | Utilisez n'importe quelle variable personnalisée pour contrôler quelle ligne s'affiche. |
Une source de tableau saute entièrement cette question, puisque le tableau contient déjà directement les mots d'un essai. L'écran demande ensuite ce qu'il faut enregistrer. Consultez Intégration des Événements pour ce que chaque case à cocher crée et un aperçu des données résultantes.

| Case à cocher | Par défaut | Ce que cela crée |
|---|---|---|
Record the x, y, width and height of every word on each trial | Coché | Une variable de cadre de données et un événement qui écrit la géométrie de l'AOI au début de chaque cadre. |
Record eyetracking metrics for every word on each trial | Décoche | Une variable de cadre de données et un événement qui écrit le temps de séjour, les comptes de fixation, et le minutage à la fin de chaque cadre. |
Note
Cocher Record eyetracking metrics for every word on each trial active également la détection des fixations pour toute la tâche et définit les fixations pour se conclure à la fin du cadre, afin que la dernière fixation sur un mot soit complète au moment où les métriques sont écrites. Les deux changements s'appliquent à la tâche entière, pas seulement à cet objet, et l'assistant indique cela avant que vous n'optez pour cela.
Une fois configuré, l'objet rend un mot par cellule et commence à enregistrer automatiquement :

Propriétés de l'Objet
Tous les paramètres ci-dessous se trouvent dans le panneau Propriétés de l'Objet lorsque l'Objet de Segmentation de Texte est sélectionné.
| Propriété | Description |
|---|---|
Text Source | Le CSV, cadre de données, ou variable de tableau liée. Cliquez sur Set Text Source… pour la relier. |
Row Index | La variable contrôlant quelle ligne (phrase) s'affiche sur l'essai actuel. |
Row Index Offset | Ajouté à la valeur de l'index de ligne. Les numéros de ligne sont basés sur 1 dans Labvanced, donc la valeur par défaut de -1 attribue le premier essai à la première ligne. Ne changez cela que si votre variable de ligne est comptée différemment. |
Preview Row | Sources de cadre de données uniquement. Quelle phrase dessiner sur le canevas lors de la modification ; n'affecte pas ce que voient les participants, puisque cela dépend de la randomisation. |
Recorded Into | La variable de cadre de données recevant les propres données liées de l'objet. |
Split cells on whitespace | Désactivé par défaut lorsque la feuille de calcul contient déjà un mot par colonne. Activez pour diviser le texte de chaque cellule en mots séparés automatiquement. |
Layout | Flow emballe les mots à la largeur de l'élément et enregistre la propre boîte glyph de chaque mot. Grid place les mots dans des colonnes de largeur égale et enregistre toute la cellule, de sorte que les AOIs tuilent l'élément sans écarts ni chevauchements. |
Max Rows | Le nombre maximum de lignes enveloppées que l'élément permet avant d'afficher un avertissement dans l'éditeur. |
Columns | Disposition de Grille uniquement. Mots par ligne. 0 utilise le minimum de colonnes nécessaires pour adapter le texte dans Max Rows. |
Word Alignment | Disposition de Grille uniquement. Alignement horizontal et vertical des glyphes de chaque mot à l'intérieur de sa cellule. Ne change pas l'AOI enregistré, qui est toujours la cellule entière. |
Gap Between Cells / Margin Between Words | Espacement X et Y, en unités de cadre. Étiqueté Gap Between Cells dans la disposition de grille, Margin Between Words dans la disposition de flux. |
AOI Padding | Disposition de Flux uniquement. Élargit la boîte enregistrée de chaque mot au-delà de ses glyphes, en unités de cadre par côté. Non disponible dans la disposition de grille, où élargir la boîte chevaucherait la cellule du mot suivant. |
Font | Famille de polices, taille, et couleur pour les mots rendus. |
Sentence Alignment | Disposition de Flux uniquement. Alignement horizontal et vertical de l'ensemble de la phrase à l'intérieur de l'élément. |
Show AOI boxes in player | Lorsqu'il est coché, dessine la boîte AOI de chaque mot à l'écran pendant l'étude, utile pour vérifier la couverture lors de la création. |
Stimulus Info | Champ de texte libre pour des notes sur le stimulus actuel, non affichées aux participants. |
Liaison d'une Source de Texte
Le chemin CSV-vers-cadre-de-données est le moyen le plus rapide d'importer un ensemble de stimuli existant, que ce soit via le premier pas de l'assistant de configuration ou plus tard via Set Text Source… dans les Propriétés de l'Objet : une feuille de calcul avec une phrase par ligne et, avec Split cells on whitespace désactivé, un mot par colonne, les longueurs de ligne irrégulières sont supportées, les lignes plus courtes ayant simplement moins de mots mesurés. Un signe de ponctuation final peut rester attaché au dernier mot de la phrase comme sa propre cellule.
Lier un cadre de données existant fonctionne de la même manière une fois que le cadre de données existe déjà dans l'expérience, utile lorsque le même ensemble de stimuli alimente plusieurs objets. Une variable de tableau est l'option la plus simple pour une étude d'une seule phrase, puisqu'elle saute complètement l'étape du cadre de données.
Intégration des Événements
Deux actions dédiées enregistrent les données de l'objet. Les deux ont besoin d'un Target (l'élément de cadre contenant l'Objet de Segmentation de Texte) et d'un Variable (le cadre de données recevant le tableau). Les deux actions sont créées automatiquement si vous cochez la case correspondante dans l'assistant de configuration.
| Action | Ce qu'elle enregistre | Quand la déclencher |
|---|---|---|
Record Text Segment AOIs | Géométrie des mots, lignes et position/taille, une ligne par mot. | Généralement au début du cadre, re-mesure les mots rendus pour que le tableau corresponde à ce qui était à l'écran. |
Record Text Segment Eyetracking Metrics | Temps de séjour, total des fixations, durée totale des fixations, temps jusqu'à la première fixation, et durée moyenne de fixation, une ligne par mot. | À la fin du cadre, une fois que les fixations du cadre sont finales. Nécessite le suivi oculaire via webcam activé. |
Un mot qui n'a jamais été fixé garde sa ligne dans le tableau des métriques avec des zéros dans chaque colonne, plutôt qu'une cellule vide. Filtrez sur total_fixations > 0 avant de faire la moyenne d'une colonne temporelle, puisqu'un zéro ne distingue pas "jamais regardé" de "fixé exactement au début du cadre."
Un exemple des événements ajoutés autour d'une étude de lecture utilisant l'Objet de Segmentation de Texte avec suivi oculaire par webcam, pour progresser entre les essais, peut être vu dans Étape 5 : Configurer la Progression des Essais du guide accompagnateur.
Aperçu des Données
Les images suivantes représentent les données captées par ces deux événements automatisés.

Matériaux Ouverts et Exemples d'Études
Voir l'Objet de Segmentation de Texte dans une étude réelle : dix phrases, une par essai, avec la géométrie AOI par mot et les métriques de suivi oculaire enregistrées automatiquement.
Lectures Supplémentaires
Technologie de Segmentation de Texte
Vue d'ensemble de la capacité : mécanisme, sortie de données, et cas d'utilisation en recherche.
Construire une Étude de Lecture
Une véritable étude de lecture sur la fréquence des mots construite étape par étape avec cet objet.
Tous les Objets
Un index complet de tous les objets disponibles dans l'éditeur d'expérience Labvanced.