For the complete documentation index, see llms.txt. This page is also available as Markdown.

Stage 1 · Calibration

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.

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.

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.

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.

Calibrate button in the Calibrate sensors panel
Calibrate opens the six-step wizard below.

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.

1 · Setup

Setup with sensor status and calibration wand selection highlighted
  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).

2 · First calibration

First calibration sensor collection progress highlighted
  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.

Completed collection progress and first calibration result review highlighted
  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. Closing the wizard discards the unsaved collection.

3 · Refine calibration

Refine calibration sensor progress and wand trajectories highlighted

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.

Refine calibration complete
A completed refinement is ready for axis selection.

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.

O R F wand placement
Wand placement for the three axis points.
  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.

Axis position candidates
Candidate list after the origin capture.
  1. Verify the selected marker against the real wand position; choose another candidate if needed.

  2. Select Next: right, move the wand to the right-hand spot, and repeat with Start right capture.

  3. Select Next: forward, then repeat at the forward spot with Start forward capture.

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

World alignment in Top, Front, Side, and 3D views
World alignment in the four views.

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

Aligned and separated sensor surfaces, schematic comparison
Aligned surfaces (left) and surfaces that need attention (right).
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

Save calibration with a timestamped filename

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

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.

Align world appears only when a calibration is already saved, and only while the pipeline is stopped.

Continue to Stage 2 · Settings.

Last updated