validateBeat()

bool fl::audio::detector::MusicalBeat::validateBeat ( float onsetStrength )

private

Validate if an onset is a true musical beat.

Parameters

onsetStrength

Onset magnitude

Returns

True if onset matches expected beat timing

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

                                                               {
    // First beat always validates (no history to compare)
    if (mLastBeatFrame == 0) {
        return true;
    }
 
    // Calculate expected IBI based on current BPM
    float expectedIBI = 60.0f / mCurrentBPM;  // seconds per beat
    float expectedFrames = (expectedIBI * static_cast<float>(mConfig.sampleRate)) /
                          static_cast<float>(mConfig.samplesPerFrame);
 
    // Calculate actual IBI since last beat
    float actualFrames = static_cast<float>(mCurrentFrame - mLastBeatFrame);
 
    // Allow ±25% deviation from expected tempo
    float tolerance = 0.25f;
    float minExpected = expectedFrames * (1.0f - tolerance);
    float maxExpected = expectedFrames * (1.0f + tolerance);
 
    // If we have no IBI history yet, accept any beat within valid BPM range
    if (mIBIHistory.empty()) {
        float actualIBI = (actualFrames * static_cast<float>(mConfig.samplesPerFrame)) /
                         static_cast<float>(mConfig.sampleRate);
        return isValidIBI(actualIBI);
    }
 
    // Validate timing matches expected tempo
    return (actualFrames >= minExpected) && (actualFrames <= maxExpected);
}

References fl::FL_NO_EXCEPT, isValidIBI(), mConfig, mCurrentBPM, mCurrentFrame, mIBIHistory, and mLastBeatFrame.

Referenced by processSample().

Here is the call graph for this function:

Here is the caller graph for this function: