VoxaTrace/com.musicmuni.voxatrace.accura.model/NoteAnalysis

NoteAnalysis

data class NoteAnalysis(val label: String, val targetIntervalCents: Float, val targetPitchHz: Float, val detectedPeakCents: Float, val detectedPeakHz: Float, val deviationCents: Float, val deviationPercent: Float, val score: Float, val tier: PitchingTier, val amplitude: Float)

Analysis of a single detected note against its target interval in the requested scale.

Each instance describes one peak in the performance's pitch histogram: what the target was, what the singer actually produced, and how far off in cents and as a percentage of the interval to the nearest neighbor.

Typically produced as part of IntonationAnalysisResult.notes by com.musicmuni.voxatrace.accura.Accura.analyzePitching.

Constructors

NoteAnalysis

constructor(label: String, targetIntervalCents: Float, targetPitchHz: Float, detectedPeakCents: Float, detectedPeakHz: Float, deviationCents: Float, deviationPercent: Float, score: Float, tier: PitchingTier, amplitude: Float)

Properties

amplitude

val amplitude: Float

Histogram peak amplitude — proxy for note duration / prominence.

detectedPeakCents

val detectedPeakCents: Float

Detected histogram peak position in cents relative to tonic.

detectedPeakHz

val detectedPeakHz: Float

Detected histogram peak frequency in Hz.

deviationCents

val deviationCents: Float

Signed deviation from target in cents (positive = sharp, negative = flat).

deviationPercent

val deviationPercent: Float

Deviation as percentage of the interval to the nearest neighboring note.

label

val label: String

Note label using the requested tradition (e.g., "S", "R2", "C4").

score

val score: Float

Per-note accuracy score in 0f..100f — Accura's grading curve applied to |deviationPercent|. The single numeric the tier and the overall PitchingScore are both derived from.

targetIntervalCents

val targetIntervalCents: Float

Target interval position in cents relative to tonic.

targetPitchHz

val targetPitchHz: Float

Target interval frequency in Hz.

tier

val tier: PitchingTier

Qualitative accuracy tier — the banded view of score.

NoteAnalysis

See also

Constructors

Properties