> 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/setup/calibration.md).

# Stage 1 · Calibration

Combine every LiDAR view into one 3D scene with the calibration wand. Run it after the first installation, after moving a sensor, or when surfaces look doubled.

Calibration combines every LiDAR view into one 3D scene. Run it after the first installation, whenever a sensor moves, or when walls and floors look doubled.

Before you start: clear the stage, power and connect every sensor, and have the calibration wand ready.

{% hint style="info" %}
If the sensors are already calibrated but the floor or the forward direction looks wrong, skip the full run — see [Adjust the stage alignment only](#adjust-the-stage-alignment-only).

If nothing has changed since the last show, select **Skip to Settings ›** on this stage to go straight to Stage 2. It is available only while a valid calibration is saved.
{% endhint %}

## Connect sensors

1. Select **Calibration → Connect sensors** in the left navigation to detect the sensors.
2. Check that every installed sensor appears in the connected list. If one is missing, check its power and cable, then select **Detect again**.
3. Select **Calibrate sensors** on the left, then **Calibrate** in the right panel.

<figure><img src="https://1990205953-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsiYoXLAF78e1PzseNXtd%2Fuploads%2Fgit-blob-6c9071d156d038de1eb003d1dda417f4daa7a8dc%2Fcalib-calibrate-sensors.png?alt=media" alt="Calibrate button in the Calibrate sensors panel"><figcaption><p>Calibrate opens the six-step wizard below.</p></figcaption></figure>

{% hint style="info" %}
Calibration is locked while the pipeline runs. Select **Stop pipeline** in the top bar to edit it. This interrupts any live output; use GO LIVE again to resume.
{% endhint %}

## 1 · Setup

<figure><img src="https://1990205953-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsiYoXLAF78e1PzseNXtd%2Fuploads%2Fgit-blob-873e0f127594cef412d2ba3b3f8c889a9ace2a64%2Fcalib-01-setup.png?alt=media" alt="Setup with sensor status and calibration wand selection highlighted"><figcaption></figcaption></figure>

1. Confirm **PTP sync**, **Connected**, and **Live data** are green for every sensor. The **Reference** sensor is chosen automatically.
2. Choose the wand: **Regular** (15 cm ball) or **Big** (20 cm ball).

{% hint style="warning" %}
If a stream does not start, check power and cabling, then select **Try again**. If **PTP sync** never turns green, contact your MOVIN support team.
{% endhint %}

## 2 · First calibration

<figure><img src="https://1990205953-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsiYoXLAF78e1PzseNXtd%2Fuploads%2Fgit-blob-0117b90e9283ffd33b3addbd46d1bcc78db18720%2Fcalib-02-first-collecting.png?alt=media" alt="First calibration sensor collection progress highlighted"><figcaption></figcaption></figure>

1. Select **Start collection**. A wand reminder appears — select **Start collection** again to begin.
2. Walk the wand slowly around the whole stage.
3. Vary its height as you walk, from near the floor to overhead.

Collection stops on its own once every sensor's estimate settles. There is no stop button.

<figure><img src="https://1990205953-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsiYoXLAF78e1PzseNXtd%2Fuploads%2Fgit-blob-7b4c0a041503d4e424cec35a7b4ea9eaab296239%2Fcalib-03-first-ready.png?alt=media" alt="Completed collection progress and first calibration result review highlighted"><figcaption></figcaption></figure>

1. Confirm every sensor is ready under **Collection progress**.
2. Check **Result review**. A **Pass** is enough — collect again only if a sensor fails.
3. Select **Confirm first calibration**. The wizard continues to Refine calibration on its own.

### If collection does not finish

Check each sensor's progress and **Live data / PTP sync**. Move the wand through shared views of at least two neighboring sensors and vary its height. If only one sensor stops progressing, check its view, obstructions, and cable. If progress remains stuck, send the screen and sensor status with the [support details](/movin-tracin-stage/reference/troubleshooting.md#what-to-include-in-a-support-request). Closing the wizard discards the unsaved collection.

## 3 · Refine calibration

<figure><img src="https://1990205953-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsiYoXLAF78e1PzseNXtd%2Fuploads%2Fgit-blob-b612935658523b00d5cb2b6b3c992a9e3badb19f%2Fcalib-04-refine-collecting.png?alt=media" alt="Refine calibration sensor progress and wand trajectories highlighted"><figcaption></figcaption></figure>

Unlike First calibration, this step waits for you to stop it.

1. Select **Start capture**. The same wand reminder appears — select **Start capture** again to begin.
2. Move the wand side to side, front to back, and low to high.
3. Watch the viewport — the trajectories should cover the full working volume, not one small area.
4. When **Enough data — press Stop when ready** appears, select **Stop capture**.
5. Select **Refine calibration**. Stopping alone does not calculate the result.

<figure><img src="https://1990205953-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsiYoXLAF78e1PzseNXtd%2Fuploads%2Fgit-blob-1f62b38cde867f03367ef3eaac552094d9c411dc%2Fcalib-05-refine-done.png?alt=media" alt="Refine calibration complete"><figcaption><p>A completed refinement is ready for axis selection.</p></figcaption></figure>

When **Refinement** shows **Complete**, select **Next · Select axis**.

To add coverage, select **Capture more**, collect, select **Stop capture**, then **Refine again**. **Reset all** discards everything in this step.

## 4 · Select axis

Set three points in order: **Origin**, **Right**, and **Forward**. Put the **Origin** at the center of the capture space and stand there facing the audience — **Right** is your right, and **Forward** points toward the audience.

<figure><img src="https://1990205953-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsiYoXLAF78e1PzseNXtd%2Fuploads%2Fgit-blob-7c08d3d7db2e8eb6c3dd4cbe7acd1be3a0b66143%2Faxis-placement-guide.svg?alt=media" alt="O R F wand placement"><figcaption><p>Wand placement for the three axis points.</p></figcaption></figure>

1. Select **Start origin capture**.
2. Place the wand at the origin and step away.
3. Confirm **Placed — start capture**, then leave the wand still until the candidate list appears.

<figure><img src="https://1990205953-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsiYoXLAF78e1PzseNXtd%2Fuploads%2Fgit-blob-9027f88f8e8fccd42d5d0b9fcfcb636e1a3d866c%2Fcalib-07-axis-origin-capture.png?alt=media" alt="Axis position candidates"><figcaption><p>Candidate list after the origin capture.</p></figcaption></figure>

4. Verify the selected marker against the real wand position; choose another candidate if needed.
5. Select **Next: right**, move the wand to the right-hand spot, and repeat with **Start right capture**.
6. Select **Next: forward**, then repeat at the forward spot with **Start forward capture**.
7. Once all three points are selected, select **Next · World alignment**.

Use **Resample** on a target if you need to capture it again.

## 5 · World alignment

<figure><img src="https://1990205953-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsiYoXLAF78e1PzseNXtd%2Fuploads%2Fgit-blob-d9e4f43c9990b6c86f827da7177fd850fc3eec16%2Fcalib-10-world-align.png?alt=media" alt="World alignment in Top, Front, Side, and 3D views"><figcaption><p>World alignment in the four views.</p></figcaption></figure>

**Auto align** runs on its own when you enter this step.

1. When **World solve** shows **Complete**, check the Top, Front, Side, and 3D views.
2. If the floor looks tilted or sits at the wrong height, clear the floor and select **Fast refine**.
3. Select **Confirm**. It may stay disabled for a few seconds — wait for it.

### Check before saving

<figure><img src="https://1990205953-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsiYoXLAF78e1PzseNXtd%2Fuploads%2Fgit-blob-43744b4401662041f40631d0c6a6c1bca7ddd8c8%2Falignment-check.svg?alt=media" alt="Aligned and separated sensor surfaces, schematic comparison"><figcaption><p>Aligned surfaces (left) and surfaces that need attention (right).</p></figcaption></figure>

| Check                                  | Ready to save                                        | Needs attention                                                      |
| -------------------------------------- | ---------------------------------------------------- | -------------------------------------------------------------------- |
| Sensor views of the same floor or wall | Overlap as one surface                               | Separate doubled surfaces: check for sensor movement and recalibrate |
| Stage floor in Front and Side          | Level and at the intended floor height at the origin | Tilted or offset: clear the floor, run Fast refine, then check again |
| Origin, right, and forward             | Match your physical O/R/F placements                 | Wrong direction: revisit the selected points in Select axis          |

Check the scene against your stage rather than trusting the Complete status alone, then select **Next · Save**.

## 6 · Save

<figure><img src="https://1990205953-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsiYoXLAF78e1PzseNXtd%2Fuploads%2Fgit-blob-81c69669784d4e57aa48f1fab1f59dd491d44c30%2Fcalib-11-save.png?alt=media" alt="Save calibration with a timestamped filename"><figcaption></figcaption></figure>

Keep the suggested filename or enter your own, then select **Save**. The saved file becomes the default for the next pipeline start.

{% hint style="warning" %}
**Discard & exit** clears everything from this session — the wand paths, the axis points, and the refined result. Closing the wizard with **×** does the same. Save first if you want to keep the work.
{% endhint %}

## Adjust the stage alignment only

Sometimes the sensors are fine but the stage isn't. The floor sits at the wrong height, the scene leans, or forward points the wrong way.

You can fix that without collecting wand data again:

1. With the pipeline stopped, select **Calibration → Align world**. The saved sensor positions are kept — you go straight to World alignment.
2. Adjust the floor and the forward direction, then save.

Select **Re-calibrate** instead when a sensor has moved, a sensor was added or removed, or surfaces look doubled. Those need the full run.

{% hint style="info" %}
**Align world** appears only when a calibration is already saved, and only while the pipeline is stopped.
{% endhint %}

Continue to [Stage 2 · Settings](/movin-tracin-stage/setup/live-settings.md).


---

# 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/setup/calibration.md?ask=<question>&goal=<endgoal>
```

`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.