pydicom DICOM 처리
로컬 DICOM 파일의 메타데이터·픽셀 데이터를 안전하게 읽고 쓰고 변환하며, 비식별화 전 점검까지 도와주는 스킬입니다.
개발·코딩고급★ 33,030⑂ 3,248AI 점수 9/10마지막 업데이트: 2026. 8. 9.
무엇을 해주나
- 안전한 DICOM 읽기:
dcmread()의stop_before_pixels,specific_tags,defer_size옵션을 활용해 필요한 태그만 최소로 읽는 패턴을 안내합니다. 전체Dataset출력이나 JSON 덤프처럼 PHI(보호대상 건강정보)가 유출되는 습관을 명시적으로 금지합니다. - 전송 구문·코덱 점검: Transfer Syntax UID 해석, JPEG/JPEG-LS/JPEG 2000/RLE 플러그인(pylibjpeg, pyjpegls, python-gdcm) 설치 조합과 공급망·해시 검증까지 정리합니다.
- 픽셀 데이터 처리:
pydicom.pixels의 프레임 단위 디코딩, 배열 shape 규칙, Modality LUT → VOI LUT 적용 순서, MONOCHROME1 반전, Palette Color 처리 등을 다룹니다. - 압축/해제와 캡슐화:
compress(),decompress()가 SOP Instance UID를 새로 생성한다는 점,encapsulate()/generate_frames()사용법을 설명합니다. - 비식별화 워크플로: PS3.15 Annex E 기반 9단계 절차와, 원본 보존·시퀀스 재귀 처리·UID 일대일 치환·키(UID 맵) 비밀 관리 원칙을 제공합니다.
- 헬퍼 CLI 7종: 메타데이터 집계, 기술 인벤토리, 코덱 프리플라이트, 프레임/메모리 계획, 단일 프레임 렌더링, 가명화 및 감사, UID 맵 검증 스크립트를 안내합니다.
이런 분께 추천
- 의료 영상 연구 데이터셋을 파이썬으로 전처리하는 연구자·데이터 엔지니어
- PACS/영상 파이프라인을 개발하며 전송 구문과 코덱 의존성을 정리해야 하는 개발자
- 외부 공유 전 DICOM 가명화 절차와 감사 로그를 설계해야 하는 IRB/보안 담당 실무자
- pydicom 2.x 코드를 3.0으로 마이그레이션해야 하는 팀
활용 예시
- 데이터셋 파악: "authorized/ 폴더의 DICOM 수천 건을 모달리티·해상도·전송 구문별로 집계해줘" →
scripts/dicom_inventory.py authorized/ --recursive실행 후 개별 값 노출 없이 요약 리포트를 받습니다. - 디코딩 준비: JPEG 2000으로 압축된 CT 시리즈를 열려는데 오류가 날 때,
transfer_syntax_inspector.py로 설치된 플러그인과 지원 UID를 확인하고 필요한 pinned 패키지만 추가 설치합니다. - 연구용 가명화: 프로젝트 키를 생성해
anonymize_dicom.py --uid-key-file project.key --uid-scope export-v1로 파생본을 만들고,deidentification_audit.py로 잔여 식별자를 점검한 뒤 전문가 검증을 받습니다.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 K-Dense-AI/scientific-agent-skills 의 skills/pydicom 폴더를 내 ~/.claude/skills/pydicom/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git && mkdir -p ~/.claude/skills && cp -r scientific-agent-skills/skills/pydicom ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 스킬 저장소를 내려받습니다:
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git - 스킬 폴더를 Claude Code 스킬 경로로 복사합니다:
mkdir -p ~/.claude/skills && cp -r scientific-agent-skills/skills/pydicom ~/.claude/skills/ - 파이썬 가상환경을 만들고 활성화합니다(예:
python3 -m venv .venv && source .venv/bin/activate). Python 3.10 이상이 필요합니다. - 검증된 버전을 고정 설치합니다:
uv pip install "pydicom==3.0.2"(또는pip install "pydicom==3.0.2"). - 픽셀 배열·이미지 렌더링이 필요하면
numpy==2.5.1,Pillow==12.3.0을 추가하고, 압축 포맷은 필요한 플러그인(pylibjpeg 계열, pyjpegls, python-gdcm)만 골라 설치합니다. - Claude Code를 재시작한 뒤 "pydicom으로 이 DICOM 폴더를 점검해줘"처럼 요청하면 스킬이 자동으로 호출됩니다.
- 실행 전 반드시 접근 권한이 있는 로컬 데이터만 사용하고, 원본은 별도 보관하세요. 가명화 키 파일은 절대 커밋·공유하지 않습니다.
GitHub에서 원본 보기 ↗라이선스: MIT