CommunityBildgithub.com

paper-figure-export

Exportiert publikationsbereite Abbildungen aus R (ggplot2/patchwork) mit fester physischer Größe, eingebetteten Schriftarten, farbenblind-sicherer Okabe-Ito-Palette, 300+ dpi PNG, Caption-Notiz und Export-Manifest. Prüft die Dateien (Größe in mm, dpi, eingebettete Schriftarten) und testet die Palette auf Farbfehlsichtigkeiten. Für Journal-Abbildungen, Nature/Cell-Spaltenbreiten, 'mach diese Abbildung papierfertig', Schrifteinbettung, Abbildungs-dpi, Panel-Komposition und farbenblind-sichere Farben.

Was ist paper-figure-export?

Diese Fähigkeit (Skill) automatisiert die Erstellung publikationsreifer Abbildungen in R (ggplot2/patchwork). Sie vermeidet die drei häufigsten Nachbearbeitungsprobleme: (1) Export in einer beliebigen Größe mit späterer Skalierung, (2) nicht eingebettete Schriftarten und (3) Paletten, die für farbenblinde Leser ungeeignet sind. Der Skill setzt die Zielgröße vor dem Plotten in Millimetern fest, exportiert Vektor-PDF mit eingebetteten Schriftarten plus PNG mit angegebener dpi, zeichnet ein Export-Manifest auf und bietet zwei unabhängige Prüfskripte (Python, reine Standardbibliothek) zur Verifikation der exportierten Dateien. Zudem wird die Farbpalette auf Farbfehlsichtigkeiten (Protan, Deutan, Tritan) getestet. Der Skill unterstützt gängige Formate (PDF, PNG, SVG, TIFF) und ist mit Journal-Vorgaben wie Nature/Cell-Spaltenbreiten kompatibel. Er wird über R-Quellen und Python-Prüfskripte gesteuert und enthält eine Testsuite mit 27 Tests. Die Nutzung erfolgt durch eine klare Abfolge von Schritten: Zielgrößen festlegen, Plot mit Hilfsthema und Palette bauen, Panels komponieren, exportieren, Dateien auditieren und ggf. die Palette prüfen. Damit wird sichergestellt, dass die resultierenden Abbildungen direkt einreichbar sind, ohne nachträgliche manuelle Anpassungen.

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

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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

  1. Ziel vor dem Plotten festlegen. Wählen Sie das Journal und die Spalte (JOURNAL_MM$nature[["single"]] ist 89 mm; siehe references/journal-sizes.md), die maximale Höhe und die dpi. Notieren Sie diese Werte; sie werden sowohl im Exportaufruf als auch im Auditaufruf verwendet.
  2. 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.
  3. Panels komponieren (optional). pf_row(list(a, b), tags = c("A","B")) und pf_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.
  4. 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). note wird zu einer umbrochenen Caption-Zeile unter der Abbildung für Stichprobengrößen, Replikatdefinitionen und Statistiken. figure_manifest.tsv im outdir zeichnet Name, Format, Datei, Größe, dpi und md5 jeder Datei auf. Führen Sie pf_session("figures/sessionInfo.txt") aus, um die Paketversionen zu sichern.
  5. 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 300 Exit-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. kein pdffonts); das ist kein Bestehen.
  6. Palette prüfen, wenn Sie andere Farben als okabe() verwenden: python3 scripts/palette_check.py --colors "#E69F00,#56B4E9,#009E73" --min-delta 15 Es 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).
  7. 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 Sie pt_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_save aufruft.
  • 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.

Individual skills in this repo

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

Verwandte Skills