excursion()

double MayaFlux::Kinesis::excursion ( std::span< const double >  values )

inlinenoexcept

Difference between the largest and smallest value in a window.

Parameters

values

Chronological span, non-empty

Returns

Range, or zero for an empty span

How much ground the value covered, ignoring how many times it covered it. Pairs with roughness: a large excursion with low roughness is one slow sweep, a small excursion with high roughness is a tremor, and both large is a sustained thrashing.

Definition at line 86 of file TemporalMeasures.hpp.

{
    if (values.empty())
        return 0.0;
    const auto [lo, hi] = std::ranges::minmax_element(values);
    return *hi - *lo;
}

References hi, lo, and values.