evaluate
fun evaluate(reference: LessonMaterial, student: LessonMaterial, contourExtractor: CalibraPitch.ContourExtractor): SingingResult
Evaluate a melody performance against a reference.
Return
Complete evaluation result with per-segment scores
Parameters
reference
The reference material with audio, segments, and key
student
The student's lesson material with audio and key. If student.segments is empty, uses reference.segments. If student.pitchContour is pre-computed, skips extraction.
contour
Pre-built contour extractor for pitch extraction. Caller owns the extractor lifecycle.