Skip to content

Changelog

Notable changes to the LUC3D app. Entries reference the merged pull request. The app is deployed to luc3d.sleap.ai with /stable/, /latest/, and /dev/ channels (see Installation).

October 2026

Added

  • Define Planes and Set Origin — View → Define Planes annotates planes (e.g. the arena floor) in 2D, triangulates and fits them; Set Origin picks a plane node as the new origin and which way +Z points, re-basing the 3D view, and Set as New Calibration rewrites the data into that frame (#208). See Defining the Arena & Origin.

July – September 2026

Added

  • Track Frame Range — the Track Frame toolbar button is now a split button whose menu opens a Start / End / Animals dialog to re-track just a span of frames under new Tracking Wizard settings, reusing existing identities (#227).
  • SLEAP skeleton JSON import — Load Skeleton... reads skeletons saved from the SLEAP GUI (list-wrapped and nx_graph forms) with correct node order (#228).
  • Display Legend — an optional per-view legend (Detected / Reprojected / Error vector) drawn as pane chrome, so it stays upright and readable on rotated views; the Settings dialog is now resizable (#225).
  • Hide/Show 3D View toolbar button, in sync with \ and View → Toggle 3D Viewport; a hidden viewport stops rendering (#220).
  • Views strip and single-view mode — one click on a view thumbnail focuses, swaps in, or re-opens a view; Up / Down step through cameras in single-view mode; V enters single-view and G returns to the grid with the same camera selected (#218).
  • Calibrate menu — Calibrate → Calibrate in New Tab opens the companion calibration app calibrat3 (#217).
  • Export Video Overlays — compose any set of camera views (plus the 3D viewport) in a dockable layout and render them with the pose overlays burned in to one stitched MP4 or one file per tile (#197).
  • Per-video Contrast slider in the Visibility tab, and every session-scoped Visibility setting (brightness, contrast, rotation, hidden rows) saved in the project file (#196).
  • Custom Instance Delete — Edit → Custom Instance Delete... bulk-deletes by type, grouping state, view, track, or identity, for the current frame or the whole session (#191).
  • Per-instance reprojection error — the Instances tab's node breakdown is now one per-node × per-camera table per triangulated instance, each with its own mean error (#154).
  • Stale-detection eviction tracker parameter (default 20 frames) in the Tracking Wizard, which drops a target's stale per-camera anchor after an occlusion; the distance threshold default tightened from 50 to 25 mm (#210).
  • Prompt to save when switching sessions with unsaved changes (#157).

Changed

  • "Bundle Adjustment" renamed "Refined (Ref)" in Settings, the Triangulate / Triangulate All dropdowns, and the Instances tab. Cameras are held fixed and only 3D points are refined, which "bundle adjustment" misdescribed (#224). The solver now minimizes the same distorted-space error the app reports, and the chosen method sticks after Triangulate All (#192).
  • SLP export dialogs state that user labels are always saved; the Include options are now Predicted Instances and Reprojections toggles (#219).
  • Hosted release channels — the app is deployed to luc3d.sleap.ai with /stable/, /latest/, and /dev/ channels plus per-PR previews (#221, #222).
  • Session-folder loading treats all cameras as one unit — every camera loads eagerly or lazily together, and cameras that load with no labels are reported instead of silently shown empty (#215).
  • Manual identity switches propagate forward — assigning a taken identity swaps both identities from the current frame to the end of the timeline, across all cameras (#193).
  • Project files use SLP 2.8 columnar session data (sleap-io.js 0.5.5) — 3D points and grouping are stored in chunked HDF5 datasets so very large projects save and reload; unreadable session data now fails loudly (#166).

Fixed

  • Ungrouping an instance kept its identity and its on-canvas name pill; an identity switch on one view no longer leaks into the other cameras (#202, #213).
  • Cross-view tracker: stale 3D anchors after occlusions caused permanent identity swaps (#210).
  • Refined-solver reprojections ignored the Visibility panel color, and lazy hydration of .h5 predictions could drop grouped labels back to ungrouped (#211).
  • Propagate IDs → Tracks: an ID switch on one view gave both animals the same track, and ambiguous first-frame tracks were exported trackless (#204, #207).
  • Save As on large lazy projects after Track All + Triangulate All ran out of memory; Track All on a freshly opened large project bailed with "No frames to track" (#189).
  • Skeleton/video misalignment on B-frame videos: the frame map was built in decode order instead of presentation order (#187).
  • Wrong or duplicate identity colors on the first frame after Track All (#183).
  • SLP exports wrote track labels only on the first frame after Propagate IDs → Tracks; merged saves duplicated the track list per camera (#182).
  • Propagate IDs ↔ Tracks lost identity data outside the resident window on large lazy sessions (#179).
  • ID timeline showed identities only for visited frames on lazy-loaded sessions (#171).
  • With 3+ animals, a reprojection into a view where the animal was undetected could take another animal's color (#169).
  • Reopening a large project .slp crashed the tab; project reopen is now a memory-bounded lazy load, and calibration, 3D points, and identities survive reload (#166, #167).
  • Fixing a mid-video identity swap did not propagate to later frames (#160).
  • Save failed: invalid string length on large projects; calibration lost when reopening via the session-folder path; project files roughly halved in size (#157).

Earlier in 2026

Added

  • Cross-view tracker — automatic multi-view grouping and identity assignment, a faithful port of the CrossViewTracker from talmolab/sleap-3d (#131).
  • Tracking Wizard — per-node weights, per-view (camera) inclusion, cross-view association thresholds, a reprojection-error threshold for robust triangulation, and editable keyboard shortcuts with a Settings catalog (#100, #103).
  • Frame-accurate video decode via mediabunny (WebCodecs), fixing video/pose frame mismatch when stepping and seeking (#141).
  • Lazy-loading for large .slp / .h5 files plus a memory-bounded full pipeline — windowed triangulate-all and streaming save/export — so very large prediction sessions no longer exhaust memory (#132, #133).
  • SLP backend migrated to sleap-io.js — reads and writes now use sleap-io.js; exported .slp files are in SLEAP's native format (requires SLEAP ≥ 1.6) (#128).
  • Bundle Adjustment triangulation with distortion-aware reprojection and dual error reporting, plus a Settings/Help menu (#98).
  • 3D viewer upgrades — import 3D points (H5), navigate without videos, timeline tracks, and 3D video (MP4) export (#99).
  • New SLEAP exports — "Export SLEAP File Per Session" and "Export SLEAP File By Cam" with folder-based Download All and per-session export (#97, #108); multi-session 2D SLP export (#77).
  • Full skeleton editor with node/edge add/rename/remove, and enforcement of one skeleton per project (#109, #118).
  • Per-session tracks & identities with null/trackless round-trip (#104), IDs↔Tracks propagation (#94), and duplicate-identity resolution (#92).
  • Responsive info-panel tabs with a "More ▾" overflow menu (#110).

Fixed

  • Occluded nodes after triangulation could become unplaceable in new instances (#146).
  • Adding/reassigning a track or ID in the Instances panel could hide the timeline (#140).
  • Timeline canvas overflow crash on tall (many-row) timelines (#116).
  • Frame stepping on high-fps video (frame-rate-aware seek tolerance) (#90).

Changed

  • Refactored index.html into an ES module tree (#81).