# Shoulder rig v0.7 — local Blender prototype

10 September 2026. A regional development step within the full musculoskeletal objective, not a replacement for the full-body explorer or completion of shoulder biomechanics.

## Built

`shoulder-rig-v07.blend` contains both rotator cuffs, both humeri/scapulae/clavicles and glenoid labra: 16 source structures and 24 browser draw parts. A FIT-authored armature has a fixed scapular frame and one axial humeral bone per side. Geometry, source fibre-shaped ridges and assigned tissues are unchanged. The versioned rig adds deformation groups/modifiers, while the v0.5 master remains intact.

The [interactive study](index.html) reuses v0.5 geometry and the v0.6 renderer. It provides a -25 to +25 degree internal/external rotation study, both/left/right views, source-pose reset, selection, labels, wheel zoom, two-axis viewing, hiding, source-position outlines and the established separation stages. This limited angle range is a development control, not a normal-range benchmark. The scapula is fixed and the study does not include the whole arm or all shoulder muscles. Scapular movement remains a required next step.

Origin / insertion controls highlight the whole named receiving bone: blue scapula and amber humerus. The specific fossa/tubercle is named in the text. These are bone references, not exact on-model footprint areas. The anatomical facts are recorded in [the evidence review](../../Research/2026-09-10/SHOULDER_RIG_EVIDENCE.md).

## What the tests prove

Local Blender 5.2.1 loaded the unchanged v0.5 master with scripts disabled. Construction and evaluation are recorded in the saved Blender logs. At -25, 0 and +25 degrees, all eight cuff meshes were evaluated through Blender's armature modifier and compared to the exported blend computation. Maximum deviation was below 0.00024 mm. Fixed geometric seeds stayed fixed; moving seeds followed the humerus within 0.00020 mm. These tiny computational residuals do not certify anatomical attachment locations.

Browser checks in `qa-v07.json` compare its skin matrices against Blender reference poses (maximum element difference below 1e-7), test posed labels/picking, receiving-bone highlights, source-pose reset, separation stages and tissue display transforms, left-side selection and 390-pixel layout. No page/HTTP errors in the final run. Neutral/internal/external, receiving-bone, separation and mobile screenshots are retained. The desktop captures were visually inspected; the model remains coarse and requires contact/wrapping refinement.

## Known gaps — do not lose these

1. Supraspinatus, subscapularis and teres minor have tendon slots but **zero assigned tendon faces**, bilaterally. Infraspinatus has assigned tendon faces. The app now lists actual assigned surfaces rather than inferring tissue presence from slots. Tissue boundaries must be added accurately; none were invented here.
2. Deformation uses a smooth blend of distances to scapula/humerus with geometric endpoint constraints. These are provisional rig seeds, not verified origin/insertion footprints, fibre fields, biomechanical forces or muscle recruitment. The surface-contact candidates are recorded separately from learner labels.
3. The humeral centre is a sphere fit to source cartilage, not an independently measured joint centre. Scapular/clavicular movement, abduction, flexion, full muscle/ligament wrapping and physiological validation are incomplete.
4. Muscle tone/activation, fibre verification, detailed tissue finish, abdominal aponeuroses, remaining regions, lessons/practice and the supplied final visual standard remain in scope.

## Preserve and reproduce

Run `tools/blender/inspect_shoulder_v07.py`, then `build_shoulder_rig_v07.py` through the installed FIT Blender helper. Run `tools/build_shoulder_browser_v07.py` to build the view. `tools/qa/qa-shoulder-v07.cjs` uses the local 8771 server; set `FIT_ANATOMY_QA_OUTPUT` to the output directory. Retain v0.5 geometry/catalogue/study content and v0.6 renderer/layout/joint presets alongside this folder. No source scripts or paid assets/services were introduced. The original licence and attribution remain applicable; see `ATTRIBUTION.md`. Skills Locker accounts remain future work for Mitch.
