Estadística Correlacional

Inferencia, asociación, y reporte

Juan Carlos Castillo
Sociología FACSO - UChile
2do Sem 2026

correlacional.metodos-facso.org


Sesión 14:

Introducción a la escritura en documentos dinámicos en Quarto

A. Texto plano y Markdown

B. Quarto

C. Quarto en Positron

D. ¿Qué se puede hacer en Quarto?

A. Texto plano y Markdown

B. Quarto

C. Quarto en Positron

D. ¿Qué se puede hacer en Quarto?

Flujo de trabajo con procesador de texto tradicional

Abriendo el archivo de escritura tradicional

Desventajas del procesador tradicional

  • Barrera de pago/licencia para acceder a los contenidos

  • Difícil versionamiento: cuesta llevar registro de quién hizo qué cambio, lo que dificulta la reproducibilidad y la colaboración

  • No permite un documento enteramente reproducible que combine el texto con el código de análisis


Un caso conocido: el reporte de una correlación

  • Calculamos en R la correlación entre escolaridad e ingresos: 0.4335

  • Copiamos el número y el gráfico a un procesador de texto

  • Detectamos un error en la base, o decidimos filtrar otros casos. Ahora el coeficiente es 0.362

  • … y hay que rehacer a mano cada cifra, tabla y gráfico del informe

  • ¿Cómo sabe un lector, nuestro equipo o nosotros mismo de dónde salió cada número?

Donde hay cortar/pegar, no hay reproducibilidad

Escritura libre y abierta

  • independiente de programa comercial

  • independiente de plataformas específicas

  • permite combinar texto y análisis en un mismo documento

  • foco en los contenidos en lugar del formato

  • permite distintas opciones de formato final

Escritura simple / plana

  • entorno: editor de texto (en nuestro caso, Positron)

  • separación entre texto de entrada (input) y texto de salida (output)

  • foco en el input/contenido vs. output/formato

  • marcas de edición: vínculo entre el formato del input y del output

  • sin cortar / pegar

Documentos dinámicos

  • La escritura en texto plano permite la ejecución de documentos dinámicos

  • Los documentos dinámicos integran distintas formas de código (de escritura y de análisis)

  • Se evita la práctica no reproducible de cortar/pegar

  • Mayor eficiencia al momento de corregir y volver a ejecutar los análisis

  • Ejemplos: knitr, RMarkdown y… Quarto

Principales alternativas escritura simple

LaTeX

Markdown

  • sistema de escritura simple de amplio uso en la academia

  • alta calidad en salida a pdf

  • creado a comienzos de los 80 (Donald Knuth, Leslie Lamport)

Principales alternativas escritura simple

LaTeX

Markdown

Principales alternativas escritura simple

LaTeX

Markdown

  • creado por John Gruber y Aaron Swartz en 2004

  • forma de escritura simple con pocas marcas de formato

  • conversión a distintos formatos de salida (html, pdf)

  • soporta encabezados, tablas, imágenes, tablas de contenidos, ecuaciones, links …

  • filosofía: foco en contenido primero, el formato después

Principales alternativas escritura simple

LaTeX

Markdown

Principales alternativas escritura simple

LaTeX

Markdown

Principales alternativas escritura simple


Control de formato Marcas de edición Formatos de salida
LaTeX + + -
Markdown - - +

A. Texto plano y Markdown

B. Quarto

C. Quarto en Positron

D. ¿Qué se puede hacer en Quarto?

Desafiando el modelo cortar & pegar

  • Ideal de reproducibilidad: documento donde se combine texto y código que genera resultados presentados.

  • Limitación procesadores de texto: no permiten incorporar código & resultados de manera eficiente

  • Limitación software de análisis: permiten incorporar texto solo en un formato plano, no publicable

Quarto

  • Sistema de publicación científica y técnica de código abierto

  • Sucesor de RMarkdown: misma lógica, más formatos y más lenguajes (R, Python, Julia)

  • Se escribe en texto plano, en archivos .qmd

  • Un mismo archivo puede producir HTML, PDF, Word, presentaciones, sitios web y libros

  • Viene incluido en Positron: no hay que instalar nada adicional


¿Cómo funciona?

flowchart LR
  A[".qmd<br>texto + código"] --> B["knitr<br>ejecuta el código R"]
  B --> C[".md<br>texto + resultados"]
  C --> D["Pandoc<br>convierte"]
  D --> E["HTML"]
  D --> F["PDF"]
  D --> G["Word"]
  D --> H["Presentación"]

  • Todo esto ocurre al presionar un solo botón: Preview (Ctrl+Shift+K)

Anatomía de un archivo .qmd

---
title: "Escolaridad e ingresos en Chile"
author: "Nombre Apellido"
format: html
lang: es
---

## Introducción

Este informe usa datos de la **CASEN 2024**.

```{r}
#| label: datos
load("input/data/casen_barrio2024.rdata")
```

1. Encabezado YAML: título, autor y formato de salida, entre dos líneas de tres guiones

2. Texto en Markdown: lo que lee el lector

3. Bloques de código (chunks): código R que se ejecuta al generar el documento

Marcas de edición en Markdown

Se escribe Se obtiene
## Resultados Un título de sección
**asociación positiva** asociación positiva
*Pearson* Pearson
- primer punto una lista con viñetas
[CASEN](https://...) un enlace
![](img/grafico.png) una imagen

Opciones de los bloques de código

Se escriben al inicio del bloque, con #|

Opción Qué hace
echo: false muestra el resultado, oculta el código
eval: false muestra el código, sin ejecutarlo
include: false ejecuta, pero no muestra ni código ni resultado
warning: false oculta advertencias
fig-cap: "..." agrega una leyenda a la figura
label: fig-... nombra el bloque y permite referirse a la figura

A. Texto plano y Markdown

B. Quarto

C. Quarto en Positron

D. ¿Qué se puede hacer en Quarto?

Nuestra pregunta

¿Se asocia la escolaridad con el ingreso del trabajo en Chile?

  • Datos: CASEN 2024, submuestra aleatoria de 3.000 personas de 18 años o más (repositorio de datos del curso)

  • Variables: escolaridad (años), ingreso_trabajo ($ mensuales), edad (años)

  • Ojo: solo quienes trabajan reportan ingreso del trabajo

Paso 0: la carpeta de trabajo

  • En Positron, la carpeta es el proyecto: File › Open Folder…

  • Proyecto autocontenido: todo está dentro de la carpeta

  • Se evita setwd("C:/Users/...") y .Rproj

  • Se usan rutas relativas: input/data/...

mi-informe/
├── informe.qmd
├── input/
│   └── data/
│       └── casen_barrio2024.rdata
└── output/

Paso 1: crear el documento

  • File › New File… y elegir Quarto Document

  • Escribir el encabezado YAML

  • Presionar Preview (arriba a la derecha) o Ctrl/Cmd + Shift + K

---
title: "Escolaridad e ingresos en Chile"
author: "Nombre Apellido"
format: html
lang: es
---

Paso 2: cargar los datos

  • Insertar un bloque de código: Ctrl/Cmd + Shift + I
```{r}
#| label: datos
library(tidyverse)
load(url("https://raw.githubusercontent.com/cursos-metodos-facso/datos-ejemplos/main/casen_barrio2024.rdata"))  
# crea el objeto datos_casen
```

  • Ejecutar el bloque en la Consola: Ctrl/Cmd + Shift + Enter (o Run Cell sobre el bloque)

  • Ejecutar solo una línea: Ctrl/Cmd + Enter

Paso 3: graficar la relación

```{r}
#| label: fig-dispersion
#| fig-cap: "Escolaridad e ingreso del trabajo"
ggplot(datos_casen,
       aes(x = escolaridad,
           y = ingreso_trabajo)) +
  geom_jitter(alpha = 0.3, width = 0.3) +
  geom_smooth(method = "lm", se = FALSE) +
  labs(x = "Años de escolaridad",
       y = "Ingreso del trabajo ($)")
```

Paso 4: calcular r y reportarlo sin escribirlo a mano

```{r}
#| label: correlacion
r <- cor(datos_casen$escolaridad, datos_casen$ingreso_trabajo,
         use = "complete.obs")
```

En el texto del documento se escribe:

La correlación entre escolaridad e ingreso del trabajo es `r round(r, 2)`.

Y al generar el documento se lee:

La correlación entre escolaridad e ingreso del trabajo es 0.43.

Paso 5: generar el informe

  • Preview o Ctrl/Cmd + Shift + K: el documento aparece en el panel Viewer de Positron

  • El archivo informe.html queda grabado en la misma carpeta que informe.qmd

  • Con Render on Save activado (barra del editor), el informe se actualiza cada vez que se guarda

  • Si cambian los datos, se vuelve a generar y todas las cifras se actualizan solas

1. Escritura abierta y reproducibilidad

2. ¿Qué es Quarto?

3. Quarto en Positron

4. ¿Qué se puede hacer en Quarto?

Un mismo .qmd, muchos formatos

---
title: "Escolaridad e ingresos"
format:
  html: default
  pdf: default
  docx: default
---
  • html: página web (la más rápida)
  • pdf: vía LaTeX o Typst
  • docx: Word, para quien lo pida
  • revealjs: presentación
  • dashboard: panel de indicadores

En Positron: Quarto: Render Document genera todos los formatos declarados.

Informes y artículos

  • Informes de investigación, tesis y artículos académicos

  • Numeración y referencias cruzadas: al escribir @fig-dispersion en el texto, aparece “Figura 1” con su enlace

  • Ecuaciones en LaTeX:

\[ r = \frac{\sum (x_i - \bar{x})(y_i - \bar{y})}{(n-1)\, s_x\, s_y} \]

Referencias bibliográficas

  • La bibliografía se guarda en texto plano: archivo BibTeX (.bib)

  • Zotero + Better BibTeX exporta y actualiza el .bib automáticamente

  • En el YAML: bibliography: input/bib/referencias.bib

  • En el texto: [@pardo2014] → (Pardo, 2014), con la lista de referencias al final

  • El estilo se cambia con un archivo csl (APA, Chicago…), sin reescribir nada

Presentaciones

  • Esta presentación está hecha en Quarto (format: revealjs)

  • Todas las clases del curso son archivos .qmd

  • Los gráficos y resultados de las láminas se calculan al generar la presentación

  • También se puedes generar presentaciones en PowerPoint (pptx) y Beamer (PDF)

Sitios web y libros

Sitios web

  • La página del curso es un sitio Quarto

  • Varios .qmd + un archivo _quarto.yml

  • Publicación gratuita en GitHub Pages o Quarto Pub

Libros

Visualizaciones interactivas

library(plotly)
ggplotly(g)     # convierte un gráfico ggplot en interactivo

library(DT)
datatable(datos_casen)   # tabla con búsqueda y orden

Dashboards y diagramas

  • Dashboards (format: dashboard): paneles de indicadores con gráficos, tablas y valores destacados

  • Diagramas escritos como texto (Mermaid, Graphviz)

  • Shiny y Observable JS para aplicaciones con filtros y controles: VISLATAM

  • Galería de ejemplos: quarto.org/docs/gallery

Resumen

  • Escritura abierta: texto plano, independiente de programas comerciales

  • Documentos dinámicos: texto y código en un solo archivo, sin cortar/pegar

  • Quarto en Positron: .qmd + Preview → informe reproducible

  • Un mismo sistema para informes, presentaciones, sitios web, libros y visualizaciones interactivas

Recursos



Estadística Correlacional

Inferencia, asociación, y reporte

Juan Carlos Castillo
Sociología FACSO - UChile
2do Sem 2026

correlacional.metodos-facso.org