Grafico delle prestazioni: Compiti 1 e 2

Astrovic commented 2 years ago

Attualmente i dati delle prestazioni sono rappresentati solo nelle tabelle, i cui valori sono esportabili in Excel. Questo è un esempio di Risultati della giornata:

Nei compiti 1 e 2, AccDay(%) e ReactTimeDay(ms) sono i parametri che indicano la media giornaliera delle percentuali di risposte corrette e dei tempi di reazione di tutte le sessioni svolte nella giornata di lavoro.

Ho pensato di rappresentare entrambi i parametri sull'asse Y (AccDay a sinistra e ReactTimeDay a destra), ed utilizzare un "range selector" che permette di visualizzare i valori in un range di tempo predefinito (1 settimana, 1 mese, 3 mesi, 6 mesi, dall'inizio dell'anno, 1 anno, tutti), oppure impostare manualmente un range temporale e scorrere i risultati nel tempo. Sia per AccDay che per ReactDay ho inoltre implementato la possibilità di visualizzare la standard deviation su intervalli di 7 e 30 giorni. Ho sviluppato una pagina di test che genera un dataset col grafico. I valori sono casuali e solo a scopo dimostrativo, per testare il funzionamento. C'è anche un pulsante per generare nuovi valori. Questo il link per provarlo: https://htmlpreview.github.io/?https://github.com/acaland/SmartMe/blob/main/charts/task1/task1-1.0.html

Il grafico è generato utilizzando Highcharts, una libreria gratuita per un uso non commerciale o personale (https://www.highcharts.com/blog/download/), in caso contrario bisogna acquistare una licenza annuale. Ho testato diverse librerie, ma trovo che questa sia la più adatta.

Astrovic commented 1 year ago

Modifiche richieste:

[ ] I labels più grandi e visibili e non acronimi, sigle in lingua inglese
[x] Che sulle linee venissero individuati i giorni in cui il soggetto ha svolto il compito, con dei puntini o quadratini
[x] Che venisse corretto il disallineamento tra i giorni rappresentati sulla linea e il giorno raffigurato sull'asse delle x

Astrovic commented 1 year ago

Questo è il link per provare la nuova versione: https://htmlpreview.github.io/?https://github.com/acaland/SmartMe/blob/main/charts/task1/task1-v1.1.html

Modifiche richieste:

[x] I labels più grandi e visibili e non acronimi, sigle in lingua inglese
[x] Che sulle linee venissero individuati i giorni in cui il soggetto ha svolto il compito, con dei puntini o quadratini
[x] Che venisse corretto il disallineamento tra i giorni rappresentati sulla linea e il giorno raffigurato sull'asse delle x
[ ] Label in italiano, con caratteri più grandi e in grassetto che siano chiare a livello di che dato rappresentano
[x] Puntini/quadratini sulla linea che l'utente possa facilmente intercettare per avere una misura più dettagliata del risultato
[x] Colori che spicchino di più.

Ho completato le modifiche spuntate nell'elenco sopra. Ho anche creato due temi di visualizzazione, uno con sfondo chiaro ed uno con sfondo scuro. È possibile cambiare tema dal menu contestuale (l'icona con i tre trattini in alto a destra sul grafico). In calce allego l'anteprima con entrambi i temi.

Per le labels in italiano sulle misure (AccDay, ReactTimeDay, ecc...) forse sarebbe meglio lasciare le originali, che sono le stesse utilizzate sul server e nelle varie configurazioni, e magari creare una legenda che ne spieghi il significato. Utilizzare nomi di misure abbreviati ci consente anche di sfruttare meglio lo spazio a disposizione sul display del tablet. Altrimenti vi chiedo gentilmente di indicarmi i nomi da usare per tutte le labels che saranno utilizzate anche negli altri compiti:

TASK 1: AccDay(%) e ReactTimeDay(ms)

TASK 2: AccDay(%) e ReactTimeDay(ms)

TASK3:
- Without alert signals:  AccDay(%) e ReactTimeDay(ms)
- With alert signals:  AccDay(%) e ReactTimeDay(ms)

TASK 4:
- Targets not preceded by cues:  AccDay(%) e ReactTimeDay(ms)
- Targets preceded by cues:  AccCueDay(%) e ReactTimeCueDay(ms)
- Stay target only:  AccStayDay(%) e ReactTimeStayDay(ms)
- Change target only:  AccChangeDay(%) e ReactTimeChangeDay(ms)

TASK 5:
- “Valid” Targets preceded by cues in the same side:  AccValidDay(%) e ReactTimeValidDay(ms)
- “Invalid” Targets preceded by cues in the opposite side:  AccInvalidDay(%) e ReactTimeInvalidDay(ms)

TASK 6:
- Targets preceded by “cues” in the same side with Three-target max (50% of the cases):  AccCueTmaxDay(%) e ReactTimeCueTmaxDay(ms)
- Targets preceded by “cues” in the same side with Three-target min (50% of the cases):  AccCueTminDay(%) e ReactTimeCueTminDay(ms)

TASK 7: AccNOGODay(%), AccGODay(%) e ReactTimeGODay(ms)

Anteprima dei grafici

tema chiaro

tema scuro

Astrovic commented 1 year ago

Ho aggiornato il grafico inserendo in alto a sinistra un pulsante INFO che consente di aprire un popup con le informazioni sui valori rappresentati nel grafico utilizzando le definizioni presenti del documento ufficiale.

Sia per AccDay che per ReacTimeDay ho aggiunto la rappresentazione del relativo valore medio nell'intervallo di date visualizzato.

Questo è il link per provare la nuova versione: https://htmlpreview.github.io/?https://github.com/acaland/SmartMe/blob/main/charts/task1/task1-v1.2.html

Astrovic commented 1 year ago

Sono state aggiunte le informazioni del paziente e dell'operatore, e le cifre decimali nei valori.

Questo è il link per provare la nuova versione: https://htmlpreview.github.io/?https://github.com/acaland/SmartMe/blob/main/charts/task1/task1-v1.3.html

Modifiche implementate nella release 1.0.10 https://github.com/acaland/SmartMe/releases/tag/v1.0.10

Questo è il link diretto per il download della versione Android: https://github.com/acaland/SmartMe/releases/download/v1.0.10/SmartMe.apk

Build iOS su TestFlight: https://testflight.apple.com/v1/app/1535177677?build=102142775

Astrovic commented 1 year ago

INFO SUI DATI DEL GRAFICO

VALORE	DEFINIZIONE
AccDay	Accuratezza media di giornata, definita come la percentuale dei quadrati target verdi (D4) toccati nel tempo concesso (Treact), in una giornata di lavoro. AccDay si ottiene con la seguente procedura. 1) Per ogni prova, si calcola la percentuale di quadrati target verdi (D4) toccati nel tempo concesso Treact (AccTrial). 2) Per ogni sessione, si calcola la media dell’AccTrial per tutte le prove previste dalla sessione (AccSession). 3) Per ogni giornata, si calcola la media dell’AccSession per tutte le sessioni svolte (AccDay).
ReactTimeDay	Tempo di reazione medio di giornata, definito come il tempo di reazione per toccare i quadrati target verdi (D4) nel tempo concesso (Treact), in una giornata di lavoro. ReactTimeDay si ottiene con la seguente procedura. 1) Per ogni prova, si calcola il tempo di reazione per toccare i quadrati target verdi (D4) nel tempo concesso Treact (ReactTimeTrial). 2) Per ogni sessione, si calcola la media del ReactTimeTrial per tutte le prove previste dalla sessione (ReactTimeSession). 3) Per ogni giornata, si calcola la media del ReactTimeSession per tutte le sessioni svolte (ReactTimeDay).
Avg 7 days	Indica l'andamento medio del valore rispetto alle 7 giornate di lavoro precedenti
Avg 30 days	Indica l'andamento medio del valore rispetto alle 30 giornate di lavoro precedenti

Astrovic commented 1 year ago

Come richiesto, sono state aumentate ulteriormente le dimensioni delle labels, sostituito il pulsante INFO con DEFINIZIONI e modificate le intestazioni dei due assi.

Questo è il link per provare la nuova versione: https://htmlpreview.github.io/?https://github.com/acaland/SmartMe/blob/main/charts/task1/task1-v1.4.html

Astrovic commented 1 year ago

L'applicazione offre due modalità di utilizzo: una modalità operatore, che consente l'accesso a tutte le funzionalità dell'app, e una modalità paziente, che limita l'accesso ai compiti e alla consultazione dei risultati.

In questa nuova versione, sono stati proposti due tipi di visualizzazione dei grafici che si attivano automaticamente in base alla modalità selezionata:

Modalità paziente: in questa modalità, le labels e le linee del grafico sono molto più grandi, e le nomenclature e le definizioni sono semplificate per facilitare la comprensione dei pazienti. Il grafico mostra solo i due parametri principali: l'Accuratezza e i Tempi di reazione. L'Accuratezza rappresenta la media aritmetica di tutti i parametri di accuratezza giornalieri, mentre i Tempi di reazione rappresentano la media aritmetica di tutti i parametri di reazione giornalieri. Questa visualizzazione fornisce ai pazienti uno strumento semplice ed intuitivo per comprendere i progressi nel tempo.
Modalità operatore: in questa modalità, il grafico mostra tutti i parametri e le relative definizioni, offrendo all'operatore la flessibilità di selezionare i parametri in base alle proprie necessità. Le dimensioni delle labels sono normali, consentendo una migliore visualizzazione dei grafici, soprattutto nei compiti con un elevato numero di parametri, come nel caso del compito 4, che presenta 24 parametri, o nel caso del compito 3, che presenta 12 parametri.

Queste due modalità di visualizzazione dei grafici potrebbero fornire un'esperienza ottimale per entrambi gli utenti. La modalità paziente garantisce una comprensione immediata dei progressi nel tempo, mentre la modalità operatore offre una visualizzazione completa dei parametri per un'analisi più dettagliata.

Per illustrare l'utilizzo di queste due modalità, è stata creata una demo che include il compito 1 e 2. Nella demo sono presenti due pulsanti (OPERATOR MODE e PATIENT MODE) che consentono di attivare e confrontare le due modalità descritte in precedenza. Nell'applicazione reale, le modalità si abilitano automaticamente in base al tipo di utente. La demo può essere provata al seguente link: https://htmlpreview.github.io/?https://github.com/acaland/SmartMe/blob/main/charts/task1/task1-v1.5.html

Di seguito sono riportati due screenshot che mostrano le due modalità di visualizzazione dei grafici.

MODALITÀ OPERATORE

MODALITÀ PAZIENTE

Astrovic commented 1 year ago

Richieste le seguenti modifiche:

Astrovic commented 1 year ago

Sono state apportate le modifiche richieste nella issue https://github.com/acaland/SmartMe/issues/23#issuecomment-1621984235

Questo è il link per provare la nuova versione: https://htmlpreview.github.io/?https://github.com/acaland/SmartMe/blob/main/charts/task1/task1-v1.6.html

Di seguito sono riportati due screenshot che mostrano le due modalità di visualizzazione dei grafici.

MODALITÀ OPERATORE

MODALITÀ PARTECIPANTE

Astrovic commented 1 year ago

I grafici sono stati implementati all'interno dell'app. Nella pagina Home sessione c'è un nuovo pulsante Archivio grafici dal quale è possibile accedere alla pagina con l'elenco dei pazienti.

grafici-pulsante-home

Nella pagina Elenco pazienti in cima è stato inserito un utente Patient Test a scopo dimostrativo, per consentire di testare i grafici usando dati di prestazione generati in modo random ed automatico.

grafici-elenco-pazienti

Selezionando un paziente dall'elenco, si accede alla finestra Elenco compiti. Qui è visibile l'elenco di tutti i compiti svolti dal paziente, quelli in cui il paziente abbia concluso almeno una giornata lavorativa. In alto ci sono due pulsanti che consentono di scegliere in quale modalità visualizzare i grafici: MODALITÀ OPERATORE o MODALITÀ PARTECIPANTE. Nel caso in cui l'applicazione è in MODALITÀ PARTECIPANTE, dunque in uso dal paziente, questi pulsanti non saranno disponibili, ed i grafici saranno visualizzati in MODALITÀ PARTECIPANTE. Selezionando uno dei compiti, si accede al grafico.

grafici-elenco-compiti

Modifiche implementate nella release 1.0.15 https://github.com/acaland/SmartMe/releases/tag/v1.0.15

Questo è il link diretto per il download della versione Android: https://github.com/acaland/SmartMe/releases/download/v1.0.15/SmartMe.apk

Build iOS su TestFlight: https://testflight.apple.com/v1/app/1535177677?build=123676984

--

Modifiche: commit1

Astrovic commented 11 months ago

Aggiunti i grafici dei compiti 1 e 2 in versione smartphone.

Questo è il link per provare la nuova versione 1.7: https://htmlpreview.github.io/?https://github.com/acaland/SmartMe/blob/main/charts/task1/task1-v1.7.html

Di seguito sono riportati 4 screenshots che mostrano le modalità operatore e modalità partecipante su tablet e smartphone.

MODALITÀ OPERATORE - TABLET task1-tablet operator

MODALITÀ PARTECIPANTE - TABLET task1-tablet participant

MODALITÀ OPERATORE - SMARTPHONE task1-smartphone-operator

MODALITÀ PARTECIPANTE - SMARTPHONE smartphone-participant

Astrovic commented 11 months ago

Aggiunte le traduzioni delle definizioni dei valori in italiano, inglese e turco:

Modifiche implementate nella release 1.0.19 https://github.com/acaland/SmartMe/releases/tag/v1.0.19

Questo è il link diretto per il download della versione Android: https://github.com/acaland/SmartMe/releases/download/v1.0.19/SmartMe.apk

Build iOS su TestFlight: https://testflight.apple.com/v1/app/1535177677?build=128729275

--

Modifiche: commit

Astrovic commented 9 months ago

Aggiunte le librerie dei grafici in locale.

Questo è il link per provare la nuova versione 1.8: https://htmlpreview.github.io/?https://github.com/acaland/SmartMe/blob/main/charts/task1/task1-v1.8.html

--

Modifiche: commit commit

acaland / SmartMe

Grafico delle prestazioni: Compiti 1 e 2 #23

Anteprima dei grafici