def evaluate_user_scores(pitch_user, pitch_ref,
                         onset_user_norm, onset_ref_norm,
                         onset_pos_user, onset_pos_ref,
                         tempo_user, tempo_ref,
                         mfcc_stack_user, mfcc_stack_ref):
    """
    pitch, onset, tempo, mfcc 데이터를 기반으로
    pitch_scores, tone_scores, beat_scores, tempo_scores 계산 후 dict 형태로 반환합니다.

    ✅ [Pitch 관련 점수 설명]
    - pitch_dtw         : 정규화된 pitch 시퀀스 간 DTW 거리 기반 유사도 점수 (시퀀스 형태 중심 비교)
    - transpose         : 전체 평균 pitch(f0)의 반음 차이 → score_whole (전조 수준 평가)
    - pitch_chunk       : pitch를 10개의 구간으로 나누어 chunk 평균 기반 반음 차이 → score_chunk

    📌 사용 함수:
    - compare_pitch()       → norm_dtw 사용
    - compute_score()       → score_whole, score_chunk 사용
    - semitone_series()     → pitch_chunk에 대응하는 대안 점수로도 활용 가능

    ✅ [Tone 관련 점수 설명] (MFCC 기반 음색 유사도)
    - mfcc_cos          : MFCC 평균/표준편차 벡터 간 cosine 유사도 (방향 중심 유사도)
    - mfcc_norm_euc     : 위 벡터들을 정규화한 후 유클리디안 거리 기반 점수
    - mfcc_dtw          : 전체 MFCC 시퀀스 간 DTW 거리 기반 점수

    📌 사용 함수:
    - calculate_scores()  → MFCC 스택 입력, 벡터 비교 + 시퀀스 비교 포함

    ✅ [Beat 관련 점수 설명] (리듬 유사도)
    - onset_euc         : 정규화된 onset strength 시퀀스 간 유클리디안 거리 기반 점수
    - onset_dtw         : 정규화된 onset strength 시퀀스 간 DTW 기반 거리 → 점수
    - onset_proxy       : onset 시퀀스 간 전체 차이 총합 (sum of abs diff) 기반 점수
    - onset_match       : onset 위치(time) 기준으로 ±0.1초 내에서 매칭된 비율 기반 점수

    📌 사용 함수:
    - compare_onset()
    - match_onset_score()

    ✅ [Tempo 관련 점수 설명] (템포 유사도)
    - tempo_abs         : |user_tempo - ref_tempo| 절대값 기반 점수
    - tempo_ratio       : user/ref 비율 기반 차이 점수
    - tempo_log         : log(1 + diff) 기반 감쇠 점수 (작은 차이에 민감)
    - tempo_thresh      : 템포 차이를 계단식 임계값 기반으로 점수화 (범위별 감점)

    📌 사용 함수:
    - compute_tempo_scores()
    """


🧠 요약 포맷

항목 점수 변수명 설명 주요 함수
Pitch pitch_dtw 정규화된 DTW 기반 피치 시퀀스 유사도 compare_pitch()
transpose 전체 평균 피치 간 반음 차이 → 전조 감지 compute_score()["score_whole"]
pitch_chunk 구간별 평균 피치 기반 반음 차이 → chunk 기반 평가 compute_score()["score_chunk"] or semitone_series()
Tone mfcc_cos MFCC 평균/표준편차 벡터의 cosine 유사도 calculate_scores()
mfcc_norm_euc 위 벡터 정규화 후 유클리디안 거리 점수 calculate_scores()
mfcc_dtw MFCC 시퀀스 간 DTW 기반 유사도 calculate_scores()
Beat onset_euc onset strength 시퀀스 유클리디안 거리 compare_onset()
onset_dtw onset strength DTW 거리 기반 유사도 compare_onset()
onset_proxy onset 간 전체 차이의 총합 기반 점수 compare_onset()
onset_match onset 위치가 ±0.1초 내에서 얼마나 일치하는지 비율 match_onset_score()
Tempo tempo_abs 절대 템포 차이 기반 점수 compute_tempo_scores()
tempo_ratio user/ref 비율 기반 템포 점수 compute_tempo_scores()
tempo_log log 기반 템포 점수 (작은 차이에 민감) compute_tempo_scores()
tempo_thresh 차이를 구간별로 나누어 점수화 compute_tempo_scores()