Capstone_analysis

서울과학기술대학교 20학번 김경민 캡스톤디자인 프로젝트 음성 분석 관련 코드 저장소 입니다.

사용 가능한 분석 스크립트

1. practice_eval.py

기타 연습 분석 - 박자 및 음정 정확도 측정 (백엔드 연동용)

사용법:

python3 src/analysis/practice_eval.py <audio_file_path>

출력 예시:

{
  "rhythm_accuracy": 68,
  "pitch_accuracy": 63,
  "rhythm_sections": {"early": 64, "middle": 72, "late": 69},
  "pitch_sections": {"early": 60, "middle": 60, "late": 69}
}

2. chord_eval.py

코드 진행 분석 - 코드 정확도, 박자 정확도, 전환 속도 측정

사용법:

python3 src/analysis/chord_eval.py --audio <path> --bpm <float> --chords "Em,C,G,D"
# Basic Pitch 크로마 사용
python3 src/analysis/chord_eval.py --audio <path> --bpm 100 --chords "Em,C,G,D" --use-basic-pitch 1

3. chromatic_eval.py

크로매틱 연습 분석 - Basic Pitch 기반 음정/박자 정확도 측정 (초/중/후반 구간별)

사용법:

python3 src/analysis/chromatic_eval.py \
  --audio /abs/path.wav --bpm 100 --repeats 3 --fingers "1,2,3,4"

출력: 요약, pitch/rhythm 정확도(0-100), 구간별(early/middle/late) 정확도

4. unified_eval.py (Basic Pitch 기반 통합 엔트리)

코드/크로매틱을 단일 인터페이스로 분석합니다.

# 코드 모드
python3 src/analysis/unified_eval.py \
  --mode chord \
  --audio /abs/path.wav --bpm 100 --repeats 3 \
  --chords "C,D,E,Em" --beats-per-chord 4

# 크로매틱 모드
python3 src/analysis/unified_eval.py \
  --mode chromatic \
  --audio /abs/path.wav --bpm 100 --repeats 3 \
  --fingers "1,2,3,4"

출력: rhythm_accuracy, pitch_accuracy, 각 섹션(early/middle/late)