Expand description
Analytical Two-Bone, Constrained FABRIK, Coupled Swing-Twist Reach Cones,
Scapulo-Humeral Rhythm & Biarticular Tendon Coupling (re-exported from etalon-render).
Structs§
- Biarticular
Length Constraint - Passive multi-joint tendon excursion invariant $\sum_k r_{m,k},\theta_k \le L_{m,\max}$ (e.g. rectus femoris, hamstrings, gastrocnemius, extrinsic finger flexors).
- Biarticular
Term - One joint-coupling term inside a
BiarticularLengthConstraint. - Scapulo
Humeral Coupling - Coupled glenohumeral-to-scapulothoracic rhythm (2:1 GH:ST above 30 deg elevation).
- Swing
Twist Cone Constraint - Coupled quaternion swing-twist reach cone with optional polygonal swing boundary, swing-dependent twist narrowing $[\tau_{\min}(\mathbf{s}), \tau_{\max}(\mathbf{s})]$, and synovial translation bounds.
- TwoBone
IkResult - Output receipt for
solve_two_bone_motor_ik_zero_heap.
Enums§
- Joint
Constraint - Angular constraint applied to a joint during
solve_constrained_fabrik_motor_ik_zero_heap.
Constants§
- MAX_
BIARTICULAR_ JOINTS - Maximum joints spanned by a single
BiarticularLengthConstraint(HotZeroHeapstack bound). - MAX_
IK_ CHAIN - Maximum joints in a single constrained FABRIK chain (
HotZeroHeapstack bound). - MAX_
SWING_ POLYGON_ VERTICES - Maximum vertices in a polygonal swing cone on $S^2$ (
HotZeroHeapstack bound).
Functions§
- decompose_
swing_ twist - Decomposes unit quaternion
q([w, x, y, z]) into(swing, twist)aroundtwist_axissuch thatquat_mul(swing, twist) == normalize(q)andtwistis a pure rotation aroundtwist_axisin the shortest-arc hemisphere (twist[0] >= 0). - project_
swing_ twist_ cone - Projects quaternion
q([w, x, y, z]) onto an elliptical swing-twist reach cone aroundtwist_axis, scaled bylaxity_scale. - solve_
constrained_ fabrik_ motor_ ik_ zero_ heap - Solves multi-joint Constrained Forward-And-Backward Reaching Inverse Kinematics (FABRIK)
directly on a chain of up to
MAX_IK_CHAIN = 16PGAMotors with zero heap allocations (HotZeroHeap). - solve_
two_ bone_ motor_ ik_ zero_ heap - Analytically solves two-bone inverse kinematics (e.g., hip–knee–ankle or shoulder–elbow–wrist)
directly on PGA
Motors using the Law of Cosines and a pole-vector bend plane (HotZeroHeap).