Introducción al uso de Quarto

Taller

Xavier Buenaño

Indicaciones Generales

Puedes obtener recursos complementarios en: Quarto Herramientas Complementarias.

Las credenciales de acceso a la base de datos serán entregadas durante el desarrollo del taller.

Todas las preguntas son bienvenidas.

Encuéntrame en:

@BXgoodyear

xgoodyear@gmail.com

Supuestos

Conoces algún lenguaje de programación.


Conoces algo sobre Markdown.


Quieres aprender sobre Quarto, la siguiente generación de RMarkdown.

Pre-requisitos

  • Tienes RStudio v.2022.07.0-548 o superior?


  • Tienes la última versión de Quarto?


  • Tienes instaladas las librerías de R requeridas en este taller?
```{r}
#| label: librerias
pacman::p_load(RPostgreSQL, tidyverse, kableExtra, glue)
```


Perfecto, empezamos !

¿ Qué es Quarto ?

Quarto es un sistema de publicación técnico y científico de código abierto construido en Pandoc.





Es posible integrar texto narrativo y código para producir salidas formateadas elegantemente, como: documentos, páginas web, blogs, libros y más.

Es una interfase en línea de comandos (CLI, por sus siglas en inglés) que renderiza textos en formato plano (.qmd, .rmd, .md) ó mixtos (.ipynb/Jupyter notebook) a visuales.

Compilación

Flujo de compilación clásico (Usado con RMarkdown)

Compilación (nuevo enfoque)

Flujo de compilación integrador

Formatos de salida

Aprende más: Formatos de salida

Código ejecutable

library(ggplot2)
ggplot(mtcars, aes(hp, mpg, color = am)) +
  geom_point() +
  geom_smooth(formula = y ~ x, method = "loess")

Estructura de documento Quarto

  • Metadato (Cabecera YAML)
---
title: "My document"
---
  • Código
```{r}
#| eval: true
library(dplyr)
mtcars %>% 
  group_by(cyl) %>%
  summarize(mean = mean(mpg), .groups = "drop")
```
  • Texto
## Introducción

Esta es una oración con **texto en negrilla**, some *texto en cursiva* y una [Imagen](imagenes/quarto_logo.png)

Configuración de pedazo de código (chunk)

```{r}
#| label: fig-grafica1
#| fig-cap: Gráfica de dispersión

ggplot(mtcars, aes(x=mpg, y=disp)) + geom_point()
```

Figure 1: Gráfica de dispersión

Referencias cruzadas

Una vez que el chunk, tenga definida correctamente su etiqueta (label), es posible realizar una referencia cruzada con @fig-, @tab-.


Nótese que las etiquetas de las figuras deben iniciar con el prefijo fig- y las de las tablas deben iniciar con el prefijo tab-.

Código en línea

A continuación código en línea:

#r mean(mtcars$mpg)


Es necesario anteponer tilde invertida antes y después del código. La primera tilde invertida debe estar acompañada de la letra `r.


Y el resultado:

20.090625

Parametrización

A veces es necesario generar varios reportes, relacionados con fechas, cobertura geográfica, grupos etáreos, etc.


Puedes incluir el metaparámetro params en la cabecera YAML para definir el o los parámetros requeridos para el reporte.

---
title: "My document"
params:
  anio: 2020
  provincia: PICHINCHA
---


En el cuerpo del reporte, debes relacionar o usar el/los parámetros, mediante: params$anio, por ejemplo.

Modos Source y Visual en RStudio

Recursos

Nota

Este minicurso se basa en los contenidos de la charla dictada por Tom Mock de RStudio en agosto de 2022.

Teorema