CommunityImagemgithub.com

exportar-figuras-para-publicacao

Exporte figuras prontas para publicação a partir de R (ggplot2/patchwork) com tamanho físico definido, fontes incorporadas, paleta Okabe-Ito segura para daltonismo, PNG com 300+ dpi, nota de legenda e manifesto de exportação, depois audite os arquivos (tamanho em mm, dpi, fontes incorporadas) e verifique a paleta quanto a deficiências de visão de cores. Use para figuras de periódicos, larguras de colunas Nature/Cell, 'deixe esta figura pronta para papel', incorporação de fontes, dpi da figura, composição de painéis, cores seguras para daltonismo.

O que é exportar-figuras-para-publicacao?

Esta skill padroniza a exportação de figuras científicas geradas em R (ggplot2, patchwork) para padrões de periódicos como Nature e Cell. Ela garante que o tamanho físico seja definido em milímetros antes da plotagem, incorpora fontes no PDF vetorial, gera PNG com dpi especificado (≥300), e produz um manifesto de exportação com metadados (nome, formato, tamanho, dpi, MD5). Além disso, inclui dois verificadores independentes em Python (apenas biblioteca padrão): um para auditar arquivos exportados (tamanho, dpi, fontes incorporadas) e outro para simular deficiências de visão de cores (protanopia, deuteranopia, tritanopia) e detectar pares de cores muito similares. A skill é útil para qualquer fluxo de trabalho que exija figuras prontas para submissão, eliminando retrabalhos comuns como redimensionamento posterior, fontes não incorporadas ou paletas inadequadas para daltonismo. Suporta R (com ggplot2, systemfonts; opcional: patchwork, svglite) e Python 3. Os caminhos são relativos à pasta da skill.

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

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Exportação de figuras prontas para publicação (R)

A maior parte do retrabalho em figuras vem de três causas evitáveis: exportar em tamanho arbitrário e redimensionar depois, fontes não incorporadas ou diferentes das exigidas pelo periódico, e paletas que falham para leitores daltônicos. Esta skill fixa o tamanho em milímetros antes da exportação, gera PDF vetorial (fontes incorporadas) mais PNG com dpi definido, registra o que foi exportado e fornece dois verificadores independentes (Python, apenas biblioteca padrão) para validar o resultado a partir dos próprios arquivos.

Requisitos: R com ggplot2 e systemfonts (opcional: patchwork para composição, svglite para SVG); python3 para os verificadores; pdffonts/pdfinfo (poppler) melhoram as verificações de PDF e são usados quando instalados. Caminhos são relativos a esta pasta da skill.

Procedimento

  1. Defina o alvo antes de plotar. Escolha o periódico e a coluna (JOURNAL_MM$nature[["single"]] é 89 mm; veja references/journal-sizes.md), a altura máxima e o dpi. Anote-os; eles vão para a chamada de exportação e para a chamada de auditoria.
  2. Construa o gráfico com o tema helper e a paleta.
    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 base 8 pt, texto de eixo 6 pt, legendas 7 pt, linhas 0.3 mm e tags de painel em negrito 10 pt. pf_font() escolhe Arial, Helvetica ou Liberation Sans (compatível metricamente), a que estiver instalada, e avisa quando recai para sans genérico. Use uma cor por entidade em todas as figuras de um artigo. okabe(n) para em 8 cores: além disso, use facetas, formas ou rótulos diretos.
  3. Componha painéis (opcional). pf_row(list(a, b), tags = c("A","B")) e pf_stack(list(row1, row2), heights = c(1, 1)) constroem cada linha independentemente, para que o alinhamento em uma linha não distorça a seguinte; as tags continuam entre as linhas.
  4. Exporte. pf_save(p, "fig1", width_mm = 89, height_mm = 70, outdir = "figures", formats = c("pdf","png"), dpi = 300, note = "n = ... por grupo; barras de erro mostram ...") O PDF usa o dispositivo cairo (fontes incorporadas; sem cairo, avisa e recai). note vira uma linha de legenda encapsulada sob a figura para tamanhos amostrais, definição de réplica e estatísticas. figure_manifest.tsv em outdir registra nome, formato, arquivo, tamanho, dpi e md5 de cada arquivo. Execute pf_session("figures/sessionInfo.txt") para manter as versões dos pacotes.
  5. Audite os arquivos, não a intenção. python3 scripts/figure_audit.py figures/fig1.png figures/fig1.pdf --expect-width-mm 89 --max-height-mm 170 --expect-dpi 300 Código de saída 4 e uma linha FAIL significam que tamanho, dpi ou incorporação de fontes estão errados. SKIP significa que uma verificação não pôde ser executada (por exemplo, sem pdffonts); não é uma aprovação.
  6. Verifique a paleta quando usar cores diferentes de okabe(): python3 scripts/palette_check.py --colors "#E69F00,#56B4E9,#009E73" --min-delta 15 Ele simula visão protan, deutan e tritan e informa o par mais próximo. Código de saída 4 significa que duas cores se tornaram muito similares. Esta é uma heurística de triagem; também observe a figura com um simulador de daltonismo ou em escala de cinza, e não confie apenas na cor para linhas finas ou pontos pequenos (adicione forma ou rótulos diretos).
  7. Observe a figura no tamanho final (imprima o PNG em 100% ou abra o PDF na largura física). Texto menor que o mínimo do periódico, rótulos sobrepostos e títulos de eixo cortados só são visíveis desta forma.

Regras que previnem falhas conhecidas

  • O tamanho é definido em milímetros na exportação (width_mm); nunca redimensione um arquivo exportado para caber.
  • Use PDF vetorial para gráficos e PNG apenas para pré-visualizações ou conteúdo puramente raster; fotografias e mapas de calor com muitas células podem precisar de uma camada raster no dpi final.
  • Tamanhos de texto: mantenha-se dentro da faixa do periódico (Nature pede 5-7 pt). Tamanhos de geom_text/annotate são em mm: use pt_to_geom(6).
  • Informe n e o que é uma réplica na nota da figura ou legenda; barras de erro devem dizer o que representam.
  • Não incorpore vereditos ou rótulos específicos do projeto nos helpers compartilhados: mantenha-os no script de análise que chama pf_save.
  • Fontes: instale Arial/Helvetica ou Liberation Sans; uma fonte ausente torna-se silenciosamente uma família diferente na exportação. pf_env_check() imprime o que está sendo usado.

Saídas

<outdir>/<name>.pdf|png|svg|tiff, figure_manifest.tsv, opcionalmente sessionInfo.txt; relatórios de auditoria e paleta na saída padrão.

Testes

bash tests/run.sh (27 testes): figuras geradas são auditadas quanto à largura exata em pixels, dpi registrado, tamanho da página em mm e fontes incorporadas; uma exportação simples com pdf() e fontes não incorporadas deve ser detectada; tamanhos errados, dpi errado, metadados de dpi ausentes, arquivos corrompidos e argumentos inválidos devem falhar com os códigos de saída documentados; o verificador de paleta deve aprovar Okabe-Ito e falhar em um par vermelho/verde sob deuteranopia. Testes dependentes de R são ignorados quando R está ausente.

Individual skills in this repo

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

Habilidades Relacionadas