VoxaTrace/com.musicmuni.voxatrace.tona.model/PitchContour

PitchContour

data class PitchContour(val samples: List<PitchPoint>, val sampleRate: Int = 16000, val hopSize: Int = 0)

A sequence of PitchPoints representing a pitch contour over time.

The primary data type flowing through the tona pipeline: PitchDetection produces it, PitchProcessing cleans it, PitchAnalysis analyzes it, and downstream modules (tessera, accura, calibra) consume it.

Construct via fromArrays (from parallel time/pitch arrays), fromPoints (from a list), or fromPitchData (from parsed file data).

Constructors

PitchContour

constructor(samples: List<PitchPoint>, sampleRate: Int = 16000, hopSize: Int = 0)

Types

Companion

object Companion

Properties

duration

val duration: Float

Duration of the contour in seconds

hopSize

val hopSize: Int

Hop size in samples between pitch frames (0 = unknown/unset).

isEmpty

val isEmpty: Boolean

True if contour has no samples

pitchesHz

@ShouldRefineInSwift

val pitchesHz: FloatArray

Pitches in Hz (fast path). Unvoiced frames use -1.

pitchesMidi

@ShouldRefineInSwift

val pitchesMidi: FloatArray

Pitches in MIDI for native evaluator (fast path). Unvoiced frames use -1.

sampleRate

val sampleRate: Int

Original audio sample rate (default 16kHz).

samples

val samples: List<PitchPoint>

List of pitch points in chronological order.

size

val size: Int

Number of samples in the contour

times

@ShouldRefineInSwift

val times: FloatArray

Times array for native evaluator (fast path)

voicedRatio

val voicedRatio: Float

Ratio of voiced samples to total samples (0.0 - 1.0)

Functions

slice

fun slice(startTime: Float, endTime: Float, relativeTimes: Boolean = true): PitchContour

Extract a slice of the contour within a time range.

toPitchesArray

@ShouldRefineInSwift

fun toPitchesArray(): FloatArray

Get pitches as a FloatArray (for compatibility with internal APIs).

toTimesArray

@ShouldRefineInSwift

fun toTimesArray(): FloatArray

Get times as a FloatArray (for compatibility with internal APIs).

PitchContour

See also

Constructors

Types

Properties

Functions