channel_curvature()

float MayaFlux::Kinesis::channel_curvature ( MotionChannel< glm::vec2 > &  channel )

inline

Curvature helper for MotionChannel<glm::vec2>, self-calibrating its min_speed guard from the channel's own learned noise floor.

Parameters

channel

A MotionChannel<glm::vec2> that has had at least one update()

Returns

curvature(velocity, acceleration, min_speed), where min_speed is derived from the combined per-axis Estimate floors divided by dt rather than a fixed constant

A fixed min_speed constant has to assume a coordinate scale (pixels, normalized 0..1, millimeters); this instead asks "how much speed could this channel's own measurement noise alone produce", which scales automatically with whatever device and coordinate range the channel is actually receiving. Kept as a free function rather than a MotionChannel method since it is glm::vec2-specific and curvature itself does not generalize to vec3 the way velocity/acceleration do.

Definition at line 332 of file MotionChannel.hpp.

{
    const glm::vec2 vel = channel.derivative<1>();
    const glm::vec2 accel = channel.derivative<2>();
 
    const glm::vec2 floor_vec {
        static_cast<float>(channel.estimate_for_component(0).floor()),
        static_cast<float>(channel.estimate_for_component(1).floor())
    };
    const auto dt = static_cast<float>(channel.last_dt());
    const float min_speed = (dt > 0.0F) ? (glm::length(floor_vec) / dt) : 0.0F;
 
    return curvature(vel, accel, min_speed);
}

References curvature(), MayaFlux::Kinesis::MotionChannel< T >::derivative(), MayaFlux::Kinesis::MotionChannel< T >::estimate_for_component(), MayaFlux::Kinesis::Stochastic::Estimate::floor(), and MayaFlux::Kinesis::MotionChannel< T >::last_dt().

Here is the call graph for this function: