Tutorial: Defining the Arena and Setting the Origin¶
A calibration puts the 3D origin wherever the calibration board or reference camera happened to be, so the 3D viewport's grid is usually tilted and off to one side of the arena. This tutorial annotates the arena floor as a plane and then makes its centre the new (0, 0, 0), with +Z pointing up toward the cameras.
| Needs | Videos and a calibration with 2+ cameras loaded |
| Mode | View → Define Planes (Ctrl+Shift+P / Cmd+Shift+P) |
The origin moves the display, not your data
Setting an origin re-bases the 3D viewport — its grid, axes and orbit. Cameras, poses and planes stay in calibration coordinates, and exported 3D poses are unchanged. To move the data itself, see Making the origin permanent.
1. Enter Defining Plane Mode¶
Choose View → Define Planes. A Defining Plane Mode banner appears and the info panel switches to the plane panel (Nodes, Planes, 3D Mesh Objects). The pose toolbar (+ Instance, Triangulate, Track All, …) is locked while the mode is on.
To leave, click Exit in the banner. Esc does not leave this mode.
2. Create the nodes¶
Nodes are project-wide and can be shared by several planes. For a rectangular floor, make five: the four corners and the centre.
- Under Nodes, type a name (e.g.
C1) and click + Node. Leave the name blank forp1,p2, …. - Repeat for
C2,C3,C4andCenter.
3. Create the plane and add the nodes¶
- Under Planes, click + New Plane and give it a Name (e.g.
arena). - Under Nodes In This Plane, pick each node from the dropdown and click + Add, in order around the floor with the centre last.
- (Optional) Under Node Connections, use + Link to draw edges between corners. Connections are only for display.
4. Place the plane on two views¶
- Drag the plane's row from the Planes table onto a video view where the whole floor is visible. The nodes appear in a ring around the drop point.
- Drag each node onto its corner, and the centre node to the middle of the floor.
- Drop the plane on a second view and put each node on the same physical corner as in the first view.
| In a video view | Does |
|---|---|
| Drag a node | Move that node |
| Alt + drag | Move the whole plane |
| Right-click / Ctrl + click a node | Toggle the node off in this view |
Each plane can be placed once per view. The Views column counts the views you placed by hand.
5. Triangulate and check the error¶
Click Triangulate under Actions. LUC3D triangulates every node from your hand-placed views and reprojects the plane into all other views. The status bar and the expanded plane row report the mean reprojection error in pixels, per node and overall.
- If the error is high, find the view where the reprojected corners miss the floor and drag them onto it. A reprojected corner counts as evidence only after you drag it.
- Click Fill to shade the plane so the floor is easy to see.
6. Fit the plane¶
Click Fit. LUC3D fits one flat plane through the nodes, moves them onto it, and updates every view. The status bar reports how far the points were off the plane (mm RMS) and how far the corners moved in 2D. A fit needs 3+ triangulated nodes that are not in a line.
Once fitted, nodes can also be dragged in the 3D viewport. They stay on the plane.
7. Set the origin and the +Z direction¶
Click Set Origin (available once a plane is fitted). A Set Origin Mode banner appears, and a movable instruction box walks through three steps in the 3D viewport. Widening the 3D view and looking across the floor from a low angle makes the arrows easier to click.
- Click a node of the fitted plane. It becomes the new origin. For an arena, click
Center. - Click the red or the blue arrow to choose which way +Z points. The two arrows are the plane's two normals. Pick the one pointing up, toward the cameras.
- Continue to apply, or Cancel to pick again.
Esc leaves Set Origin Mode at any step. +X and +Y are set automatically: +X is the calibration's +X laid onto the plane, and +Y completes a right-handed frame.
The 3D grid now lies on the arena floor, centred on the origin, with Z up, and orbiting and zooming pivot on the new origin. While labeling, you can keep the floor in 3D and hide it on the videos with the Planes toggles in the Visibility tab.
The Defined Origin panel¶
After an origin is set, the plane panel shows a Defined Origin section with the transform from calibration coordinates to the new frame:
It lists the origin (in calibration coordinates), the translation t (mm), the rotation as a vector, axis and angle, the three new axes, and the 3×3 rotation matrix R. Select the text to copy it.
Making the origin permanent¶
The Danger Zone section (shown once an origin exists) holds three actions:
| Action | What it does |
|---|---|
| Set as New Calibration | Rewrites every 3D point (poses and plane nodes) and the camera extrinsics into the new frame; 2D labels are untouched. Writes calibration-rebased.toml next to the original, which is not overwritten. Saves the project if it already has a file, otherwise prompts you to use File → Save As. Afterwards the defined origin is cleared, since the data is now in that frame. |
| Export New Calibration | Downloads calibration-rebased.toml with the re-based camera extrinsics only; no points move. |
| Reset to Calibration Origin | Discards the defined origin and returns the 3D view to the calibration frame. There is no undo; run Set Origin again to restore it. |
Warning
When calibration-rebased.toml and calibration.toml are both in a folder, calibration-rebased.toml takes precedence on load.
What is saved¶
Nodes, planes, their placements and the defined origin are saved with the project (in the .slp under metadata.lucid, and in the project JSON) and restored when it is reopened. The Plane Appearance sliders and the Visibility Planes toggles are browser preferences and are not saved in the project.
Troubleshooting¶
| Message or symptom | Fix |
|---|---|
| "Load calibration for 2+ cameras first" | Load a calibration before triangulating |
| "…is placed on N view(s) — needs 2+" | Drop the plane on a second view |
| "…has hand-placed corners on only 1 view" | Reprojected corners don't count. Place the plane on, or drag its corners in, another view |
| "…needs 3+ non-collinear triangulated nodes to fit a plane" | Add or triangulate more nodes, not all in a line |
| Set Origin is greyed out | Fit a plane first |
| "Flattening will move points a long way" | A node is badly placed. Fix it in 2D and re-triangulate, or click Fit anyway |
| "…is now stale — re-fit it" | You moved a node shared with another plane. Select that plane and click Fit |
| A plane reappears on a view you removed it from | Triangulate reprojects into every view. Remove the placement again after triangulating |
| +Z points down into the floor | You picked the wrong arrow. Run Set Origin again and pick the other one |