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() |