# Escribe a partir de tus datos

Mantén conectados los datos de entrada del análisis, los scripts, las tablas y los resultados del manuscrito.

Un párrafo de resultados inspira más confianza cuando el cálculo que lo respalda está cerca. Usa un proyecto de investigación para mantener el procedimiento de análisis y sus salidas junto al manuscrito.

## Prepara el proyecto

Elige el punto de partida **Análisis reproducible**. [Enlaza la carpeta de datos](/docs/linked-folders/) para que las herramientas de investigación puedan leer las mediciones originales sin moverlas al artículo.

Anota qué significan las columnas, sus unidades y las exclusiones antes de pedir un análisis.

## Dale al asistente una tarea acotada

Usa `/oleafly-data-analysis` o una [tarea de investigación](/docs/research-tasks/) de **Análisis**:

> Lee las mediciones de la carpeta Datos enlazada. Compara las dos condiciones con el método de analysis-plan.md. Guarda el script, una tabla con unidades y una nota que describa las exclusiones. Deja sin cambios los datos de entrada.

Los scripts de análisis necesitan el entorno de ejecución y las bibliotecas locales correspondientes. Pide al asistente que compruebe esos requisitos y que guarde cómo volver a ejecutar el trabajo.

## Inspecciona las salidas

Lee el script y confirma que los datos y el método elegidos se corresponden con la pregunta. Comprueba las unidades, el número de muestras, los valores que faltan y la incertidumbre antes de aceptar un resultado.

Conserva las tablas y las figuras junto con los scripts que las generan. La [habilidad de preparación de figuras](/docs/skills/) puede ayudarte a convertir un resultado comprobado en una figura para el manuscrito.

Con un [agente de CLI](/docs/cli-agents/#research-starting-points), el punto de partida **Auditoría de reproducibilidad** pregunta qué necesita aún cada resultado para poder reproducirse: código, datos, versiones del software, semillas aleatorias e instrucciones de compilación. **Auditoría de figuras** revisa los pies, las etiquetas, las unidades de los ejes y la legibilidad. Los dos piden al agente que escriba un informe en `research/` y que deje el manuscrito en paz.

## Ejecuta el código dentro del documento

Para que las cifras del PDF salgan directamente del código, escribe el informe en [Quarto o Calepin](/docs/engines/#quarto). Quarto ejecuta bloques de R, Python o Julia en un archivo `.qmd` o `.Rmd`, y Calepin ejecuta bloques en un documento de Typst.

- El código sigue desactivado en cada proyecto hasta que eliges **Permitir código en este proyecto**. Con el código desactivado, Quarto muestra el código de cada bloque sin su salida, y Calepin muestra los resultados que guardó la última vez que se ejecutó el código. Los filtros, los shortcodes, una carpeta `_extensions`, los scripts de generación y el código R en línea ejecutan código incluso así, de modo que un proyecto que usa alguno de ellos no se compila hasta que permites el código.
- Con el código desactivado y sin R en el equipo, un archivo `.qmd` con front matter aún se previsualiza, salvo que su front matter tenga una clave `knitr:`. Cualquier otro documento con código R, incluidos los archivos `.Rmd`, necesita R incluso con el código desactivado. Instala R desde [cloud.r-project.org](https://cloud.r-project.org/) y compila otra vez.
- Oleafly necesita Quarto 1.5 o posterior. Si el tuyo es más antiguo, Oleafly usa su propia copia, o te pide que descargues una desde **Ajustes → Motores → Quarto**. Sin ninguna copia descargada, un documento de un proyecto con `_quarto.yml` se compila con tu Quarto más antiguo.
- El código de Python se ejecuta en el entorno propio del proyecto cuando el proyecto tiene una carpeta `.venv`, `venv` o `env` con Jupyter instalado, y Calepin usa una carpeta `.venv` cuando el proyecto la tiene. Si no, el código se ejecuta en el Python que aparece en **Lenguajes**, dentro de **Ajustes → Motores → Quarto**.
- Un documento `pdf` o `beamer` necesita LaTeX. Sin ningún TeX instalado, instala TinyTeX cuando Oleafly lo ofrezca, cambia el documento a `format: typst`, o añade `pdf-engine: tectonic` al front matter para usar el motor integrado una vez permitido el código.
- Quarto escribe un archivo de trabajo con el nombre del documento a su lado: `report.tex` para un PDF, o `report.typ` para Typst. Si un archivo tuyo ya tiene ese nombre, la compilación se detiene y lo nombra en lugar de reemplazarlo. Cambia el nombre de tu archivo o muévelo, y compila otra vez.
- Si faltan caracteres coreanos, chinos o japoneses en el PDF, la advertencia nombra una tipografía y da dos líneas para añadir al front matter: `CJKmainfont:` con esa tipografía, y `pdf-engine: tectonic`. Añade las dos, porque la tipografía viene con el motor integrado. `pdf-engine: tectonic` solo funciona una vez permitido el código para el proyecto.
- Un cuaderno puede ejecutarse hasta una hora. Pasado ese tiempo, Oleafly lo detiene y el registro muestra la celda a la que llegó. Acorta o guarda en caché esa celda, y compila otra vez.

## Escribe el resultado

Pide al asistente que redacte un pasaje de resultados usando solo las salidas revisadas. Comprueba cada cifra con la tabla y mantén el método separado de la interpretación.

Compila el documento y revisa en el PDF la tabla o la figura completa, con sus etiquetas y su pie.
