openfast
A multi-physics, multi-fidelity tool for simulating the coupled dynamic response of wind turbines and wind farms.
https://github.com/openfast/openfast
Category: Renewable Energy
Sub Category: Wind Energy
Keywords
aeroelasticity wind wind-energy wind-farm wind-power wind-turbine
Keywords from Contributors
ecp exascale-computing wind-turbines cfd amrex amr low-mach exawind les openfast
Last synced: about 4 hours ago
JSON representation
Repository metadata
Main repository for the NREL-supported OpenFAST whole-turbine and FAST.Farm wind farm simulation codes.
- Host: GitHub
- URL: https://github.com/openfast/openfast
- Owner: OpenFAST
- License: apache-2.0
- Created: 2016-08-31T20:07:10.000Z (almost 10 years ago)
- Default Branch: main
- Last Pushed: 2026-06-17T20:40:19.000Z (5 days ago)
- Last Synced: 2026-06-19T15:05:35.277Z (3 days ago)
- Topics: aeroelasticity, wind, wind-energy, wind-farm, wind-power, wind-turbine
- Language: Fortran
- Homepage: http://openfast.readthedocs.io
- Size: 328 MB
- Stars: 921
- Watchers: 62
- Forks: 527
- Open Issues: 549
- Releases: 33
-
Metadata Files:
- Readme: README.rst
- License: LICENSE
README.rst
OpenFAST
========
|actions| |nbsp| |rtfd|
.. |actions| image:: https://github.com/openfast/openfast/actions/workflows/automated-dev-tests.yml/badge.svg?branch=dev
:target: https://github.com/OpenFAST/openfast/actions/workflows/automated-dev-tests.yml?query=workflow%3A%22Development+Pipeline%22
:alt: Build Status
.. |rtfd| image:: https://readthedocs.org/projects/openfast/badge/?version=dev
:target: https://openfast.readthedocs.io/en/dev
:alt: Documentation Status
.. |nbsp| unicode:: 0xA0
:trim:
OpenFAST is a wind turbine simulation tool which builds on FAST v8. FAST.Farm
extends the capability of OpenFAST to simulate multi-turbine wind farms. They were
created with the goal of being community models developed and used by research
laboratories, academia, and industry. They are managed by a dedicated team at the
National Laboratory of the Rockies. Our objective is to ensure that OpenFAST and FAST.Farm
are sustainable software that are well tested and well documented. If you'd like
to contribute, see the `Developer Documentation `_
and any open GitHub issues with the
`Help Wanted `_
tag.
**OpenFAST is under active development**.
Part of the WETO Stack
----------------------
OpenFAST is primarily developed with the support of the U.S. Department of Energy and is part of the `WETO Software Stack `_. For more information and other integrated modeling software, see:
* `Portfolio Overview `_
* `Entry Guide `_
* `OpenFAST Workshop `_
FAST v8 - OpenFAST
------------------
The transition from FAST v8 to OpenFAST represents the effort to better
support an open-source developer community around FAST-based aero-hydro-servo-
elastic engineering models of wind-turbines and wind-plants. OpenFAST is the
next generation of FAST analysis tools. More information is available in the
`transition notes `_.
FAST v8, now OpenFAST, is a physics-based engineering tool for simulating the coupled dynamic
response of wind turbines. OpenFAST joins aerodynamics models, hydrodynamics models
for offshore structures, control and electrical system (servo) dynamics models,
and structural (elastic) dynamics models to enable coupled nonlinear aero-
hydro-servo-elastic simulation in the time domain. The OpenFAST tool enables the
analysis of a range of wind turbine configurations, including two- or
three-blade horizontal-axis rotor, pitch or stall regulation, rigid or
teetering hub, upwind or downwind rotor, and lattice or tubular tower. The wind
turbine can be modeled on land or offshore on fixed-bottom or floating
substructures. OpenFAST is based on advanced engineering models derived from
fundamental laws, but with appropriate simplifications and assumptions, and
supplemented where applicable with computational solutions and test data.
With OpenFAST, you can run large numbers of nonlinear time-domain simulations
in approximately real time to enable standards-based loads analysis for predicting
wind system ultimate and fatigue loads. You can also linearize the underlying
nonlinear model about an operating point to understand the system response
and enable the calculation of natural frequencies, damping, and mode shapes;
the design of controllers, and analysis of aero-elastic instabilities.
The aerodynamic models use wind-inflow data and solve for the rotor-wake
effects and blade-element aerodynamic loads, including dynamic stall. The
hydrodynamics models simulate the regular or irregular incident waves and
currents and solve for the hydrostatic, radiation, diffraction, and viscous
loads on the offshore substructure. The control and electrical system models
simulate the controller logic, sensors, and actuators of the blade-pitch,
generator-torque, nacelle-yaw, and other control devices, as well as the
generator and power-converter components of the electrical drive. The
structural-dynamics models apply the control and electrical system
reactions, apply the aerodynamic and hydrodynamic loads, adds gravitational
loads, and simulate the elasticity of the rotor, drivetrain, and support
structure. Coupling between all models is achieved through a modular
interface and coupler (glue code).
FAST.Farm extends the capabilities of OpenFAST to provide physics-based
engineering simulation of multi-turbine land-based, fixed-bottom offshore,
and floating offshore wind farms. With FAST.Farm, you can simulate each wind
turbine in the farm with an OpenFAST model and capture the relevant
physics for prediction of wind farm power performance and structural loads,
including wind farm-wide ambient wind, super controller, and wake advection,
meandering, and merging. FAST.Farm maintains computational efficiency
through parallelization to enable loads analysis for predicting the ultimate
and fatigue loads of each wind turbine in the farm.
Documentation
-------------
The full documentation is available at http://openfast.readthedocs.io/.
This documentation is stored and maintained alongside the source code.
It is compiled into HTML with Sphinx and is tied to a particular version
of OpenFAST. `Readthedocs `_ hosts the following
versions of the documentation:
* ``latest`` - The latest commit on the ``main`` branch
* ``stable`` - Corresponds to the last tagged release
* ``dev`` - The latest commit on the ``dev`` branch
These can be toggled with the ``v: latest`` button in the lower left corner of
the docs site.
Obtaining OpenFAST and FAST.Farm
--------------------------------
OpenFAST and FAST.Farm are hosted entirely on GitHub so you are in the
`right place `_!
The repository is structured with two branches following the
"git-flow" convention:
* ``main``
* ``dev``
The ``main`` branch is stable, well tested, and represents the most up to
date released versions of OpenFAST and FAST.Farm. The latest commit on ``main``
contains a tag with version info and brief release notes. The tag history can be
obtained with the ``git tag`` command and viewed in more detail on
`GitHub Releases `_. For general
use, the ``main`` branch is highly recommended.
The ``dev`` branch is generally stable and tested, but not static. It contains
new features, bug fixes, and documentation updates that have not been compiled
into a production release. Before proceeding with new development, it is
recommended to explore the ``dev`` branch. This branch is updated regularly
through pull requests, so be sure to ``git fetch`` often and check
`outstanding pull requests `_.
For those not familiar with git and GitHub, there are many resources:
* https://guides.github.com
* https://try.github.io
* https://help.github.com/categories/bootcamp/
* https://desktop.github.com/
* http://nvie.com/posts/a-successful-git-branching-model/
Compilation, Usage, and Development
-----------------------------------
Details for compiling
`compiling `_,
`using `_, and
`developing `_
OpenFAST and FAST.Farm on Unix-based and Windows machines are available at
`readthedocs `_.
Help
----
Please use `GitHub Issues `_ to:
* ask usage questions
* report bugs
* request code enhancements
Users and developers may also be interested in the NLR National Wind
Technology Center (NWTC) `Forum `_,
which is still maintained and has a long history of FAST-related questions
and answers.
Acknowledgments
---------------
OpenFAST and FAST.Farm are maintained and developed by researchers and software
engineers at the `National Laboratory of the Rockies `_
(NLR), with support from the US Department of Energy's Wind Energy Technology
Office. NLR gratefully acknowledges development contributions from the following
organizations:
* Envision Energy USA, Ltd
* Brigham Young University
* The University of Massachusetts
* `Intel® Parallel Computing Center (IPCC) `_
Owner metadata
- Name: OpenFAST
- Login: OpenFAST
- Email:
- Kind: organization
- Description: Organization for OpenFAST-related repositories including whole-turbine and full wind farm simulation tools.
- Website: https://openfast.readthedocs.io
- Location:
- Twitter:
- Company:
- Icon url: https://avatars.githubusercontent.com/u/15838605?v=4
- Repositories: 7
- Last ynced at: 2023-08-21T02:34:18.403Z
- Profile URL: https://github.com/OpenFAST
GitHub Events
Total
- Fork event: 43
- Discussion event: 1
- Create event: 28
- Release event: 11
- Issues event: 337
- Watch event: 120
- Delete event: 19
- Member event: 1
- Issue comment event: 1075
- Push event: 200
- Pull request review comment event: 363
- Pull request review event: 470
- Pull request event: 310
Last Year
- Discussion event: 1
- Create event: 21
- Release event: 10
- Issues event: 322
- Watch event: 114
- Delete event: 12
- Issue comment event: 1006
- Push event: 189
- Pull request review comment event: 357
- Pull request review event: 458
- Pull request event: 290
- Fork event: 41
Committers metadata
Last synced: 11 days ago
Total Commits: 12,170
Total Committers: 107
Avg Commits per committer: 113.738
Development Distribution Score (DDS): 0.746
Commits in past year: 864
Committers in past year: 22
Avg Commits per committer in past year: 39.273
Development Distribution Score (DDS) in past year: 0.663
| Name | Commits | |
|---|---|---|
| Bonnie Jonkman | b****n@n****v | 3097 |
| andrew-platt | a****t@n****v | 2071 |
| Rafael M Mudafort | r****f@g****m | 1141 |
| Qi Wang | q****2@n****v | 1124 |
| Derek Slaughter | d****r@g****m | 961 |
| Emmanuel Branlard | e****d@n****v | 725 |
| Lu Wang | L****g@n****v | 511 |
| Greg Hayman | g****n@n****v | 341 |
| Hannah Ross | h****s@n****v | 210 |
| Mike Sprague | m****e@n****v | 204 |
| John Michalakes | j****s@n****v | 174 |
| Greg Hayman | h****y@g****m | 142 |
| RyanDavies19 | r****9@g****m | 137 |
| cortadocodes | c****s@p****m | 123 |
| Mayank Chetan | m****n@g****m | 106 |
| Greg Hayman | g****n@n****v | 82 |
| Matt Hall | 5****l | 78 |
| Jason Jonkman | j****n@n****v | 75 |
| Ganesh Vijayakumar | g****r@n****v | 73 |
| Marshall Buhl | m****l@n****v | 57 |
| reos-rcrozier | 9****r | 46 |
| Russell9798 | 1****8 | 42 |
| Roger Bergua | r****a@n****v | 40 |
| AbhineetGupta | a****a@n****v | 37 |
| unknown | n****n@n****v | 34 |
| Bortolotti | p****i@g****m | 32 |
| Marco Masciola | m****a@n****v | 29 |
| el | e****o | 27 |
| unknown | n****1@n****v | 24 |
| Shreyas Ananthan | s****s@u****u | 24 |
| and 77 more... | ||
Committer domains:
- nrel.gov: 36
- sandia.gov: 2
- envision-energy.com: 2
- cener.com: 2
- njohnson-19058s.nrel.gov: 1
- umd.edu: 1
- el3.ib0.cm.hpc.nrel.gov: 1
- stc-21808s.nrel.gov: 1
- lbl.gov: 1
- login2.hpc.nrel.gov: 1
- tool.net: 1
- ed3.ib0.cm.hpc.nrel.gov: 1
- kl2.head.cm.kestrel.hpc.nrel.gov: 1
- usp.br: 1
- loaner-26719s.nrel.gov: 1
- virginia.edu: 1
- ibk.baug.ethz.ch: 1
- mesh-engineering.de: 1
- 163.com: 1
- sanida.gov: 1
- dnvgl.com: 1
- innosea.fr: 1
- login3.hpc.nrel.gov: 1
Issue and Pull Request metadata
Last synced: 5 days ago
Total issues: 1,516
Total pull requests: 1,364
Average time to close issues: 3 months
Average time to close pull requests: 25 days
Total issue authors: 595
Total pull request authors: 74
Average comments per issue: 4.28
Average comments per pull request: 1.41
Merged pull request: 1,151
Bot issues: 0
Bot pull requests: 10
Past year issues: 122
Past year pull requests: 132
Past year average time to close issues: 24 days
Past year average time to close pull requests: 4 days
Past year issue authors: 79
Past year pull request authors: 19
Past year average comments per issue: 4.05
Past year average comments per pull request: 0.8
Past year merged pull request: 93
Past year bot issues: 0
Past year bot pull requests: 0
Top Issue Authors
- andrew-platt (54)
- jjonkman (54)
- ebranlard (32)
- ZL6462 (31)
- RBergua (25)
- rafmudaf (24)
- tchatte3 (23)
- sffgd (19)
- shipors (17)
- YangLeiTH (17)
- robytian (15)
- bjonkman (15)
- ietqlw (13)
- Tommi1198 (13)
- May0048 (11)
Top Pull Request Authors
- andrew-platt (438)
- rafmudaf (146)
- bjonkman (135)
- deslaughter (107)
- luwang00 (93)
- ebranlard (86)
- RyanDavies19 (35)
- mayankchetan (27)
- hkross (21)
- RBergua (20)
- gantech (15)
- ghost (13)
- gbarter (11)
- sayerhs (11)
- marchdf (11)
Top Issue Labels
- Type: Bug (383)
- Type: Question (304)
- Type: Enhancement (213)
- Type: Usage question (130)
- FAST.Farm (111)
- Module: AeroDyn (103)
- Module: HydroDyn (88)
- Module: ElastoDyn (67)
- Module: BeamDyn (55)
- Module: ServoDyn (50)
- Type: Documentation (49)
- Type: Build issue (46)
- Type: Testing (42)
- Module: SubDyn (40)
- Sytem: MATLAB/Simulink (37)
- Module: MoorDyn (36)
- Module: InflowWind (35)
- Module: TurbSim (33)
- Type: Compiling Question (30)
- System: CMake (26)
- System: Visual Studio (22)
- Module: OLAF (21)
- System: Unix (19)
- Feature: Linearization (18)
- System: Windows (17)
- Help wanted (14)
- Module: MAP++ (12)
- System: MinGW/CygWin (8)
- C++ API (7)
- Compiler: Intel (6)
Top Pull Request Labels
- Module: AeroDyn (185)
- Type: Bug (174)
- Type: Enhancement (150)
- Module: HydroDyn (119)
- Type: Testing (103)
- Type: Documentation (99)
- Module: MoorDyn (83)
- System: CMake (75)
- FAST.Farm (74)
- Module: InflowWind (62)
- Module: NWTC Lib (60)
- Type: Build issue (57)
- Module: BeamDyn (56)
- C++ API (55)
- System: Visual Studio (52)
- Module: SubDyn (50)
- Module: OpenFAST Lib (50)
- Module: ServoDyn (44)
- Module: SeaState (43)
- Module: ElastoDyn (43)
- Feature: Linearization (36)
- Type: IO Readers/Writers (35)
- Compiler: Intel (31)
- FAST Registry (31)
- Module: MAP++ (30)
- Sytem: MATLAB/Simulink (28)
- Feature: MHK (21)
- Module: TurbSim (19)
- Module: AWAE (19)
- System: Docker (16)
Package metadata
- Total packages: 4
-
Total downloads:
- pypi: 1,183 last-month
- Total dependent packages: 0 (may contain duplicates)
- Total dependent repositories: 0 (may contain duplicates)
- Total versions: 89
- Total maintainers: 1
proxy.golang.org: github.com/openfast/openfast
- Homepage:
- Documentation: https://pkg.go.dev/github.com/openfast/openfast#section-documentation
- Licenses: apache-2.0
- Latest release: v5.0.0+incompatible (published 3 months ago)
- Last Synced: 2026-06-19T15:02:03.416Z (3 days ago)
- Versions: 34
- Dependent Packages: 0
- Dependent Repositories: 0
-
Rankings:
- Dependent repos count: 1.622%
- Average: 4.057%
- Dependent packages count: 6.492%
proxy.golang.org: github.com/OpenFAST/openfast
- Homepage:
- Documentation: https://pkg.go.dev/github.com/OpenFAST/openfast#section-documentation
- Licenses: apache-2.0
- Latest release: v5.0.0+incompatible (published 3 months ago)
- Last Synced: 2026-05-17T23:06:17.448Z (about 1 month ago)
- Versions: 34
- Dependent Packages: 0
- Dependent Repositories: 0
-
Rankings:
- Dependent packages count: 6.999%
- Average: 8.173%
- Dependent repos count: 9.346%
conda-forge.org: openfast
NREL-supported OpenFAST whole-turbine simulation code
- Homepage: https://github.com/openfast/openfast
- Licenses: Apache-2.0
- Latest release: 3.3.0 (published over 3 years ago)
- Last Synced: 2026-04-08T09:55:27.211Z (3 months ago)
- Versions: 9
- Dependent Packages: 0
- Dependent Repositories: 0
-
Rankings:
- Forks count: 7.926%
- Stargazers count: 17.29%
- Average: 27.604%
- Dependent repos count: 34.025%
- Dependent packages count: 51.175%
pypi.org: openfast_io
Readers and writers for OpenFAST files.
- Homepage:
- Documentation: https://openfast_io.readthedocs.io/
- Licenses: Apache Software License
- Latest release: 5.0.0 (published 3 months ago)
- Last Synced: 2026-06-18T10:42:49.594Z (4 days ago)
- Versions: 12
- Dependent Packages: 0
- Dependent Repositories: 0
- Downloads: 1,183 Last month
-
Rankings:
- Dependent packages count: 9.845%
- Average: 32.631%
- Dependent repos count: 55.418%
- Maintainers (1)
Dependencies
- ./.github/actions/tests-module-aerodyn * composite
- ./.github/actions/tests-module-beamdyn * composite
- ./.github/actions/tests-module-hydrodyn * composite
- ./.github/actions/tests-module-inflowwind * composite
- ./.github/actions/tests-module-moordyn * composite
- ./.github/actions/tests-module-nwtclibrary * composite
- ./.github/actions/tests-module-subdyn * composite
- ./.github/actions/tests-module-version * composite
- actions/cache v3.0.4 composite
- actions/checkout main composite
- actions/setup-python v3 composite
- actions/upload-artifact v3 composite
- actions/checkout main composite
- Pygments >=2.2
- Sphinx >=1.8.5
- breathe >=4.4
- docutils ==0.16
- pyparsing >=2.1
- requests *
- sphinx_rtd_theme >=0.3
- sphinxcontrib-bibtex >=2.0.0
- sphinxcontrib-doxylink >=1.3
- sphinxcontrib-mermaid >=0.6
- rafmudaf/openfast-ubuntu v2.3.0 build
- ubuntu bionic build
Score: 19.04250032967864