Clase 2: Documentos parametrizados

class: center, middle, inverse, title-slide

<h1 class = "celeste-ish">
 Clase 2:
 &nbsp; 
 Reportes parametrizados
</h1>

<h3 class = "celeste-ish" style = "position: absolute; bottom: 80px;">
 Autor: Lucio Cornejo
</h3>

---

## Repaso rápido de la sesión pasada

### Estructura de un documento Rmd

&nbsp;

&nbsp;

### ¿Cómo se generan los archivos?

&nbsp;

![rernder_process](images-and-gifs/clase-1-render-process.png)

???

¿Alguien hizo su tarea y desea compartirla con nosotros?

---
class: middle
## Objetivos de esta sesión:

1. Aprender a insertar **código** en un documento **R Markdown**.

1. Familiarizarnos con el formato **html_notebook**.

1. Realizar un reporte no parametrizado.

1. **Parametrizar** el reporte creado anteriormente.

---

## _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á**.

.pull-left[
**Markdown**

Código en línea:
```md
El comando `mean(edades)` sirve para calcular la media 
de un vector denominado _edades_ .
```

&nbsp;

Bloque de código:
````
```r
edades <- c(1,2,3)
mean(edades)
```
````
]

.pull-right[
**R Markdown**

Código en línea:
.scrollable[

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

&nbsp;

Chunk:

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

]

---

## Propiedades principales de chunks

&nbsp;

![chunks](images-and-gifs/main-chunk-options.png)

???

Mostrar propiedades de **chunks** en **RStudio**,
trabajando todos juntos.

---

## Chunks de diversos lenguajes

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

<details>
 <summary>Presionar este texto para mostrarlos u octultarlos.</summary>
 
 awk 
 bash 
 coffee 
 gawk 
 groovy 
 haskell 
 lein 
 mysql 
 node 
 octave 
 perl 
 psql 
 Rscript 
 ruby 
 sas 
 scala 
 sed 
 sh 
 stata 
 zsh 
 highlight 
 Rcpp 
 tikz 
 dot 
 c 
 cc 
 fortran 
 fortran95 
 asy 
 cat 
 asis 
 stan 
 block 
 block2 
 js 
 css 
 sql 
 go 
 python 
 julia 
 sass 
 scss 
 R 
 bslib 
 theorem 
 lemma 
 corollary 
 propositio 
 conjecture 
 definition 
 example 
 exercise 
 hypothesis 
 proof 
 remark 
 solution 
</details>

&nbsp;

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

&nbsp;

.scrollable[
```` 
```{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.

&nbsp;

## ¿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

&nbsp;

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.

&nbsp;

<a href = "https://raw.githubusercontent.com/lucio-cornejo/taller-r-markdown/main/_material/clase-2/0-html-notebook.Rmd" download="0-html-notebook">
0-html-notebook.Rmd
</a>
 &nbsp; 
- Objetivos:
 - Crear nuestro primer html_notebook.
 - Familiarizarnos con propiedades de chunks.

<a href = "https://raw.githubusercontent.com/lucio-cornejo/taller-r-markdown/main/_material/clase-2/1-parametrizacion-basica.Rmd" download="1-parametrizacion-basica">
1-parametrizacion-basica.Rmd
</a>
 &nbsp; 
 - 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_.

???

Guardar en ua misma carpeta todos los archivos R Markdown que crearemos ahora.

---

<a href = "https://raw.githubusercontent.com/lucio-cornejo/taller-r-markdown/main/_material/clase-2/2-parametrizacion-interactiva.Rmd" download="2-parametrizacion-interactiva">
2-parametrizacion-interactiva.Rmd
</a>
 - Objetivo: Crear un menú interactivo para definir los parámetros.

<a href = "https://raw.githubusercontent.com/lucio-cornejo/taller-r-markdown/main/_material/clase-2/3-horario-parametrizado.Rmd" download="3-horario-parametrizado">
3-horario-parametrizado.Rmd
</a>
 - 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.

<a href = "https://raw.githubusercontent.com/lucio-cornejo/taller-r-markdown/main/_material/clase-2/4-certificado-parametrizado.Rmd" download = "4-certificado-parametrizados">
4-certificado-parametrizados.Rmd
</a>
 - Objetivo: Producir varias versiones de un mismo archivo.

&nbsp;

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

---
class: middle

## Links opcionales en caso deseen profundizar más sobre los temas de esta sesión:

- [Propiedades adicionales para chunks](https://yihui.org/knitr/options/)

- <https://garrettgman.github.io/rmarkdown/developer_parameterized_reports.html>

- <https://bookdown.org/yihui/rmarkdown/parameterized-reports.html>

- <https://www.youtube.com/watch?v=oFKb8WYDLB0&ab_channel=BryanJenks>