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
- Defina o alvo antes de plotar. Escolha o periódico e a coluna (
JOURNAL_MM$nature[["single"]]é 89 mm; vejareferences/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. - 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. - Componha painéis (opcional).
pf_row(list(a, b), tags = c("A","B"))epf_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. - 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).notevira uma linha de legenda encapsulada sob a figura para tamanhos amostrais, definição de réplica e estatísticas.figure_manifest.tsvemoutdirregistra nome, formato, arquivo, tamanho, dpi e md5 de cada arquivo. Executepf_session("figures/sessionInfo.txt")para manter as versões dos pacotes. - 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 300Có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, sempdffonts); não é uma aprovação. - Verifique a paleta quando usar cores diferentes de
okabe():python3 scripts/palette_check.py --colors "#E69F00,#56B4E9,#009E73" --min-delta 15Ele 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). - 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/annotatesão em mm: usept_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.