Annotazioni sul grafico

Un grafico è utile per mostrare che qualcosa è cambiato. Non può però spiegarne il motivo. È nelle annotazioni del grafico che si annota il motivo: basta cliccare su un punto del grafico Dashboard e registrare cosa stava succedendo, in modo che il mese successivo si sappia ancora a cosa era dovuto quel picco.

Un'annotazione è associata a una misurazione effettuata in un determinato momento, non a un singolo grafico. Se si inserisce un'annotazione relativa al livello di glucosio, questa apparirà su tutti i grafici relativi al glucosio, indipendentemente dal livello di dettaglio mostrato da ciascun grafico.

Scrivere un'annotazione

Clicca su un punto qualsiasi del grafico. Si aprirà una piccola finestra di modifica che mostra la data, il valore corrispondente a quel punto e un campo in cui inserire la tua annotazione. Digita ciò che è successo e premi "Salva".

La data registrata è quella dell'intervallo su cui hai cliccato, non il momento in cui hai cliccato. Un'annotazione inserita su un grafico mensile riguarda quel mese, quindi rimane nella posizione in cui l'hai inserita invece di spostarsi alla data odierna.

È possibile inserire più di un'annotazione sullo stesso punto. Se lo si riapre, sotto le annotazioni già presenti viene visualizzata una nuova casella.

Dove compaiono le tue annotazioni

Le annotazioni appaiono come piccoli simboli in una riga sotto il grafico, allineati al punto a cui si riferiscono. Passa il mouse su un simbolo per leggere l'annotazione completa, oppure cliccaci sopra per modificarla o eliminarla.

Quando diverse annotazioni sono ravvicinate, si uniscono in un unico simbolo che indica il numero totale. Cliccandoci sopra, l'editor le elenca tutte, così una settimana intensa non si trasforma in una fila di simboli uno sopra l'altro.

Un'annotazione per ogni grafico

Le annotazioni seguono la misurazione. Da ciò derivano due cose, entrambe intenzionali:

• Un'annotazione inserita su un grafico giornaliero compare anche sul grafico settimanale o mensile della stessa scala, nel riquadro che la contiene. Basta inserirla una volta e verrà visualizzata ovunque si consultino quei dati.
• Le unità di misura non hanno importanza. Un’annotazione riportata su un grafico in miglia compare anche su un grafico con la stessa misura espresso in chilometri, e un’annotazione relativa al glucosio su mg/dL compare sul grafico mmol/L.

Annotazioni relative a una lettura

Alcune letture provenienti dalle tue fonti sono già corredate di un commento e, nel caso di misurazioni che registrano un unico valore, come il glucosio, l'ossigeno e la temperatura, tale commento viene visualizzato anche come annotazione.

Questi elementi sono contrassegnati come parte integrante della misurazione stessa, poiché fanno parte del valore rilevato e non sono semplicemente delle annotazioni scritte sul grafico. Per modificarne uno, modifica il valore rilevato nel tuo FitnessSyncer Notebook. Puoi comunque aggiungere una tua annotazione allo stesso punto.

Quali grafici consentono di inserire annotazioni

Qualsiasi grafico il cui asse orizzontale rappresenti il tempo: grafici a linee, ad area, a linee con intervallo, a colonne, a colonne sovrapposte, a flusso e a scatola-barra supportano tutti le annotazioni.

I grafici in cui l'asse inferiore non rappresenta il tempo non lo fanno, poiché non c'è una data a cui associare un'annotazione. Ciò vale per i grafici a dispersione, gli istogrammi, le mappe di calore, il grafico "Giorno", i grafici a torta e ad anello, gli indicatori e i riquadri KPI.

Anche i valori calcolati non accettano annotazioni. L’A1C stimata, la percentuale nell’intervallo o il debito di sonno vengono calcolati sulla base di altre letture anziché essere registrati direttamente, quindi non vi è alcuna lettura su cui inserire un commento. Scrivi invece l’annotazione sulle letture riportate più in basso.

Se preferisci che un determinato grafico non mostri le annotazioni e sei un utente FitnessSyncer Pro, apri le impostazioni del grafico nell'editor Dashboard e disattivale per quel grafico.

Le tue annotazioni

L'icona delle annotazioni , presente sulla barra degli strumenti Dashboard, apre la finestra "Le tue annotazioni", che elenca in una tabella tutte le annotazioni che hai scritto, a gruppi di cento alla volta.

In quella schermata è possibile modificare sia la data che il testo. Se modifichi una cella e premi “Salva”, l’annotazione si sposta o viene visualizzata in modo diverso ovunque compaia. La misura a cui appartiene un’annotazione non può essere modificata, perché ciò la sposterebbe su grafici che non hai mai selezionato.

Esportazione e importazione

La sezione "Le tue annotazioni" presenta anche un pulsante "Esporta" e un menu a tendina per l'importazione, così potrai conservare una copia delle tue annotazioni oppure crearne un gruppo altrove e importarle.

L'esportazione salva ogni annotazione come file CSV con quattro colonne:

• Data: periodo di validità dell'annotazione, indicata nel formato ISO per data e ora in UTC.
• DataField: il parametro a cui si riferisce l'annotazione, nel formato utilizzato internamente da FitnessSyncer, ad esempio GLUCOSE_MMOL_PER_L.
• Misura: il nome leggibile di quella misura. Questa colonna serve per facilitare la lettura del file e viene ignorata durante l'importazione.
• Nota: il tuo testo.

La funzione "Importa" legge un file con la stessa struttura. Un'annotazione è identificata dalla data e dalla misura, anziché da un ID; pertanto, un file esportato, modificato e reimportato aggiorna le annotazioni in esso contenute, anziché crearne una seconda copia per ciascuna di esse.

Una riga illeggibile non blocca il file. Una riga che contiene una misura FitnessSyncer non riconosciuta, una data non analizzabile o un’annotazione vuota viene saltata; l’importazione indica quante righe sono state create, quante aggiornate, quante saltate e quali siano queste ultime. Le annotazioni più lunghe di mille caratteri vengono abbreviate anziché scartate.

Nelle app

Le annotazioni vengono visualizzate sui grafici nelle app FitnessSyncer per iOS e Android e in tali app sono di sola lettura. È possibile scriverle e modificarle sul web.