Golf Model Maps
This reference maps generalized coordinates, joint orderings, kinematic conventions, and bilateral grip decompositions across the shipped UpstreamDrift golf multibody, biomechanics, and motion-capture modules at pinned commit 625a16e6.
This establishes qpos / velocity index order, joint type, axis, limit, actuator name, and closed-loop equality constraints for four MuJoCo golf XML definitions; the 35-DOF golfer-scapula/2.0 Simscape articulated chain, segment lengths, and signed log-column map; ISB anatomical angle Cardan sequences, wrist per-side sign tables, and golf aliases; the pose-estimator three-point included-angle convention (\(\theta = \arccos(\hat{u}\cdot\hat{v})\)); and the \(6\times 12\) two-hand grasp map and hand-split coordinates.
This does not establish full generated MJCF/URDF/OSIM tables for MyoSuite, Drake, OpenSim, or Pinocchio, nor unvalidated Simscape wrist/leg/head DOFs. Those extensions remain tracked under AffineDrift #5621.
MuJoCo Motor-Driven Humanoids
Regenerate after changing the manifest pin:
python3 -m scripts.generate_golf_model_mapsPinned UpstreamDrift commit 625a16e6897b88ab29fb5a64c65ecee820dd58f5.
MuJoCo reports configuration size nq, tangent velocity size nv, and motor count nu. Internal revolute/universal joints use radians. A free joint occupies seven qpos entries (translation plus unit quaternion) and six velocity components.
Canonical Floating-Hip Humanoid (canonical)
Source: src/engines/physics_engines/mujoco/_golf_swing_canonical_xml.py (CANONICAL_GOLF_HUMANOID_XML); vendored snapshot data/upstreamdrift_golf_models/mujoco/canonical.xml.
nq |
nv |
nu |
equality constraints |
|---|---|---|---|
| 26 | 25 | 19 | 1 |
Generalized-Coordinate Map
qpos idx |
v idx |
Joint | Type | Axis | Range | Actuator | ctrl range |
|---|---|---|---|---|---|---|---|
| 0 | 0 | pelvis_floating |
free | — | — | — | — |
| 7 | 6 | spine_universal_1 |
hinge | (1, 0, 0) | [-0.6, 0.6] rad | spine_universal_1_motor |
[-200, 200] |
| 8 | 7 | spine_universal_2 |
hinge | (0, 1, 0) | [-0.6, 0.6] rad | spine_universal_2_motor |
[-200, 200] |
| 9 | 8 | spine_twist |
hinge | (0, 0, 1) | [-1, 1] rad | spine_twist_motor |
[-200, 200] |
| 10 | 9 | right_scapula_universal_1 |
hinge | (1, 0, 0) | [-0.5, 0.5] rad | right_scapula_universal_1_motor |
[-200, 200] |
| 11 | 10 | right_scapula_universal_2 |
hinge | (0, 1, 0) | [-0.5, 0.5] rad | right_scapula_universal_2_motor |
[-200, 200] |
| 12 | 11 | right_shoulder_gimbal_1 |
hinge | (0, 0, 1) | [-3.14, 3.14] rad | right_shoulder_gimbal_1_motor |
[-200, 200] |
| 13 | 12 | right_shoulder_gimbal_2 |
hinge | (0, 1, 0) | [-1.5, 1.5] rad | right_shoulder_gimbal_2_motor |
[-200, 200] |
| 14 | 13 | right_shoulder_gimbal_3 |
hinge | (1, 0, 0) | [-1.5, 1.5] rad | right_shoulder_gimbal_3_motor |
[-200, 200] |
| 15 | 14 | right_elbow |
hinge | (0, 1, 0) | [-2.5, 0] rad | right_elbow_motor |
[-200, 200] |
| 16 | 15 | right_wrist_universal_1 |
hinge | (1, 0, 0) | [-1, 1] rad | right_wrist_universal_1_motor |
[-200, 200] |
| 17 | 16 | right_wrist_universal_2 |
hinge | (0, 1, 0) | [-1, 1] rad | right_wrist_universal_2_motor |
[-200, 200] |
| 18 | 17 | left_scapula_universal_1 |
hinge | (1, 0, 0) | [-0.5, 0.5] rad | left_scapula_universal_1_motor |
[-200, 200] |
| 19 | 18 | left_scapula_universal_2 |
hinge | (0, 1, 0) | [-0.5, 0.5] rad | left_scapula_universal_2_motor |
[-200, 200] |
| 20 | 19 | left_shoulder_gimbal_1 |
hinge | (0, 0, 1) | [-3.14, 3.14] rad | left_shoulder_gimbal_1_motor |
[-200, 200] |
| 21 | 20 | left_shoulder_gimbal_2 |
hinge | (0, 1, 0) | [-1.5, 1.5] rad | left_shoulder_gimbal_2_motor |
[-200, 200] |
| 22 | 21 | left_shoulder_gimbal_3 |
hinge | (1, 0, 0) | [-1.5, 1.5] rad | left_shoulder_gimbal_3_motor |
[-200, 200] |
| 23 | 22 | left_elbow |
hinge | (0, 1, 0) | [-2.5, 0] rad | left_elbow_motor |
[-200, 200] |
| 24 | 23 | left_wrist_universal_1 |
hinge | (1, 0, 0) | [-1, 1] rad | left_wrist_universal_1_motor |
[-200, 200] |
| 25 | 24 | left_wrist_universal_2 |
hinge | (0, 1, 0) | [-1, 1] rad | left_wrist_universal_2_motor |
[-200, 200] |
Grip and Hip Closure
| Kind | Attributes |
|---|---|
weld |
site1=“right_grip_site”, site2=“club_grip_site” |
MuJoCo weld and connect constraints are soft equalities whose violation and constraint forces depend on solver settings; they are not independent joint coordinates.
Advanced Biomechanical Golf Swing (advanced)
Source: src/engines/physics_engines/mujoco/_golf_swing_advanced_xml.py (ADVANCED_BIOMECHANICAL_GOLF_SWING_XML); vendored snapshot data/upstreamdrift_golf_models/mujoco/advanced.xml.
nq |
nv |
nu |
equality constraints |
|---|---|---|---|
| 42 | 40 | 28 | 3 |
Generalized-Coordinate Map
qpos idx |
v idx |
Joint | Type | Axis | Range | Actuator | ctrl range |
|---|---|---|---|---|---|---|---|
| 0 | 0 | left_ankle_plantar |
hinge | (1, 0, 0) | [-0.7, 0.9] rad | l_ankle_plantar |
[-50, 50] |
| 1 | 1 | left_ankle_inversion |
hinge | (0, 0.980581, 0.196116) | [-0.6, 0.6] rad | l_ankle_invert |
[-35, 35] |
| 2 | 2 | left_knee |
hinge | (1, 0, 0) | [-2.3, 0.1] rad | l_knee |
[-150, 150] |
| 3 | 3 | right_ankle_plantar |
hinge | (1, 0, 0) | [-0.7, 0.9] rad | r_ankle_plantar |
[-50, 50] |
| 4 | 4 | right_ankle_inversion |
hinge | (0, 0.980581, 0.196116) | [-0.6, 0.6] rad | r_ankle_invert |
[-35, 35] |
| 5 | 5 | right_knee |
hinge | (1, 0, 0) | [-2.3, 0.1] rad | r_knee |
[-150, 150] |
| 6 | 6 | joint_6 |
free | — | — | — | — |
| 13 | 12 | spine_lateral |
hinge | (0, 1, 0) | [-0.5, 0.5] rad | spine_lateral |
[-120, 120] |
| 14 | 13 | spine_sagittal |
hinge | (1, 0, 0) | [-0.7, 1] rad | spine_sagittal |
[-130, 130] |
| 15 | 14 | spine_rotation |
hinge | (0, 0, 1) | [-1.9, 1.9] rad | spine_rotation |
[-110, 110] |
| 16 | 15 | left_scapula_elevation |
hinge | (0, 1, 0) | [-0.5, 0.8] rad | l_scap_elev |
[-40, 40] |
| 17 | 16 | left_scapula_protraction |
hinge | (0, 0, 1) | [-0.7, 0.7] rad | l_scap_prot |
[-35, 35] |
| 18 | 17 | left_shoulder_flexion |
hinge | (0, 1, 0) | [-1, 3] rad | l_shldr_flex |
[-90, 90] |
| 19 | 18 | left_shoulder_abduction |
hinge | (1, 0, 0) | [-0.5, 2.8] rad | l_shldr_abd |
[-90, 90] |
| 20 | 19 | left_shoulder_rotation |
hinge | (0, 0, 1) | [-1.6, 1.6] rad | l_shldr_rot |
[-65, 65] |
| 21 | 20 | left_elbow |
hinge | (0, 1, 0) | [-2.6, 0] rad | l_elbow |
[-75, 75] |
| 22 | 21 | left_wrist_flexion |
hinge | (0, 1, 0) | [-1.4, 1.4] rad | l_wrist_flex |
[-35, 35] |
| 23 | 22 | left_wrist_deviation |
hinge | (1, 0, 0) | [-0.6, 0.5] rad | l_wrist_dev |
[-28, 28] |
| 24 | 23 | right_scapula_elevation |
hinge | (0, 1, 0) | [-0.5, 0.8] rad | r_scap_elev |
[-40, 40] |
| 25 | 24 | right_scapula_protraction |
hinge | (0, 0, 1) | [-0.7, 0.7] rad | r_scap_prot |
[-35, 35] |
| 26 | 25 | right_shoulder_flexion |
hinge | (0, 1, 0) | [-1, 3] rad | r_shldr_flex |
[-90, 90] |
| 27 | 26 | right_shoulder_abduction |
hinge | (1, 0, 0) | [-2.8, 0.5] rad | r_shldr_abd |
[-90, 90] |
| 28 | 27 | right_shoulder_rotation |
hinge | (0, 0, 1) | [-1.6, 1.6] rad | r_shldr_rot |
[-65, 65] |
| 29 | 28 | right_elbow |
hinge | (0, 1, 0) | [-2.6, 0] rad | r_elbow |
[-75, 75] |
| 30 | 29 | right_wrist_flexion |
hinge | (0, 1, 0) | [-1.4, 1.4] rad | r_wrist_flex |
[-35, 35] |
| 31 | 30 | right_wrist_deviation |
hinge | (1, 0, 0) | [-0.5, 0.6] rad | r_wrist_dev |
[-28, 28] |
| 32 | 31 | shaft_flex_upper |
hinge | (1, 0, 0) | [-0.15, 0.15] rad | shaft_upper |
[-5, 5] |
| 33 | 32 | shaft_flex_middle |
hinge | (1, 0, 0) | [-0.2, 0.2] rad | shaft_middle |
[-5, 5] |
| 34 | 33 | shaft_flex_tip |
hinge | (1, 0, 0) | [-0.25, 0.25] rad | shaft_tip |
[-5, 5] |
| 35 | 34 | joint_29 |
free | — | — | — | — |
Grip and Hip Closure
| Kind | Attributes |
|---|---|
connect |
body1=“pelvis”, body2=“left_femur”, anchor=“-0.12 0 0” |
connect |
body1=“pelvis”, body2=“right_femur”, anchor=“0.12 0 0” |
weld |
body1=“left_hand”, body2=“club_grip”, relpose=“0 0 -0.18 1 0 0 0”, active=“true” |
MuJoCo weld and connect constraints are soft equalities whose violation and constraint forces depend on solver settings; they are not independent joint coordinates.
Full-Body Golf Swing (full_body)
Source: src/engines/physics_engines/mujoco/_golf_swing_full_body_xml.py (FULL_BODY_GOLF_SWING_XML); vendored snapshot data/upstreamdrift_golf_models/mujoco/full_body.xml.
nq |
nv |
nu |
equality constraints |
|---|---|---|---|
| 29 | 27 | 15 | 3 |
Generalized-Coordinate Map
qpos idx |
v idx |
Joint | Type | Axis | Range | Actuator | ctrl range |
|---|---|---|---|---|---|---|---|
| 0 | 0 | left_ankle |
hinge | (1, 0, 0) | [-0.8, 0.8] rad | left_ankle_motor |
[-40, 40] |
| 1 | 1 | left_knee |
hinge | (1, 0, 0) | [-2, 0] rad | left_knee_motor |
[-120, 120] |
| 2 | 2 | right_ankle |
hinge | (1, 0, 0) | [-0.8, 0.8] rad | right_ankle_motor |
[-40, 40] |
| 3 | 3 | right_knee |
hinge | (1, 0, 0) | [-2, 0] rad | right_knee_motor |
[-120, 120] |
| 4 | 4 | joint_4 |
free | — | — | — | — |
| 11 | 10 | spine_bend |
hinge | (1, 0, 0) | [-0.5, 0.8] rad | spine_bend_motor |
[-100, 100] |
| 12 | 11 | spine_rotation |
hinge | (0, 0, 1) | [-1.8, 1.8] rad | spine_rotation_motor |
[-100, 100] |
| 13 | 12 | left_shoulder_swing |
hinge | (0, 1, 0) | [-2.2, 3] rad | left_shoulder_swing_motor |
[-80, 80] |
| 14 | 13 | left_shoulder_lift |
hinge | (1, 0, 0) | [-1.5, 1.5] rad | left_shoulder_lift_motor |
[-80, 80] |
| 15 | 14 | left_elbow |
hinge | (0, 1, 0) | [-2.5, 0] rad | left_elbow_motor |
[-60, 60] |
| 16 | 15 | left_wrist |
hinge | (0, 1, 0) | [-1.6, 1.6] rad | left_wrist_motor |
[-30, 30] |
| 17 | 16 | right_shoulder_swing |
hinge | (0, 1, 0) | [-3, 2.2] rad | right_shoulder_swing_motor |
[-80, 80] |
| 18 | 17 | right_shoulder_lift |
hinge | (1, 0, 0) | [-1.5, 1.5] rad | right_shoulder_lift_motor |
[-80, 80] |
| 19 | 18 | right_elbow |
hinge | (0, 1, 0) | [-2.5, 0] rad | right_elbow_motor |
[-60, 60] |
| 20 | 19 | right_wrist |
hinge | (0, 1, 0) | [-1.6, 1.6] rad | right_wrist_motor |
[-30, 30] |
| 21 | 20 | club_wrist |
hinge | (0, 1, 0) | [-1.2, 1.2] rad | club_wrist_motor |
[-20, 20] |
| 22 | 21 | joint_16 |
free | — | — | — | — |
Grip and Hip Closure
| Kind | Attributes |
|---|---|
connect |
body1=“pelvis”, body2=“left_thigh”, anchor=“0 0 0” |
connect |
body1=“pelvis”, body2=“right_thigh”, anchor=“0 0 0” |
weld |
body1=“left_hand”, body2=“club”, relpose=“0 0 -0.18 1 0 0 0” |
MuJoCo weld and connect constraints are soft equalities whose violation and constraint forces depend on solver settings; they are not independent joint coordinates.
Upper-Body Golf Swing (upper_body)
Source: src/engines/physics_engines/mujoco/_golf_swing_upper_body_xml.py (UPPER_BODY_GOLF_SWING_XML); vendored snapshot data/upstreamdrift_golf_models/mujoco/upper_body.xml.
nq |
nv |
nu |
equality constraints |
|---|---|---|---|
| 17 | 16 | 10 | 1 |
Generalized-Coordinate Map
qpos idx |
v idx |
Joint | Type | Axis | Range | Actuator | ctrl range |
|---|---|---|---|---|---|---|---|
| 0 | 0 | spine_rotation |
hinge | (0, 0, 1) | [-1.57, 1.57] rad | spine_rotation_motor |
[-100, 100] |
| 1 | 1 | left_shoulder_swing |
hinge | (0, 1, 0) | [-2, 2.8] rad | left_shoulder_swing_motor |
[-80, 80] |
| 2 | 2 | left_shoulder_lift |
hinge | (1, 0, 0) | [-1.5, 1.5] rad | left_shoulder_lift_motor |
[-80, 80] |
| 3 | 3 | left_elbow |
hinge | (0, 1, 0) | [-2.4, 0] rad | left_elbow_motor |
[-60, 60] |
| 4 | 4 | left_wrist |
hinge | (0, 1, 0) | [-1.57, 1.57] rad | left_wrist_motor |
[-30, 30] |
| 5 | 5 | right_shoulder_swing |
hinge | (0, 1, 0) | [-2.8, 2] rad | right_shoulder_swing_motor |
[-80, 80] |
| 6 | 6 | right_shoulder_lift |
hinge | (1, 0, 0) | [-1.5, 1.5] rad | right_shoulder_lift_motor |
[-80, 80] |
| 7 | 7 | right_elbow |
hinge | (0, 1, 0) | [-2.4, 0] rad | right_elbow_motor |
[-60, 60] |
| 8 | 8 | right_wrist |
hinge | (0, 1, 0) | [-1.57, 1.57] rad | right_wrist_motor |
[-30, 30] |
| 9 | 9 | club_wrist |
hinge | (0, 1, 0) | [-1, 1] rad | club_wrist_motor |
[-20, 20] |
| 10 | 10 | joint_10 |
free | — | — | — | — |
Grip and Hip Closure
| Kind | Attributes |
|---|---|
weld |
body1=“left_hand”, body2=“club”, relpose=“0 0 -0.16 1 0 0 0”, active=“true” |
MuJoCo weld and connect constraints are soft equalities whose violation and constraint forces depend on solver settings; they are not independent joint coordinates.
MyoSuite Asset Paths (Declared Sizes Only)
Motor-driven MuJoCo humanoids above are distinct from MyoSuite musculoskeletal assets referenced in src/engines/physics_engines/mujoco/golf_swing_models_xml.py. AffineDrift does not vendor those MJCF files in this slice; counts below are taken from upstream comments only.
| Asset ID | Relative path | Declared nq |
Declared nu |
Note |
|---|---|---|---|---|
myoupperbody |
myo_sim/body/myoupperbody.xml |
19 | 20 | Torso, head, and both arms (per upstream module comment). |
myobody |
myo_sim/body/myobody.xml |
52 | 290 | Full musculoskeletal model with muscle–tendon units (per upstream comment). |
myoarm_simple |
myo_sim/arm/myoarm_simple.xml |
14 | — | Bilateral arms with simplified torso (per upstream comment). |
How to Read q[i]
Use the qpos index for configuration components and the v index for generalized velocities. Motor actuators act on the listed hinge joints. weld and connect equalities enforce grip closure and (in the advanced model) hip attachment without adding independent coordinates; their forces depend on the MuJoCo solver.
Simscape Articulated Model (golfer-scapula/2.0)
The motion-capture reconstruction model (golfer-scapula/2.0, src/motion_capture/reconstruct/model/golfer.py) places every body frame at the Simscape GolfSwing3D_Kinetic sensor frame using identified constant pre/post rotations:
\[\text{child} = \text{parent} \cdot R(\text{pre}) \cdot R_{\text{axes}}(q) \cdot R(\text{post})\]
where rotations are intrinsic with the first listed axis outermost, and relative identifications solve \(R_P^T R_C = A R(\pm q) B\) (maximum fit residual \(\le 2.7 \times 10^{-4}\text{ rad}\) across 620 logged frames; forward replay within \(\le 1.7 \times 10^{-3}\text{ rad}\) and \(\le 0.6\text{ mm}\)). Note that the kinematic tree puts the torso revolute (z) before the spine universal (zx) — the reverse of the prose order in the legacy MATLAB guide — and uses asymmetric left/right arm axis labels (left_scapula xz / left_shoulder xyz vs. right_scapula yz / right_shoulder yzx). The reconstruct world (\(x\) target, \(y\) up, \(z\) golfer’s right) maps to Simscape world (\(z_s\) up, \(y_s\) golfer’s right) via \((x_s, y_s, z_s) = (x, -z, y)\). Only the 23 trunk, scapula, shoulder, elbow, and forearm DOFs (plus 3 root translations and 3 root rotations in SIMSCAPE_NAMES) match logged sensors; wrist DOFs are named only and leg/head DOFs are omitted from the MATLAB model.
python3 -m scripts.generate_golf_model_maps --simscape-onlyPinned UpstreamDrift commit 625a16e6897b88ab29fb5a64c65ecee820dd58f5 (src/motion_capture/reconstruct/model/golfer.py, src/motion_capture/reconstruct/model/simscape.py).
Total DOFs (q) |
Mapped Simscape variables | Sensor-validated DOFs | Max residual |
|---|---|---|---|
| 35 | 27 | 23 | 0.00027 rad |
q idx |
DOF | Parent | Axes | Simscape variable | Sign | Range | Validated | Log column |
|---|---|---|---|---|---|---|---|---|
| 0 | pelvis.tx |
world |
translation |
TranslationStartPositionX |
+1 | unbounded | yes | — |
| 1 | pelvis.ty |
world |
translation |
TranslationStartPositionY |
+1 | unbounded | yes | — |
| 2 | pelvis.tz |
world |
translation |
TranslationStartPositionZ |
+1 | unbounded | yes | — |
| 3 | pelvis.ry |
world |
yxz |
HipStartPositionX |
+1 | [-π, π] | yes | HipLogs_HipAngularPositionX |
| 4 | pelvis.rx |
world |
yxz |
HipStartPositionY |
-1 | [-π, π] | yes | HipLogs_HipAngularPositionY |
| 5 | pelvis.rz |
world |
yxz |
HipStartPositionZ |
+1 | [-π, π] | yes | HipLogs_HipAngularPositionZ |
| 6 | torso.rz |
pelvis |
z |
TorsoStartPosition |
+1 | [-2.5, 2.5] | yes | TorsoLogs_AngularPosition |
| 7 | spine.rz |
torso |
zx |
SpineStartPositionX |
+1 | [-0.9, 0.9] | yes | SpineLogs_AngularPositionX |
| 8 | spine.rx |
torso |
zx |
SpineStartPositionY |
+1 | [-0.9, 0.9] | yes | SpineLogs_AngularPositionY |
| 9 | left_scapula.rx |
hub |
xz |
LScapStartPositionX |
+1 | [-1.6, 1.6] | yes | LScapLogs_AngularPositionX |
| 10 | left_scapula.rz |
hub |
xz |
LScapStartPositionY |
-1 | [-1.6, 1.6] | yes | LScapLogs_AngularPositionY |
| 11 | left_shoulder.rx |
left_scapula |
xyz |
LSStartPositionX |
+1 | [-π, π] | yes | LSLogs_AngularPositionX |
| 12 | left_shoulder.ry |
left_scapula |
xyz |
LSStartPositionY |
+1 | [-π, π] | yes | LSLogs_AngularPositionY |
| 13 | left_shoulder.rz |
left_scapula |
xyz |
LSStartPositionZ |
+1 | [-π, π] | yes | LSLogs_AngularPosition_Z |
| 14 | left_elbow.ry |
left_shoulder |
y |
LEStartPosition |
+1 | [-0.1, 2.8] | yes | AngularKinematicsLogs_LEAngularPosition |
| 15 | left_forearm.rx |
left_elbow |
x |
LFStartPosition |
+1 | [-π, π] | yes | LFLogs_AngularPosition |
| 16 | left_wrist.rx |
left_forearm |
xz |
LWStartPositionX |
+1 | [-1.3, 1.3] | no | — |
| 17 | left_wrist.rz |
left_forearm |
xz |
LWStartPositionY |
+1 | [-0.7, 0.7] | no | — |
| 18 | right_scapula.ry |
hub |
yz |
RScapStartPositionX |
+1 | [-1.6, 1.6] | yes | RScapLogs_AngularPositionX |
| 19 | right_scapula.rz |
hub |
yz |
RScapStartPositionY |
+1 | [-1.6, 1.6] | yes | RScapLogs_AngularPositionY |
| 20 | right_shoulder.ry |
right_scapula |
yzx |
RSStartPositionX |
+1 | [-π, π] | yes | RSLogs_AngularPositionX |
| 21 | right_shoulder.rz |
right_scapula |
yzx |
RSStartPositionY |
+1 | [-π, π] | yes | RSLogs_AngularPositionY |
| 22 | right_shoulder.rx |
right_scapula |
yzx |
RSStartPositionZ |
+1 | [-π, π] | yes | RSLogs_AngularPosition_Z |
| 23 | right_elbow.rx |
right_shoulder |
x |
REStartPosition |
+1 | [-0.1, 2.8] | yes | AngularKinematicsLogs_REAngularPosition |
| 24 | right_forearm.ry |
right_elbow |
y |
RFStartPosition |
+1 | [-π, π] | yes | RFLogs_AngularPosition |
| 25 | right_wrist.rx |
right_forearm |
xz |
RWStartPositionX |
+1 | [-1.3, 1.3] | no | — |
| 26 | right_wrist.rz |
right_forearm |
xz |
RWStartPositionY |
+1 | [-0.7, 0.7] | no | — |
| 27 | left_hip.rx |
pelvis |
xyz |
— | — | [-1.6, 1.6] | no | — |
| 28 | left_hip.ry |
pelvis |
xyz |
— | — | [-1.6, 1.6] | no | — |
| 29 | left_hip.rz |
pelvis |
xyz |
— | — | [-1.0, 1.0] | no | — |
| 30 | left_knee.rx |
left_hip |
x |
— | — | [0, 2.6] | no | — |
| 31 | right_hip.rx |
pelvis |
xyz |
— | — | [-1.6, 1.6] | no | — |
| 32 | right_hip.ry |
pelvis |
xyz |
— | — | [-1.6, 1.6] | no | — |
| 33 | right_hip.rz |
pelvis |
xyz |
— | — | [-1.0, 1.0] | no | — |
| 34 | right_knee.rx |
right_hip |
x |
— | — | [0, 2.6] | no | — |
Fixed head/ankle frames (hub→nose head 0.18 m; left_ankle, right_ankle zero-axis frames) contribute 0 DOFs. Exported Simscape CSV angles multiply the internal radian coordinate by sign and convert to degrees; legs, head, and wrist DOFs are unvalidated against MATLAB logs.
ISB Anatomical Angle Conventions & Golf Aliases
UpstreamDrift reports clinical/anatomical angles (src/shared/python/biomechanics/joint_conventions.py, src/shared/python/anatomical_angles/) using calibrated right-handed ISB frames (Wu et al. 2002/2005) and distinct golf-alias tables:
| Segment / Profile | Sequence | Ordered Components & Positive Sense | Singularity / Scope Notes |
|---|---|---|---|
isb_thorax & trunk_pelvis |
ZXY |
extension (FE), right_lateral_flexion (LB), left_axial_rotation (AR) |
Decomposes lab^T R_segment; forward_bend = -FE; FE, AR -> NaN at \|LB\| = 90° |
isb_hip |
ZXY |
flexion_extension, adduction_abduction, internal_external_rotation |
Flexion-positive (opposite to spine extension-positive) |
isb_glenohumeral / isb_thoracohumeral |
YXY |
plane_of_elevation, negative_elevation, internal_rotation |
Middle angle negated (negative_middle=True); 0° abduction vs 90° flexion |
isb_elbow |
ZXY |
flexion, carrying_angle, pronation |
Source for forearm pronation (forearm_in_humerus_rotation) |
isb_wrist |
ZXY |
flexion, ulnar_deviation, axial_rotation |
Radius→3rd metacarpal (OBSERVABILITY = fitted_grip_rotation); SIDE_SIGN: R=(1,1,1), L=(1,-1,-1); 3rd angle is not forearm pronation; \|ulnar\| = 90° -> NaN |
grood_suntay_knee |
XYZ |
femoral_x_rotation, floating_axis_rotation, tibial_z_rotation |
Grood & Suntay (1983) floating-axis sequence |
In src/shared/python/anatomical_angles/golf_aliases.py, WRIST_GOLF_ALIASES maps "cupped" to -flexion, "bowed" to +flexion, and "hinge" / "cock" to -ulnar_deviation; "release" deliberately raises ValueError because it names a dynamic swing event rather than a signed angle.
Pose-Estimator Included Angles vs. Anatomical Flexion
MediaPipe and OpenPose pipelines (src/shared/python/pose_estimation/joint_angle_utils.py, src/tools/video_analyzer/analyzer.py) compute three-keypoint limb angles from joint-to-proximal and joint-to-distal unit vectors:
\[\theta = \arccos(\hat{u} \cdot \hat{v}) \in [0, \pi] \quad (\text{or } [0^\circ, 180^\circ]).\]
Under this included-angle formula, a straight limb reads \(\approx \pi\text{ rad}\) (\(180^\circ\)), whereas ISB anatomical flexion (anatomical_angles/limbs.py) is \(0^\circ\) in neutral standing posture. For purely planar hinge motion, \(\text{flexion}_{\text{anat}} \approx 180^\circ - \theta\); in general 3D motion, three-point angles mix planar flexion with ab/adduction and axial rotation and cannot be equated directly with signed Cardan coordinates.
Two-Hand Grasp Map and Hand-Split Coordinates
In src/shared/python/loop_nullspace/grip_split.py, bilateral six-axis hand wrenches \(y = (f_L, c_L, f_R, c_R) \in \mathbb{R}^{12}\) (each three force components plus three free couple components at grip points \(r_L, r_R\) about their midpoint origin) map to the net club wrench \(w = (F, M) \in \mathbb{R}^6\) via the \(6 \times 12\) grasp map \(G\):
\[w = G y = \begin{bmatrix} I_3 & 0 & I_3 & 0 \\ [\rho_L]_\times & I_3 & [\rho_R]_\times & I_3 \end{bmatrix} \begin{bmatrix} f_L \\ c_L \\ f_R \\ c_R \end{bmatrix}.\]
Every admissible hand-load allocation decomposes into equal-split plus internal null-space coordinates \(y = G^# w + K s\), where \(G^#\) allocates half the net wrench to each hand, \(G K = 0\) (\(K \in \mathbb{R}^{12\times 6}\)), and \(s = \Phi y = \bigl(\tfrac{1}{2}(f_R - f_L),\, \tfrac{1}{2}(c_R - c_L)\bigr)\) defines the six split coordinates \(s_1\)–\(s_6\) (axial component positive when pulling right relative to left along \(d\), negative when squeezing; compare the scalar point-force projection in _ch05_two_hand_wrench.qmd).
Citation
@online{untitled,
author = {},
title = {Golf {Model} {Maps}},
url = {https://affinedrift.com/models/golf-model-maps.html},
langid = {en}
}