CommunityImagengithub.com

exportacion-figuras-articulo

Exporta figuras listas para publicación desde R (ggplot2/patchwork) con tamaño físico definido, fuentes incrustadas, paleta Okabe-Ito segura para daltonismo, PNG a 300+ dpi, nota de pie y manifiesto de exportación; luego audita los archivos (tamaño en mm, dpi, fuentes) y verifica la paleta para deficiencias de visión cromática. Útil para figuras de revistas, anchos de columna Nature/Cell, 'hacer esta figura lista para publicación', incrustación de fuentes, dpi de figura, composición de paneles, colores seguros para daltonismo.

¿Qué es exportacion-figuras-articulo?

Este skill, diseñado para agentes de IA como Claude Code o Cursor, automatiza el flujo de trabajo completo para crear figuras listas para publicación científica en R (ggplot2/patchwork). Resuelve los tres problemas más comunes que obligan a rehacer figuras: tamaño de exportación arbitrario que luego se reescala, fuentes no incrustadas o incorrectas para la revista, y paletas que fallan en lectores con daltonismo. El skill fija el tamaño en milímetros desde el principio, exporta PDF vectorial (con fuentes incrustadas) y PNG a un dpi específico, genera un manifiesto de exportación con metadatos, y proporciona dos verificadores independientes en Python (solo librería estándar) que auditan los archivos resultantes para confirmar tamaño, dpi y fuentes, y que verifican la paleta de colores simulando visión protan, deutan y tritan. Soporta composición de paneles con pf_row y pf_stack, y anima a usar una paleta Okabe-Ito de hasta 8 colores, segura para daltonismo. Es compatible con flujos de trabajo en R y Python, y se integra con herramientas como pdfinfo/pdffonts de poppler para verificaciones más completas.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/harshameghadri/claude-bioinfo-skills/tree/HEAD/skills/paper-figure-export

Installed? Explore more Imagen skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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

  1. Fija el objetivo antes de graficar. Elige la revista y columna (JOURNAL_MM$nature[["single"]] son 89 mm; consulta references/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.
  2. 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.
  3. Compón paneles (opcional). pf_row(list(a, b), tags = c("A","B")) y pf_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.
  4. 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). note se 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.tsv en outdir registra nombre, formato, archivo, tamaño, dpi y md5 de cada archivo. Ejecuta pf_session("figures/sessionInfo.txt") para conservar las versiones de los paquetes.
  5. 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 300 El 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, sin pdffonts); no es un aprobado.
  6. Verifica la paleta cuando uses colores distintos de okabe(): python3 scripts/palette_check.py --colors "#E69F00,#56B4E9,#009E73" --min-delta 15 Simula 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).
  7. 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/annotate usan tamaños en mm: usa pt_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.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados