VoxaTrace/com.musicmuni.voxatrace.calibra/CalibraNoteEval/evaluate

evaluate

fun evaluate(pattern: ExercisePattern, student: PitchContour, referenceKeyHz: Float, studentKeyHz: Float = 0.0f, config: NoteEvalConfig = NoteEvalConfig.DEFAULT): ExerciseResult

Evaluate with configuration object.

Return

Exercise evaluation result with per-note scores

Parameters

pattern

The exercise pattern with note frequencies and durations

student

Pitch contour from student's performance

referenceKeyHz

Reference key/tonic frequency in Hz

studentKeyHz

Student's key frequency in Hz (0 = same as reference, default 0)

config

Note evaluation configuration (default: NoteEvalConfig.DEFAULT)

@ShouldRefineInSwift

fun evaluate(pattern: ExercisePattern, student: PitchContour, referenceKeyHz: Float, studentKeyHz: Float = 0.0f, preset: NoteEvalPreset): ExerciseResult

Evaluate with preset.

Return

Exercise evaluation result with per-note scores

Parameters

pattern

The exercise pattern with note frequencies and durations

student

Pitch contour from student's performance

referenceKeyHz

Reference key/tonic frequency in Hz

studentKeyHz

Student's key frequency in Hz (0 = same as reference, default 0)

preset

Note evaluation preset (LENIENT, BALANCED, or STRICT)

@ShouldRefineInSwift

fun evaluate(pattern: ExercisePattern, student: PitchContour, referenceKeyHz: Float, studentKeyHz: Float = 0.0f, scoreType: Int = 0, leewaySamples: Int = 0): ExerciseResult

Evaluate a note/exercise performance.

Return

Exercise evaluation result with per-note scores

Parameters

pattern

The exercise pattern with note frequencies and durations

student

Pitch contour from student's performance

referenceKeyHz

Reference key/tonic frequency in Hz

studentKeyHz

Student's key frequency in Hz (0 = same as reference, default 0)

scoreType

Scoring algorithm type (0 = standard, 1 = strict/weighted)

leewaySamples

Tolerance at note boundaries in samples (default 0)