Annotations du graphique

Un graphique permet de mettre en évidence un changement. Il ne peut toutefois pas vous expliquer pourquoi. C'est dans les annotations du graphique que vous pouvez noter ces informations : cliquez sur un point du graphique Dashboard et indiquez ce qui s'est passé, afin de pouvoir, le mois prochain, comprendre à quoi correspondait ce pic.

Une annotation est associée à une mesure prise à un moment donné, et non à un graphique en particulier. Si vous ajoutez une annotation à votre glycémie, celle-ci apparaîtra sur tous les graphiques représentant cette glycémie, quelle que soit la précision affichée par le graphique.

Rédiger une annotation

Cliquez sur n'importe quel point du graphique. Une petite fenêtre s'ouvre alors, affichant la date, la valeur correspondante à ce point, ainsi qu'un champ pour saisir votre annotation. Saisissez ce qui s'est passé, puis cliquez sur « Enregistrer ».

La date enregistrée correspond à la tranche sur laquelle vous avez cliqué, et non au moment où vous avez cliqué dessus. Une annotation ajoutée sur un graphique mensuel concerne ce mois-là ; elle reste donc à l'endroit où vous l'avez placée, au lieu de se déplacer vers la date d'aujourd'hui.

Vous pouvez ajouter plusieurs annotations au même endroit. Ouvrez-le à nouveau : une nouvelle zone d'annotation s'affiche alors sous celles qui existent déjà.

Où apparaissent vos annotations ?

Les annotations apparaissent sous forme de petits carrés dans une colonne située sous le graphique, alignés sur le point auquel elles se rapportent. Passez la souris sur un carré pour lire l'intégralité de l'annotation, ou cliquez dessus pour la modifier ou la supprimer.

Lorsque plusieurs annotations sont très proches les unes des autres, elles fusionnent en une seule icône indiquant leur nombre. Cliquez dessus et l'éditeur les répertorie toutes ; ainsi, une semaine chargée ne se traduit pas par une rangée d'icônes empilées les unes sur les autres.

Une annotation par graphique

Les annotations suivent la mesure. Il en découle deux choses, toutes deux intentionnelles :

• Une annotation ajoutée sur un graphique journalier apparaît également sur les graphiques hebdomadaires ou mensuels de la même échelle, dans le groupe qui la contient. Il suffit de l'ajouter une seule fois pour qu'elle s'affiche partout où vous consultez ces données.
• Les unités n'ont pas d'importance. Une annotation inscrite en miles sur un graphique apparaît également sur un graphique de même mesure exprimé en kilomètres, et une annotation concernant le glucose mg/dL apparaît sur le graphique mmol/L.

Notes prises lors de la lecture

Certaines mesures provenant de vos sources sont accompagnées d'un commentaire, et pour les mesures qui enregistrent une seule valeur, telles que le glucose, l'oxygène et la température, ce commentaire s'affiche également sous forme d'annotation.

Ces éléments sont indiqués comme faisant partie intégrante de la mesure elle-même, car ils font partie de la valeur relevée et ne constituent pas une annotation inscrite sur le graphique. Pour en modifier un, modifiez la valeur relevée dans votre FitnessSyncer Notebook. Vous pouvez toujours ajouter votre propre annotation au même point.

Quels graphiques permettent d'ajouter des annotations ?

Tout graphique dont l'axe horizontal représente le temps (graphiques linéaires, graphiques en aires, graphiques linéaires avec échelles, graphiques à colonnes, graphiques à colonnes empilées, graphiques en flux et diagrammes en boîte) peut comporter des annotations.

Les graphiques dont l'axe des abscisses ne représente pas le temps ne le permettent pas, car il n'y a pas de date à laquelle associer une annotation. Cela concerne les nuages de points, les histogrammes, les cartes thermiques, le graphique « Jour », les graphiques circulaires et en anneau, les jauges et les vignettes KPI.

Les mesures calculées ne peuvent pas non plus faire l'objet d'annotations. Une valeur estimée d'A1C, un pourcentage dans la fourchette cible ou un déficit de sommeil sont calculés à partir d'autres mesures plutôt que d'être enregistrés directement ; il n'y a donc pas de mesure sur laquelle ajouter un commentaire. Écrivez plutôt votre annotation sur les mesures situées en dessous.

Si vous préférez qu'un graphique en particulier n'affiche pas d'annotations et que vous êtes un utilisateur FitnessSyncer Pro, ouvrez les paramètres du graphique dans l'éditeur Dashboard et désactivez-les pour ce graphique.

Vos annotations

L'icône d'annotations , située dans la barre d'outils Dashboard, ouvre la fenêtre « Vos annotations », qui répertorie toutes les annotations que vous avez rédigées dans un tableau, par centaines.

La date et le texte sont tous deux modifiables à cet endroit. Modifiez une cellule, cliquez sur « Enregistrer », et l'annotation se déplace ou s'affiche différemment partout où elle apparaît. La mesure à laquelle appartient une annotation ne peut pas être modifiée, car cela la déplacerait vers des graphiques que vous n'avez pas choisis.

Exportation et importation

La section « Vos annotations » comporte également un bouton « Exporter » et une liste déroulante permettant d'importer des données ; vous pouvez ainsi conserver une copie de vos annotations ou en rédiger plusieurs à la fois ailleurs, puis les importer.

La fonction « Exporter » télécharge chaque annotation sous forme de fichier CSV comportant quatre colonnes :

• Date : date à laquelle l'annotation s'applique, exprimée au format ISO pour la date et l'heure en UTC.
• DataField : la mesure à laquelle se rapporte l'annotation, sous la forme FitnessSyncer utilisée en interne, par exemple GLUCOSE_MMOL_PER_L.
• Mesure : nom lisible de cette mesure. Cette colonne est destinée à vous faciliter la lecture du fichier et n'est pas prise en compte lors de l'importation.
• Remarque : votre texte.

La fonction « Importer » lit un fichier présentant la même structure. Une annotation est identifiée par sa date et sa mesure plutôt que par un identifiant ; ainsi, un fichier que vous avez exporté, modifié puis réimporté met à jour les annotations qu’il décrit, au lieu d’en créer une deuxième copie pour chacune d’entre elles.

Une ligne illisible n'entraîne pas l'arrêt du fichier. Une ligne contenant une mesure FitnessSyncer non reconnue, une date impossible à analyser ou une annotation vide est ignorée. L'importation vous indique le nombre de lignes créées, mises à jour et ignorées, ainsi que leur numéro. Les annotations de plus de mille caractères sont raccourcies plutôt que rejetées.

Dans les applications

Les annotations apparaissent sur les graphiques dans les applications FitnessSyncer pour iOS et Android ; elles y sont en lecture seule. Vous pouvez les créer et les modifier sur le Web.