> For the complete documentation index, see [llms.txt](https://pcnautic.gitbook.io/autopilot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pcnautic.gitbook.io/autopilot/operate/web-interface-apps/tuning.md).

# Tuning

The **Tuning** screen provides real-time insight into the autopilot’s performance and allows you to adjust steering parameters (Gains) directly.

<figure><img src="/files/WLWCMTHSzE49U8fYEqWa" alt=""><figcaption><p><em>Screenshot Tuning-pagina van webinterface</em></p></figcaption></figure>

## **Graphical Display**

In the chart, you will see:

🟧 **Orange Area** – Desired Heading Band\
This represents the acceptable deviation from the set course.\
As long as the boat's heading (red line) stays within this area, the course is considered acceptable.

🔴 **Red Line** – Actual Boat Heading\
This line shows the real-time heading of the vessel, as measured by the compass.

🔵 **Blue Line** – Autopilot Steering Correction\
This indicates how much (and how often) the autopilot is making adjustments to stay on course.

## **Gains (Adjustable Steering Parameters)**

On the left side of the screen, you can adjust key steering settings such as:

### Aggr level

The *Aggr* setting determines how aggressively the autopilot reacts. Use the **–** and **+** buttons to adjust the response level to your preference.

This option is only available when you create a new profile based on the *Default* profile.\
To do this, click the **+** button in the top-right corner to duplicate the *Default* profile. The new profile will be locked by default. Start by adjusting only the *Aggr* level to achieve optimal performance.

You can then unlock the profile to manually fine-tune individual parameters.&#x20;

{% hint style="info" %}
Please note: if you manually adjust just one parameter, the internal balance between settings is lost, and *Aggr* will become unavailable (*N/A*).
{% endhint %}

### Parameters

| Parameter | Meaning                                        |
| --------- | ---------------------------------------------- |
| **P**     | Base response to heading deviation             |
| **PR**    | Response to rudder position                    |
| **I**     | Long-term correction (usually 0 for sailboats) |
| **D**     | Damping to prevent overshooting                |
| **DD**    | Additional damping for faster course changes   |

## **Performance Analysis**

This panel provides real-time feedback on steering performance:

| Value                      | Meaning                                          |
| -------------------------- | ------------------------------------------------ |
| **Actual**                 | Current heading                                  |
| **Target**                 | Desired heading                                  |
| **Command**                | Current steering output                          |
| **Unstable system**        | Instability indication (true/false)              |
| **Rise Time (s)**          | How quickly the course change starts             |
| **Overshoot (%)**          | Amount by which the course overshoots the target |
| **Settling Time (s)**      | Time until the system stabilizes                 |
| **Steady state error (°)** | Constant heading deviation from the target       |

{% hint style="info" %}
Tip: Keep an eye on the behavior of the red and blue lines when adjusting the Gains.\
Aim for stable, smooth corrections that stay within the orange band.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://pcnautic.gitbook.io/autopilot/operate/web-interface-apps/tuning.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.