Formato richiesto per l'invio dei dati delle previsioni

Per ogni previsione settimanale e per ogni modello partecipante andrà inviato un file al repository (tramite un'operazione di pull request). Come anticipato in precedenza, i file delle previsioni avranno un percorso all'interno del repository della forma:

previsioni/Team_X-Modello_Y/2024_05.csv

I file delle previsioni dovranno essere dei file CSV (comma-separated values) con le seguenti colonne:

• anno
• settimana
• luogo
• tipo_valore
• id_valore
• orizzonte
• valore

anno, settimana: l'anno e la settimana a cui si riferisce la previsione, indicati come numeri interi. Questi devono corrispondere all'anno e alla settimana del report di sorveglianza. Devono inoltre essere gli stessi utilizzati nel nome del file (a meno dello 0 iniziale per le prime 9 settimane dell'anno). Per comodità di riferimento il file previsioni/settimane_<stagione>.csv riporta tutte le settimane possibili per la stagione, indicando per ciascuna settimana: anno, numero della settimana, data di inizio e data di fine.

luogo: un codice di due caratteri (una stringa) che indica il luogo a cui si riferisce la previsione. I valori ammessi sono i seguenti: IT, 01, 02, 03, 04, 05, 06 07, 08, 09, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21. Il codice IT indica la previsione a livello nazionale, mentre i codici da 01 a 21 si riferiscono alle regioni secondo la seguente mappatura:

• 01 : Abruzzo
• 02 : Basilicata
• 03 : Calabria
• 04 : Campania
• 05 : Emilia Romagna
• 06 : Friuli Venezia Giulia
• 07 : Lazio
• 08 : Liguria
• 09 : Lombardia
• 10 : Marche
• 11 : Molise
• 12 : Provincia autonoma di Bolzano
• 13 : Provincia autonoma di Trento
• 14 : Piemonte
• 15 : Puglia
• 16 : Sardegna
• 17 : Sicilia
• 18 : Toscana
• 19 : Umbria
• 20 : Valle d'Aosta
• 21 : Veneto

tipo_valore: questo campo deve sempre contenere la stringa 'quantile'. (Il campo è ridondante in quanto attualmente tutte le previsioni saranno fornite sotto forma di quantili, ma è presente per garantire la compatibilità con infrastrutture simili a livello europeo).

id_valore: il quantile per il quale si indicano i valori delle previsioni nella colonna valore, nella forma di numero decimale compreso tra 0 e 1. Per ciascuna previsione è obbligatorio indicare i valori per i seguenti quantili: 0.01, 0.025, 0.05, 0.1, 0.15, 0.2, 0.25, 0.3, 0.35, 0.4, 0.45, 0.5, 0.55, 0.6, 0.65, 0.7, 0.75, 0.8, 0.85, 0.9, 0.95, 0.975, 0.99.

orizzonte: un numero intero che indica la settimana obiettivo della previsione, a partire dalla settimana di riferimento corrispondente al report di sorveglianza. I valori ammessi saranno quindi 1, 2, 3 e 4 ad indicare, rispettivamente, la previsione ad una settimana, a due settimane, a tre settimane o a quattro settimane.

valore: un numero decimale che indica la previsione, ovvero il valore dell'incidenza settimanale stimato (casi settimanali per 1000 assistiti) al termine della settimana (la domenica) indicata nella colonna orizzonte, per il quantile e il luogo indicati nelle colonne id_valore e luogo.

Ad esempio, i quantili di ordine 0.025 e 0.975 per una determinata settimana ed un determinato luogo devono rappresentare il 95% dei valori stimati, corrispondenti ad un intervallo di confidenza del 95%.