centroid() [2/3]

template<typename T , std::invocable< const T & > PosFn, std::invocable< const T & > WeightFn>
requires std::convertible_to<std::invoke_result_t<PosFn, const T&>, glm::vec3> && std::convertible_to<std::invoke_result_t<WeightFn, const T&>, float>

glm::vec3 MayaFlux::Kinesis::centroid ( std::span< T >  pts, PosFn  pos, WeightFn  weight  )

noexcept

Fully explicit weighted centroid for arbitrary point types.

Neither PositionCarrying nor any field convention is required. Both the position and the weight are extracted via caller-supplied callables. Use this overload for Nexus QueryResult spans, CV observation structs, Eigen column references, or any type that does not follow the vertex convention.

Falls back to the zero vector when total weight is zero or the span is empty.

Template Parameters

T	Element type. No concept constraint.
PosFn	Callable: const T& -> glm::vec3 (or convertible).
WeightFn	Callable: const T& -> float (or convertible).

Parameters

pts	Non-owning span of elements.
pos	Position extractor.
weight	Weight extractor.

Returns

Weighted mean position.

Definition at line 107 of file Morphology.hpp.

{
    if (pts.empty())
        return glm::vec3(0.0F);
    glm::vec3 acc(0.0F);
    float total = 0.0F;
    for (const auto& p : pts) {
        const auto w = static_cast<float>(std::invoke(weight, p));
        acc += static_cast<glm::vec3>(std::invoke(pos, p)) * w;
        total += w;
    }
    return total > 0.0F ? acc / total : glm::vec3(0.0F);
}

References weight.