> For the complete documentation index, see [llms.txt](https://help.movin3d.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.movin3d.com/movin-tracin-stage-en/setup/calibration.md). # Stage 1 · Calibration Calibration aligns the sensors into one shared 3D scene. You perform it by moving a calibration wand — a spherical target mounted on a rod — throughout the stage while the sensors detect it. The reference sensor — usually one mounted high overhead and aimed down — defines the coordinate frame to which all other sensors are aligned. Perform calibration at initial installation, after a sensor is moved or replaced, or when the scene appears misaligned (for example, doubled walls or an offset floor). Before you begin, keep the wand within reach, make sure the entire stage is clear and accessible, and confirm that every sensor is powered, connected, and PTP-synced. Before opening the six-step wizard, complete the following two screens. ## Before the wizard ### Calibration guide card

Calibration guide card — The Stage 1 landing card.

1. **What this stage does** — connect the sensors, then calibrate them. The pipeline starts from Live Settings, once calibration is done. 2. **Two paths** — **Next: Connect sensors →** to begin, or **Skip to Live Settings →** if a valid calibration is already loaded. ### Connect sensors

Connect sensors screen — Select the sensors and the reference before the wizard opens.

1. **Sensors** — every detected sensor. Select the reference sensor used to align all other sensors — usually a ceiling-mounted LiDAR aimed down over the stage. A **REFERENCE** badge identifies the selected sensor. **Detect sensors** re-scans if one is missing. 2. **Where is the reference mounted?** — **Ceiling** (aimed downward) or **Floor** (upright). This only orients the preview; the saved calibration is unaffected. 3. **Timecode / LTC** — the incoming Linear Timecode (LTC), shown for reference. It does not affect calibration. 4. **Next: Calibrate sensors →** — opens the wizard. {% hint style="info" %} Calibration is locked while the pipeline is running. Selecting it prompts you to stop the pipeline first, which unlocks the wizard. The show stops broadcasting until you go live again. {% endhint %} ## Step 1 · Setup *Check the sensor status and select the wand type. The stream starts automatically.*

Step 1 Setup — sensor status and calibration wand — All four sensors are PTP-synced, connected, and streaming.

Confirm each sensor shows three green indicators — **PTP synced**, **Connected**, and **Live data** — then select the wand type you are holding: **Regular** (15 cm diameter) or **Big** (20 cm diameter). The stream starts automatically; if a sensor does not connect or begin streaming, select **Reconnect**. When every indicator is green, select **Next · First calibration**. {% hint style="warning" %} PTP synchronization is required when two or more sensors are used. Without a shared clock, the alignment does not converge. A single sensor used for testing does not require it. {% endhint %} ## Step 2 · First Calibration *Move the wand throughout the stage to create an initial alignment.*

Step 2 First Calibration — collecting — The reference defines the frame; the other sensors fill in as the wand enters their view.

1. **Collecting…** — move the wand slowly throughout the stage and vary its height from low to high. Keeping it at one height can leave the result tilted. 2. **Collection progress** — the reference reads *defines the frame — no capture needed*; the progress indicators for the other sensors fill as the wand enters their fields of view.

Step 2 — all sensors ready — Every sensor has collected enough frames, and the result review shows Good.

1. **All sensors ready** — every sensor has collected enough frames. 2. **Collection progress** — each sensor now reads e.g. `50 / 50 frames · ready`. 3. **Result review** — a per-sensor quality check; **Good** means the alignment looks right. 4. **Confirm first calibration** — save the initial result and continue to Refine Calibration. ## Step 3 · Refine Calibration *Move the wand throughout the capture volume to collect trajectory data, then refine the alignment.*

Step 3 Refine — collecting trajectories — The green loops are the path you have covered; the per-sensor percentages show coverage.

1. **Collecting…** — per-sensor coverage (e.g. `L-202 50%`); keep moving the wand until each sensor's coverage indicator is complete. 2. **Capture summary** — accepted and skipped trajectories, counted live. 3. **Stop capture** — select it once sufficient coverage has been collected. 4. In the viewport, the **green loops** are the path you have covered.

Step 3 complete — Refine Complete — Trajectories accepted and the Refine calibration status shows Complete.

1. **Capture control** — **Capture more** adds trajectories without losing earlier ones; **Reset all** starts fresh. 2. **Capture summary** — the accepted trajectories. 3. **Refine calibration** — the optimization has run and shows **Complete**. 4. **Next · Select axis** — continue. ## Step 4 · Select Axis *Define the origin, right, and forward directions, in that order. Set them while facing the stage, so the frame matches the stage.*

Step 4 Select Axis — Origin — Place the wand at the center and hold it still while candidates accumulate.

1. **Target axis** — starts on **Origin**. 2. **Where to place the wand** — the diagram shows each spot: **O** (the stage center), **R** (to your right), and **F** (the forward direction you face). Place the wand there and step clear. 3. **Candidate list** — fills with scored candidates as you hold the wand still.

Step 4 — candidates in the viewport — Each candidate appears as a marker in the 3D view.

Each candidate appears as a marker in the 3D view. Select the one that matches where you actually placed the wand — confirm the preselected candidate or click another. (RMSE reflects how consistently the wand was detected — lower is generally better — but always pick the marker at the wand's real position.)

Step 4 — Right axis — The white O marker shows the confirmed origin; now place the wand to your right.

1. **Target axis** switches to **Right**. 2. The diagram now points to the **R** spot — place the wand there and step clear. 3. Select the candidate, as you did for the origin.

Step 4 — all three axes confirmed — With all three axes confirmed, the O, R, and forward markers define the world frame.

Repeat once more for **forward**. When all three axes show a check mark, select **Next · World alignment**. ## Step 5 · World Alignment *Finalize the shared coordinate frame, adjust the floor, and confirm.*

Step 5 World Alignment — Top, Front, Side, and 3D views — The viewport splits into Top, Front, Side, and 3D views so you can verify the result from every angle.

1. **Auto align** (required) — **World solve** computes the common frame from your Step 4 points and shows **Complete** when done. 2. **Fast Refine → Run** (recommended) — auto-corrects the floor's tilt and height. Skip it if the floor has objects on it (boxes, cables, or people), because it estimates the floor plane from the visible floor points. 3. **Manual fine-tune** — rarely needed; use it only if the floor is still tilted or offset after Fast Refine. 4. **Confirm** — verify in the **Top / Front / Side / 3D** views, then confirm. ## Step 6 · Save *Save the calibration so it can be used when the pipeline starts.*

Step 6 Save — timestamped filename — A timestamped filename is prefilled; saving it sets it as the default calibration.

A timestamped **base filename** is prefilled, with sensor IDs added automatically — change it if necessary. Select **Save**, and the calibration becomes the default, applied automatically the next time the pipeline starts. **Discard & exit** leaves without saving. ## Next Continue to [Stage 2 · Live Settings](/movin-tracin-stage-en/setup/live-settings.md). Once the pipeline starts, calibration is locked until you stop the pipeline and reopen the wizard. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.movin3d.com/movin-tracin-stage-en/setup/calibration.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.