CoolFace
Modelpublic

handsukwoo/qwen2.5_7b_2split_Performance_Evaluation

sourceHugging Faceupdated 1y agoView on Hugging Face
0likes8downloads
Model Card

qwen2.5 피부종양 진단 모델

이 모델은 15가지 피부 질환을 진단할 수 있는 qwen2.5 기반 멀티모달 모델입니다.

모델 성능

  • 정확도: 82.4%
  • F1 Score: 0.823
  • 평가 이미지: 500개

주의사항

⚠️ 이 모델은 의료 참고용으로만 사용하며, 실제 진단은 반드시 전문의와 상담하세요. \n# qwen2.5 피부종양 진단 모델

📋 모델 개요

이 모델은 qwen2.57b를 기반으로 15가지 피부 종양을 분류하기 위해 파인튜닝된 멀티모달 모델입니다.

🎯 성능 지표

  • 정확도 (Accuracy): 0.8240 (82.40%)
  • 정밀도 (Precision): 0.8494
  • 재현율 (Recall): 0.8343
  • F1 Score: 0.8235
  • 평가 이미지 수: 500개

🏥 분류 가능한 피부 질환 (15개 클래스)

번호질환명영문명Code
0광선각화증Actinic KeratosisAK
1기저세포암Basal Cell CarcinomaBCC
2멜라닌세포모반Melanocytic NevusMN
3보웬병Bowen's DiseaseBD
4비립종MiliaMI
5사마귀WartWA
6악성흑색종Malignant MelanomaMM
7지루각화증Seborrheic KeratosisSK
8편평세포암Squamous Cell CarcinomaSCC
9표피낭종Epidermal CystEC
10피부섬유종DermatofibromaDF
11피지샘증식증Sebaceous HyperplasiaSH
12혈관종HemangiomaHE
13화농 육아종Pyogenic GranulomaPG
14흑색점LentigoLE

📊 평가 데이터셋

  • 총 평가 이미지: 500개
  • 평가 방식: 랜덤 샘플링
  • 출력 형식: XML 구조화된 진단 결과
  • 평가 일자: 2025년 8월 14일

🔬 모델 아키텍처

  • Base Model: qwen2.5_7b
  • Fine-tuning Method: LoRA (Low-Rank Adaptation)
  • Task Type: Multi-modal (Image + Text) Classification
  • Input: 피부 병변 이미지 + 진단 instruction
  • Output: 구조화된 XML 진단 결과

💻 사용 방법

vLLM + OpenAI 호환 API 사용 (현재 설정)

python
from openai import OpenAI
import base64

# 현재 사용 중인 설정 (localhost의 vLLM 서버)
client = OpenAI(
    api_key="empty",  # vLLM은 빈 키 사용
    base_url="http://localhost:8001/v1"  # vLLM 서버 주소
)

# 또는 RunPod 엔드포인트 사용 시
# client = OpenAI(
#     api_key="rpa_토큰",
#     base_url="https://api.runpod.ai/v2/엔드포인트/openai/v1"
# )

# 이미지 인코딩
def encode_image(path):
    with open(path, "rb") as f:
        return base64.b64encode(f.read()).decode("utf-8")

# 피부 진단 instruction (한국어)
instruction = """너는 피부 병변을 진단하는 전문 AI이다. 다음은 네가 진단할 수 있는 피부 병변 목록이며, 각 병변의 임상적 특징은 아래와 같다. 환자에게 나타난 병변의 이미지와 설명을 바탕으로 가장 적합한 질병을 하나 선택하여 진단하라.

0: 광선각화증
1: 기저세포암
2: 멜라닌세포모반
3: 보웬병
4: 비립종
5: 사마귀
6: 악성흑색종
7: 지루각화증
8: 편평세포암
9: 표피낭종
10: 피부섬유종
11: 피지샘증식증
12: 혈관종
13: 화농 육아종
14: 흑색점

<root><label id_code="{코드}" score="{점수}">{진단명}</label><summary>{진단소견}</summary><similar_labels><similar_label id_code="{코드}" score="{점수}">{유사질병명}</similar_label></similar_labels></root>
"""

# 진단 수행
image_base64 = encode_image("path_to_skin_image.jpg")
response = client.chat.completions.create(
    model="model_name",  # vLLM에서 로드된 모델명
    messages=[
        {
            "role": "user",
            "content": [
                {"type": "text", "text": instruction},
                {
                    "type": "image_url", 
                    "image_url": {
                        "url": f"data:image/jpeg;base64,{image_base64}",
                    },
                },
            ],
        }
    ],
)

print(response.choices[0].message.content)

출력 형식 예시

xml
<root>
<label id_code="1" score="85.2">기저세포암</label>
<summary>이미지에서는 진주빛 반투명 결절 형태의 병변이 관찰됩니다. 이러한 병변은 일반적으로 천천히 성장하며 주변 조직으로 깊게 침습할 수 있는 특성을 가지고 있습니다...</summary>
<similar_labels>
<similar_label id_code="3" score="12.0">보웬병</similar_label>
<similar_label id_code="0" score="8.5">광선각화증</similar_label>
</similar_labels>
</root>

⚠️ 중요 안내사항

  • 이 모델은 의료진을 대체할 수 없으며, 참고용으로만 사용해야 합니다
  • 실제 진단 및 치료에는 반드시 전문 의료진의 상담이 필요합니다
  • 모델의 결과는 확률적 추정치이며, 100% 정확하지 않을 수 있습니다
  • 이 모델은 교육 및 연구 목적으로만 사용하시기 바랍니다

📈 클래스별 성능

자세한 클래스별 성능은 class_performance.csv 파일을 참조하세요.

클래스PrecisionRecallF1-Score
광선각화증0.9290.5420.684
기저세포암1.0000.4290.600
멜라닌세포모반0.7211.0000.838
보웬병0.6251.0000.769
비립종0.7810.8620.820
사마귀0.8571.0000.923
악성흑색종0.6670.6900.678
지루각화증0.7920.5940.679
편평세포암0.7950.9390.861
표피낭종1.0000.8860.939
피부섬유종0.9660.8240.889
피지샘증식증0.8280.7500.787
혈관종0.8671.0000.929
화농 육아종0.9501.0000.974
흑색점0.9661.0000.983

🛠️ 개발 환경

  • Python 3.11+
  • vLLM OpenAI 호환 서버
  • RunPod 클라우드 환경
  • CUDA 지원 GPU

📁 저장소 파일 구조

├── evaluation_results.json    # 상세 평가 결과
├── class_performance.csv      # 클래스별 성능 지표
├── confusion_matrix.png       # 혼동행렬 시각화
├── class_performance.png      # 성능 차트
└── README.md                  # 모델 문서 (이 파일)

📝 라이선스

이 모델은 연구 및 교육 목적으로만 사용하시기 바랍니다.

📞 문의사항

모델 사용 중 문제가 발생하면 이슈를 등록해 주세요.


개발: qwen2.5 기반 피부질환 진단 모델 평가일: 2025-08-14 정확도: 82.40%