HW 06 - reportistica in Quarto (parte 1)

Data di consegna: martedì 05 novembre 2024

Introduzione

In questo compito utilizzerai i comandi utili per:

  • organizzare una tabella da inserire in un report
  • preparare un report Quarto in formato html, pdf e MS-Word
  • preparare un report Quarto sfruttando un file di codice esterno

Obiettivi di apprendimento

Lo svolgimento di questo compito ti permetterà di:

  • usare R e Quarto per preparare un report dinamico, che combina gli output di R con una parte testuale statica
  • usare R e Quarto per preparare un report che sfrutta codice R presente su file esterni

Istruzioni per l’uso

  • Crea un progetto associandolo ad una cartella “RLab_hw06_cognome_nome” sul tuo disco: nel mio caso il nome della cartella sarebbe: “RLab_hw06_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 codice R integrato

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

  1. Visualizza la tabella dati presente nel file dati-citta-italiane-qmd.csv sfruttando la funzione datatable {DT}

  2. Utilizzando le funzioni disponibili nel package kableExtra prova a riprodurre la seguente tabella:

area abitanti_media reddito_medio consumi_media
Nord est 144721.7 23056.43 14941.323
Nord ovest 186608.3 21437.27 13705.475
Centro 203929.2 18562.32 12489.649
Sud e Isole 157356.2 12361.07 9547.997
Suggerimento

Consulta la guida di kableExtra disponibile su questo link

  1. Utilizzando le funzioni disponibili nel package formattable prova a riprodurre la seguente tabella (i valori dei consumi sono visualizzati in rosso se minori del consumo medio di tutte le province, in rosso altrimenti):
area abitanti_media reddito_medio consumi_media
Nord est 144721.7 23056.43 14941.323
Nord ovest 186608.3 21437.27 13705.475
Centro 203929.2 18562.32 12489.649
Sud e Isole 157356.2 12361.07 9547.997
Suggerimento

Consulta le seguenti pagine:

  1. Utilizzando le funzioni disponibili nel package gt:
furti_auto rapine
Abbruzzo 91.8 14.49
Basilicata 123.7 5.42
Calabria 333.4 18.98
Campania 241.3 13.07
Emilia Romagna 145.6 21.92
Friuli Venezia Giulia 107.0 13.95
Lazio 154.5 26.36
Liguria 602.0 55.71
Lombardia 483.3 35.92
Marche 97.7 15.86
Molise 120.1 8.81
Piemonte 195.4 40.78
Puglia 833.2 63.91
Sardegna 572.5 27.62
Sicilia 123.8 12.23
Toscana 87.0 21.05
Trentino Alto Adige 51.7 12.16
Umbria 188.9 27.95
Valle d'Aosta 117.2 10.89
Veneto 55.4 4.78
Suggerimento

Consulta le seguenti pagine:

  1. Utilizzando le funzioni disponibili nel package formattable e nel package htmltools prova a riprodurre la seguente tabella:
Suggerimento

Consulta le seguenti pagine:

Parte 2: Creazione di un report Quarto con codice R esterno

  1. Scrivi uno script R hw-06-codice-R-tabella_cognome_nome.R per rappresentare un report tabellare di sintesi a tua scelta a partire dalla tabella dati presente nel file dati-citta-italiane-qmd.csv ispirandoti ad uno degli esempi presenti su queste pagine:
  1. Scrivi un report Quarto in formato html che sfrutta il codice presente nel file .R creato nel punto precedente commentando nel report brevemente la tabella scelta
Suggerimento

Per assegnare un nome ad un chunk di codice devi usare la seguente sintassi sulla riga del file .R che precede il codice che vuoi richiamare in Quarto. Se ad esempio vuoi associare nome_chunk ad alcune righe di codice devi usare questa sintassi:

## @knitr nome_chunk

Il nome è assegnato a tutte le linee di codice a partire dalla linea successiva in cui lo hai definito fino alla linea che precede la definizione di un nuovo nome (se non ci sono altri nomi a seguire fino alla fine del file .R).

Per utilizzare nel file .qmd il chunk di codice che hai nominato nome_chunk è sufficiente inserire un chunk con il solo attributo label impostato come nell’esempio seguente:

Suggerimento due

Consulta gli esempi forniti nel materiale di questa settimana

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 - 7 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↩︎