Variables de série chronologique

Une variable de série chronologique enregistre chaque changement de valeur pendant un essai, chacune associée à un horodatage. Cela diffère du mode d'enregistrement par défaut, qui ne capture que la valeur finale à la fin d'un essai.

Utilisez des variables de série chronologique chaque fois que vous devez suivre quelque chose qui évolue de manière continue au cours d'un essai : coordonnées de regard, position de la souris, valeurs de signaux physiologiques ou toute réponse qui change au fil du temps plutôt que de produire un seul résultat discret.

Configuration d'une variable de série chronologique

L'enregistrement de séries chronologiques est contrôlé par deux propriétés de variable :

Dans le panneau des propriétés de la variable, définissez Record Type sur All changes / time series. Cela indique à Labvanced d'enregistrer chaque changement de valeur avec un horodatage plutôt que d'attendre la fin de l'essai.
Assurez-vous que Record Variable est activé afin que les données soient incluses dans votre exportation.

Pour les variables qui contiennent des coordonnées ou des tableaux de valeurs (comme les coordonnées x/y de regard), définissez Format sur Array. Pour des mesures continues uniques (comme la position d'un curseur), Scalar est approprié.

Méthode d'échantillonnage

Lorsque Record Type est défini sur All changes / time series, une option Sampling method apparaît dans le panneau des propriétés de la variable. Elle contrôle la manière dont les valeurs consécutives en double sont gérées.

Option	Description
`record changes only (no repeated duplicates)`	Enregistre un nouveau point de données uniquement lorsque la valeur change. Les valeurs consécutives en double sont ignorées.
`record all (allow repeated duplicates)`	Enregistre un point de données à chaque intervalle d'échantillonnage, y compris les valeurs répétées.

La valeur par défaut dépend du format de la variable : les variables scalaires par défaut à record changes only, et les variables de tableau par défaut à record all. Cela correspond au modèle d'utilisation le plus courant pour chaque type.

Utilisez record changes only lorsque votre variable se met à jour rarement et que vous souhaitez minimiser le volume de données. Utilisez record all lorsque vous avez besoin d'une série chronologique complète et régulièrement espacée, quel que soit le fait que la valeur change entre les échantillons, par exemple lors de l'échantillonnage à un intervalle fixe via une boucle.

En-têtes de colonnes

Lorsque une variable de série chronologique a Format défini sur Array, une section Column Headers apparaît dans le panneau des propriétés de la variable. Utilisez-la pour assigner une étiquette descriptive à chaque position d'indice dans le tableau.

Cliquez sur + Add à côté de l'étiquette Column Headers pour ajouter une entrée d'en-tête. Le numéro d'indice est affiché automatiquement ; tapez le texte de l'étiquette pour cette position. Répétez pour chaque indice que le tableau contient.

Les en-têtes apparaissent comme des noms de colonnes dans le fichier d'exportation de séries chronologiques pour cette variable. Cela rend les données exportées plus faciles à lire lorsque chaque position de tableau a une signification distincte, par exemple en étiquetant l'indice 1 comme x et l'indice 2 comme y pour un tableau de paires de coordonnées.

Comment les données de série chronologique sont enregistrées

Chaque fois que la valeur de la variable change (ou à chaque échantillon, selon la méthode d'échantillonnage), Labvanced stocke :

La valeur de la variable à ce moment-là
Un horodatage relatif à l'essai

Cela produit une ligne par échantillon dans l'exportation, plutôt qu'une ligne par essai. Les essais avec de nombreux échantillons produiront de nombreuses lignes dans l'exportation de séries chronologiques.

Sortie de données

Les variables de série chronologique sont exportées séparément des données au niveau des essais réguliers. Dans l'onglet Vue des données & Exportation, il y a deux téléchargements de données :

Données régulières : une ligne par essai, capturant les valeurs finales des variables standard.
Données de séries chronologiques : une ligne par échantillon enregistré, avec une colonne d'horodatage.

Dans l'exportation de séries chronologiques, vous pouvez choisir de combiner toutes les variables de séries chronologiques en un seul fichier (organisé par temps, avec des lignes alternées par variable) ou d'exporter un fichier séparé pour chaque variable. Un fichier séparé par variable est plus facile à manipuler lorsque les variables ont des taux d'échantillonnage différents.

Cas d'utilisation courants

Suivi de la souris : Enregistrez la position x/y de la souris de manière continue au cours d'un essai en définissant une variable de tableau numérique sur All changes / time series et en utilisant un événement avec un déclencheur Mouse Move pour écrire la position actuelle à chaque mouvement.

Suivi oculaire : Les variables de coordonnées de regard créées par le système de suivi oculaire sont des séries chronologiques par défaut. Chaque échantillon de regard est stocké avec son horodatage, permettant une analyse image par image des fixations et des chemins de balayage.

Signaux physiologiques : Les variables recevant des entrées physiologiques continues (fréquence cardiaque, position de la tête) enregistrent en tant que séries chronologiques afin que le signal complet soit préservé tout au long de la durée de l'essai.

Curseur ou réponse continue : Si un participant déplace un curseur tout au long d'un essai et que vous souhaitez capturer la trajectoire, pas seulement la position finale, définissez la variable liée sur l'enregistrement en série chronologique.