CommunityImagegithub.com

Exportation de figures prêtes pour publication (R)

Exportez des figures prêtes pour publication depuis R (ggplot2/patchwork) avec une taille physique définie, des polices incorporées, une palette Okabe-Ito adaptée aux daltoniens, un PNG à 300+ dpi, une note de légende et un manifeste d'exportation, puis auditez les fichiers et vérifiez la palette pour les carences de vision des couleurs.

Qu'est-ce que Exportation de figures prêtes pour publication (R) ?

Cette compétence permet d'exporter des figures scientifiques prêtes pour publication directement depuis R. Elle résout trois problèmes courants dans la reprise des figures : taille arbitraire, polices non incorporées et palettes inadaptées aux daltoniens. Elle supporte l'exportation en PDF vectoriel avec polices incorporées et en PNG à une résolution définie (300 dpi par défaut), enregistre un manifeste complet et fournit deux vérificateurs indépendants (Python, uniquement bibliothèque standard). Les scripts auditeur vérifient la taille en millimètres, le dpi et les polices incorporées à partir des fichiers eux-mêmes, tandis que le vérificateur de palette simule les déficiences protan, deutan et tritan pour signaler les combinaisons trop similaires. Cette compétence est idéale pour les figures de revues à comité de lecture, notamment Nature, Cell ou toute publication exigeant des dimensions précises en colonnes, des polices vectorielles et des couleurs accessibles. Elle s'utilise avec R, ggplot2 et les scripts associés présents dans le dossier. Le test automatisé (27 tests) valide l'intégrité des fichiers exportés et le comportement des vérificateurs.

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

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait Exportation de figures prêtes pour publication (R) ?

La plupart des reprises de figures proviennent de trois erreurs évitables : exporter à une taille arbitraire et réduire plus tard, des polices non incorporées ou non conformes à la revue, et des palettes qui échouent pour les lecteurs daltoniens. Cette compétence fixe la taille en millimètres en amont, exporte un PDF vectoriel (polices incorporées) plus un PNG à une résolution donnée, enregistre ce qui a été exporté, et fournit deux vérificateurs indépendants (Python, uniquement bibliothèque standard) pour que le résultat soit vérifié à partir des fichiers eux-mêmes.

Prérequis : R avec ggplot2 et systemfonts (optionnel : patchwork pour la composition, svglite pour SVG) ; python3 pour les vérificateurs ; pdffonts/pdfinfo (poppler) améliorent les vérifications PDF et sont utilisés s'ils sont installés. Les chemins sont relatifs au dossier de cette compétence.

Procédure

  1. Fixez la cible avant de tracer. Choisissez la revue et la colonne (JOURNAL_MM$nature[["single"]] fait 89 mm ; voir references/journal-sizes.md), la hauteur maximale et le dpi. Notez-les ; ils seront utilisés dans l'appel d'exportation et l'appel d'audit.
  2. Construisez le graphique avec le thème et la palette d'aide.
    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() utilise une police de base de 8 pt, un texte d'axe de 6 pt, des légendes de 7 pt, des lignes de 0,3 mm et des étiquettes de panneau en gras de 10 pt. pf_font() choisit Arial, Helvetica ou la police compatible métriquement Liberation Sans, selon celle qui est installée, et le signale lorsqu'elle se replie sur une police sans empattement générique. Utilisez une couleur par entité dans toutes les figures d'un article. okabe(n) s'arrête à 8 couleurs : au-delà, utilisez des facettes, des formes ou des étiquettes directes.
  3. Composez les panneaux (optionnel). pf_row(list(a, b), tags = c("A","B")) et pf_stack(list(row1, row2), heights = c(1, 1)) construisent chaque ligne indépendamment, afin que l'alignement dans une ligne ne déforme pas la suivante ; les étiquettes continuent sur les lignes.
  4. Exportez. pf_save(p, "fig1", width_mm = 89, height_mm = 70, outdir = "figures", formats = c("pdf","png"), dpi = 300, note = "n = ... par groupe ; les barres d'erreur montrent ...") Le PDF utilise le périphérique cairo (polices incorporées ; sans cairo, il émet un avertissement et se replie). note devient une ligne de légende enveloppée sous la figure pour les tailles d'échantillon, la définition des réplicats et les statistiques. figure_manifest.tsv dans outdir enregistre le nom, le format, le fichier, la taille, le dpi et le md5 de chaque fichier. Exécutez pf_session("figures/sessionInfo.txt") pour conserver les versions des paquets.
  5. Auditez les fichiers, pas l'intention. python3 scripts/figure_audit.py figures/fig1.png figures/fig1.pdf --expect-width-mm 89 --max-height-mm 170 --expect-dpi 300 Une sortie 4 et une ligne FAIL signifient que la taille, le dpi ou l'incorporation des polices sont incorrects. SKIP signifie qu'une vérification n'a pas pu être exécutée (par exemple, pas de pdffonts) ; ce n'est pas une réussite.
  6. Vérifiez la palette lorsque vous utilisez des couleurs autres que okabe() : python3 scripts/palette_check.py --colors "#E69F00,#56B4E9,#009E73" --min-delta 15 Il simule les visions protan, deutan et tritan et signale la paire la plus proche. Une sortie 4 signifie que deux couleurs deviennent trop similaires. Il s'agit d'une heuristique de filtrage ; examinez également la figure avec un simulateur de daltonisme ou en niveaux de gris, et ne vous fiez pas uniquement à la couleur pour les lignes fines ou les petits points (ajoutez une forme ou des étiquettes directes).
  7. Regardez la figure à la taille finale (imprimez le PNG à 100 % ou ouvrez le PDF à la largeur physique). Le texte plus petit que le minimum de la revue, les étiquettes qui se chevauchent et les titres d'axes tronqués ne sont visibles que de cette façon.

Règles qui évitent les échecs connus

  • La taille est définie en millimètres à l'exportation (width_mm) ; ne redimensionnez jamais un fichier exporté pour l'adapter.
  • Utilisez le PDF vectoriel pour les graphiques et le PNG uniquement pour les aperçus ou le contenu purement matriciel ; les photographies et les cartes de chaleur avec un très grand nombre de cellules peuvent nécessiter une couche matricielle au dpi final.
  • Tailles de texte : restez dans la plage de la revue (Nature demande 5-7 pt). Les tailles geom_text/annotate sont en mm : utilisez pt_to_geom(6).
  • Indiquez n et ce qu'est un réplicat dans la note de la figure ou la légende ; les barres d'erreur doivent préciser ce qu'elles sont.
  • N'incorporez pas de verdicts de projet ou d'étiquettes spécifiques au projet dans les aides partagées : gardez-les dans le script d'analyse qui appelle pf_save.
  • Polices : installez Arial/Helvetica ou Liberation Sans ; une police manquante devient silencieusement une famille différente dans l'exportation. pf_env_check() affiche ce qui est utilisé.

Sorties

<outdir>/<name>.pdf|png|svg|tiff, figure_manifest.tsv, éventuellement sessionInfo.txt ; rapports d'audit et de palette sur stdout.

Test

bash tests/run.sh (27 tests) : les figures générées sont auditées pour la largeur exacte en pixels, le dpi enregistré, la taille de page en mm et les polices incorporées ; une exportation pdf() simple avec des polices non incorporées doit être détectée ; des tailles erronées, un dpi erroné, des métadonnées de dpi manquantes, des fichiers corrompus et des arguments incorrects doivent échouer avec les codes de sortie documentés ; le vérificateur de palette doit réussir pour Okabe-Ito et échouer pour une paire rouge/vert sous deutéranopie. Les tests dépendant de R sont ignorés lorsque R est absent.

Individual skills in this repo

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

Skills associés