> For the complete documentation index, see [llms.txt](https://docs.theseus.us/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.theseus.us/gcs-software/vozilla/cameras/calibrating-your-camera.md).

# Calibrating your camera

<figure><img src="/files/FvQQ7k96WrZgXY6Z3SBS" alt=""><figcaption></figcaption></figure>

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

#### What you need

* A 7×8 asymmetric circle grid calibration target, found below.

{% file src="/files/9jIZU1cdlLUHxN8zqzdi" %}

* For thermal cameras, we’ve found it works best to 3D print the grid and place it on a uniform warm surface so the pattern is clearly visible. A step file for this grid can be found below.

{% file src="/files/YUxFEpZH5geflfCvGavu" %}

{% hint style="info" %}
Placing the 3D print against a monitor works well for thermal cameras, providing a consistent warm background.

<p align="center"><img src="/files/SHX6TwSShF7h2AbpyBpE" alt="" data-size="original"></p>
{% endhint %}

#### Capture calibration images

1. Connect your camera and open the Camera Calibration page.
2. Use Capture Frame to record images of the detected grid.
3. Move the target 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.

<figure><img src="/files/J6P4UgK4k99w5TvPUxbY" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
If your target is white dots on a black background, enable Inverted Pattern so detection works correctly.
{% endhint %}

#### Compute and save

After capturing enough frames, Vozilla will prompt you to compute the calibration. Save it using the default name or a descriptive name (helpful if you switch cameras or lenses later). The saved calibration can be reused in the future.

#### Verify quality

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

<figure><img src="/files/BcgayQfcqDZpNK9Flpky" alt=""><figcaption></figcaption></figure>

#### Advanced options

{% hint style="danger" %}
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.
{% endhint %}