논문 제출용 그림 내보내기 (R)
대부분의 그림 수정 작업은 피할 수 있는 세 가지 문제에서 비롯됩니다: 임의의 크기로 내보낸 후 줄이기, 폰트가 내장되지 않거나 저널이 요구하는 폰트가 아닌 경우, 색각 이상 독자에게 실패하는 팔레트. 이 스킬은 처음부터 크기를 밀리미터 단위로 고정하고, PDF(폰트 내장)와 PNG를 지정된 dpi로 내보내며, 내보낸 내용을 기록하고, 파일 자체에서 검증하는 두 개의 독립적인 검사기(Python, 표준 라이브러리만 사용)를 제공합니다.
요구 사항: R(ggplot2, systemfonts; 선택 사항: patchwork(패널 구성), svglite(SVG)); 검사기를 위한 python3; pdffonts/pdfinfo(poppler)는 PDF 검사를 개선하며 설치된 경우 사용됩니다. 경로는 이 스킬 폴더를 기준으로 합니다.
절차
- 플롯을 그리기 전에 대상을 고정합니다. 저널과 열을 선택합니다(
JOURNAL_MM$nature[["single"]]은 89mm입니다.references/journal-sizes.md참조), 최대 높이와 dpi를 선택합니다. 이것들을 기록해 둡니다. 이 값들은 내보내기 호출과 감사 호출에 사용됩니다. - 도우미 테마와 팔레트로 플롯을 만듭니다.
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()는 8pt 기본, 6pt 축 텍스트, 7pt 범례, 0.3mm 선, 10pt 굵은 패널 태그를 사용합니다.pf_font()는 설치된 Arial, Helvetica 또는 메트릭 호환 Liberation Sans 중 하나를 선택하고, 일반 sans로 대체될 때 알려줍니다. 논문의 모든 그림에서 하나의 개체에 하나의 색상을 사용합니다.okabe(n)은 8색에서 멈춥니다: 그 이상은 패싯, 도형 또는 직접 레이블을 사용하세요. - 패널을 구성합니다(선택 사항).
pf_row(list(a, b), tags = c("A","B"))와pf_stack(list(row1, row2), heights = c(1, 1))는 각 행을 독립적으로 구성하므로, 한 행의 정렬이 다음 행을 왜곡하지 않습니다. 태그는 행 사이에 연속됩니다. - 내보냅니다.
pf_save(p, "fig1", width_mm = 89, height_mm = 70, outdir = "figures", formats = c("pdf","png"), dpi = 300, note = "n = ... per group; error bars show ...")PDF는 cairo 장치를 사용합니다(폰트 내장됨; cairo가 없으면 경고하고 대체합니다).note는 그림 아래에 캡션 줄로 감싸져 표본 크기, 복제 정의 및 통계를 표시합니다.outdir에 있는figure_manifest.tsv는 모든 파일의 이름, 형식, 파일, 크기, dpi 및 md5를 기록합니다.pf_session("figures/sessionInfo.txt")를 실행하여 패키지 버전을 보관합니다. - 의도가 아니라 파일을 감사합니다.
python3 scripts/figure_audit.py figures/fig1.png figures/fig1.pdf --expect-width-mm 89 --max-height-mm 170 --expect-dpi 300종료 코드 4와 FAIL 줄은 크기, dpi 또는 폰트 내장이 잘못되었음을 의미합니다. SKIP은 검사를 실행할 수 없음을 의미하며(예:pdffonts없음), 통과가 아닙니다. okabe()이외의 색상을 사용할 때 팔레트를 확인합니다:python3 scripts/palette_check.py --colors "#E69F00,#56B4E9,#009E73" --min-delta 15이는 원시, 제2색맹 및 제3색맹 시각을 시뮬레이션하고 가장 가까운 쌍을 보고합니다. 종료 코드 4는 두 색상이 너무 유사해짐을 의미합니다. 이는 선별 휴리스틱입니다. 또한 색맹 시뮬레이터나 회색조로 그림을 살펴보고, 얇은 선이나 작은 점에만 색상에 의존하지 마십시오(도형 또는 직접 레이블 추가).- 최종 크기로 그림을 확인합니다.(PNG를 100%로 인쇄하거나 PDF를 물리적 너비로 엽니다). 저널 최소값보다 작은 텍스트, 겹치는 레이블, 잘린 축 제목은 이 방법으로만 볼 수 있습니다.
알려진 실패를 방지하는 규칙
- 크기는 내보낼 때 밀리미터 단위로 설정합니다(
width_mm). 내보낸 파일을 맞추기 위해 크기를 조정하지 마십시오. - 플롯에는 벡터 PDF를 사용하고 PNG는 미리보기 또는 래스터 전용 콘텐츠에만 사용하십시오. 사진과 매우 많은 셀이 있는 히트맵은 최종 dpi의 래스터 레이어가 필요할 수 있습니다.
- 텍스트 크기: 저널 범위 내에 유지하십시오(Nature는 5-7pt 요구).
geom_text/annotate크기는 mm 단위입니다.pt_to_geom(6)을 사용하십시오. - 그림 노트나 범례에 n과 복제가 무엇인지 명시하십시오. 오차 막대는 그것이 무엇인지 말해야 합니다.
- 공유 도우미에 프로젝트 판결이나 프로젝트별 레이블을 포함하지 마십시오. 이러한 것들은
pf_save를 호출하는 분석 스크립트에 보관하십시오. - 폰트: Arial/Helvetica 또는 Liberation Sans를 설치하십시오. 누락된 폰트는 내보내기에서 자동으로 다른 패밀리로 바뀝니다.
pf_env_check()는 사용 중인 것을 출력합니다.
출력
<outdir>/<name>.pdf|png|svg|tiff, figure_manifest.tsv, 선택 사항으로 sessionInfo.txt; 감사 및 팔레트 보고서는 stdout으로 출력됩니다.
테스트
bash tests/run.sh (27개 테스트): 생성된 그림은 정확한 픽셀 너비, 기록된 dpi, mm 단위 페이지 크기 및 내장 폰트에 대해 감사됩니다. 폰트가 내장되지 않은 일반 pdf() 내보내기는 반드시 잡혀야 합니다. 잘못된 크기, 잘못된 dpi, dpi 메타데이터 누락, 손상된 파일 및 잘못된 인수는 문서화된 종료 코드로 실패해야 합니다. 팔레트 검사기는 Okabe-Ito를 통과하고 제2색맹 하에서 적/녹 쌍에 실패해야 합니다. R 종속 테스트는 R이 없을 때 건너뜁니다.