Vili/scripts/loop_window.py
Meta Vens 0426a7ce3a loop_windows moves beside loop_window and takes the model; a test pins it on a real take with the two skeletons
The worker's window path loaded the 8B model at import, so no test reached it and swapped atan2 arguments or
the 30-joint skeleton went unnoticed. loop_windows(output, model) needs only model.output_skeleton and
model.fps. The test uses a committed 240-frame somaskel77 take (fixtures/take.npz, joints from a live Vili BVH
by forward kinematics) and stand-ins that carry the 77- and 30-joint skeletons' names and parents.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-25 18:32:25 +01:00

60 lines
3.4 KiB
Python

"""The frame window of a generated take that loops with the smallest seam. Called by the resident worker, nowhere else.
A seam is the jump from frame b back to frame a. Its cost is the pose difference plus 0.1 s times the velocity
difference (Kovar, Gleicher and Pighin 2002, motion-graph transitions), both as RMS over joints, with each frame
taken relative to its own Hips and turned to face a fixed way, so where the take wanders and which way it faces
do not count. loop_window is numpy only; loop_windows needs torch and kimodo's heading, and no model weights.
"""
import math
import numpy as np
import torch
from kimodo.constraints import compute_global_heading
VELOCITY_WEIGHT_SECONDS = 0.1
def loop_window(joints, heading, fps, min_frames, hips=0):
"""joints [F, J, 3] world positions, heading [F] radians about Y (Kimodo's hip-vector angle), the joint index of
Hips. Returns (first, last, pose_cost, velocity_cost): frame indices into the take, last inclusive, last - first
at least min_frames, the pair with the lowest cost. A tie goes to the longer window, then to the earlier first."""
joints = np.asarray(joints, dtype=np.float64)
heading = np.asarray(heading, dtype=np.float64)
frames = joints.shape[0]
if joints.ndim != 3 or joints.shape[2] != 3 or heading.shape != (frames,) or not 1 <= min_frames < frames:
raise ValueError("loop_window: shapes or min_frames out of range")
relative = joints - joints[:, hips:hips + 1]
cos, sin = np.cos(-heading), np.sin(-heading)
x, z = relative[..., 0], relative[..., 2]
pose = relative.copy()
pose[..., 0] = x * cos[:, None] + z * sin[:, None]
pose[..., 2] = -x * sin[:, None] + z * cos[:, None]
velocity = np.gradient(pose, axis=0) * fps # central differences, one-sided at the two ends
firsts, lasts = np.triu_indices(frames, k=min_frames)
pose_cost = np.empty(len(firsts))
velocity_cost = np.empty(len(firsts))
for first in range(frames - min_frames): # one row of seams at a time: memory stays O(frames * joints)
row = slice(*np.searchsorted(firsts, [first, first + 1]))
later = lasts[row]
pose_cost[row] = np.sqrt(((pose[later] - pose[first]) ** 2).sum(-1).mean(-1))
velocity_cost[row] = np.sqrt(((velocity[later] - velocity[first]) ** 2).sum(-1).mean(-1))
cost = pose_cost + VELOCITY_WEIGHT_SECONDS * velocity_cost
best = np.flatnonzero(cost == cost.min())
pick = best[np.lexsort((firsts[best], -(lasts[best] - firsts[best])))[0]]
return int(firsts[pick]), int(lasts[pick]), float(pose_cost[pick]), float(velocity_cost[pick])
def loop_windows(output, model):
"""One loop window per sample of a Kimodo output, as the worker answers them: {first, last, poseCost, velocityCost},
frame indices into the take, last inclusive. The joints are posed_joints, always in model.output_skeleton (the
somaskel77, not model.skeleton), and the heading is Kimodo's own from those joints."""
skeleton = model.output_skeleton
hips = skeleton.bone_index["Hips"]
windows = []
for joints in output["posed_joints"]:
heading = compute_global_heading(torch.from_numpy(joints[None]), skeleton)[0]
angle = torch.atan2(heading[:, 1], heading[:, 0]).numpy()
first, last, pose_cost, velocity_cost = loop_window(joints, angle, model.fps, math.ceil(len(joints) / 2), hips)
windows.append({"first": first, "last": last, "poseCost": pose_cost, "velocityCost": velocity_cost})
return windows