# Calibration with measurements

In wind resource assessment and energy yield modelling, accurately representing the wind climate at your project site is critical. Whiffle Wind uses high-resolution Large Eddy Simulation to generate site-specific time series and wind resource grids that capture atmospheric dynamics such as turbulence, wake effects, and terrain-induced flow features. These detailed simulations help reduce uncertainty in wind resource estimates and provide a strong foundation for feasibility studies and energy yield predictions.

Like any numerical model, simulation output can show systematic differences when compared with on-site measurements. Minor biases in mean wind speed can become significant when translated into long-term financial projections.

Calibration is the process of identifying and adjusting these systematic differences to better align simulated data with measured observations. When applied carefully, it improves confidence in model results while preserving the physical consistency of the simulation. This article explains how to set up and run calibration in Whiffle Wind.

### Good to know

Calibration is currently limited to **long-term corrected measurements** and **long-term statistics** in Whiffle Wind.&#x20;

{% hint style="info" %}
You can request a calibrated time series by setting up a simulation in Whiffle Wind and selecting **Run via support** on the Overview step. In the information field, indicate that you would like a calibrated time series. Alternatively, you can contact [**support@whiffle.nl**](mailto:support@whiffle.nl) to discuss options.
{% endhint %}

### Step 1. Uploading Measurements

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

1. Navigate to the **Measurements** tab and click the **“+ New measurement”** button.
2. Your measurements should be a **time series** with 10-minute end-of-interval timestamps, including both **mean wind speed** and **mean wind direction** at each height. The data should meet the following requirements:
   * **Long-term corrected wind speeds**
   * **Timestamps in UTC** following the ISO 8601 format
   * **NaN values** for missing or erroneous data points
3. A **template** can be downloaded directly from the upload form, or you can prepare your data using the example table below:

<table><thead><tr><th valign="top">timestamp</th><th valign="top">wind_speed_50m_mean[m_s]</th><th valign="top">wind_direction_50m_mean[deg]</th><th valign="top">wind_speed_80m_mean[m_s]</th><th valign="top">wind_direction_80_mean[deg]</th></tr></thead><tbody><tr><td valign="top">2015-12-22 00:10:00</td><td valign="top">7.842</td><td valign="top">214.3</td><td valign="top">8.654</td><td valign="top">216.1</td></tr><tr><td valign="top">2015-12-22 00:20:00</td><td valign="top">7.961</td><td valign="top">215.7</td><td valign="top">NaN</td><td valign="top">217.4</td></tr><tr><td valign="top">2015-12-22 00:30:00</td><td valign="top">NaN</td><td valign="top">213.9</td><td valign="top">8.821</td><td valign="top">215.8</td></tr></tbody></table>

**Notes:**

* The **timestamp** column is required.
* Wind speed values should be in **meters per second (m/s)**.
* Wind direction values should be in **degrees (°)**.

### Step 2. Filling in the Location and Heights

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

After uploading your measurements, a form will appear where you can set the **name** and **location** of the measurement.

For each column in your CSV file:

* A corresponding row will be created in the form.
* Select the **type** of measurement: **Mean wind speed** or **Mean wind direction**.
* Enter the **height** for that measurement.

**Requirements:**

* Exactly **one wind speed** and **one wind direction** must be provided at each height.
* Each location can have a **maximum of 6 sensor heights**.
* All measurements used in a simulation must have the same sensor heights.

Finally, mark the measurement as **final**. A finalised measurement can be used in your simulation but **can no longer be edited**, ensuring full **traceability** of your data.

### Step 3. Setting Up a Simulation

<figure><img src="/files/2g6d5yL1oa0KUPIrmx9D" alt=""><figcaption></figcaption></figure>

1. Navigate to the **Simulations** tab and click **“+ New simulation”**. For detailed instructions on setting up a simulation, see our guide [here](https://docs.whiffle.cloud/getting-started/running-a-simulation/statistics).
2. On the **Site** step, open the calibration panel and select your previously uploaded measurements.
3. On the **Period** step, choose between Statistics and Time series. Currently, calibration is only available for Statistics. A calibrated Time series can be requested through support.
4. On the **Output** step, the heights for the calibrated and non-calibrated WRG will be displayed. These heights are based on the heights defined in your measurements.
5. Start the simulation. Once complete, you can download the following for each height
   * A **calibrated WRG** (Wind Resource Grid)
   * A **non-calibrated WRG**

This allows you to compare results and see the impact of calibration on your simulation outputs.

### FAQ

**Does calibration cost extra?**

No. The cost for running a calibration is the same as a standard statistics run in Whiffle Wind.

**Which method is used?**

We apply an **“Adjust-to-Mast”** bias correction that calibrates the modelled wind resource grid to match the measured mast wind climate. For each wind-direction sector, we compute the ratio between the measured and modelled sector mean wind speed (at each mast), then apply a **distance-squared (1/d²) weighted blend** of those ratios to every location on the site. This results in adjusted wind speeds matching the statistics at the mast locations. The method preserves the model’s spatial patterns while removing systematic bias relative to the measurements.

**What if I’m interested in a calibrated time series?**

You can request a calibrated time series by setting up a simulation in Whiffle Wind and selecting **Run via support** on the Overview step. In the information field, indicate that you would like a calibrated time series. Alternatively, you can contact [**support@whiffle.nl**](mailto:support@whiffle.nl) to discuss options.


---

# 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.whiffle.cloud/getting-started/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.
