클로드스킬마트스킬 둘러보기스킬이 뭐예요?
목록으로

OpenPIV 유동장 해석

PIV 이미지 쌍에서 속도장을 추출하고 와도·변형률·난류 통계까지 계산해 주는 유체 실험 분석 스킬.

데이터·분석고급33,0303,248AI 점수 8/10마지막 업데이트: 2026. 8. 9.

무엇을 해주나

OpenPIV(입자 영상 유속계) 라이브러리를 이용해 실험용 PIV 이미지 쌍을 처리하는 전 과정을 Claude가 대신 설계하고 실행합니다.

  • 전처리(동적 마스킹) → 상호상관(cross-correlation) → 벡터 검증 → 이상치 대체 → 스무딩 → 물리 단위 스케일링까지 파이프라인 전체를 다룹니다.
  • extended_search_area_piv 단일 패스와 windef 다중 패스(창 변형) 방식을 모두 안내합니다.
  • 와도(vorticity), 변형률 텐서, RMS·난류 운동에너지(TKE) 등 후처리 지표를 계산합니다.
  • 벡터장 시각화(원본 이미지 위 quiver, 성분별 컬러맵)와 vectors.txt / params.npz 결과 저장을 지원합니다.
  • CLI 러너(runner.py)와 분석 클래스(PIVAnalyzer)가 함께 제공됩니다.

특히 문서에 실무에서 자주 걸리는 함정(신호대잡음 방식별 임계값 차이, windefdt를 무시한다는 점, 좌표 변환 후 와도 부호 반전 등)이 명시되어 있어 잘못된 결과를 크게 줄여 줍니다.

이런 분께 추천

  • 유동 가시화 실험을 수행하는 유체역학·기계공학 연구실 구성원
  • PIV 촬영 데이터를 처음 처리해 보는 대학원생
  • 기존 PIV 스크립트를 재현 가능한 형태로 정리하고 싶은 엔지니어
  • 시뮬레이션(CFD)이 아니라 측정 데이터를 다루는 분

활용 예시

  1. 기본 속도장 추출 — "frame_a.bmp와 frame_b.bmp로 window_size 32, overlap 12, dt 0.02에서 속도장을 계산하고 벡터장 이미지를 만들어 줘."
  2. 큰 변위 다중 패스 — "제트 유동이라 변위가 커. windef 다중 패스(64→32→16)로 처리하고 px/frame 결과를 px/s로 변환해 줘."
  3. 후처리 지표 — "results/params.npz에서 와도와 전단 변형률을 계산하고, 공간 RMS와 TKE를 표로 정리해 줘."

· · · 설치 가이드 · · ·

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 K-Dense-AI/scientific-agent-skills 의 skills/openpiv 폴더를 내 ~/.claude/skills/openpiv/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/K-Dense-AI/scientific-agent-skills.git /tmp/sci-skills && cp -r /tmp/sci-skills/skills/openpiv ~/.claude/skills/openpiv

제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 열고 Python 3.10 이상이 설치되어 있는지 확인합니다: python3 --version
  2. OpenPIV를 설치합니다(재현성을 위해 버전 고정 권장): uv pip install "openpiv==0.25.4" (uv가 없으면 pip install "openpiv==0.25.4")
  3. 스킬 저장소를 내려받습니다: git clone https://github.com/K-Dense-AI/scientific-agent-skills.git /tmp/sci-skills
  4. 스킬 폴더를 Claude 스킬 디렉터리로 복사합니다: mkdir -p ~/.claude/skills && cp -r /tmp/sci-skills/skills/openpiv ~/.claude/skills/openpiv
  5. Claude Code를 재시작한 뒤 "PIV 이미지 쌍에서 속도장을 계산해 줘"처럼 요청하면 스킬이 자동으로 활성화됩니다.
  6. 설치 검증: python ~/.claude/skills/openpiv/scripts/run_example.py --output_dir /tmp/openpiv-demo 를 실행해 예제 결과가 생성되는지 확인합니다.