ROSCO Documentation

Version:

2.8.0

Date:

Aug 08, 2023

Reference OpenSource Controller (ROSCO) is a reference controller framework designed to facilitates turbine controller design and implementation for fixed and floating offshore wind turbines. ROSCO provides a modular reference wind turbine controller that can be easily adapted to a wide variety of different wind turbines and can be used to run representative dynamic simulations using OpenFAST.

The ROSCO framwork and toolset provides the following advantages:

• Easy tuning process: The tuning process for ROSCO controller is extremely simple where only a few tuning parameters need to be provided. The control designer need not run aeroelastic simulations or provide linearized state space models to obtain the controller.

• Standard controller framwork: ROSCO provides a single framework for designing controllers for onshore and offshore turbines of varying sizes. This helps researchers perform ‘apples-to-apples’ comparison of controller capabilities across turbines. ROSCO has been used to provide reference controllers for many recent reference turbines including the IEA 3.4-MW , IEA 10-MW , IEA 15-MW and the upcoming IEA 22-MW turbines. Engineers can design their own controllers and compare them with reference controller design using ROSCO for existing and new turbines.

• MATLAB/SIMULINK implementation: The ROSCO controller framework can be implemented in a MATLAB/SIMULINK environment and can be used along with OpenFAST’s MATLAB/SIMULINK implementation to run dynamic simulations. This capability also help in dynamic prototyping of user defined controllers and quick comparision with reference controllers designed using ROSCO.

• Advanced controller capabilities: Apart from providing a simple baseline turbine controller, ROSCO includes advanced controller capabilities like distributed aerodynamic controls (e.g., via trailing edge flaps), peak-shaving control to reduce maximum rotor thrust etc. A list of the capabilities of the ROSCO controller is provided in XXX.

Technical Reference

A publication highlighting much of the theory behind the controller tuning and implementation methods can be found at: https://wes.copernicus.org/preprints/wes-2021-19/

Documentation Directory

• 1. Standard ROSCO Workflow
  • 1.1. Standard Use
  • 1.2. Tuning Controllers and Generating DISCON.IN
  • 1.3. Running OpenFAST Simulations
  • 1.4. Testing ROSCO
• 2. Installing the ROSCO tools
  • 2.1. Installing the ROSCO controller
  • 2.2. Installing the ROSCO toolbox
  • 2.3. Full ROSCO Installation
  • 2.4. Getting Started
• 3. ROSCO Toolbox Structure
  • 3.1. ROSCO Toolbox File Structure
  • 3.2. The ROSCO Toolbox Tuning File
• 4. ROSCO Controller Structure
  • 4.1. ROSCO File Structure
  • 4.2. The DISCON.IN file
• 5. ROSCO Advanced Capabilities
• 6. API changes between versions
  • 6.1. 2.7.0 to 2.8.0
  • 6.2. 2.6.0 to 2.7.0
  • 6.3. 2.5.0 to 2.6.0
  • 6.4. ROSCO v2.4.1 to ROSCO v2.5.0
• 7. ROSCO_Toolbox tuning .yaml
  • 7.1. path_params
  • 7.2. turbine_params
  • 7.3. controller_params
  • 7.4. linmodel_tuning
• 8. Running Bladed simulations with ROSCO controller
  • 8.1. Bladed versions 4.6 to current (4.12)
  • 8.2. Bladed 4.5 & earlier
• 9. License