Community이미지github.com

paper-figure-export

R(ggplot2/patchwork)로 출판용 그림을 지정된 물리적 크기, 내장 폰트, 색각 이상 안전 Okabe-Ito 팔레트, 300+dpi PNG, 캡션 노트 및 내보내기 매니페스트와 함께 내보낸 후 파일(크기(mm), dpi, 내장 폰트)을 감사하고 팔레트의 색각 결함을 확인합니다. 저널 그림, Nature/Cell 열 너비, '이 그림을 논문 제출용으로', 폰트 내장, 그림 dpi, 패널 구성, 색각 이상 안전 색상에 사용합니다.

paper-figure-export란 무엇인가요?

이 스킬은 R ggplot2로 작성된 과학적 그림을 출판 준비가 완료된 상태로 내보내는 전체 워크플로우를 제공합니다. 사용자가 저널과 열 너비(Nature 단일 컬럼 89mm 등)를 먼저 선택하고, 특수 테마와 Okabe-Ito 색맹 안전 팔레트로 그림을 구성한 후, `pf_save()` 함수를 통해 PDF(폰트 내장)와 PNG를 지정된 dpi로 내보냅니다. 내보낸 후에는 Python 감사 스크립트(`figure_audit.py`)가 실제 파일 크기, dpi, 폰트 내장 여부를 확인하고, `palette_check.py`가 색각 이상 시뮬레이션으로 팔레트의 대비를 검증합니다. 모든 내보내기 파일은 매니페스트(TSV)에 기록되며, 세션 정보도 저장됩니다. 이 스킬은 Claude Code, Cursor, Codex 등 터미널 기반 AI 에이전트에서 직접 실행할 수 있으며, 과학 출판에서 흔히 발생하는 크기 문제, 폰트 누락, 색맹 비친화적 팔레트를 예방합니다.

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

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

논문 제출용 그림 내보내기 (R)

대부분의 그림 수정 작업은 피할 수 있는 세 가지 문제에서 비롯됩니다: 임의의 크기로 내보낸 후 줄이기, 폰트가 내장되지 않거나 저널이 요구하는 폰트가 아닌 경우, 색각 이상 독자에게 실패하는 팔레트. 이 스킬은 처음부터 크기를 밀리미터 단위로 고정하고, PDF(폰트 내장)와 PNG를 지정된 dpi로 내보내며, 내보낸 내용을 기록하고, 파일 자체에서 검증하는 두 개의 독립적인 검사기(Python, 표준 라이브러리만 사용)를 제공합니다.

요구 사항: R(ggplot2, systemfonts; 선택 사항: patchwork(패널 구성), svglite(SVG)); 검사기를 위한 python3; pdffonts/pdfinfo(poppler)는 PDF 검사를 개선하며 설치된 경우 사용됩니다. 경로는 이 스킬 폴더를 기준으로 합니다.

절차

  1. 플롯을 그리기 전에 대상을 고정합니다. 저널과 열을 선택합니다(JOURNAL_MM$nature[["single"]]은 89mm입니다. references/journal-sizes.md 참조), 최대 높이와 dpi를 선택합니다. 이것들을 기록해 둡니다. 이 값들은 내보내기 호출과 감사 호출에 사용됩니다.
  2. 도우미 테마와 팔레트로 플롯을 만듭니다.
    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색에서 멈춥니다: 그 이상은 패싯, 도형 또는 직접 레이블을 사용하세요.
  3. 패널을 구성합니다(선택 사항). pf_row(list(a, b), tags = c("A","B"))와 pf_stack(list(row1, row2), heights = c(1, 1))는 각 행을 독립적으로 구성하므로, 한 행의 정렬이 다음 행을 왜곡하지 않습니다. 태그는 행 사이에 연속됩니다.
  4. 내보냅니다. 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")를 실행하여 패키지 버전을 보관합니다.
  5. 의도가 아니라 파일을 감사합니다. 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 없음), 통과가 아닙니다.
  6. okabe() 이외의 색상을 사용할 때 팔레트를 확인합니다: python3 scripts/palette_check.py --colors "#E69F00,#56B4E9,#009E73" --min-delta 15 이는 원시, 제2색맹 및 제3색맹 시각을 시뮬레이션하고 가장 가까운 쌍을 보고합니다. 종료 코드 4는 두 색상이 너무 유사해짐을 의미합니다. 이는 선별 휴리스틱입니다. 또한 색맹 시뮬레이터나 회색조로 그림을 살펴보고, 얇은 선이나 작은 점에만 색상에 의존하지 마십시오(도형 또는 직접 레이블 추가).
  7. 최종 크기로 그림을 확인합니다.(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이 없을 때 건너뜁니다.

Individual skills in this repo

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

관련 스킬