# 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 %}


---

# Agent Instructions: 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:

```
GET https://docs.theseus.us/gcs-software/vozilla-2.0/cameras/calibrating-your-camera.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.