UMAP-learn 차원 축소 도우미
UMAP으로 고차원 데이터를 2D/3D로 임베딩하고, 클러스터링 전처리와 지도·Parametric UMAP까지 안내하는 스킬.
데이터·분석중급★ 33,030⑂ 3,248AI 점수 8/10마지막 업데이트: 2026. 8. 9.
무엇을 해주나
UMAP(Uniform Manifold Approximation and Projection)을 활용한 비선형 차원 축소 작업 전반을 Claude가 안내합니다.
n_neighbors,min_dist,n_components,metric4대 파라미터의 의미와 값 범위별 효과 정리- 시각화용 / 클러스터링 전처리용 / ML 파이프라인용 설정을 각각 구분해 제안
- 지도·준지도 UMAP(
y=labels, 미라벨은-1), HDBSCAN 연계 클러스터링 워크플로 - Parametric UMAP(신경망 인코더), inverse_transform, AlignedUMAP 등 고급 기능
- 재현성(
random_state), NaN 처리, 파일명 충돌 등 흔한 오류 해결법
이런 분께 추천
- scRNA-seq, 임베딩 벡터 등 고차원 데이터를 시각화해야 하는 연구자·데이터 분석가
- t-SNE 대신 더 빠르고 전역 구조를 잘 보존하는 방법을 찾는 분
- UMAP + HDBSCAN 조합으로 군집을 뽑아내려는 ML 엔지니어
- 학습된 축소 모델로 새 데이터를 투영해야 하는 파이프라인 개발자
활용 예시
- "이 유전자 발현 행렬을 UMAP으로 2D 시각화해줘" → 표준화 →
UMAP(n_neighbors=15, min_dist=0.1)→ matplotlib 산점도 코드까지 생성. - "클러스터를 찾고 싶어" → 시각화용이 아닌
n_neighbors=30, min_dist=0.0, n_components=10설정으로 임베딩 후 HDBSCAN을 적용하고 Adjusted Rand Score로 평가. - "학습 후 새 데이터도 계속 투영해야 해" → 분포 변화 위험을 설명하고 Parametric UMAP 인코더 정의 +
save()/load_ParametricUMAP()저장 방식을 제시.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 K-Dense-AI/scientific-agent-skills 의 skills/umap-learn 폴더를 내 ~/.claude/skills/umap-learn/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git /tmp/scientific-agent-skills && mkdir -p ~/.claude/skills && cp -r /tmp/scientific-agent-skills/skills/umap-learn ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 엽니다.
- 스킬 저장소를 내려받습니다:
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git - 스킬 폴더를 만듭니다:
mkdir -p ~/.claude/skills - 해당 스킬만 복사합니다:
cp -r scientific-agent-skills/skills/umap-learn ~/.claude/skills/ - 파이썬 환경에 라이브러리를 설치합니다:
pip install umap-learn hdbscan scikit-learn matplotlib(문서에 적힌 특정 버전 고정 대신 PyPI의 최신 안정 버전을 확인해 사용하세요) - Claude Code를 다시 실행한 뒤 "UMAP으로 이 데이터 차원 축소해줘"처럼 요청하면 스킬이 자동으로 사용됩니다.
GitHub에서 원본 보기 ↗라이선스: MIT