HW 05 - reportistica in Quarto

Data di consegna: lunedì 30 ottobre 2023

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
• preparare un modello di report che puoi rendere parametrico in modo da utilizzarlo per differenti input

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
• usare R e Quarto per preparare modelli di report che puoi riutilizzare più volte cambiando semplicemente alcuni parametri di input

Istruzioni per l’uso

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

Attaching package: 'kableExtra'

The following object is masked from 'package:dplyr':

    group_rows

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

3. 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:

• Introduzione a formattable
• Formattable data frame

4. 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:

• Documentazione package gt

• Add custom styles to one or more cells

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

Suggerimento

Consulta le seguenti pagine:

• Twitter Followers
• Building the Twitter Followers Demo
• Documentazione package reactable

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

6. Scrivi uno script R hw-05-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:

• flextable book

• Documentazione huxtable

• Make Beatiful Tables with the Formattable Package

• Documentazione pixiedust:

  • Advanced Magic with pixiedust

  • Creating Magic with pixiedust

  • Sprinkles

• Documentazione reactablefmtr

7. 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

Parte 3: 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

8. Calcolo e formattazine di una tabella contenente informazini di sintesi 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

9. 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

10. 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

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 - 35	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