Repaso rápido de la sesión pasada

Estructura de un documento Rmd

¿Cómo se generan los archivos?

Chunks : Bloques de código

La sesión pasada, aprendimos que Markdown nos permite incluir código tanto en línea como en bloques, pero para resaltarlo; en cambio, R Markdown sí lo ejecutará.

El comando `mean(edades)` sirve para calcular la media 
de un vector denominado _edades_ .

```r
edades <- c(1,2,3)
mean(edades)
```

La media del vector _edades_ vale `r mean(edades)`.

```{r}
edades <- c(1,2,3)
mean(edades)
```

Propiedades principales de chunks

Chunks de diversos lenguajes

R Markdown admite código de cualquiera de los siguiente lenguajes:

Ejemplos:

Python

```{python, echo = FALSE, eval=FALSE}
# Podemos añadir varias propiedades a un mismo chunk,
# separándolas con coma.
import numpy as np
x = np.cos(0) # vale 1
y = np.sin(0) # vale 0
print(x**2 + y**2) # vale 1
```

JavaScript

```{js mi-primer-chunk, include=FALSE}
// Podemos nombrar a cada chunk, ya sea para hacer referencia 
// a ellos en nuestro documento Rmd, facilitar el poder ejecutar
// varias veces un mismo chunk, o simplemente para ser más ordenados.
document.addEventListener(
  "DOMContentLoaded", //
  function() {
    // Definimos un array con los meses del año
    let meses = ["enero","febrero","marzo","abril","mayo","junio","julio","agosto","setiembre","octubre","noviembre","diciembre"];
    // Obtener fecha de hoy
    let fecha = new Date();
    // Obtener qué día es hoy
    let numeroDeDia = fecha.getDate();
    // Crear una ventana con un mensaje particular
    alert(`Hoy es ${numeroDeDia} de ${meses[fecha.getMonth()]}.`)
  }
)
```

¿Qué es un reporte parametrizado?

Es un documento dinámico que cambia en función de la input proporcionada por el usuario o una aplicación.

¿Para qué nos sirve un reporte parametrizado?

Nos permite automatizar la creación de reportes o documentos que poseen un modelo similar (template/plantilla) y los cuales se tienen que producir con cierta frecuencia .

Por ejemplo:

• Análisis de data respecto a algún fenómeno natural periódico.
• Algunos reportes mensuales o anuales sobre ventas de algún negocio.
• Horarios.
• Certificados.

Manos a la obra

Para cada link en azul, copiar su contenido (presionar ctrl+A y luego ctrl+C), pegarlo en un nuevo archivo Rmd y guardarlo con el mismo nombre del texto azul; todos los archivos en una misma carpeta.

0-html-notebook.Rmd

• Objetivos:
  • Crear nuestro primer html_notebook.
  • Familiarizarnos con propiedades de chunks.

1-parametrizacion-basica.Rmd

• Objetivos:
  • Crear nuestro primer reporte parametrizado.
  • Parametrizar el notebook creado, pero ahora presentado como un documento HTML, pues no hay más código que añadir, solo que ejecutar.
  • Instalaremos el paquete Shiny de R para hacer más interactiva la manera en que definimos parámetros del reporte/documento, esto gracias a los comandos rmarkdown::render("my-file.Rmd",params="ask") y knit with parameters.

2-parametrizacion-interactiva.Rmd

• Objetivo: Crear un menú interactivo para definir los parámetros.

3-horario-parametrizado.Rmd

• Objetivo:
  • Usar parámetros en forma de vectores, para evitar tener que definir una gran cantidad de parámetros, sino más bien parámetros que contienen varios valores.

4-certificado-parametrizados.Rmd

• Objetivo: Producir varias versiones de un mismo archivo.

Último ejemplo:
https://rmarkdown.rstudio.com/articles_mail_merge.html (no descargar)