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
- Fixez la cible avant de tracer. Choisissez la revue et la colonne (
JOURNAL_MM$nature[["single"]]fait 89 mm ; voirreferences/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. - 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. - Composez les panneaux (optionnel).
pf_row(list(a, b), tags = c("A","B"))etpf_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. - 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).notedevient 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.tsvdansoutdirenregistre le nom, le format, le fichier, la taille, le dpi et le md5 de chaque fichier. Exécutezpf_session("figures/sessionInfo.txt")pour conserver les versions des paquets. - 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 300Une 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 depdffonts) ; ce n'est pas une réussite. - Vérifiez la palette lorsque vous utilisez des couleurs autres que
okabe():python3 scripts/palette_check.py --colors "#E69F00,#56B4E9,#009E73" --min-delta 15Il 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). - 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/annotatesont en mm : utilisezpt_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.