Trabajo final: plantilla y proyecto reproducible

Sesión del miércoles, 11 de noviembre de 2026

Objetivo de la sesión

En las sesiones anteriores aprendimos a escribir documentos dinámicos con Quarto y a presentar gráficos y tablas en R. Ahora utilizaremos esas herramientas para organizar el trabajo final como un proyecto de investigación reproducible. En lugar de comenzar un análisis nuevo, trabajaremos con los datos, las variables y los resultados que cada grupo ya ha desarrollado.

Durante esta sesión revisaremos la plantilla del informe, identificaremos dónde incorporar los análisis y comprobaremos cómo compartir el proyecto para que otra persona pueda generar nuevamente sus resultados. Finalmente, dedicaremos un espacio a revisar los avances y las dificultades pendientes de cada grupo.

Plantilla del trabajo final

La plantilla contiene la estructura del informe, una tabla de operacionalización de variables y ejemplos mínimos de una figura y una cita bibliográfica. Los ejemplos son ilustrativos: deberán reemplazarlos por los resultados y fuentes de su propia investigación. Su diseño ya está preparado, por lo que no necesitan construir el informe desde cero.

Descargar plantilla del trabajo final (ZIP)

Para utilizarla, descarguen y descompriman el archivo. En Positron, seleccionen File → Open Folder y abran la carpeta completa del proyecto. La redacción del informe se realiza principalmente en index.qmd.

1 Del documento dinámico al proyecto reproducible

Un documento dinámico permite integrar el texto y el código de análisis en un archivo .qmd. Al renderizarlo, Quarto ejecuta el código correspondiente y produce un documento con los resultados actualizados. Sin embargo, obtener un HTML no garantiza, por sí solo, que otra persona pueda reproducir la investigación: si faltan los datos o los scripts, no será posible reconstruir las tablas, las cifras y los gráficos.

Por eso, para el trabajo final organizaremos un proyecto autocontenido: una carpeta que reúne los archivos necesarios para realizar el análisis y generar el informe. Podemos representar su funcionamiento de la siguiente manera:

Organización de los archivos (IPO)

Input

Datos y bibliografía

Processing

Preparación y análisis en R

Output

Gráficos y tablas exportados

Publicación del informe

Informe Quarto (index.qmd)

Texto, código y resultados

HTML final

Documento para lectura y entrega

El esquema Input–Processing–Output describe cómo organizamos las carpetas del proyecto. El archivo index.qmd utiliza los insumos y análisis pertinentes para generar el HTML. No es obligatorio exportar primero todos los gráficos y tablas a output/: Quarto también puede producirlos directamente al renderizar el documento.

Conviene distinguir tres conceptos que están relacionados, pero no son equivalentes:

Concepto ¿Qué significa en nuestro trabajo?
Documento dinámico El informe puede actualizar sus resultados al ejecutar el código del .qmd.
HTML autocontenido El archivo de salida incorpora los recursos necesarios para visualizarse sin depender de archivos auxiliares de presentación, cuando se configura para ello.
Proyecto reproducible Se conservan los datos, el código y los demás insumos necesarios para reconstruir el análisis y generar nuevamente el informe.

1.0.1 Esquema general de un proyecto reproducible

Figura 1: Esquema general de organización de un proyecto de investigación reproducible.

Fuente: Ciencia Social Abierta.

Este esquema permite visualizar cómo se relacionan los distintos componentes de un proyecto reproducible. A continuación, veremos cómo se organiza concretamente la plantilla que utilizaremos en el trabajo final.

2 Organización del proyecto: estructura IPO

La plantilla utiliza la organización IPO (Input–Processing–Output). Su propósito es separar los insumos, el código de análisis y los productos del trabajo, de modo que los integrantes del grupo puedan localizar los archivos y comprender cómo se generaron los resultados. Esta estructura también facilita que el proyecto se abra en otro computador sin depender de carpetas personales.

Estas son las carpetas principales y los archivos de referencia de la plantilla:

Plantilla-trabajo-final-2026/
├── index.qmd                 # Documento del informe
├── _quarto.yml               # Configuración general
├── README.md                 # Instrucciones del proyecto
├── .gitignore                # Archivos excluidos de Git
├── input/
│   ├── data/
│   │   ├── original/         # Datos originales
│   │   └── proc/             # Datos preparados
│   ├── images/               # Imágenes incorporadas
│   └── bib/
│       ├── referencias.bib   # Referencias bibliográficas
│       └── apa.csl           # Estilo de citación
├── processing/
│   ├── 01_preparacion.R      # Preparación de datos
│   └── 02_analisis.R         # Análisis estadísticos
├── output/
│   ├── graphs/               # Gráficos exportados
│   └── tables/               # Tablas exportadas
└── libs/
    └── custom.scss          # Estilos del informe

Input guarda los insumos del estudio: las bases originales y preparadas, las imágenes y la bibliografía. Processing contiene los scripts de preparación y análisis. Output se reserva para gráficos y tablas que se exportan como archivos independientes cuando sea necesario. Finalmente, index.qmd reúne la escritura y los resultados para producir el informe HTML.

La mayor parte del trabajo se concentrará en index.qmd, las bases guardadas en input/data/ y los scripts ubicados en processing/. En cambio, _quarto.yml y libs/custom.scss ya contienen la configuración y el diseño del informe; no necesitan modificarlos para comenzar. Los archivos .gitkeep que puedan encontrar dentro de algunas carpetas sirven para conservarlas vacías en Git y no requieren ninguna acción especial.

3 Verificar la reproducibilidad del proyecto

Un proyecto puede ejecutarse correctamente en el computador de un integrante del grupo y fallar cuando otra persona intenta abrirlo. Una causa frecuente es el uso de rutas absolutas, que indican una ubicación particular del computador. Para facilitar el trabajo colaborativo, los archivos deben buscarse mediante rutas relativas a la carpeta del proyecto.

Ruta personal: evitar

readRDS("C:/Users/Estudiante/Downloads/encuesta.rds")

Ruta relativa: preferir

readRDS("input/data/proc/encuesta.rds")

En el segundo caso, R buscará encuesta.rds dentro de la carpeta input/data/proc/ del proyecto. Por supuesto, esa base debe estar guardada allí. Cuando el archivo original es demasiado grande, se puede conservar un subconjunto de los datos necesarios junto con el código que permite prepararlo, siguiendo las indicaciones de la pauta del curso.

Para comprobar el funcionamiento del proyecto, guarden sus cambios y generen el informe mediante Preview en Positron o ejecutando el siguiente comando desde la carpeta raíz:

quarto render index.qmd
quarto preview index.qmd

Después, si es posible, copien la carpeta completa a otra ubicación y repitan la renderización sin modificar las rutas. Esta prueba ayuda a detectar dependencias de archivos personales o faltantes.

ImportanteUna distinción importante

Abrir un HTML no es lo mismo que reproducir un análisis. La plantilla inicial puede generar su figura ilustrativa aunque los scripts de investigación todavía no estén activos. Cuando incorporen los datos y análisis del grupo, deberán comprobar que esos procedimientos también se ejecutan y que el HTML presenta sus resultados reales.

4 Citas y bibliografía con BibTeX

La plantilla también permite incorporar citas y generar automáticamente la bibliografía. Para ello utiliza BibTeX, un formato que guarda los datos de cada fuente (autoría, título, año, entre otros) en el archivo input/bib/referencias.bib. Cada referencia tiene una clave única que permite citarla desde index.qmd. Por ejemplo, una entrada se organiza así (datos ilustrativos):

@article{apellido2026,
  author  = {Apellido, Nombre},
  title   = {Título del artículo},
  journal = {Nombre de la revista},
  year    = {2026}
}

En la plantilla encontrarán la clave wickham2023r. Para utilizarla en el informe, pueden escribir:

Según @wickham2023r, ...

La organización de los datos facilita el análisis reproducible [@wickham2023r].

Al renderizar el documento, Quarto transforma estas marcas en citas y construye la lista de referencias. El archivo input/bib/apa.csl define el estilo de citación APA. Para incorporar sus propias fuentes, deben agregarlas a referencias.bib y citar sus claves en el texto. No es necesario escribir manualmente la bibliografía al final del informe.

Estos recursos fueron revisados en las clases anteriores. Si necesitan recordar cómo preparar las figuras, las tablas o sus referencias cruzadas, pueden consultar la sesión de visualización. No deben conservar los resultados ni las referencias de ejemplo en la entrega: su función es mostrar cómo se verá el informe cuando incorporen su propio trabajo.

Cada grupo deberá reemplazar las figuras, las tablas, las interpretaciones y las referencias ilustrativas de la plantilla por las que correspondan a su propia investigación.

5 Revisión de avances del trabajo grupal

Para finalizar el trabajo necesitamos reconocer qué partes de la investigación ya están resueltas y cuáles requieren atención. Este monitoreo no constituye una nueva evaluación: es una instancia para que cada grupo organice sus pendientes y pueda plantear preguntas concretas al equipo docente.

A continuación, revisaremos los principales componentes del informe para identificar qué aspectos tiene avanzado cada grupo y cuáles requieren mayor atención. Esta revisión servirá para orientar las consultas y priorizar el trabajo pendiente antes de la entrega.

Componente del informe Qué revisar
Tema, pregunta y conceptos Claridad y coherencia del problema.
Objetivo e hipótesis Correspondencia con el análisis.
Base de datos y selección de casos Disponibilidad y justificación.
Variables, recodificaciones y descriptivos Preparación y documentación.
Cruce entre variables categóricas Análisis e interpretación.
Análisis entre variable continua y categórica Análisis e interpretación.
Gráficos, tablas e interpretaciones Presentación y explicación de los resultados.
Introducción, discusión y conclusiones Coherencia argumentativa.
Citas, bibliografía y proyecto reproducible Fuentes, archivos y renderización.

Durante la asesoría conversaremos con cada grupo a partir de tres preguntas: ¿qué tenemos avanzado y podemos incorporar al informe?, ¿qué nos falta completar antes de la entrega? y ¿qué dificultad concreta necesitamos resolver con el equipo docente?

A partir de esta revisión, cada grupo debería identificar hasta dos prioridades principales para continuar su trabajo. Si existen dificultades metodológicas o técnicas, pueden plantearlas al equipo docente durante la asesoría.

6 Preparación de la entrega

El producto final es un informe académico en HTML generado con Quarto, acompañado de una carpeta comprimida que permita revisar el trabajo realizado. Según las instrucciones oficiales, esa carpeta debe incluir el archivo .qmd, los datos utilizados, los scripts correspondientes y el HTML generado.

Antes de entregar, es importante comprobar que el documento presenta los resultados reales del grupo, que las figuras y tablas están identificadas e interpretadas, y que las rutas permiten generar nuevamente el informe. Asimismo, recuerden reemplazar la figura y la referencia bibliográfica ilustrativas que vienen en la plantilla.

Idea central: un proyecto reproducible no es únicamente un informe bien presentado; también permite reconstruir el procedimiento mediante el cual se obtuvieron los resultados de la investigación.

TipRecursos