Skip to content

Feat/keypoint viewer - #14

Merged
tkclam merged 3 commits into
mainfrom
feat/keypoint-viewer
Jun 11, 2026
Merged

Feat/keypoint viewer#14
tkclam merged 3 commits into
mainfrom
feat/keypoint-viewer

Conversation

@tkclam

@tkclam tkclam commented Jun 11, 2026

Copy link
Copy Markdown
Collaborator

No description provided.

tkclam and others added 3 commits June 11, 2026 20:34
Introduces a Napari-based GUI for reviewing and correcting 3D pose
estimates, with supporting state management, keyboard-driven corrections,
and CLI integration.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Add a docs page showing where deeperfly's 38 tracked keypoints sit on the
NeuroMechFly model, rendered entirely in-browser with MuJoCo (WebAssembly)
and Three.js, deployable as static GitHub Pages.

- scripts/build_keypoint_viewer_assets.py: offline generator (flygym + mujoco,
  run by hand) that exports a flattened, self-contained MJCF + simplified
  meshes and emits the neutral pose, per-geom flygym colours and the 38
  keypoint -> NeuroMechFly body mapping into docs/keypoints/assets/. Heavy deps
  stay out of the docs CI; the products are committed.
- docs/keypoints/: standalone viewer + vendored @mujoco/mujoco (official WASM)
  and three.js. Sliders for the 7 actuated leg DOFs x6 legs + 3 head DOFs;
  mesh opacity slider and flygym-colour toggle; node-size and edge-width
  controls. The stick-and-ball overlay is read from the solved model each
  change (mj_forward, kinematics only) so it stays locked to the mesh.
- docs/explanation/keypoints.md + "Keypoint locations" nav entry in mkdocs.yml.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
A checkbox (default on) controls the overlay's z-order against the mesh.
When on, the stick-and-ball skeleton uses depthTest:false and a higher
renderOrder so it always draws over the body. When off, the overlay
materials switch to depthTest:true (and are transparent so they share the
mesh's render pass), letting the mesh occlude the parts of the skeleton
behind it.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@tkclam
tkclam merged commit 008c71c into main Jun 11, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant