Export publikationsreifer Abbildungen (R)
Die meiste Nachbearbeitung von Abbildungen entsteht durch drei vermeidbare Dinge: Export in einer willkürlichen Größe und spätere Verkleinerung, nicht eingebettete oder nicht den Journal-Vorgaben entsprechende Schriftarten sowie Paletten, die für farbenblinde Leser ungeeignet sind. Dieser Skill legt die Größe vorab in Millimetern fest, exportiert Vektor-PDF (Schriftarten eingebettet) plus PNG mit angegebener dpi, zeichnet auf, was exportiert wurde, und stellt zwei unabhängige Prüfwerkzeuge (Python, nur Standardbibliothek) zur Verfügung, sodass das Ergebnis anhand der Dateien selbst verifiziert wird.
Voraussetzungen: R mit ggplot2 und systemfonts (optional: patchwork für Komposition, svglite für SVG); python3 für die Prüfskripte; pdffonts/pdfinfo (poppler) verbessern die PDF-Prüfungen und werden verwendet, wenn installiert. Pfade sind relativ zu diesem Skill-Ordner.
Vorgehen
- Ziel vor dem Plotten festlegen. Wählen Sie das Journal und die Spalte (
JOURNAL_MM$nature[["single"]]ist 89 mm; siehereferences/journal-sizes.md), die maximale Höhe und die dpi. Notieren Sie diese Werte; sie werden sowohl im Exportaufruf als auch im Auditaufruf verwendet. - Plot mit dem Hilfsthema und der Palette erstellen.
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()verwendet eine 8 pt Basis, 6 pt Achsentexte, 7 pt Legenden, 0,3 mm Linien und 10 pt fette Panel-Beschriftungen.pf_font()wählt Arial, Helvetica oder die metrikkompatible Liberation Sans aus, je nachdem, was installiert ist, und meldet, wenn auf generisches Sans zurückgegriffen wird. Verwenden Sie eine Farbe pro Entität über alle Abbildungen eines Papers hinweg.okabe(n)stoppt bei 8 Farben: Darüber hinaus verwenden Sie Facets, Shapes oder direkte Beschriftungen. - Panels komponieren (optional).
pf_row(list(a, b), tags = c("A","B"))undpf_stack(list(row1, row2), heights = c(1, 1))bauen jede Zeile unabhängig, sodass die Ausrichtung in einer Zeile die nächste nicht verzerren kann; Beschriftungen werden über Zeilen hinweg fortgesetzt. - Exportieren.
pf_save(p, "fig1", width_mm = 89, height_mm = 70, outdir = "figures", formats = c("pdf","png"), dpi = 300, note = "n = ... pro Gruppe; Fehlerbalken zeigen ...")PDF verwendet das Cairo-Gerät (Schriftarten eingebettet; ohne Cairo wird gewarnt und auf ein anderes zurückgegriffen).notewird zu einer umbrochenen Caption-Zeile unter der Abbildung für Stichprobengrößen, Replikatdefinitionen und Statistiken.figure_manifest.tsvimoutdirzeichnet Name, Format, Datei, Größe, dpi und md5 jeder Datei auf. Führen Siepf_session("figures/sessionInfo.txt")aus, um die Paketversionen zu sichern. - Dateien auditieren, nicht die Absicht.
python3 scripts/figure_audit.py figures/fig1.png figures/fig1.pdf --expect-width-mm 89 --max-height-mm 170 --expect-dpi 300Exit-Code 4 und eine FAIL-Zeile bedeuten, dass Größe, dpi oder Schrifteinbettung falsch sind. SKIP bedeutet, dass eine Prüfung nicht ausgeführt werden konnte (z. B. keinpdffonts); das ist kein Bestehen. - Palette prüfen, wenn Sie andere Farben als
okabe()verwenden:python3 scripts/palette_check.py --colors "#E69F00,#56B4E9,#009E73" --min-delta 15Es simuliert Protan-, Deutan- und Tritan-Farbsicht und meldet das ähnlichste Paar. Exit-Code 4 bedeutet, dass zwei Farben zu ähnlich werden. Dies ist eine Screening-Heuristik; betrachten Sie die Abbildung auch mit einem Farbenblindheitssimulator oder in Graustufen und verlassen Sie sich nicht allein auf Farbe für dünne Linien oder kleine Punkte (fügen Sie Shape oder direkte Beschriftungen hinzu). - Abbildung in Endgröße betrachten (PNG bei 100% drucken oder PDF mit der physischen Breite öffnen). Text, der kleiner als das Journal-Minimum ist, überlappende Beschriftungen und abgeschnittene Achsentitel sind nur so sichtbar.
Regeln zur Vermeidung bekannter Fehler
- Die Größe wird beim Export in Millimetern festgelegt (
width_mm); skalieren Sie niemals eine exportierte Datei nachträglich, um sie anzupassen. - Verwenden Sie Vektor-PDF für Plots und PNG nur für Vorschauen oder reine Rasterinhalte; Fotos und Heatmaps mit sehr vielen Zellen benötigen möglicherweise eine Rasterebene in der endgültigen dpi.
- Textgrößen: bleiben Sie innerhalb des Journal-Bereichs (Nature verlangt 5-7 pt).
geom_text/annotate-Größen sind in mm: verwenden Siept_to_geom(6). - Geben Sie n und was ein Replikat ist in der Abbildungsnotiz oder Legende an; Fehlerbalken müssen angeben, was sie sind.
- Betten Sie Projektbewertungen oder projektspezifische Bezeichnungen nicht in gemeinsam genutzte Hilfsfunktionen ein: bewahren Sie diese im Analysescript auf, das
pf_saveaufruft. - Schriftarten: Installieren Sie Arial/Helvetica oder Liberation Sans; eine fehlende Schriftart wird beim Export stillschweigend durch eine andere Familie ersetzt.
pf_env_check()gibt aus, was verwendet wird.
Ausgaben
<outdir>/<name>.pdf|png|svg|tiff, figure_manifest.tsv, optional sessionInfo.txt; Audit- und Palettenberichte auf stdout.
Tests
bash tests/run.sh (27 Tests): generierte Abbildungen werden auf exakte Pixelbreite, aufgezeichnete dpi, Seitengröße in mm und eingebettete Schriftarten geprüft; ein einfacher pdf()-Export mit nicht eingebetteten Schriftarten muss erkannt werden; falsche Größen, falsche dpi, fehlende dpi-Metadaten, korrupte Dateien und ungültige Argumente müssen mit den dokumentierten Exit-Codes fehlschlagen; der Palettenprüfer muss Okabe-Ito bestehen und ein Rot/Grün-Paar unter Deuteranopie fehlschlagen lassen. R-abhängige Tests werden übersprungen, wenn R nicht vorhanden ist.