reversal_count()

size_t MayaFlux::Kinesis::reversal_count ( std::span< const double >  samples, size_t  window  )

inlinenoexcept

Number of direction reversals across a window.

Parameters

samples	Newest-first span
window	Number of samples, minimum 3

Returns

Count of sign changes between consecutive non-zero steps

The scalar reading of total_turning: how often the value turned around, not by how much.

Definition at line 878 of file Differential.hpp.

{
    window = std::min(window < 3 ? size_t { 3 } : window, samples.size());
    size_t reversals = 0;
    double previous = 0.0;
    for (size_t i = 0; i + 1 < window; ++i) {
        const double step = samples[i] - samples[i + 1];
        if (step == 0.0)
            continue;
        if (previous != 0.0 && (step > 0.0) != (previous > 0.0))
            ++reversals;
        previous = step;
    }
    return reversals;
}

References window.