Exportación de figuras listas para publicación (R)
La mayor parte del retrabajo en figuras proviene de tres problemas evitables: exportar a un tamaño arbitrario y reducir después, fuentes no incrustadas o diferentes a las de la revista, y paletas que fallan en lectores con daltonismo. Este skill fija el tamaño en milímetros desde el principio, exporta PDF vectorial (fuentes incrustadas) más PNG a un dpi especificado, registra lo exportado, y proporciona dos verificadores independientes (Python, solo librería estándar) para que el resultado quede verificado desde los propios archivos.
Requisitos: R con ggplot2 y systemfonts (opcional: patchwork para composición, svglite para SVG); python3 para los verificadores; pdffonts/pdfinfo (poppler) mejoran las comprobaciones de PDF y se usan si están instalados. Las rutas son relativas a esta carpeta del skill.
Procedimiento
- Fija el objetivo antes de graficar. Elige la revista y columna (
JOURNAL_MM$nature[["single"]]son 89 mm; consultareferences/journal-sizes.md), la altura máxima y el dpi. Anótalos; se usarán en la llamada de exportación y en la auditoría. - Construye el gráfico con el tema y la paleta auxiliares.
source("scripts/paper_figure.R") p <- ggplot(d, aes(x, y, colour = group)) + geom_point() + scale_colour_manual(values = okabe(3, skip_black = TRUE)) + theme_paper()theme_paper()usa un tamaño base de 8 pt, texto de ejes de 6 pt, leyendas de 7 pt, líneas de 0.3 mm y etiquetas de panel en negrita de 10 pt.pf_font()elige Arial, Helvetica o la compatible Liberation Sans (la que esté instalada) e informa cuando recurre a sans genérica. Usa un color por entidad en todas las figuras de un artículo.okabe(n)se detiene en 8 colores: más allá usa facetas, formas o etiquetas directas. - Compón paneles (opcional).
pf_row(list(a, b), tags = c("A","B"))ypf_stack(list(row1, row2), heights = c(1, 1))construyen cada fila de forma independiente, para que la alineación en una fila no distorsione la siguiente; las etiquetas continúan entre filas. - Exporta.
pf_save(p, "fig1", width_mm = 89, height_mm = 70, outdir = "figures", formats = c("pdf","png"), dpi = 300, note = "n = ... por grupo; las barras de error muestran ...")El PDF usa el dispositivo cairo (fuentes incrustadas; sin cairo avisa y recurre a otro).notese convierte en una línea de leyenda envuelta bajo la figura para tamaños muestrales, definición de réplica y estadísticos.figure_manifest.tsvenoutdirregistra nombre, formato, archivo, tamaño, dpi y md5 de cada archivo. Ejecutapf_session("figures/sessionInfo.txt")para conservar las versiones de los paquetes. - Audita los archivos, no la intención.
python3 scripts/figure_audit.py figures/fig1.png figures/fig1.pdf --expect-width-mm 89 --max-height-mm 170 --expect-dpi 300El código de salida 4 y una línea FAIL indican que el tamaño, dpi o las fuentes incrustadas son incorrectos. SKIP significa que una comprobación no pudo ejecutarse (por ejemplo, sinpdffonts); no es un aprobado. - Verifica la paleta cuando uses colores distintos de
okabe():python3 scripts/palette_check.py --colors "#E69F00,#56B4E9,#009E73" --min-delta 15Simula visión protan, deutan y tritan e informa del par más cercano. El código de salida 4 significa que dos colores se vuelven demasiado similares. Es una herramienta de cribado; también revisa la figura con un simulador de daltonismo o en escala de grises, y no te bases solo en el color para líneas finas o puntos pequeños (añade forma o etiquetas directas). - Observa la figura a su tamaño final (imprime el PNG al 100% o abre el PDF con el ancho físico). El texto más pequeño que el mínimo de la revista, las etiquetas superpuestas y los títulos de ejes recortados solo se ven así.
Reglas que evitan fallos conocidos
- El tamaño se fija en milímetros al exportar (
width_mm); nunca reescales un archivo exportado para que encaje. - Usa PDF vectorial para gráficos y el PNG solo para previsualizaciones o contenido exclusivamente raster; las fotografías y mapas de calor con muchas celdas pueden necesitar una capa raster al dpi final.
- Tamaños de texto: mantente dentro del rango de la revista (Nature pide 5-7 pt).
geom_text/annotateusan tamaños en mm: usapt_to_geom(6). - Indica n y qué es una réplica en la nota de la figura o en la leyenda; las barras de error deben explicar qué representan.
- No incrustes veredictos del proyecto ni etiquetas específicas del proyecto en las ayudas compartidas: mantén eso en el script de análisis que llama a
pf_save. - Fuentes: instala Arial/Helvetica o Liberation Sans; si falta una fuente, en la exportación se sustituye silenciosamente por otra familia.
pf_env_check()imprime lo que se está usando.
Salidas
<outdir>/<name>.pdf|png|svg|tiff, figure_manifest.tsv, opcionalmente sessionInfo.txt; informes de auditoría y paleta en stdout.
Pruebas
bash tests/run.sh (27 pruebas): las figuras generadas se auditan para verificar el ancho exacto en píxeles, el dpi registrado, el tamaño de página en mm y las fuentes incrustadas; una exportación simple con pdf() sin fuentes incrustadas debe ser detectada; tamaños incorrectos, dpi incorrecto, metadatos de dpi faltantes, archivos corruptos y argumentos incorrectos deben fallar con los códigos de salida documentados; el verificador de paleta debe aprobar Okabe-Ito y fallar un par rojo/verde bajo deuteranopía. Las pruebas que dependen de R se omiten cuando R no está presente.