signed_turning()

float MayaFlux::Kinesis::signed_turning ( std::span< const glm::vec2 >  path )

inlinenoexcept

Turning accumulated along a path, with sign retained.

Parameters

path	Positions in chronological order, at least three

Returns

Sum of signed angular deltas between consecutive segment headings, positive for net counterclockwise

The signed counterpart to total_turning in Differential.hpp, which accumulates absolute values. That one measures how much a path bent in total and is blind to direction; this one measures where it ended up in heading and lets opposing bends cancel.

The pair separates cases neither resolves alone. A closed circle and a figure-eight of the same arc length accumulate similar absolute turning and very different signed turning, near one full revolution against near zero. A clockwise and a counterclockwise circle are identical under absolute turning and opposite under this.

Definition at line 98 of file PathShape.hpp.

{
    if (path.size() < 3)
        return 0.0F;
 
    float total = 0.0F;
    float prev = heading(path[1] - path[0]);
    for (size_t i = 2; i < path.size(); ++i) {
        const float h = heading(path[i] - path[i - 1]);
        total += angular_delta(h, prev);
        prev = h;
    }
    return total;
}

References angular_delta(), h, heading(), and total.

Referenced by winding_number().

Here is the call graph for this function:

Here is the caller graph for this function: