HW 07 - reportistica in Quarto (parte 2)

Data di consegna: lunedì 11 novembre 2024

Introduzione

In questo compito utilizzerai i comandi utili per:

  • preparare un modello di report Quarto in formato html, pdf e MS-Word
  • produrre in automatico diverse versioni del modello di report sfruttando l’attributo params della sezione YAML
  • preparare una dashboard di sintesi di una tabella dati

Obiettivi di apprendimento

Lo svolgimento di questo compito ti permetterà di:

  • usare R e Quarto per preparare modelli di report per la generazione automatica di report in funzione di differenti input
  • usare R e Quarto per preparare una dashboard sintetica di presentazione dei dati contenenti testo, tabelle, grafici ed indicatori di sintesi

Istruzioni per l’uso

  • Crea un progetto associandolo ad una cartella “RLab_hw07_cognome_nome” sul tuo disco: nel mio caso il nome della cartella sarebbe: “RLab_hw07_vistocco_domenico” e copia all’interno della cartella il seguente file: dati-citta-italiane-qmd.csv.
Descrizione del dataset

Una descrizione del contenuto del file con la corrispondente legenda delle variabili è disponibile sul primo foglio (Descrizione variabili) della cartella di lavoro MS-Excel utilizzata nel compito della scorsa settimana. A differenza del precedente compito, nella tabella sono state già codificate le aree geografiche e le regioni in formato testuale.

  • Utilizza i commenti nei file .R e il testo statico nei file .qmd per rispondere alle domande in cui viene chiesta un’interpretazione da parte tua

  • Assicurati che sia il report che lo script siano correttamente funzionanti: aprendo il tuo file di progetto sul mio PC devo essere in grado di provare i file .R e di compilare (Render) i file .qmd

  • Gli script e i report vengono valutati sia in base alla correttezza del codice che in base alla qualità (stile utilizzato per rendere gli script e i report leggibili ed ordinati).

Esercizi

Nota

Ricordati di utilizzare i commenti per le risposte aperte nei file .R e il testo statico nei file .qmd

Parte 1: Creazione di un report Quarto con parametri

Crea un “template” di report Quarto in formato html inserendo nel file .qmd direttamente i chunk di codice utili a rispondere ai seguenti punti

  1. Calcolo e formattazione di una tabella contenente informazioni di sintesi su tutte le province di una delle cinque aree geografiche impostata come params nella sezione YAML del file .qmd
Suggerimento

Consulta gli esempi forniti nel materiale di questa settimana

  1. Creazione di un grafico contenente informazini su tutte le province di una delle cinque aree geoegrafiche impostata come params nella sezione YAML del file .qmd
Suggerimento

Consulta gli esempi forniti nel materiale di questa settimana

  1. Compila il report usando la funzione quarto::quarto_render() per tutte e cinque le aree geografiche sfruttando gli argomenti in input della funzione
Suggerimento

Consulta gli esempi forniti nel materiale di questa settimana

Parte 2: Creazione di dashboard di sintesi

  1. Progetta ed implementa una dashboard che rappresenti i dati raggruppati per aree geografiche, inserendo almeno un grafico, una tabella e dei Value Box che rappresentino sinteticamente una o più variabili presenti nella tabella dati

  2. Progetta ed implementa una dashboard che rappresenti i dati delle province di una singola area geografica a tua scelta inserendo almeno un grafico, una tabella e dei Value Box che rappresentino sinteticamente una o più variabili presenti nella tabella dati

  3. Implementa una dashboard organizzata per pagine (o se preferisci tabset): ciascuna pagina (o tabset) ripropone per le varie aree geografiche la dashboard costruita al punto precedente.

Suggerimento
  • Sfrutta l’approccio basato sui parametri (opzione params dello YAML) per evitare di duplicare la dashboard per ciascuna area geografica e generare le singole dashboard (una per ciascuna area geografica)
  • Sfrutta lo shortcode include per includere i singoli file nella dashboard: {{< include _content.qmd >}}

Consegna

Per inviare la tua soluzione:

  • Salva i file .R con le tue soluzioni
  • Salva i file .qmd con le tue soluzioni
  • Chiudi il progetto RStudio
  • Comprimi in un file .zip la cartella associata al progetto
  • Carica il file .zip salvato in risposta al compito assegnato su Teams

Valutazione

Totale punti disponibili: 110 punti

Component Punti
Es 1 - 6 100
Workflow & formattazione 101

Footnotes

  1. La valutazione al “Workflow & formattazione” tiene conto del principio di riproducibilità del codice: lo script caricato deve funzionare senza errori su qualunque PC dando gli stessi risultati↩︎