Skip to content

ufechner7/FLORIDyn.jl

Repository files navigation

FLORIDyn

Dev Build Status codecov Aqua QA

Introduction

A dynamic wind farm simulation software, translated from FLORIDyn_Matlab [1], which was written by Marcus Becker. The code uses the Gaussian wake model derived in [3].

Model features

  • Simulate wind farms dynamically at a low computational cost
  • Estimate the power generated, added turbulence, and wake-induced losses.
  • Apply heterogeneous and time-varying wind speeds and directions
  • Test different modeling approaches

Status

All examples work, most key examples are selectable via a menu:

include("examples/menu.jl")

The other examples can be executed directly using the include statement. Often, more than 30x the performance of the Matlab version can be achieved. Currently, only IterateOPs_basic is implemented.

A Python version of FLORIDyn is available at https://github.com/TUDelft-DataDrivenControl/OFF .

Installation

Install Julia 1.11, if you haven't already. Julia 1.10 is still supported. On Linux, make sure that Python3 and Matplotlib are installed:

sudo apt install python3-matplotlib

Make sure that ControlPlots.jl works as explained here.

Before installing this software it is suggested to create a new project, for example like this:

mkdir test
cd test
julia --project=.

Don't forget to type the dot at the end of the last command.

Then add FLORIDyn from Julia's package manager, by typing:

using Pkg
pkg"add FLORIDyn"

at the Julia prompt. You can run the unit tests with the command:

pkg"test FLORIDyn"

You can install the examples using the following command:

using FLORIDyn
install_examples()

If you now quit Julia with and restart it with

./bin/run_julia

then you can get the example menu by typing:

menu()

You can select any of the examples with the <UP> and <DOWN> keys, and then press <ENTER>.

Installation using GIT

For developers, follow the developer notes.

Documentation

The documentation is available here.

License

This project is licensed under the BSD-3-Clause. The documentation is licensed under the CC-BY-4.0 License. Please see the below Copyright notice in association with the licenses that can be found in the file LICENSE in this folder.

Copyright notice

Technische Universiteit Delft hereby disclaims all copyright interest in the package “FLORIDyn.jl” (dynamic wind farm simulation) written by the Author(s).

Prof.dr. H.G.C. (Henri) Werij, Dean of Aerospace Engineering, Technische Universiteit Delft.

See the copyright notices in the source files, and the list of authors in AUTHORS.md.

Sponsors

This research has been partly funded by Rijksdienst voor Ondernemend (RVO) Nederland under contract HEP24-03681024 through the EuroWindWakes project which is a Horizon Europe Partnership.

References

Citation of the FLORIDyn model:
[1] FLORIDyn - A dynamic and flexible framework for real-time wind farm control, M. Becker, D. Allaerts, J.W. van Wingerden, 2022, DOI 10.1088/1742-6596/2265/3/032103

Used FLORIS model:
[2] Experimental and theoretical study of wind turbine wakes in yawed conditions, M. Bastankhah, F. Porté-Agel, 2020, DOI 10.1017/jfm.2016.595

Gaussian wake model:
[3] Experimental and theoretical study of wind turbine wakes in yawed conditions, M. Bastankhah, F. Porté-Agel, 2016, Journal of Fluid Mechanics 806:506-541. DOI 10.1017/jfm.2016.595

Additional references for smaller subcomponents can be found in the code or in the related publications.

Publications that use FLORIDyn

About

Dynamic wind farm simulation software

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •