v1.1.1

What's Changed

• Sg/tilted bem dev by @skygering in #32
• Kl model dev by @skygering in #33

Full Changelog: v1.1.0...v1.1.1

v1.1.0

Release notes

This release adds tilt as an optional set point to the turbines in the windfarm. It accomplishes this through a coordinate transformation in the y-z plane, to take advantage of existing code/theory for the yaw-only case (see UMM package Geometry code for details). The wake and centerline are adjusted to also reflect the z velocity deficit. Tests are added for centerline and wake adjustments.

What's Changed

• Sg/add pr guidelines by @skygering in #27
• Sg/add tilt by @skygering in #28

Full Changelog: v1.0.0...v1.1.0

1.0.0

Release notes

This release contains the wake modeling tools for Heck, Liew, Upfal, and Howland, Joint Yaw-Induction Control Optimization for Wind Farms (2025). Couples with MITRotor, Dualitic, and the Unified Momentum Model for fast-running, gradient-enabled, control-oriented evaluations of flow through wind farms.

Wake models

GaussianWakeModel (default) - an axisymmetric Gaussian wake with wake deflection, following Shapiro, Gayme, and Meneveau, JFM (2018).

VariableKwGaussianWakeModel - a Gaussian wake model with $k_w = a\cdot TI + b$

Rotor models

AD (Default) - Actuator disk modeling with a uniform thrust and induction distribution

BEM - Blade element modeling with the Unified Momentum Model closure

Cosine - Empirical power and thrust losses with increasing yaw angle magnitude

Windfields

Uniform (default) - Uniform inflow with a set ambient turbulence

PowerLaw - A power law profile following a prescribed shear exponent

Superimposed - Base windfield with wakes from the wake model solution superimposed

Superposition methods

Linear - Freestream linear superposition, where all wakes are computed from the freestream wind and summed follwing Lissaman (1979)

Niayifar (Default) - Modified linear superposition, scaled by the rotor-equivalent wind speed following Niayifar and Porté-Agel (2016)

Quadratic - Freestream quadratic (also called sum-of-squares freestream) follwing Katic, Højstrup & Jensen (1987)

Dominant - also called maximum superposition, considers only the strongest wake of all superimposed wakes (c.f. see Gunn, et al. (2016))