Primeros pasos con R Markdown

Independientemente del trabajo que realice, es importante poder crear documentos que le ayuden a comunicar su trabajo y sus resultados. Si usa R, puede intentar crear documentos comunicativos copiando y pegando su código y análisis en otras herramientas como Microsoft Word. Pero el proceso de copiar y pegar puede llevar mucho tiempo y puede ser muy difícil conservar el formato que desea. Es por eso que existe un paquete R llamado R Markdown. Con R Markdown, puede escribir código que no solo realiza los cálculos que forman parte de su flujo de trabajo de R, sino que también crea directamente documentos hermosos que pueden facilitar la comunicación.

Para comenzar con el paquete R Markdown, puede ejecutar el siguiente código para instalarlo y cargarlo en su sesión R:

install.packages("rmarkdown")
library(rmarkdown)

A continuación, debe crear un archivo donde escribirá todo su código R Markdown. Este archivo debe tener una extensión de archivo «.Rmd». Por ejemplo, puede llamar a su nuevo archivo rmdexample.Rmd. Este archivo contendrá el código R y el código de descuento y le facilitará la creación de un informe.

La primera parte de cada archivo R Markdown se denomina encabezado y contiene información importante sobre el título, el autor y el formato de su informe. El encabezado comienza y termina con tres guiones juntos (“—”). Aquí hay un encabezado de ejemplo:

---
title: "TPS Report"
author: Lawrence
date: April 7, 2023
output: html_document
---

Ahora que tiene un encabezado, ya está listo para crear o «renderizar» su informe. Puedes renderizarlo con el siguiente comando:

rmarkdown::render("rmdexample.Rmd")

Después de ejecutar este comando, verá (en cualquier directorio que esté usando para ejecutar R) que hay un nuevo archivo llamado «rmdexample.html». Este es el informe que ha creado con su código R Markdown, y verá que se ve así:

TPS Report
Lawrence
April 7, 2023

No es más que un título, autor y fecha, porque ese es el único contenido en su archivo Rmd (recuerde, lo único en su archivo es el encabezado). Se ha generado como un archivo HTML porque ese es el tipo de salida que especificó en su encabezado.

Ahora que puede crear un encabezado para su informe, querrá agregar contenido. Intente agregar el siguiente texto debajo del encabezado en su archivo Rmd:

# Useful R Markdown Information

Estos son algunos personajes que debes conocer:

• Puede usar el carácter «#» para crear un título de sección.
• Puede usar el carácter «*» para crear una viñeta.

Veamos cómo aparece el informe si renderizamos el documento nuevamente ejecutando rmarkdown::render(“rmdexample.Rmd”):

Puede ver que el carácter «#», cuando se usa al principio de una línea, crea un texto más grande que se puede usar para el título de una sección. Además, el carácter «*», cuando se usa al principio de una línea, crea una viñeta.

Lo mejor de R Markdown es que podemos agregar código R a los informes además de texto simple. Por ejemplo, si queremos crear y describir un marco de datos en el informe, podemos agregarle un código R visualizable agregando lo siguiente al final del archivo Rmd:

```{r}
names <- c("peter", "milton", "michael", "samir")
red_staplers <- c(0, 1, 0, 0)
dataframe <- data.frame(names, red_staplers)
print(dataframe)
```

Aquí, el texto «`{r}» indica que está comenzando una sección de código R puro, y los caracteres «` indican que la sección R pura está terminando. En el medio, hemos definido e impreso un marco de datos simple. Si renderiza el informe ahora, verá que se ve así:

Informe GST
lorenzo
7 de abril de 2023
Información útil de rebajas de R
Aquí hay algunos personajes que debes conocer:

• Puede usar el carácter «#» para crear un título de sección.
• Puede usar el carácter «*» para crear una viñeta.

names <- c("peter", "milton", "michael", "samir")
red_staplers <- c(0, 1, 0, 0)
dataframe <- data.frame(names, red_staplers)
print(dataframe)

##      names red_staplers
## 1    peter            0
## 2   milton            1
## 3  michael            0
## 4    samir            0

Puede ver que con R Markdown, podemos combinar texto descriptivo y código, en un estilo legible, en formatos de archivo comunes como HTML.

A medida que aprenda más sobre R Markdown, aprenderá a agregar otro texto y código atractivos a sus informes. Por ejemplo, puede agregar matemáticas, como el siguiente texto, a su informe:

# Math Section

$E = m cdot c^{2}$

Aquí, el carácter «$» indica el comienzo del texto que debe formatearse como una expresión matemática. El “cdot” es un atajo que se refiere a un punto que indica multiplicación. Si presenta esto en su informe, verá que se ve así:

Sección de Matemáticas
mi = m*c²

Felicitaciones, puede crear informes hermosos, legibles y basados ​​en código usando R Markdown. Si desea obtener más información sobre R Markdown u otros temas relacionados con el uso de R para la ciencia de datos, debe explorar la programación de Udacity para la ciencia de datos con R Nanodegree.