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

PitchHistogram

data class PitchHistogram(val binCenters: FloatArray, val values: FloatArray, val tonicHz: Float, val isDensity: Boolean, val isFolded: Boolean, val mode: HistogramMode)

Pitch histogram with musical metadata. Wraps Histogram from common.

Entry point for peak analysis: getPeaksValleys → PeakData → computePeakStats.

Constructors

constructor(binCenters: FloatArray, values: FloatArray, tonicHz: Float, isDensity: Boolean, isFolded: Boolean, mode: HistogramMode)

Properties

@ShouldRefineInSwift

val binCenters: FloatArray

val isDensity: Boolean

val isFolded: Boolean

val mode: HistogramMode

val tonicHz: Float

@ShouldRefineInSwift

val values: FloatArray

Functions

computePeakStats

fun computePeakStats(peakData: PeakData, rawPitchCents: FloatArray, refIntervalsCents: FloatArray, config: PeakStatsConfig = PeakStatsConfig.DEFAULT): PeakStatsCollection

Compute per-peak statistics against reference intervals.

open operator override fun equals(other: Any?): Boolean

getPeaksValleys

fun getPeaksValleys(targetIntervalsCents: FloatArray, config: PeakDetectionConfig = PeakDetectionConfig.DEFAULT): PeakData

Detect peaks and valleys using the specified method and target intervals.

open override fun hashCode(): Int

fun normalizeArea(): PitchHistogram

Normalize so total area = 1. Returns a new PitchHistogram.

fun smooth(sigma: Float = 5.0f): PitchHistogram

Apply Gaussian smoothing. Returns a new PitchHistogram.