# User Calibration

To reduce the presence of Fixed Pattern Noise (FPN), a User Calibration can be created based on a short clip recorded with no light hitting the sensor. Available in [Wave Player (macOS)](/products/products/wave-camera/downloads.md#wave-player-macos) v1.4.1 and in [Wave Player (Windows)](/products/products/wave-camera/downloads.md#wave-player-windows) v1.4.0. See below for instructions for macOS and Windows.

At a minimum, this should be done at once for 4K and once for 2K. However, since FPN is affected by temperature and exposure and may change over time, it can be beneficial to generate new User Calibrations periodically or if operating conditions have changed substantially. Use camera settings that closely match the target operating point(s).

{% hint style="info" %}
.kwc calibration files are not cross platform, but can be used on other computers with the same Operating System.
{% endhint %}

### macOS

To generate a new User Calibration, follow the steps below:

1. Turn on the camera and wait 10-15 minutes for it to warm up.
2. With the lens or body cap on to prevent light from hitting the sensor, record a short clip (at least 40 frames, but more than that is not beneficial).
3. Connect the camera via USB
4. Show Dark Frame Manager from the Menu Bar (image below)
5. Click "Add Dark Frame"
6. If the list is empty, click "Open Dark Frame Clips" and select WAVE drive&#x20;
7. Select your target source Dark Frame clip from the list
8. Click "Generate Dark Frame" at the bottom of the window

On macOS, User Calibrations can be accessed from the Menu Bar from "Configuration > Dark Frame Manager"&#x20;

<div align="left"><img src="/files/y12hyV5vKnrauzQ7p7Za" alt=""></div>

The best calibration for a given clip is automatically selected according to criteria listed in the table below, and will show "Active" if the User Calibration is being used for the currently opened clip. Use the folder icon at the bottom of the Dark Frame Manager to directly access KWC files containing User Calibration Data.

<table><thead><tr><th width="159.5029591129976" align="center">Criteria</th><th>Condition</th></tr></thead><tbody><tr><td align="center">Camera UID</td><td>Must match.</td></tr><tr><td align="center">Width (4K or 2K)</td><td>Must match.</td></tr><tr><td align="center">Height</td><td>Must match or exceed clip Height. Must match identically for clips with Aspect Ratio 24:9 or higher (Closest Height selected as ranking priority #1.)</td></tr><tr><td align="center">FPS</td><td>Closest FPS selected as ranking priority #2.</td></tr><tr><td align="center">Shutter Angle</td><td>Closest Shutter Angle selected as ranking priority #3.</td></tr><tr><td align="center">Temperature</td><td>Closest image sensor temperature selected as raking priority #4.</td></tr><tr><td align="center">Date/Time</td><td>Newest calibration selected as ranking priority #5.</td></tr></tbody></table>

To delete a User Calibration, select it and use the "Delete Dark Frame" button. This could be used to remove an older calibration that matches more settings and enable selection of a newer calibration that might be more accurate despite matching fewer settings.&#x20;

### Windows

To generate a new User Calibration, follow the steps below:

1. Turn on the camera and wait 10-15 minutes for it to warm up.
2. With the lens or body cap on to prevent light from hitting the sensor, record a short clip (at least 40 frames, but more than that is not beneficial).
3. Connect the camera via USB and open the clip.
4. Switch to the CALIBRATE tab.
5. Select a location for the calibration data using SELECT CAL FOLDER. (This only needs to be done once and will persist across sessions and updates.)
6. Click MAKE CAL FROM CLIP.

User Calibrations already present in the selected folder will be displayed in the CALIBRATE tab. The most relevant calibration for a given clip is automatically selected according to the criteria listed in the table below, and will be highlighted. If no calibrations are valid for the selected clip, none will be highlighted.

<table><thead><tr><th width="159.5029591129976" align="center">Criteria</th><th>Condition</th></tr></thead><tbody><tr><td align="center">Camera UID</td><td>Must match.</td></tr><tr><td align="center">Width (4K or 2K)</td><td>Must match.</td></tr><tr><td align="center">Height</td><td>Must match or exceed clip Height. (Closest Height selected as ranking priority #1.)</td></tr><tr><td align="center">FPS</td><td>Closest FPS selected as ranking priority #2.</td></tr><tr><td align="center">Shutter Angle</td><td>Closest Shutter Angle selected as ranking priority #3.</td></tr><tr><td align="center">Temperature</td><td>Closest image sensor temperature selected as raking priority #4.</td></tr><tr><td align="center">Date/Time</td><td>Newest calibration selected as ranking priority #5.</td></tr></tbody></table>

To delete a User Calibration, click the Remove button next to it. This could be used to remove an older calibration that matches more settings and enable selection of a newer calibration that might be more accurate despite matching fewer settings. It’s also possible to use a custom folder structure to organize User Calibrations in a way that bypasses the default ranking priority.


---

# 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.freeflysystems.com/products/products/wave-camera/user-calibration.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.
