Introducción al análisis de datos con R para Ciencias Sociales

Comunicar con Quarto

1. Comunicar resultados con Quarto

¿Qué es Quarto?

Quarto es una herramienta que permite combinar:

• Texto
• Código
• Resultados
• Gráficos
• Tablas

en un único documento reproducible.

Un archivo Quarto utiliza la extensión:

.qmd

y puede exportarse a múltiples formatos como:

• HTML
• PDF
• Word
• PowerPoint
• RevealJS (presentaciones web)

Diferencias entre .R, .Rmd y .Qmd

Tipo de archivo	Contiene código	Contiene texto	Exporta documentos
.R	Sí	No	No
.Rmd	Sí	Sí	Sí
.qmd	Sí	Sí	Sí

Script R (.R)

Ideal para:

• Automatizaciones
• Funciones
• Procesamiento de datos

mean(c(1,2,3))

R Markdown (.Rmd)

Combina:

• texto
• código
• resultados

Fue durante muchos años el estándar de RStudio.

Quarto (.Qmd)

Es la evolución de R Markdown.

Ventajas:

• Mayor flexibilidad
• Soporte para múltiples lenguajes
• Mejor integración con HTML moderno
• Presentaciones RevealJS
• Sitios web
• Libros
• Dashboards

2. Markdown básico

Markdown es un lenguaje sencillo para dar formato al texto.

Títulos

# Título principal

## Subtítulo

### Sección

#### Subsección

Negrita e itálica

**Texto en negrita**

*Texto en cursiva*

***Negrita y cursiva***

Resultado:

Texto en negrita

Texto en cursiva

Negrita y cursiva

Listas

Lista con viñetas

- Elemento 1
- Elemento 2
- Elemento 3

• Elemento 1
• Elemento 2
• Elemento 3

Lista numerada

1. Primer paso
2. Segundo paso
3. Tercer paso

Enlaces

[Google](https://www.google.com)

Imágenes

![](imagen.png)

Citas

> Esta es una cita.

Resultado:

Esta es una cita.

Tablas

| Variable | Tipo |
|-----------|------|
| salario | numérica |
| seniority | categórica |

Separadores

---

3. YAML

¿Qué es YAML?

YAML es el encabezado que aparece al comienzo de un documento Quarto.

Controla:

• título
• autor
• formato de salida
• apariencia
• numeración
• tablas de contenido

Siempre aparece entre:

---
...
---

YAML mínimo

---
title: "Mi primer informe"
format: html
---

YAML con tabla de contenidos

---
title: "Análisis descriptivo"
author: "Juan Pérez"
date: today

format:
  html:
    toc: true
    code-fold: true
---

YAML para una presentación RevealJS

---
title: "Clase de R"

format:
  revealjs:
    slide-number: true
    transition: fade
---

YAML con tema visual

---
title: "Reporte"

format:
  html:
    theme: cosmo
---

Otros temas:

• cosmo
• flatly
• litera
• minty
• pulse
• sandstone
• united
• yeti

Más temas acá

4. Opciones de chunks

Las opciones de los chunks permiten controlar qué se ejecuta y qué se muestra en el documento final.

4.1 echo

echo controla si el código se muestra o no en el documento.

     speed           dist       
 Min.   : 4.0   Min.   :  2.00  
 1st Qu.:12.0   1st Qu.: 26.00  
 Median :15.0   Median : 36.00  
 Mean   :15.4   Mean   : 42.98  
 3rd Qu.:19.0   3rd Qu.: 56.00  
 Max.   :25.0   Max.   :120.00  

El resultado aparecerá en el documento, pero no el código.

---

4.2 eval

eval permite mostrar código sin ejecutarlo.

#install.packages("tidyverse")
library(tidyverse)

Warning: package 'tidyverse' was built under R version 4.3.3

Warning: package 'tibble' was built under R version 4.3.3

Warning: package 'tidyr' was built under R version 4.3.3

Warning: package 'readr' was built under R version 4.3.3

Warning: package 'purrr' was built under R version 4.3.3

Warning: package 'dplyr' was built under R version 4.3.3

Warning: package 'stringr' was built under R version 4.3.3

Warning: package 'forcats' was built under R version 4.3.3

Warning: package 'lubridate' was built under R version 4.3.3

── Attaching core tidyverse packages ──────────────────────── tidyverse 2.0.0 ──
✔ dplyr     1.1.4     ✔ readr     2.1.5
✔ forcats   1.0.0     ✔ stringr   1.5.1
✔ ggplot2   3.5.2     ✔ tibble    3.2.1
✔ lubridate 1.9.4     ✔ tidyr     1.3.1
✔ purrr     1.0.4     
── Conflicts ────────────────────────────────────────── tidyverse_conflicts() ──
✖ dplyr::filter() masks stats::filter()
✖ dplyr::lag()    masks stats::lag()
ℹ Use the conflicted package (<http://conflicted.r-lib.org/>) to force all conflicts to become errors

Es útil para mostrar ejemplos que no queremos ejecutar durante el renderizado.

---

4.3 include

include oculta tanto el código como los resultados.

Suele utilizarse para cargar librerías o preparar objetos auxiliares.

---

4.4 warning

warning permite ocultar advertencias.

as.numeric(c("1","2","texto"))

[1]  1  2 NA

Sin esta opción aparecería una advertencia indicando que se generaron valores faltantes.

---

4.5 message

message permite ocultar mensajes informativos.

library(tidyverse)

Muy útil para evitar que aparezcan los mensajes de carga de paquetes.

---

4.6 error

error permite continuar renderizando el documento aunque exista un error.

1 / "texto"

Error in 1/"texto": argumento no-numérico para operador binario

El error aparecerá en el documento, pero el renderizado continuará.

---

4.7 fig-width y fig-height

Permiten controlar el tamaño de una figura.

hist(mtcars$mpg)

---

4.8 fig-cap

Permite agregar una leyenda o caption a una figura.

hist(mtcars$mpg)

Distribución de millas por galón

---

4.9 Insertar imágenes con Markdown

Una imagen puede insertarse directamente mediante Markdown:

![](../varios/logoNIS.png)

También podemos controlar su tamaño:

![](../varios/logoNIS.png){width=50%}

---

4.10 Insertar imágenes con knitr

Otra alternativa es utilizar knitr::include_graphics():

Logo Institucional

Esta opción es útil porque la imagen se comporta como una figura y puede recibir captions, numeración y referencias cruzadas.

---

knit

Opción	Función
echo	Mostrar u ocultar código
eval	Ejecutar o no ejecutar
include	Ocultar código y resultados
warning	Ocultar advertencias
message	Ocultar mensajes
error	Continuar ante errores
fig-width	Ancho de figura
fig-height	Alto de figura
fig-cap	Leyenda de figura

Más info en la documentación

Resumen

1. Quarto = texto + código + resultados.
2. Markdown = cómo escribimos el contenido.
3. YAML = cómo configuramos el documento.
4. KNIT = opciones de kniteo de chunks