calculateBeatConfidence()

float fl::audio::detector::MusicalBeat::calculateBeatConfidence ( float currentIBI )

private

Calculate beat confidence based on rhythmic consistency.

Parameters

currentIBI

Current inter-beat interval

Returns

Confidence score (0.0-1.0)

Definition at line 152 of file musical_beat_detector.cpp.hpp.

                                                           {
    // Confidence based on temporal consistency
    if (mIBIHistory.size() < 2) {
        // Not enough history - return moderate confidence
        return 0.6f;
    }
 
    // Calculate IBI standard deviation
    float stdDev = calculateIBIStdDev();
 
    // Average IBI in seconds
    float avgIBI = getAverageIBI();
 
    // Coefficient of variation (normalized std dev)
    float cv = (avgIBI > 0.0f) ? (stdDev / avgIBI) : 1.0f;
 
    // Confidence inversely proportional to variability
    // cv = 0.0 (perfect consistency) → confidence = 1.0
    // cv = 0.2 (20% variation) → confidence ≈ 0.5
    // cv ≥ 0.5 (50%+ variation) → confidence → 0.0
    float confidence = fl::max(0.0f, 1.0f - (cv * 2.0f));
 
    // Boost confidence if current IBI matches average closely
    float ibiDiff = fl::abs(currentIBI - avgIBI);
    float ibiError = (avgIBI > 0.0f) ? (ibiDiff / avgIBI) : 1.0f;
    float ibiBonus = fl::max(0.0f, 1.0f - (ibiError * 4.0f));
 
    // Combined confidence (weighted average)
    return (confidence * 0.7f) + (ibiBonus * 0.3f);
}

References fl::abs(), calculateIBIStdDev(), getAverageIBI(), fl::max(), and mIBIHistory.

Referenced by processSample().

Here is the call graph for this function:

Here is the caller graph for this function: