RMarkdown è uno strumento potente e flessibile che permette di integrare codice R, testo descrittivo e risultati di analisi in un unico documento. In questo articolo, esploreremo il concetto di report dinamici e vedremo come RMarkdown renda semplice la creazione di report che possono essere facilmente riprodotti e condivisi.
Cos’è un Report Dinamico?
Un report dinamico è un documento che combina testo descrittivo, risultati di analisi e grafici generati direttamente dal codice. La sua dinamicità deriva dal fatto che è possibile modificare il codice e rilanciare il report per ottenere risultati aggiornati, mantenendo così il documento sempre allineato ai dati più recenti.
Esistono report dinamici che includono diversi codici di programmazione come R, Python o SQL che possono essere integrati all’interno del testo descrittivo. Spesso vengono utilizzati nell’analisi dei dati, nei calcoli statistici e permettono inoltre di poter integrare all’interno del documento dei grafici dinamici che si modificano a seconda dei dati e dei risultati ottenuti.
Infatti una delle peculiarità e potenza dei report dinamici è quella di poter inserire risultati in tempo reale. Il codice, qualunque esso sia, viene eseguito direttamente all’interno del report, ed i risultati della loro esecuzione, spesso analisi di dati, viene aggiornata in tempo reale, modificando il report ed i grafici integrati in tempo reale.
Tali possibilità, permettono quindi di ottenere report dinamici con un alto grado di personalizzazione e flessibilità. La possibilità di integrare testo e codice permette facilmente di modificare il contenuto del report, aggiungere o rimuovere sezioni, regolare parametri di analisi e altro ancora senza dover riscrivere manualmente il documento.
Un altro aspetto molto importante è la grafica. I report dinamici possono essere formattati in molti modi, in maniera simile a come fanno le regole CSS per HTML. Quindi anche dal punto di vista grafico come colori, formattazione del testo, inserimento di immagini, video, ecc. non pongono limiti incrementando ulteriormente la loro flessibilità.
Al termine di un’analisi, questi report dinamici potranno poi essere esportati in diversi formati: HTML, PDF, Word, PowerPoint e tanti altri ancora. Questo consente di condividere il report con altri in diversi formati o di integrarlo in presentazioni o documenti esistenti.
Inoltre la dinamicità delle componenti non si limita solo all’esecuzione dei codici al suo interno. E’ infatti possibile aggiungere all’interno dei controlli o strumenti che permettono l’interattività con l’utente. Si possono infatti inserire molti elementi interattivi, come tabelle filtrabili, grafici dinamici, menu a discesa per la selezione dei parametri e così via, per rendere il report più coinvolgente e utile per gli utenti finali.
In sintesi, un report dinamico è un modo potente per presentare e condividere risultati di analisi dati in modo interattivo, aggiornabile e personalizzabile. È particolarmente utile in ambito aziendale, accademico e di ricerca, dove è importante comunicare in modo efficace i risultati delle analisi e adattarsi rapidamente ai cambiamenti nei dati o nelle esigenze degli utenti.
Creazione di un Report con RMarkdown
Passiamo ora alla realizzazione di un report dinamico con RMarkdown.
Prima di tutto, è necessario assicurarsi di avere installato il pacchetto RMarkdown. Questo può essere fatto eseguendo install.packages("rmarkdown") nella console di R o di RStudio. Immediatamente vi verrà chiesto di scegliere un CRAN da cui scaricare il pacchetto.
In RStudio, è possibile creare un nuovo file RMarkdown selezionando File > Nuovo file > R Markdown. Il sistema per prima cosa farà un controllo se tutte le librerie necessarie saranno presenti o aggiornate.
Dopo eventuali aggiornamenti apparirà una finestra in sarà possibile specificare il titolo, l’autore e il formato del documento (ad esempio, HTML, PDF o Word). Inserite tali dati, e poi premete sul pulsante OK per aprire in RStudio un report in Rmarkdown.
Molti report dinamici utilizzano la sintassi di Markdown con cu è possibile formattare il testo del report e inserire elementi come titoli, paragrafi, elenchi puntati, ecc. Il report che abbiamo appena creato avrà un testo che segue questa sintassi.
---
title: "MyReport"
author: "Fabio Nelli"
date: "2024-03-20"
output: html_document
---
```{r setup, include=FALSE}
knitr::opts_chunk$set(echo = TRUE)
```
## R Markdown
This is an R Markdown document. Markdown is a simple formatting syntax for authoring HTML, PDF, and MS Word documents. For more details on using R Markdown see <http://rmarkdown.rstudio.com>.
When you click the **Knit** button a document will be generated that includes both content as well as the output of any embedded R code chunks within the document. You can embed an R code chunk like this:
```{r cars}
summary(cars)
```
## Including Plots
You can also embed plots, for example:
```{r pressure, echo=FALSE}
plot(pressure)
```
Note that the `echo = FALSE` parameter was added to the code chunk to prevent printing of the R code that generated the plot.
Questo è un esempio di documento R Markdown che può essere utilizzato per creare un report HTML utilizzando R Markdown e Knitr. Ecco una spiegazione dettagliata del codice contenuto nel testo. La parte più in alto è l’header.
---: Questo è un delimitatore che indica l’inizio e la fine dell’header YAML (YAML Ain’t Markup Language). All’interno di questo blocco vengono specificate le informazioni sull’autore, la data e il formato di output del documento.title,author,date: Queste sono informazioni sull’autore, il titolo e la data del documento.output: Specifica il formato di output del documento. In questo caso, è impostato suhtml_document, il che significa che il report finale sarà un file HTML.
Poi si passa al contenuto del report con la parte testuale e la parte in codice. Attraverso l’uso di chunk di codice, delimitati da {r} ..., è possibile inserire codice R all’interno del documento. Questi chunk possono essere utilizzati per eseguire analisi, calcoli e creare grafici. Nell’esempio di default abbiamo l’inserimento di 3 chunk:
knitr::opts_chunk$set(echo = TRUE): Questo chunk di codice R imposta l’opzioneecho = TRUEper tutti i chunk di codice R nel documento. Ciò significa che il codice R verrà mostrato insieme al suo output nel report HTML finale. Questo è utile per mostrare il codice sorgente e i risultati delle analisi.summary(cars): Questo è un chunk di codice R che esegue il comandosummary(cars), che restituisce un riassunto statistico del datasetcars. Il risultato di questo comando verrà mostrato nel report HTML insieme al codice R che lo ha generato.plot(pressure): Questo è un altro chunk di codice R che crea un grafico basato sui dati del datasetpressure. Il grafico verrà incorporato nel report HTML finale, ma il codice R utilizzato per generarlo non verrà mostrato poiché è stato specificato
Il parametro echo, che viene aggiunto al codice, permette di dire al sistema se il codice relativo dovrà essere visualizzato anche come testo (TRUE) o no (FALSE).
Per quanto riguarda la parte testuale, si seguono le regole di sintassi di Markdown, dove con # si definiscono i titoli. A seconda del numero di # utilizzati si definiranno i livelli di titolo.
## R Markdown: Questa è una sezione del documento Markdown che utilizza la sintassi Markdown per formattare il testo. In questo caso, è un titolo di secondo livello.
Una volta scritto il report e inseriti i chunk di codice desiderati, è possibile eseguire il report premendo il pulsante Knit in RStudio. Questo renderà il documento Markdown nel formato desiderato, includendo l’output dei chunk di codice.
Una volta completato il processo di “knitting”, è possibile visualizzare il report finale nel formato selezionato (ad esempio, un file HTML, PDF o Word).
Ecco il risultato:
Un po’ di Sintassi di Markdown
Quindi è chiaro che oltre al codice R, per realizzare degli ottimi report sarà necessario avere familiarità con la sintassi Markdown. Ecco quindi una serie di regole di sintassi di markdown che vi potranno essere utili per la stesura dei vostri report. Le regole di sintassi di Markdown sono relativamente semplici e consentono di formattare il testo in modo leggibile e strutturato utilizzando una serie di simboli e convenzioni. Ecco le regole di base della sintassi di Markdown:
- Intestazioni: Le intestazioni vengono create utilizzando il simbolo
#seguito da uno spazio e il testo dell’intestazione. Più#vengono aggiunti, più grande è la dimensione dell’intestazione. Ad esempio:
# Intestazione di primo livello
## Intestazione di secondo livello
### Intestazione di terzo livello- Grassetto e Corsivo: Per rendere il testo in grassetto, puoi utilizzare il doppio asterisco
**testo**o il doppio sottolineato__testo__. Per rendere il testo in corsivo, puoi utilizzare un singolo asterisco*testo*o un singolo sottolineato_testo_. - Elenco puntato: Gli elenchi puntati possono essere creati inserendo un asterisco
*, un segno meno-, o un segno più+seguito da uno spazio e il testo dell’elemento dell’elenco. Ad esempio:
* Elemento 1
* Elemento 2
* Sotto-elemento 2.1
- Elemento 3- Elenco numerato: Gli elenchi numerati possono essere creati inserendo un numero seguito da un punto e uno spazio. Ad esempio:
1. Primo elemento
2. Secondo elemento
3. Terzo elemento- Citazioni: Le citazioni possono essere create utilizzando il segno maggiore
>. Ad esempio:
> Questo è un esempio di citazione.- Link: I link possono essere creati inserendo il testo del link tra parentesi quadre
[]seguito dall’URL tra parentesi tonde(). Ad esempio:
[Testo del link](https://www.esempio.com)- Immagini: Le immagini possono essere inserite utilizzando la stessa sintassi dei link, ma con un punto esclamativo
!all’inizio. Ad esempio:
- Codice inline: Il codice inline può essere racchiuso tra singole backtick
`. Ad esempio:
Questo è un esempio di `codice inline`.- Blocchi di codice: I blocchi di codice possono essere racchiusi tra triplo backtick
```. È anche possibile specificare il linguaggio del codice per la colorazione della sintassi aggiungendo il nome del linguaggio dopo il primo set di backtick. Ad esempio:
```python
print("Questo è un esempio di blocco di codice Python")“`
- Regole orizzontali: Le regole orizzontali possono essere create inserendo tre o più trattini
-, asterischi*, o sottolineature_su una linea vuota. Ad esempio:---
oppure***
Queste sono solo alcune delle regole di base di Markdown. Esistono molte altre convenzioni e sintassi avanzate che possono essere utilizzate per formattare il testo in modi diversi.
Conclusioni
RMarkdown offre un modo intuitivo e potente per creare report dinamici che integrano codice R, testo descrittivo e risultati di analisi. Questo strumento è estremamente utile per la documentazione delle analisi dati, la comunicazione dei risultati e la riproducibilità delle analisi stesse. Con la sua semplicità d’uso e la flessibilità, RMarkdown si conferma uno strumento imprescindibile per chiunque lavori con l’analisi dei dati utilizzando R.