Cómputos

Introducción

Esta guía provee lo esencial para integrar R con Quarto. Perfecto para usuarios de R de todos los niveles, este tutorial cubre:

  • Configuración: Pasos rápidos para instalar rmarkdown y preparar tu entorno.
  • Ejecución de código: Aprende a ejecutar y controlar bloques de código R dentro de tus documentos Quarto.
  • Código en línea: Incruste código R dinámico en su texto para actualizaciones en tiempo real.
  • Características Avanzadas: Explora las opciones de chunk y el formato para mejorar tus documentos.


Requisitos previos

Instale el paquete R rmarkdown.

install.packages("rmarkdown")

Bloque de código

Sintaxis de bloques de código R ejecutables: ```{r}. Ejemplo:

---
title: "Código R"
---

Ejemplo de código: 

```{r}
print("Hellow World")
```

Código en línea

  • Incrustar código en vivo en markdown con una sola marca () en lugar de triple (```).
  • Ejemplo: Establecer radius en un bloque de código y referenciarlo en el texto con código inline.
```{r}
radius <- 5
```

El radio del círculo es `{r} radius`

Usa la función I() para sintaxis markdown en expresiones inline:

Esto es `{r} I("**bold**")`

Renderización

Leer renderizar documentos Quarto que contengan bloques de código Python o R.

Opciones Chunk

En Quarto, las opciones de chunk se colocan en comentarios en la parte superior de los chunks de código, no en la línea chunk-start:

```{r}
#| echo: false
#| fig-cap: "Calidad del aire"

library(ggplot2)
ggplot(airquality, aes(Temp, Ozone)) + 
  geom_point() + 
  geom_smooth(method = "loess", se = FALSE)
```

Las opciones utilizan la sintaxis YAML, con !expr para el código R en los valores siguientes:

#| fig-cap: !expr 'paste("Air", "Quality")'

Formatos de salida

En Quarto, usa la sintaxis format key instead of output:

R Markdown

title: "Mi documento"
output:
  html_document:
    toc: true
    number_sections: true
    css: styles.css

Quarto

title: "Mi documento"
format:
  html:
    toc: true
    number-sections: true
    css: styles.css

Quarto se alinea con Pandoc, usando - en las opciones.

Marcos de datos

Controla la impresión por defecto del marco de datos en tu documento con la opción df-print. Las opciones incluyen:

  • default: Utiliza el método estándar S3 del marco de datos.
  • kable: Genera una tabla Markdown vía knitr::kable().
  • tibble: Muestra una tabla de texto plano con el paquete tibble.
  • paged: Crea una tabla HTML con paginación para datos grandes mediante rmarkdown::paged_table().

Para configurar la impresión paged para marcos de datos:

---
title: "Documento"
format: 
   html:
     df-print: paged
---

Opciones Knitr

Para la ejecución Knitr, establezca por defecto chunk options en YAML:

---
title: "Mi documento"
format: html
knitr:
  opts_chunk: 
    collapse: true
    comment: "#>"
    R.options:
      knitr.graphics.auto_pdf: true
---

Utiliza opts_knit para la configuración global. R.options Establece temporalmente R options() antes de la ejecución. Aplique estas configuraciones en todo el documento o en un proyecto _quarto.yml or _metadata.yml.

Referencias