turning_profile()

TurningProfile MayaFlux::Kinesis::turning_profile ( std::span< const glm::vec2 >  path, size_t  samples, bool  rotation_invariant = true  )

inline

Build a turning profile from a path.

Parameters

path	Positions in chronological order, at least three
samples	Profile length, minimum 3
rotation_invariant	Subtract the initial heading from every sample, making the profile independent of which direction the path was started in

Returns

A profile of exactly samples entries

Resamples to uniform arc length first, so the profile is indexed by distance along the path rather than by time, and two recordings of the same shape at different frame rates produce comparable profiles.

Definition at line 199 of file PathShape.hpp.

{
    samples = samples < 3 ? 3 : samples;
 
    TurningProfile profile;
    profile.turning.assign(samples - 1, 0.0F);
 
    if (path.size() < 2)
        return profile;
 
    for (size_t i = 1; i < path.size(); ++i)
        profile.length += glm::length(path[i] - path[i - 1]);
 
    const std::vector<glm::vec2> even = resample_uniform(path, samples);
 
    float unwrapped = heading(even[1] - even[0]);
    profile.initial_heading = unwrapped;
    profile.turning[0] = unwrapped;
 
    float prev = unwrapped;
    for (size_t i = 2; i < even.size(); ++i) {
        const float h = heading(even[i] - even[i - 1]);
        unwrapped += angular_delta(h, prev);
        prev = h;
        profile.turning[i - 1] = unwrapped;
    }
 
    if (rotation_invariant) {
        for (auto& t : profile.turning)
            t -= profile.initial_heading;
    }
 
    return profile;
}

References angular_delta(), h, heading(), MayaFlux::Kinesis::TurningProfile::initial_heading, MayaFlux::Kinesis::TurningProfile::length, resample_uniform(), and MayaFlux::Kinesis::TurningProfile::turning.

Here is the call graph for this function: