Releases: OpenFAST/openfast
v3.5.4
Overview of v3.5.4
This release includes a performance increase for BeamDyn and several minor bug fixes. See below for details
Bugfixes
There are numerous bug fixes in several modules. See below for details.
Input File changes
No input file formats change.
Changelog
Overview
This release includes performance improvements for BeamDyn (up to 30% speed increase), python file readers and writers from WEIS, and a fix for stack overflows with FAST.Farm (Intel compilation). A few other minor updates are included as outlined below.
Anyone using BeamDyn will want to update to this version.
General
Build systems
#2311 Always build openfastcpplib
as shared. Use BUILD_OPENFAST_CPP_DRIVER
to disable openfastcpp
executable (@deslaughter)
#2173 Fix crash in MAP_End
when using Intel's new icx compiler and disable caching in setup-python GH action (@deslaughter)
Python file readers/writers
#2188 Add WEIS file readers and writers (@cortadocodes and @mayankchetan)
Solvers
FAST.Farm
#2452 Fix for some stack overflow issues with FAST.Farm when copying large amounts of wind data (closes #2053) (@andrew-platt)
#2340 Add !$ OMP critical
around file opening for VTK to prevent file collision (@andrew-platt)
Module changes
BeamDyn
#2399 BeamDyn performance improvements (@deslaughter)
ElastoDyn
#2321 Backport of #2317: Explicitly initialize ED
RtHS
to zero -- corrects issue with inccorect linearization results (@andrew-platt)
HydroDyn
#2397 HD bug fix: prevent array index out-of-bound error in HDOut_MapOutputs
when more than 9 potential-flow bodies are present (@luwang00)
NWTC-Library
#2389 FileInfoType: increase line length allowed (@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.4 (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.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 toFAST_Sizes
inFAST_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 will need this Intel Fortran redistributable package installed to run
-
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.