Camera calibration

This page cover the two methods for calibrating your Cyclops camera module.

Vozilla calibration tool

The Camera page in Vozilla lets you generate a calibration file (camera intrinsics) for your camera. A good calibration improves Cyclops tracking accuracy and reduces distortion, especially at the edges of the image.

Calibration grid

We use a 7×8 asymmetric circle grid as a calibration target. We have included a .png file of this geometry below.

circle_grid_7x9_30mm.png

image · 314KB

Open

For thermal cameras, we’ve found it works best to 3D print or laser cut the grid and place it on a uniform, warm surface so the pattern is clearly visible. A .STEP file for this grid is included below.

Cutout Thermal Calibration.STEP

310KB

Open

Placing the 3D print against a monitor works well for thermal cameras, providing a consistent warm background.

1

Start a new calibration

Connect your camera. In Vozilla, navigate to the Camera page and click + New Calibration. Confirm that the information is correct for your camera module and click CONTINUE.

2

Capture frames

Position the calibration grid beneath the camera. Move the camera through a variety of:

• Angles (tilt and rotate)

• Positions (across the full frame, including corners)

• Distances (close, medium, far)

For best results, capture 20+ frames where the pattern is cleanly detected.

If your target is white dots on a black background, enable Inverted Pattern so detection works correctly.

3

Compute and save

After capturing enough frames, Vozilla will prompt you to save the calibration. We recommend using a descriptive name (helpful if you switch cameras or lenses). The saved calibration will automatically become the active calibration on your device.

4

Verify quality

After saving, use the Distortion toggle (bottom-right of the camera view) to preview the effect of the calibration. A good calibration reduces warping and keeps lines and features looking consistent across the frame.

Camera calibration script

Alternatively, you can create a camera calibration using the script below:

Camera calibration script

We don’t recommend manually editing calibration values or entering custom intrinsics unless you’re an advanced user. If needed, you can also create a calibration by selecting a starting point from the Camera Presets dropdown.

Your Cyclops camera is calibrated and the calibration file is active.