VoxaTrace/com.musicmuni.voxatrace.tessera.model/PhraseSummary

PhraseSummary

data class PhraseSummary(val totalPhrases: Int, val phrases: List<Phrase>, val comfortableRange: PhraseRange?, val avgDuration: Float, val shortestDuration: Float, val longestDuration: Float, val longestDurationUnfiltered: Float, val phraseToBreathRatios: FloatArray, val avgPhraseToBreathRatio: Float)

Phrase-level analysis of a single recording.

Produced by TesseraBreath.analyze when the contour has enough phrase structure to segment. Each entry in phrases aligns by index with phraseToBreathRatios.

Constructors

PhraseSummary

constructor(totalPhrases: Int, phrases: List<Phrase>, comfortableRange: PhraseRange?, avgDuration: Float, shortestDuration: Float, longestDuration: Float, longestDurationUnfiltered: Float, phraseToBreathRatios: FloatArray, avgPhraseToBreathRatio: Float)

Properties

avgDuration

val avgDuration: Float

Mean phrase duration in seconds

avgPhraseToBreathRatio

val avgPhraseToBreathRatio: Float

Mean of phraseToBreathRatios. Headline efficiency value.

comfortableRange

val comfortableRange: PhraseRange?

Where most phrases land (middle two bins of a 5-bin histogram of phrase durations). Null when too few phrases to bin meaningfully.

longestDuration

val longestDuration: Float

Longest phrase duration in seconds, excluding phrases flagged as statistical outliers by Local Outlier Factor on the phrase-to-breath ratios. Headline "peak phrase" value for UI — resilient to single fluky phrases.

longestDurationUnfiltered

val longestDurationUnfiltered: Float

Longest phrase duration in seconds with no outlier filtering — the raw maximum.

phrases

val phrases: List<Phrase>

Detected phrases in chronological order

phraseToBreathRatios

@ShouldRefineInSwift

val phraseToBreathRatios: FloatArray

Per-phrase ratio of phrase duration to preceding pause duration. Higher values indicate more singing per breath.

shortestDuration

val shortestDuration: Float