normalize_shape()

std::vector< glm::vec2 > MayaFlux::Kinesis::normalize_shape ( std::span< const glm::vec2 >  path )

inline

Centre a path at the origin and scale it to unit spread.

Parameters

path	Positions in chronological order

Returns

Path translated so its centroid is at the origin and scaled so its root mean square distance from the origin is one

The alternative shape normalization to a turning profile. A profile compares how paths bent; this compares where their points are, once position and size are removed. Point comparison keeps information about proportion that turning discards, and unlike turning it stays well defined for paths with stationary stretches where no heading exists. Rotation is not removed, so orientation remains part of the identity of the shape under this normalization.

Definition at line 277 of file PathShape.hpp.

{
    std::vector<glm::vec2> out(path.begin(), path.end());
    if (out.empty())
        return out;
 
    glm::vec2 mean { 0.0F };
    for (const auto& p : out)
        mean += p;
    mean /= static_cast<float>(out.size());
 
    float acc = 0.0F;
    for (auto& p : out) {
        p -= mean;
        acc += glm::dot(p, p);
    }
 
    const float rms = std::sqrt(acc / static_cast<float>(out.size()));
    if (rms < 1e-6F)
        return out;
 
    for (auto& p : out)
        p /= rms;
    return out;
}

References MayaFlux::mean(), out, and MayaFlux::rms().

Referenced by shape_distance().

Here is the call graph for this function:

Here is the caller graph for this function: