From dae940c2b284f4d26420500a9041e993eb5745a1 Mon Sep 17 00:00:00 2001 From: Abhineet Gupta Date: Thu, 23 Oct 2025 12:48:51 -0600 Subject: [PATCH 1/3] Add documentation for the use of WHOC and ROSCO as FAST.Farm supercontrollers --- docs/source/user/fast.farm/Introduction.rst | 26 ++++++++++++++++++++ docs/source/user/fast.farm/ModelGuidance.rst | 9 ------- 2 files changed, 26 insertions(+), 9 deletions(-) diff --git a/docs/source/user/fast.farm/Introduction.rst b/docs/source/user/fast.farm/Introduction.rst index ab847446aa..a3bb178a48 100644 --- a/docs/source/user/fast.farm/Introduction.rst +++ b/docs/source/user/fast.farm/Introduction.rst @@ -373,6 +373,32 @@ FAST.Farm and OpenFAST can be read with standard open-source visualization packages such as `ParaView `__ or `VisIt `__. +Turbine controller and super controller +--------------------------------------- + +FAST.Farm does not include modules for individual turbine controllers +or farm-level controller (super controllers) and relies on +separately compiled routines for them. +FAST.Farm defers to the OpenFAST model of individual turbine for 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 `_) +can be used to design and integrate turbine controller in DLL format. + +Farm-level super controller can be designed and implemented using external tools. +`Wind-Hybrid-Open-Controller` (`WHOC `_) tool +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 +a small farm using FAST.Farm. +The `Reference Open Source Controller` (`ROSCO `_) +also has wind farm control capability. +It gives user low-level access to various turbine measurements and offsets, and +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 ------------------------- diff --git a/docs/source/user/fast.farm/ModelGuidance.rst b/docs/source/user/fast.farm/ModelGuidance.rst index 73fde5ad84..ce47a7c22f 100644 --- a/docs/source/user/fast.farm/ModelGuidance.rst +++ b/docs/source/user/fast.farm/ModelGuidance.rst @@ -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 `_) -to implement farm level controller. Commonly Encountered Errors --------------------------- From 3688f32d417d762235e35baa77c7cf36308c540b Mon Sep 17 00:00:00 2001 From: Abhineet Gupta Date: Sun, 1 Mar 2026 00:05:48 -0700 Subject: [PATCH 2/3] Address comments on PR #3043 --- docs/source/user/fast.farm/Introduction.rst | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/source/user/fast.farm/Introduction.rst b/docs/source/user/fast.farm/Introduction.rst index a3bb178a48..7ba018696c 100644 --- a/docs/source/user/fast.farm/Introduction.rst +++ b/docs/source/user/fast.farm/Introduction.rst @@ -376,24 +376,24 @@ or `VisIt `__. Turbine controller and super controller --------------------------------------- -FAST.Farm does not include modules for individual turbine controllers -or farm-level controller (super controllers) and relies on +FAST.Farm does not include its own modules for individual turbine controllers +or farm-level controller (super controllers) but relies on separately compiled routines for them. -FAST.Farm defers to the OpenFAST model of individual turbine for turbine controller. +FAST.Farm defers to the OpenFAST model of individual turbine for the 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 `_) -can be used to design and integrate turbine controller in DLL format. +can be used to design and integrate turbine controller in DLL format, if the user does not already have their own controller. Farm-level super controller can be designed and implemented using external tools. -`Wind-Hybrid-Open-Controller` (`WHOC `_) tool +The `Hycon` (`Hycon `_) tool 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 +Hycon includes examples demonstration the design of a wake steering controller and implementation on a small farm using FAST.Farm. The `Reference Open Source Controller` (`ROSCO `_) also has wind farm control capability. -It gives user low-level access to various turbine measurements and offsets, and +It gives the user low-level access to various turbine measurements and offsets, and enables implementation of user-written, python-based controllers. ROSCO also includes examples demonstrating the implementation of a farm-level controller in FAST.Farm. From 04ee3a2c7b49fe08e35b65e2a544f8d3e5dceeb0 Mon Sep 17 00:00:00 2001 From: Abhineet Gupta Date: Sun, 1 Mar 2026 00:10:48 -0700 Subject: [PATCH 3/3] Modify link from whoc to hycon in FAST.Farm documentation --- docs/source/user/fast.farm/Introduction.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/user/fast.farm/Introduction.rst b/docs/source/user/fast.farm/Introduction.rst index 7ba018696c..cb1797347a 100644 --- a/docs/source/user/fast.farm/Introduction.rst +++ b/docs/source/user/fast.farm/Introduction.rst @@ -386,7 +386,7 @@ Tools like `Reference Open Source Controller` (`ROSCO `_) tool +The `Hycon` (`Hycon `_) tool provides for rapid design of common farm-level controllers such as wake steering control, spatial filtering/consensus and active power control etc. Hycon includes examples demonstration the design of a wake steering controller and implementation on