Whiffle Wind Docs
  • Introduction
  • FAQ
  • Under the hood
  • Support
  • getting started
    • Adding a custom turbine
      • Best practices for turbine specs
    • Setting up a simulation
      • Time Series
      • Statistics
    • Cancelling a simulation
    • API client
  • outputs
    • Time series
    • Statistics
  • use cases
    • How to calculate aerodynamic losses?
    • How to extend LES domain?
  • advanced topics
    • The Whiffle LES model
    • Meso-simulation
    • Long-term representativeness
  • troubleshooting
    • Missing ERA5 data
    • Maximum domain size
  • Release notes
    • 2025
    • 2024
    • 2023
    • Whiffle LES model
Powered by GitBook
On this page
  • Whiffle API Client example notebooks
  • Installing Whiffle API Client via pip
  1. getting started

API client

PreviousCancelling a simulationNextTime series

Last updated 9 months ago

Whiffle Wind can also be used programmatically with Python thanks to the whiffle-client package. Simulations launched with the whiffle-client will also be available in the Whiffle Wind web application.

We recommend starting with the Whiffle API Client example notebooks. Afterwards you can also install the Whiffle API Client into your own projects via pip install whiffle-client.

Whiffle API Client example notebooks

Thanks to the notebooks in this repository you will learn how to:

  • πŸš€ Set-up a Whiffle Wind simulation with yaml files, launch it and retrieve the results using the whiffle-client python API.

  • πŸ“Š Evaluate aerodynamic losses of the Borselle offshore wind cluster after running two Whiffle Wind simulations. One with turbines with thrust (interacting with the atmosphere) and the other with thrust less turbines (not interacting with the atmosphere).

  • βœ… Validate Cabauw onshore met-mast data against a Whiffle Wind simulation containing a metmast.

  • πŸ—ΊοΈ Visualize and explore wind fields over the whole simulation domain.

Installing Whiffle API Client via pip

This repository contains instructions and notebooks to quickly get started with the whiffle-client. You will learn how to setup and launch two simulation to model the offshore Borssele cluster and the onshore Cabauw met mast.

More information on how to install and use the Whiffle Client can be found on .

whiffle-client-example
Pypi