v3.5.3

Overview of v3.5.3

This release includes a long awaited set of bug fixes for linearization with BeamDyn. Anyone needing to linearize with BeamDyn should not use any version of OpenFAST prior to this release.

Other notable improvements include corrections to turbine indexing when coupled to external codes such as AMR-Wind, new linearization regression tests, and new docker images.

🎉 First time contributors: @cortadocodes at @octue, @mayankchetan, @reilandsberger, and @jrood-nrel.

Bugfixes

There are numerous bug fixes in several modules. See below for details.

Input File changes

No input file formats change.

Changelog

General

Build systems

#2116 VSbuild: always build Registry as release x64 (@andrew-platt)
#2120 #2125 CMake: openmp optional for FF and CPP if not explicitly requested (@andrew-platt and @deslaughter)
#2128 VSbuild: set VS version to VS 2017 (@andrew-platt)
#2138 Remove linking of implicit Fortran libraries. (@jrood-nrel, first time contributor 🎉)

Docker builds

#2124 Update dockerfile and facilitate nrel/openfast Docker Hub registry, with documentation (@cortadocodes, first time contributor 🎉)
#2139 Add final dockerfile updates (@cortadocodes)
#2141 GH actions to push docker image to Github container registry (@mayankchetan, first time contributor 🎉)

GH actions

#2041 Upgrade to setup-python@v4 and cache@v4 for GH actions (@andrew-platt)
#2129 Fix cache failure in Github Actions caused by setup-python (@deslaughter)

Documentation

#2130 Fix cache failure in Github Actions caused by setup-python (@andrew-platt)
#2144 Edit to readthedocs.io -- Adding Internal Reference Hyperlink for appendixD.rst (@reilandsberger, first time contributor 🎉)
#2145 Docs/update for 3.5.3 release (@andrew-platt)

Solvers

OpenFAST

#2060 Fix BD + AD linearization indexing (negative damping results) (@deslaugher and @andrew-platt)

Module changes

Multiple

#2118 Fix use of uninitialized variables in FAST.Farm and increase stack size in Visual Studio (@deslaughter and @andrew-platt)

BeamDyn

#2063 Fix bug in BD linearization resulting from reference rotation change (@deslaughter)
#2085 Bug: BeamDyn Initial Strain and Linearization (@deslaughter)

MoorDyn

#2049 Backport of bathymetry bugfixes in #2013 and #2016 (@RyanDavies19)

OpenFAST library

#2097 Consistent use of turbine indexing when coupled to c/c++ (@andrew-platt and @deslaughter)

ServoDyn

#2079 Handling of Paths for SrvD UserSubs Input Files (@rdamiani)
#2134 Bugfix seg fault if blade StC used while writing summary file (@andrew-platt)

TurbSim

#2102 TurbSim: increase filename to 1024 characters (@andrew-platt)

Regression tests

#2038 Add linearization regression tests (@andrew-platt)
#2055 Lin tests: increase out precision, error printing full filename, add SD linearization test (@andrew-platt)

Input file changes

No input files change with this release, as this only includes minor bugfixes.

Full list of changes: https://openfast.readthedocs.io/en/main/source/user/api_change.html

Full input file sets: https://github.com/OpenFAST/r-test/tree/v3.5.3 (example input files from the regression testing)

Precompiled Windows Binaries

The binary files in this release were built with the Visual Studio solution files distributed with OpenFAST (not using cmake), using

• Intel Fortran compiler 2021 (Update 2, w_oneAPI_2021.2.0.243) with Microsoft Visual Studio Community 2019
• Microsoft Visual C++ 2019 (C), for build in Matlab
• MATLAB Version: 9.9.0.1857802 (R2020b) Update 7
• Executables with _OpenMP or _OMP in the name are built with OpenMP libraries and linked with dynamic libraries.
  • You will need this Intel Fortran redistributable package installed to use these executables if you do not already have Intel Fortran OneAPI 2021 installed. See the installation instructions here.
  • You may also need a redistributable library for Visual Studio installed. See instructions here.

The other OpenFAST executables DO NOT require these redistributable libraries to be installed. Instead, they were built with static libraries.

v3.5.2

Overview of v3.5.2

This release contains only bugfixes. No input files are changed from release https://github.com/OpenFAST/openfast/releases/tag/v3.5.0

Bugfixes

There are numerous bug fixes in several modules. See below for details.

Input File changes

No input file formats change.

Changelog

General

Build systems

#1948 Pass Python_EXECUTABLE to pfunit, add error check on Python version (@andrew-platt)

Module changes

AeroDyn

#1913 ADI: memory leak in ADI_UpdateStates (@andrew-platt)

AWAE

#1963 FAST.Farm, Mod_AmbWind=3: add error if HR grid not centered on turbine in Y dimension (@andrew-platt)

HydroDyn

#1872 Fix segfault in HD when no outputs specified (@deslaughter)

Regression tests

#1886 Update floating MHK case input files (@hkross)

Input file changes

No input files change with this release, as this only includes minor bugfixes.

Full list of changes: https://openfast.readthedocs.io/en/main/source/user/api_change.html

Full input file sets: https://github.com/OpenFAST/r-test/tree/v3.5.2 (example input files from the regression testing)

Precompiled Windows Binaries

The binary files in this release were built with the Visual Studio solution files distributed with OpenFAST (not using cmake), using

• Intel Fortran compiler 2021 (Update 2, w_oneAPI_2021.2.0.243) with Microsoft Visual Studio Community 2019
• Microsoft Visual C++ 2019 (C), for build in Matlab
• MATLAB Version: 9.9.0.1857802 (R2020b) Update 7
• Executables with _OpenMP or _OMP in the name are built with OpenMP libraries and linked with dynamic libraries.
  • You will need this Intel Fortran redistributable package installed to use these executables if you do not already have Intel Fortran OneAPI 2021 installed. See the installation instructions here.
  • You may also need a redistributable library for Visual Studio installed. See instructions here.

The other OpenFAST executables DO NOT require these redistributable libraries to be installed. Instead, they were built with static libraries.

v3.5.1

Overview of v3.5.1

This release primarily contains bugfixes, and a very small handful of new minor features. No input files are changed from release https://github.com/OpenFAST/openfast/releases/tag/v3.5.0

New features

Visualization of HydroDyn Morison meshes and MoorDyn mooring lines and rods is now possible in both line and surface rendering.

Bugfixes

There are numerous bug fixes in several modules. See below for details.

Input File changes

No input file formats change.

Changelog

General

Build systems

#1586 CMake: Remove openfast_cpp target if BUILD_OPENFAST_CPP_API not selected (@andrew-platt)
#1647 Fix adding OpenMP flags to CMAKE_Fortran_FLAGS (@deslaughter)
#1818 VS-build updates for rc-3.5.1 and other minor updates. Includes truing up some Types files. (@andrew-platt, @bjonkman)

Documentation

#1788 Readthedocs configuration changes (@andrew-platt)

Solvers

FAST.Farm

#1648 Fix bug with Mod_AmbWind=3 -- hub point wasn't shifted. (@andrew-platt)

Module changes

AeroDyn

#1657 AD Driver: stack size for 64 bit solutions (see #1260) (@ebranlard)
#1658 AD/TailFin: Bug Fix: remove chord in fy (see #1653) (@ebranlard)
#1659 AD: Adding rtest for TailFin polar-based model (@ebranlard)
#1679 AD: nodal outputs in different coordinate systems (new feature) (@ebranlard)
#1700 Remove deleted variables BlFB and BlMB from AeroDyn_AllBldNdOuts_IO (@hkross)

BeamDyn

#1771 Change BD states to follow the blade root reference frame. Small performance improvements around azimuth=180. (@deslaughter)
#1796 Resolve BeamDyn initial strain for rotated blade. Backport of #1663 (@deslaughter)

ElastoDyn

#1654 fix segfault when BldNd_BladesOut==0 (Also for AeroDyn) (@andrew-platt)

HydroDyn

#1621 [BugFix] HD wave visualization with 2nd order waves (@andrew-platt)
#1780 [BugFix] AddF0 for multiple potential-flow bodies with NBodyMod/=0 (backport of #1776) (@luwang00)
#1768 new feature: Visualization of HydroDyn Morison mesh (also MoorDyn lines) (@andrew-platt)
#1806 fixed some existing bugs with the strip-theory loads and updated the radiation convolution integral to 2nd order (@luwang00)

InflowWind

#1620 [BugFix] ServoDyn inputs for Lidar allocated twice, and a few other minor issues (@andrew-platt)
#1655 [BugFix] InflowWind was not setting InitOut MWS data. (@andrew-platt)
#1748 [BugFix] compute vel avg profile when exceed allowed (@ebranlard)
#1759 [BugFix] InflowWind Flow Field fails to calculate AvgVel for large wind files when using Intel Compiler (@deslaughter)
#1769 [BugFix] Add additional modulo in IfW_FlowField to correct error with exhausted field from Grid3D on long simulations (see #1746 and PR #1730) (@deslaughter)

MAP++

#1752 MAP++ linear spring approach improvement (@RBergua)

MoorDyn

#1768 MoorDyn line visualization (see HydroDyn above) (@andrew-platt)
#1727 MoorDyn updates and bug fixes (naming, catenary solve improvement, output channels, bugs with added mass, rods, and comment typos (@RyanDavies19)
#1815 MoorDyn dynamic relaxation and fixed bodies (@RyanDavies19)
#1816 Fixed drag coefficient scaling (@RyanDavies19)

NWTC-Library

#1731 Blade Pitch input to ElastoDyn drifts during solution if ServoDyn is not active (improvements to Extrap/Interp routines) (@deslaughter)

SubDyn

#1802 Increase SubDyn output to allow NMOutputs up to 99. Backport of features from dev (multiple commits) (@luwang00, @bjonkman)

Regression tests

#1581, #1593 Update floating MHK case input files (@hkross)
#1694 Improved linearization file comparison (@ebranlard)
#1695 AD: adding linearization tests for aerodyn continuous-states model (@ebranlard)
#1801 Add Mod_AmbWind=3 regression test to the CI (@MYMahfouz)

Input file changes

No input files change with this release, as this only includes minor bugfixes.

Full list of changes: https://openfast.readthedocs.io/en/main/source/user/api_change.html

Full input file sets: https://github.com/OpenFAST/r-test/tree/v3.5.1 (example input files from the regression testing)

Precompiled Binaries

The binary files in this release were built with the Visual Studio solution files distributed with OpenFAST (not using cmake), using

• Intel Fortran compiler 2021 (Update 2, w_oneAPI_2021.2.0.243) with Microsoft Visual Studio Community 2019
• Microsoft Visual C++ 2019 (C), for build in Matlab
• MATLAB Version: 9.9.0.1857802 (R2020b) Update 7
• Executables with _OpenMP or _OMP in the name are built with OpenMP libraries and linked with dynamic libraries.
  • You will need this Intel Fortran redistributable package installed to use these executables if you do not already have Intel Fortran OneAPI 2021 installed. See the installation instructions here.
  • You may also need a redistributable library for Visual Studio installed. See instructions here.

The other OpenFAST executables DO NOT require these redistributable libraries to be installed. Instead, they were built with static libraries.

v3.5.0

Overview of v3.5.0

This release includes several new features, bugfixes, and improvements.

New Features

New features include Lidar simulation within the InflowWind module, the ability to simulate a marine hydro-kinetic turbine (MHK) on a floating platform with an downward pointing tower, VTK based visualization with the BeamDyn driver, and a non-uniform point distribution in the OpenFOAM module for improved coupling fidelity to CFD with actuator lines.

Bugfixes

There were several bugfixes in SubDyn, AeroDyn, and HydroDyn. See below for details.

Improvements

AeroDyn received a minor update to the BEM solver to better model cone and prebend.

The QuKi (quad kind, 128 bit reals) was removed from OpenFAST allowing for building with on architectures that don't support 128 bit reals, and compilers that could not use it.

The build system was completely overhauled to improve general usability. This includes support for the Flang compiler in addition to the GCC and Intel compilers, the ability to install LAPACK and BLAS from source with CMake (USE_LOCAL_STATIC_LAPACK option), improved support for Ninja on all platforms, the option to directly build FAST_SFunc from CMake for linking OpenFAST with Simulink, and some minor cleanup for better readability.

Input file changes

The InflowWind input file has a new section for the Lidar simulator. There are also some minor changes to the C++ interface. See the end of the Changelog below for a summary, or see https://openfast.readthedocs.io/en/main/source/user/api_change.html. For sample input files, take a look at the regression tests at https://github.com/OpenFAST/r-test/tree/v3.5.0 in the r-test submodule for OpenFAST.

Changelog

General

Build systems

#1010 Use Cmake OBJECT libraries to create openfastlib and add option to use downloaded reference lapack and blas sources (USE_LOCAL_STATIC_LAPACK option in CMake) @reos-rcozier
#1427 Improve CMake's FindMKL to avoid rutime issues and preloading libraries @gbarter
#1506 Fix compilation issue, using Intel OneAPI on Linux (missing -fPIC flag) @pablo-benito
#1530 Add missing objects from #1010
#1535 [BugFix] CMake build on Windows and Ninja build on all platforms
#1538, #1542 Add support for Flang (Classic) compiler
#1555, #1566 Modernize CMake, remove object libraries, build Simulink MEX
#1561 [BugFix] typo in souce file list for Visual Studio build of AeroDyn driver @bjonkman

Documentation

#1419 update manual regression testing syntax for Windows
#1559 [BugFix] Limit urllib3 version so that readthedocs builds

Solvers

OpenFAST

#1453, #1560 Remove QuKi (quad-precision) from OpenFAST

FAST.Farm

#1504 Increase number of VTK output planes from 9 to 99

TurbSim

#1550 [BugFix] fix index into Z array for text grid files @bjonkman

Module changes

AeroDyn

#1477 Allow tower, hub, nacelle, and rotor below platform for MHK turbines
#1509 Improved coning and prebend modeling in future BEM
#1541 AeroDyn_Inflow minor updates
#1567 fix some divide by zero issues

BeamDyn

#1474 BeamDyn driver visualization, and driver bugfix
#1482 Fix convergence issue at initialization

ElastoDyn

#1477 Allow tower, hub, nacelle, and rotor below platform for MHK turbines.

HydroDyn

#1480 [BugFix] NBody>1 && NBodyMod==1 bug in WAMIT2

InflowWind

#1464 Add LIDAR simulation within InflowWind with control channels passed to controller @Russell9798
#1534 [BugFix] potential error when requesting wind below the ground (also fix build issue with SD syntax) @bjonkman
#1516, #1543, #1549 InflowWind restructure

OpenFOAM

#1493 Allow Non-Uniform Force Point Distribution on Blades @mchurchf

SubDyn

#1413 Implementing directional cosine matrices and section properties for rectangular members
#1526 Remove static improvement method (SIM) from the SubDyn elastic output mesh (y3mesh)
#1531 BugFix - diameter not set properly for rectangular beams

API changes

#1493 C++ interface for OpenFOAM module includes NodeClusterType_c argument

Input file changes

#1464 New section in InflowWind input file for LIDAR inputs

Full list of changes: https://openfast.readthedocs.io/en/main/source/user/api_change.html

Full input file sets: https://github.com/OpenFAST/r-test/tree/v3.5.0 (example input files from the regression testing)

Precompiled Binaries

The binary files in this release were built with the Visual Studio solution files distributed with OpenFAST (not using cmake), using

• Intel Fortran compiler 2021 (Update 2, w_oneAPI_2021.2.0.243) with Microsoft Visual Studio Community 2019
• Microsoft Visual C++ 2019 (C), for build in Matlab
• MATLAB Version: 9.9.0.1857802 (R2020b) Update 7
• FAST.Farm_x64_OMP.exe is built with OpenMP libraries and linked with dynamic libraries.
  • You will need this Intel Fortran redistributable package installed to run FAST.Farm_x64_OMP.exe if you do not already have Intel Fortran OneAPI 2021 installed. See the installation instructions here.
  • You may also need a redistributable library for Visual Studio installed. See instructions here.

The other OpenFAST executables DO NOT require these redistributable libraries to be installed. Instead, they were built with static libraries.

v3.4.1

Release Notes

OpenFAST 3.4.1 is a minor release to revert a channel name change in AeroDyn 15. This also contains minor fixes for documentation builds.

Documentation

#1442 `[BugFix] Doxygen builds failing on rtd, and locally. Documentation builds on readthedocs and local were failing due to a change in the backend of sphinx. This fixes local builds, but does not fix readthedocs builds. As a temporary workaround, doxygen is disabled on readthedocs.

AeroDyn15

#1428 AD15: revert to Aero names for output channels (Fld is now an alias). This fixes an issue introduced in v3.4.0 (#957)

Precompiled Binaries

The binary files in this release were built with the Visual Studio solution files distributed with OpenFAST (not using cmake), using

• Intel Fortran compiler 2021 (Update 2, w_oneAPI_2021.2.0.243) with Microsoft Visual Studio Community 2019
• Microsoft Visual C++ 2019 (C), for build in Matlab
• MATLAB Version: 9.9.0.1857802 (R2020b) Update 7
• FAST.Farm_x64_OMP.exe is built with OpenMP libraries and linked with dynamic libraries.
  • You will need this Intel Fortran redistributable package installed to run FAST.Farm_x64_OMP.exe if you do not already have Intel Fortran OneAPI 2021 installed. See the installation instructions here.
  • You may also need a redistributable library for Visual Studio installed. See instructions here.

The other OpenFAST executables DO NOT require these redistributable libraries to be installed. Instead, they were built with static libraries.

OpenFAST v3.4.0

Release Notes

OpenFAST v3.4.0 includes several major new features and bug fixes. New features include a new curled-wake model in FAST.Farm (#931), buoyancy calculations in AeroDyn 15 for MHK turbines (#957), rotor and tail furling (#1277), and new library interfaces for AeroDyn 15 and MoorDyn to couple with other codes (#1110 & #848). One major bug fix is changing the CFD coupling to use only the AeroDyn 15 mesh information -- this had led to some discrepancies in CFD results (#1324).

The full set of changes included in this version are further documented in the following listed pull requests.

General

#889 Add a super-controller library target to CMake
#1303 Small reorganization and clean up FAST.Farm r-test input files, upload of artifact
#1311 NWTC_IO: nullifying DLL (on restart) if not present when packing
#1318 Allow Registry to generate extrap/interp routines for types without module nickname
#1327 add version info to c-binding libraries
#1332 Documentation fixes
#1357 CI: exclude bokeh 3.0.[0-3] -- broken plots
#1376 Add regression_tests to the ALL target.

Documentation

#1267 OLAF: documentation: updated guidelines and using nFWPanels instead of WakeLength
#1406 Update example InflowWind and FAST.Farm input files

Visualization

#1319 Cleanup OpenFAST VTK output for HydroDyn
#1321 Add safety checks to VTK output
#1330 VTKLin: being more forgiving with number of modes
#1333 NWTC_Lib: Adding Yaml and VTK to library (moved from SD and AD)

FAST.Farm

#931 Implementation of the curled-wake model in FAST.Farm
#1263 FAST.Farm WriteOutput: fix for Windows Intel OMP build
#1304 API changes for future curl wake implementation, WD restructuring (Cq, OMP, skew filt)
#1305 FF: Cartesian grid for AWAE and WD outputs
#1310 FF: additional OpenMP parallelizations in FAST.Farm
#1328 FF: update of guidelines for Curled wake dr and DT_low

OpenFAST

#1275 Linear Trim Solution Improvements (Linearization)

AeroDyn

#957 Calculate buoyancy for an MHK turbine
#1110 New AeroDynInflow module with c-bindings interface
#1276 Bug Fix: OLAF: particles are NaN when vortex segments have zero length
#1277 Reactivating rotor furling and tailfin aerodynamics (ElastoDyn also)
#1283 Add new projection method and BEM methods
#1293 Minor error handling and code cleanup (OLAF)
#1317 Fix for Visual Studio builds with ADI
#1347 AeroDyn/UnsteadyAero_Driver: Fix for bug #1346
#1355 OLAF: Adding free near wake panels
#1356 AeroDyn/UnsteadyAero_Driver: Fix for bug #1346
#1369 UA: adding UA_Driver outputs, fix separation function for UAMod=6, and adding r-tests

BeamDyn

#1335 BeamDyn: output summary file in yaml format

InflowWind

#1240 Improvements to the InflowWind disk averaged velocity calculations
#1266 Temporarily removing InflowWind parallelization

MoorDyn

#848 MoorDyn v2 C-bindings interface
#1371 MoorDyn bending bugfix and message updates for v2

OpenFOAM

#1324 CFD coupling to use AD15 mesh only
#1365 OpFM: [bugfix] test for warning condition was broken
#1372 [BugFix] the DEBUG_OPENFOAM preprocessor directive was never updated for multiple AD15 rotors

TurbSim

#1361 TurbSim: User-defined time series updates

Precompiled Binaries

The binary files in this release were built with the Visual Studio solution files distributed with OpenFAST (not using cmake), using

• Intel Fortran compiler 2021 (Update 2, w_oneAPI_2021.2.0.243) with Microsoft Visual Studio Community 2019
• Microsoft Visual C++ 2019 (C), for build in Matlab
• MATLAB Version: 9.9.0.1857802 (R2020b) Update 7
• FAST.Farm_x64_OMP.exe is built with OpenMP libraries and linked with dynamic libraries.
  • You will need this Intel Fortran redistributable package installed to run FAST.Farm_x64_OMP.exe if you do not already have Intel Fortran OneAPI 2021 installed. See the installation instructions here.
  • You may also need a redistributable library for Visual Studio installed. See instructions here.

The other OpenFAST executables DO NOT require these redistributable libraries to be installed. Instead, they were built with static libraries.

OpenFAST v3.3.0

Release Notes

General

#1183 Fix bugs and issues in the online documentation
#1248 OpenFAST Registry: allow pointers

AeroDyn

#1000 Updates of Unsteady Aero (UAMod=4) and DBEMT (DBEMT_Mod=3) for linearization
#1037 Bug fix: BEMT was disabled for negative inflow
#1042 AD: merge more of TwrInfl and TwrInflArray routines
#1061 Fix AeroDyn WriteOutput linearization (and cleanup some code)
#1078 Enable cavitation calculation and outputs using FVW
#1188 AD15 driver: add visualization option for line meshes in addition to surfaces
#1239 AeroAcoustics: fix BL-thickness for heavily-tripped airfoil

HydroDyn

#999 Fix HD added mass on member end (Close #992)
#1230 HD: increase max length of line read from kinematics files

MoorDyn

#1086 MoorDyn v2 + shared moorings + wave propagation in FAST.Farm

MAP++

#1186 MAP: allow keyword fixed and fix

NWTC Library

#1254 NWTC Library and WriteOutput updates

Build System

#1198 Option to disable variable tracking with GNU compiler
#1228 r-test: Remove -m64 in CMAKE_Fortran_FLAG from r-test

Testing System

#1203 Add parallel branches to GitHub Actions
#1217 Consolidate regression test baseline set
#1222 Improvements to regression test python scripts
#1244 Reg-test scripts modification to help avoid race condition and cleanup of caselist
#1264 GitHub Workflow: adding build-all-debug-single to check type errors

C++ API

#1176 Simulink: add documentation of inputs to FAST_Library.h
#1211 Use dt_out when storing OpenFAST outputs in Python interface
#1227 Seg Fault due to hub model and external inflow

Linearization

#1199 Small improvements for -VTKLin visualization outputs

Precompiled Binaries

The binary files in this release were built with the Visual Studio solution files distributed with OpenFAST (not using cmake), using

• Intel Parallel Studio XE 2019 for Fortran (Update 5) with Microsoft Visual Studio 2017
• Microsoft Visual C++ 2015 (C) (v1.40), for build without Simulink interface
• Microsoft Visual C++ 2017 (C) (v1.41), for build in Matlab
• MATLAB Version: 9.11.0.1837725 (R2021b) Update 2
• FAST.Farm_x64_OMP.exe is built with OpenMP libraries and linked with dynamic libraries.
  • You will need this Intel Fortran redistributable package installed to run FAST.Farm_x64_OMP.exe if you do not already have Intel Fortran 2019 Update 5 installed. See the installation instructions here.
  • You may also need a redistributable library for Visual Studio installed. See instructions here.

The other OpenFAST executables DO NOT require these redistributable libraries to be installed. Instead, they were built with static libraries.

OpenFAST v3.2.1

Release Notes

This release contains the following bug fixes:

#1201 Include stdexcept in FastLibAPI driver
#1180 Add conditional compile for C++ / C definitions in OpenFAST Library
Revert #1169 Update git-module urls

Precompiled binaries

The binary files in this release were built with the Visual Studio solution files distributed with OpenFAST (not using cmake), using

• Intel Parallel Studio XE 2019 for Fortran (Update 5) with Microsoft Visual Studio 2017
• Microsoft Visual C++ 2015 (C) (v1.40), for build without Simulink interface
• Microsoft Visual C++ 2017 (C) (v1.41), for build in Matlab
• MATLAB Version: 9.11.0.1837725 (R2021b) Update 2

NOTES:

• FAST.Farm_x64_OMP.exe is built with OpenMP libraries and linked with dynamic libraries.
  • You will need this Intel Fortran redistributable package installed to run FAST.Farm_x64_OMP.exe if you do not already have Intel Fortran 2019 Update 5 installed. See the installation instructions here: https://software.intel.com/content/www/us/en/develop/articles/redistributable-libraries-for-intel-c-and-fortran-2019-compilers-for-windows.html.
  • You may also need a redistributable library for Visual Studio installed. See instructions here: https://support.microsoft.com/en-us/topic/the-latest-supported-visual-c-downloads-2647da03-1eea-4433-9aff-95f26a218cc0
• The other OpenFAST executables DO NOT require these redistributable libraries to be installed. Instead, they were built with static libraries.

OpenFAST v3.2.0

Release Notes

General

#866 Include legacy documentation in pdf and MS Word format - Modules
#1021 Reg_tests python scripts: fix issue where directory returned is empty
#1062 Add documentation for community contribution
#1169 Update git-module urls
#1158 Update orientation differences in linear trim solution
#1177 Add documentation on 3D rotations in linearization
#1178 Corrections for 3.2.0 release

AeroDyn

#932 BugFix: UA update states that were not updated
#1032 AD: added more nodal outputs for debugging UA
#1039 [BugFix] Nacelle motion not passed between AeroDyn driver and AeroDyn
#1043 AeroDyn: combine some FVW and BEMT output calculations
#1045 OLAF: check for division by zero to avoid invalid calculations
#1141 Move AD module reg tests to a standalone job

BeamDyn

#1050 Fix aeroelastic stability analysis with BeamDyn

FAST.Farm

#1107 Fix Time-Step Delay in Super Controller within FAST.Farm

HydroDyn

#806 C-bindings interface for HydroDyn
#1047 Fix HydroDyn Jacobian outputs when LinOutJac is True
#1108 BugFix: Checks to populate matrix input to Newman's app were reversed
#1173 Bug Fix: rotation matrix perturbation with small angles was wrong

InflowWind

#1144 BugFix: Fix typo in DLLEXPORT attributes for IfW C interface

MAP++

#1048 MAP: small fix based on MAP 1.3
#1168 Fix MAP linearization operating point

NWTC Library

#1050 Fix aeroelastic stability analysis with BeamDyn -- changes to the library routines for angle perturbations during linearization
#1124 Updates to VersionInfo module and its dependencies
#1157 Fix for binary file compression

OpenFAST Library

#962 Add a Python glue-code interface
#1057 FAST Library: add access to hub position and velocity

ServoDyn

#803 Linearization of ServoDyn Structural control elements
#1074 [BugFix] ServoDyn StC control signal channels were not zeroed properly
#1089 BugFix: Fix API change line numbers
#1101 BugFix: ServoDyn API change docs
#1140 Add non-rotating hub forces to Bladed Interface
#1160 Correction to documentation on Extended Bladed DLL interface

TurbSim

#887 TurbSim modifications

Precompiled binaries

The binary files in this release were built with the Visual Studio solution files distributed with OpenFAST (not using cmake), using

• Intel Parallel Studio XE 2019 for Fortran (Update 5) with Microsoft Visual Studio 2017
• Microsoft Visual C++ 2015 (C) (v1.40), for build without Simulink interface
• Microsoft Visual C++ 2017 (C) (v1.41), for build in Matlab
• MATLAB Version: 9.11.0.1837725 (R2021b) Update 2

NOTES:

• The FAST S-function was built with a few changes to the source code to work around build errors (see bjonkman@5ca2b90):

  • = NULL was removed from the last two arguments in the definition of FAST_Sizes in FAST_Library.h:

  EXTERNAL_ROUTINE void FAST_Sizes(int * iTurb, const char *InputFileName, int *AbortErrLev, int * NumOuts, double * dt, double * tmax, int *ErrStat, char *ErrMsg, char *ChannelNames, double *TMax, double *InitInputAry);

  • The first &TMax argument was added to the call to FAST_Sizes in FAST_SFunc.c:

  FAST_Sizes(&iTurb, InputFileName, &AbortErrLev, &NumOutputs, &TMax, &dt, &ErrStat, ErrMsg, ChannelNames, &TMax, InitInputAry);

• FAST.Farm_x64_OMP.exe is built with OpenMP libraries and linked with dynamic libraries.

  • You will need this Intel Fortran redistributable package installed to run FAST.Farm_x64_OMP.exe if you do not already have Intel Fortran 2019 Update 5 installed. See the installation instructions here: https://software.intel.com/content/www/us/en/develop/articles/redistributable-libraries-for-intel-c-and-fortran-2019-compilers-for-windows.html.

• You may also need a redistributable library for Visual Studio installed. See instructions here: https://support.microsoft.com/en-us/topic/the-latest-supported-visual-c-downloads-2647da03-1eea-4433-9aff-95f26a218cc0

• The other OpenFAST executables DO NOT require these redistributable libraries to be installed. Instead, they were built with static libraries.

OpenFAST v3.1.0

Release Notes

General

#707 Add environmental variables to driver input files
#734 OpenFAST Registry algorithm change: simplify USE statements
Others (#826, #835, #836, #911, #918, #971, #1019)

AeroDyn

#688 AeroDyn driver update for multiple wind turbines, with arbitrary motions and geometries
#729 New features for unsteady aerodynamics modeling
#834 Fix AD Driver unallocated variable error with GCC 11
#863 AeroDyn cleanup
#917 AD15: add nodal outputs for VUnd{xyz}i in global coords
#919 Segment treecode
#920 Update in Computing Default Unsteady Airfoil Coefficients
#922 [BugFix] Minor bugfix in AirfoilInfo
#982 [BugFix] AD15 nacelle reference position was set to hub position
#1001 Remove conditional statement for initialization of BEMT variable
#1009 [BugFix] Nacelle position set inconsistently by glue code and AeroDyn driver

BeamDyn

#996 [BugFix] BeamDyn nodal outputs occasionally segfaulted

FAST Farm

#839 Fix Bug in FAST.Farm Causing Wake Bounce-Back
#860 Fix some memory leaks in FAST.Farm
#895 [BugFix] incorrect init of aggregated output index arrays in FAST.Farm
#923 [BugFix] error handling in AWAE module

HydroDyn

#756 HydroDyn primary input file passing and parsing
#831 HydroDyn Input/Output meshes: change from SWL to MSL for consistency with OF glue code
#838 [BugFix] segmentation fault in HD linearization
#915 [BugFix] Incorrect reference frame used in HD for WAMIT/WAMIT2
#998 Fix HydroDyn summary file nodal data is incorrect when Member is flipped

InflowWind

#720 inflowWind C-bound interface and python wrapper
#769 Fix issue with interpolation that could cause a segmentation fault
#929 Fix issue with uninitialized variables in InflowWind's Direct Scaling method

NWTC Library

#1002 Increase line length in FileInfo parsing methods

OpenFAST Library

#716 [BugFix] Fix C++ API for restart, Error handling in FAST Library, and AeroDyn echo file lock
#958 Lin: CalcSteady, forcing linearization at end of simulation

ServoDyn

#664 Extended Bladed DLL interface, improved summary file including DLL channel usage, and cable controls for MD and SD
#902 Fixes for Intel in debug mode
#930 Stop OpenFAST for Simulink simulation when trim solution has been found

SubDyn

#859 Various improvements to SubDyn

Documentation

#740 Guidelines for performance considerations with Fortran
#753 Migrate the HydroDyn Manual to readthedocs
#805 Include legacy documentation in pdf and MS Word format - General & ElastoDyn
#828 Add instructions for adding new regression test cases
#858 Documentation for ExtPtfm
#951 Corrected the description of SkewModFactor in Documentation
#1020 Document AD outputs

Precompiled binaries

The binary files in this release were built with Visual Studio solution files in OpenFAST (not cmake), using

• Intel Parallel Studio XE 2019 for Fortran (Update 5) with Microsoft Visual Studio 2017
• Microsoft Visual C++ 2015 (C) (v1.40), for build without Simulink interface
• Microsoft Visual C++ 2017 (C) (v1.41), for build in Matlab
• MATLAB Version: 9.11.0.1837725 (R2021b) Update 2

NOTES

Unlike previous releases of OpenFAST, there is now NO NEED for a MAP++ DLL; this code has been statically linked into the executables.
FAST.Farm_x64_OMP.exe is built with OpenMP libraries and linked with dynamic libraries.
You will need this Intel Fortran redistributable package installed to run FAST.Farm_x64_OMP.exe if you do not already have Intel Fortran 2019 Update 5 installed. See the installation instructions here: https://software.intel.com/content/www/us/en/develop/articles/redistributable-libraries-for-intel-c-and-fortran-2019-compilers-for-windows.html.
You may also need a redistributable library for Visual Studio installed. See instructions here: https://support.microsoft.com/en-us/topic/the-latest-supported-visual-c-downloads-2647da03-1eea-4433-9aff-95f26a218cc0
The other OpenFAST executables DO NOT require these redistributable libraries to be installed. Instead, they were built with static libraries.