Quickstart¶
This guide walks you through a complete workflow: loading videos, annotating poses, grouping across views, triangulating 3D, and exporting.
1. Launch LUC3D¶
You can use LUC3D in two ways:
- Hosted (easiest): Go to https://luc3d.sleap.ai/ — no installation required.
-
Local (recommended for large files): Run a local server:
Then open http://localhost:8080 in Chrome or Edge.
2. Load a Session¶
Go to File → Load Single Session Folder (or press Ctrl+O) and select a folder containing your multi-camera videos and calibration file.
Your session folder should have per-camera subdirectories:
my_recording/
├── calibration.toml
├── back/
│ └── video.mp4
├── side/
│ └── video.mp4
└── top/
└── video.mp4
LUC3D automatically matches camera subdirectory names to the camera names in the calibration file. Other layouts are available via File → Session Folder Wizard... (see Multi-Camera Setup).
3. Annotate a Pose¶
- Navigate to a frame using the timeline or arrow keys
- Click a camera view, then press N to create a new instance
- Drag keypoint nodes to position them on the animal/person; right-click nodes that aren't visible
- Repeat for each camera view where the subject is visible
4. Group Across Views¶
- Click an ungrouped instance in one camera view — this starts a group (assignment mode)
- Click the instance in each other camera view that represents the same individual
- Press Shift+G (or click Group in the toast) to create the group
The instances are now linked as an InstanceGroup — they represent the same skeleton seen from different angles.
Or let the tracker do it
Instead of grouping by hand, run Track Frame (Shift+T) or Track All (Ctrl+Shift+T) to group instances across views and assign identities automatically. See Tracking.
5. Triangulate¶
Press T to triangulate the current frame. LUC3D computes 3D positions (DLT by default; the Triangulate ▾ toolbar button also offers the slower Ref solver, which helps when one view's 2D point is clearly wrong) and shows:
- Reprojected instances (dashed outlines) on each camera view
- Reprojection error in the Instances tab
- 3D skeleton in the 3D viewport (press \ to open)
6. Export¶
Press Ctrl+S to Save the whole project as a .slp, or go to File and choose an export:
- Export SLEAP File Per Session / By Cam — SLEAP-compatible
.slpfiles (see Exporting Data) - Export Labels (JSON) — All 2D annotations as JSON
- Export 3D Points (H5) / Export Reprojections (H5) — Triangulated 3D keypoints and their reprojections in HDF5
- Export Video Overlays / Export 3D Video — MP4 renders of the camera views with poses, or of the 3D viewport
That's it! See the User Guide and Tutorials for detailed walkthroughs.