Illustration de style graphique montrant des points de données continus enregistrés au fil du temps au cours d'un essai, représentant des données de suivi de souris ou de signaux physiologiques

Variables de séries temporelles

Une variable de séries temporelles enregistre chaque changement de valeur durant un essai, chaque changement étant associé à 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éries temporelles chaque fois que vous devez suivre quelque chose qui évolue continuellement dans 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éries temporelles

L'enregistrement des séries temporelles est contrôlé par deux propriétés de variables :

Dans le panneau de 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é pour que les données soient incluses dans votre exportation.

Pour les variables qui contiennent des coordonnées ou des tableaux de valeurs (telles que les 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 comment les valeurs dupliquées consécutives 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 dupliquées consécutives 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 sont par défaut record changes only, et les variables de tableau sont par défaut record all. Cela correspond au motif 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 temporelle complète et uniformément espacée, indépendamment de la variation de la valeur entre les échantillons, par exemple lors de l'échantillonnage à un intervalle fixe via une boucle.

En-têtes de colonne

Lorsqu'une variable de séries temporelles 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 attribuer une étiquette descriptive à chaque position d'index 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'index est affiché automatiquement ; tapez le texte d'étiquette pour cette position. Répétez pour chaque index que le tableau contient.

Les en-têtes apparaissent comme des noms de colonne dans le fichier d'exportation de séries temporelles 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'index 1 comme x et l'index 2 comme y pour un tableau de coordonnées.

Comment les données de séries temporelles 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 temporelles.

Sortie de données

Les variables de séries temporelles sont exportées séparément des données régulières au niveau de l'essai. Dans l'onglet Dataview & Export, 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 temporelles : une ligne par échantillon enregistré, avec une colonne d'horodatage.

Dans l'exportation de séries temporelles, vous pouvez choisir de combiner toutes les variables de séries temporelles en un seul fichier (organisé par temps, alternant les lignes par variable) ou d'exporter un fichier séparé pour chaque variable. Un fichier séparé par variable est plus facile à travailler 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 continuellement pendant 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 des yeux : Les variables de coordonnées de regard créées par le système de suivi des yeux sont des séries temporelles 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) s'enregistrent sous forme de séries temporelles afin que le signal complet soit préservé durant 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 de séries temporelles.