Skip to content

Movement intents (preset chips)

Movement intents are the curated preset chips at the top of the Studio’s Measurements panel. Each chip drops one or more tracking points + a pre-tuned condition into the currently-selected phase.

Defined in MovementIntents (package:pose_flow). Reference for trainers + integrators who want to know what each chip does internally.

Stance

ChipDropsDefault condition
Stance widestance_to_shoulder_ratio> 1.5
Stance narrowstance_to_shoulder_ratio< 0.8

Hand spread

ChipDropsDefault condition
Hands togetherwrist_to_shoulder_spread_ratio< 0.4
Hands apartwrist_to_shoulder_spread_ratio> 1.2

Hand height

ChipDropsDefault condition
Hands above headleft_arm_overhead_ratio + right_arm_overhead_ratioboth > 1.1
Hands at chestleft_arm_overhead_ratio + right_arm_overhead_ratioboth between [0.6, 0.9]
Hands by sideleft_arm_overhead_ratio + right_arm_overhead_ratioboth < 0.4
Hands raisedcomposite, both arms above shoulder height
Hands loweredcomposite, both arms below hip height

Body in frame

For positional gates (lateral shuffles, predator jacks).

ChipDropsDefault condition
On left of framehip_center_x< 0.35
Centred in framehip_center_xbetween [0.4, 0.6]
On right of framehip_center_x> 0.65

Knees

ChipDropsDefault condition
Knees deepleft_kneebetween [70°, 110°]
Knees straightleft_knee> 160°
Knees deep rightright_kneebetween [70°, 110°]
Knees straight rightright_knee> 160°

The split between left + right variants is intentional, for alternating movements (lunges, skater hops, high knees), the trainer drops the side-specific chip on each phase.

Elbows

ChipDropsDefault condition
Elbows bentleft_elbowbetween [60°, 110°]
Elbows straightleft_elbow> 160°
Elbows bent rightright_elbowbetween [60°, 110°]
Elbows straight rightright_elbow> 160°

Body posture

Composite intents, drop multiple tracking points + conditions to capture overall body configurations.

ChipDropsUse case
Stood upleft + right knee + hip flexion all > 160°Stand phase of squats / lunges.
Crouched downleft + right knee + hip flexion all < 110°Down phase of squats / lunges.
Hands raisedboth arms above headUp phase of jumping jacks / overhead presses.
Hands loweredboth arms by sidesClosed phase of jumping jacks.
Jumped uphip_center_y with relativeToBaseline: true, < -0.05 (hip moved upward)Airborne phase of jumps.

Customising defaults

The chips ship with reasonable defaults, that’s the point. But trainers always tune the bands after dropping a chip. Tap “Snap to current” to re-anchor on the live value, or just type in the ranges directly.

Add your own intents by extending MovementIntents and re-running the converter / Studio. The intents catalogue is open for extension.