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
Sección titulada «Prepara el proyecto»Elige el punto de partida Análisis reproducible. Enlaza la carpeta de datos 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
Sección titulada «Dale al asistente una tarea acotada»Usa /oleafly-data-analysis o una tarea de investigación 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
Sección titulada «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 puede ayudarte a convertir un resultado comprobado en una figura para el manuscrito.
Con un agente de CLI, 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
Sección titulada «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. 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
.qmdcon front matter aún se previsualiza, salvo que su front matter tenga una claveknitr:. 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 (se abre en una pestaña nueva) 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.ymlse 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,venvoenvcon Jupyter instalado, y Calepin usa una carpeta.venvcuando 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
pdfobeamernecesita LaTeX. Sin ningún TeX instalado, instala TinyTeX cuando Oleafly lo ofrezca, cambia el documento aformat: typst, o añadepdf-engine: tectonical 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.texpara un PDF, oreport.typpara 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, ypdf-engine: tectonic. Añade las dos, porque la tipografía viene con el motor integrado.pdf-engine: tectonicsolo 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
Sección titulada «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.