threshold_crossing_rate()

double MayaFlux::Kinesis::threshold_crossing_rate ( std::span< const double >  values, double  threshold, double  dt  )

inlinenoexcept

Threshold crossings per second within a window.

Parameters

values	Chronological span, at least two entries
threshold	Level whose crossings are counted
dt	Seconds per sample

Returns

Crossings in either direction, divided by the window duration

A rate in seconds against an arbitrary level, where Discrete::zero_crossing_rate is normalized per sample and windowed into a vector. Both count the same events; this is the shape a per-update scalar measure needs.

Counts crossings in both directions, so a value oscillating about the threshold reports twice the rate of its underlying cycle. Halve the result when the intended quantity is cycles rather than transitions.

Definition at line 132 of file TemporalMeasures.hpp.

{
    const size_t n = values.size();
    if (n < 2 || dt <= 0.0)
        return 0.0;
 
    size_t crossings = 0;
    for (size_t i = 1; i < n; ++i) {
        if ((values[i] >= threshold) != (values[i - 1] >= threshold))
            ++crossings;
    }
 
    const double duration = static_cast<double>(n - 1) * dt;
    return static_cast<double>(crossings) / duration;
}

References threshold, and values.