Skip to content

Documentation of WHOC and ROSCO for super controller in FAST.Farm #3043

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 1 commit into
base: dev
Choose a base branch
from
Draft

Documentation of WHOC and ROSCO for super controller in FAST.Farm #3043

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 26 additions & 0 deletions docs/source/user/fast.farm/Introduction.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -373,6 +373,32 @@ FAST.Farm and OpenFAST can be read with standard open-source
visualization packages such as `ParaView <http://www.paraview.org/>`__
or `VisIt <https://wci.llnl.gov/simulation/computer-codes/visit/>`__.

Turbine controller and super controller
---------------------------------------

FAST.Farm does not include modules for individual turbine controllers
Copy link
Collaborator

@jjonkman jjonkman Oct 23, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add "its own" before "modules".

or farm-level controller (super controllers) and relies on
Copy link
Collaborator

@jjonkman jjonkman Oct 23, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Change "and" to ", but".

separately compiled routines for them.
FAST.Farm defers to the OpenFAST model of individual turbine for turbine controller.
Copy link
Collaborator

@jjonkman jjonkman Oct 23, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add "the" before "turbine controller".

The controller is specified in the ServoDyn module of OpenFAST.
OpenFAST allows for the use of bladed-style controllers in DLL format.
Tools like `Reference Open Source Controller` (`ROSCO <https://github.com/NREL/ROSCO>`_)
can be used to design and integrate turbine controller in DLL format.
Copy link
Collaborator

@jjonkman jjonkman Oct 23, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add ", if the user does not already have their own controller" before the period.


Farm-level super controller can be designed and implemented using external tools.
`Wind-Hybrid-Open-Controller` (`WHOC <https://github.com/NREL/wind-hybrid-open-controller>`_) tool
Copy link
Collaborator

@jjonkman jjonkman Oct 23, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add "The" before "Wind".

provides for rapid design of common farm-level controllers such as wake steering
control, spatial filtering/consensus and active power control etc.
WHOC includes examples the design of a wake steering controller and implementation on
Copy link
Collaborator

@jjonkman jjonkman Oct 23, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add "demonstrating" before "the".

a small farm using FAST.Farm.
Copy link
Collaborator

@jjonkman jjonkman Oct 23, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Presumably, WHOC interacts with ROSCO for individual turbine control?

The `Reference Open Source Controller` (`ROSCO <https://github.com/NREL/ROSCO>`_)
also has wind farm control capability.
It gives user low-level access to various turbine measurements and offsets, and
Copy link
Collaborator

@jjonkman jjonkman Oct 23, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add "the" before "user".

enables implementation of user-written, python-based controllers.
ROSCO also includes examples demonstrating the implementation of a farm-level
controller in FAST.Farm.


FAST.Farm Parallelization
-------------------------

Expand Down
9 changes: 0 additions & 9 deletions docs/source/user/fast.farm/ModelGuidance.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -931,15 +931,6 @@ simulations for the NREL 5MW turbine
( :cite:`ff-Doubrawa18_1`), but these can be overwritten by the
user.

.. _FF:sec:SupCon:

Farm Level Control
------------------

FAST.Farm does not include a module for farm level control.
Users are advised to utilize the wind farm control capability of
the `Reference Open Source Controller` (`ROSCO <https://github.com/NREL/ROSCO>`_)
to implement farm level controller.

Commonly Encountered Errors
---------------------------
Expand Down