OpenFAST · andrew-platt · Jun 16, 2025 · Mar 17, 2025 · Sep 16, 2024 · Oct 1, 2024
diff --git a/.github/workflows/automated-dev-tests.yml b/.github/workflows/automated-dev-tests.yml
diff --git a/.github/workflows/conda-deploy.yml b/.github/workflows/conda-deploy.yml
@@ -15,7 +15,7 @@ on:
 jobs:
   update-dev:
     if: github.repository_owner == 'OpenFAST'
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-24.04
     steps:
       # - name: Echo path
       #   run: |

diff --git a/README.rst b/README.rst
@@ -25,6 +25,18 @@ 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 <https://nrel.github.io/WETOStack>`_. For more information and other integrated modeling software, see:
+
+* `Portfolio Overview <https://nrel.github.io/WETOStack/portfolio_analysis/overview.html>`_
+* `Entry Guide <https://nrel.github.io/WETOStack/_static/entry_guide/index.html>`_
+* `OpenFAST Workshop <https://nrel.github.io/WETOStack/workshops/user_workshops_2024.html#openfast-ecosystem>`_
+
+
 FAST v8 - OpenFAST
 ------------------
 The transition from FAST v8 to OpenFAST represents the effort to better

diff --git a/docs/OtherSupporting/OutListParameters.xlsx b/docs/OtherSupporting/OutListParameters.xlsx
diff --git a/docs/changelogs/v4.0.4.md b/docs/changelogs/v4.0.4.md
@@ -0,0 +1,94 @@
+**Feature or improvement description**
+Pull request to merge `rc-4.0.4` into `main` and create a tagged release for v4.0.4
+
+See the milestone and project pages for additional information
+
+    https://github.com/OpenFAST/openfast/milestone/20
+
+Test results, if applicable
+See GitHub Actions
+
+### Release checklist:
+- [ ] Update the documentation version in docs/conf.py
+- [ ] Update the versions in docs/source/user/api\_change.rst
+- [ ] Update version info in openfast\_io/pyproject.toml
+- [ ] Verify readthedocs builds correctly
+- [ ] Create an annotated tag in OpenFAST during merge (mark as most recent if necessary)
+- [ ] Create a merge commit in r-test and add a corresponding annotated tag
+- [ ] Upload Docker image
+- [ ] Compile executables for Windows builds
+    - [ ] `AeroDisk_Driver_x64.exe`
+    - [ ] `AeroDyn_Driver_x64.exe`
+    - [ ] `AeroDyn_Driver_x64_OpenMP.exe`
+    - [ ] `AeroDyn_Inflow_c_binding_x64.dll`
+    - [ ] `AeroDyn_Inflow_c_binding_x64_OpenMP.dll`
+    - [ ] `BeamDyn_Driver_x64.exe`
+    - [ ] `DISCON.dll (x64)`
+    - [ ] `DISCON_ITIBarge.dll (x64)`
+    - [ ] `DISCON_OC3Hywind.dll (x64)`
+    - [ ] `DISCON_SC.dll (x64)`
+    - [ ] `FAST.Farm_x64.exe`
+    - [ ] `FAST.Farm_x64_OMP.exe`
+    - [ ] `FAST_SFunc.mexw64`
+    - [ ] `HydroDynDriver_x64.exe`
+    - [ ] `HydroDyn_C_Binding_x64.dll`
+    - [ ] `IinflowWind_c_binding_x64.dll`
+    - [ ] `InflowWind_Driver_x64.exe`
+    - [ ] `InflowWind_Driver_x64_OpenMP.exe`
+    - [ ] `MoorDyn_Driver_x64.exe`
+    - [ ] `MoorDyn_c_binding_x64.dll`
+    - [ ] `OpenFAST-Simulink_x64.dll`
+    - [ ] `openfast_x64.exe`
+    - [ ] `SeaStateDriver_x64.exe`
+    - [ ] `SimpleElastoDyn_x64.exe`
+    - [ ] `SubDyn_x64.exe`
+    - [ ] `Turbsim_x64.exe`
+    - [ ] `UnsteadyAero_x64.exe`
+
+# Changelog
+
+## Overview
+
+This release includes several bug fixes and improvements for _OpenFAST_, GitHub actions, and _openfast\_io_.
+
+## General
+
+### CMake build system
+
+### GitHub actions
+
+#2778 Backport of GitHub Action to build windows executables on release (@deslaughter) -- backport of #2636
+
+
+### openfast_io
+
+#2779 MD: Backport of PR #2658 -- openfast\_IO MoorDyn compatibility (@RyanDavies19)
+
+#2777 bug fix #2762 (@mayankchetan)
+
+#2658 openfast\_IO MoorDyn compatibilityModule (@RyanDavies19)
+
+
+
+## Solvers
+
+### Simulink
+
+#2785 Avoid ending program when called as a shared library (@bjonkman) -- backport of #2671
+
+
+
+## Module changes
+
+### OpenFAST library
+
+#2780 backport of #2760: bug-fix: Adjust steady-state solver small angle assumptions (@bjonkman)
+
+#2776 Fix FAST\_ExtInfw\_Restart APIC++ API (@marchdf)
+
+
+
+## Input file changes
+
+No input file changes since v4.0.0
+
diff --git a/docs/changelogs/v4.0.5.md b/docs/changelogs/v4.0.5.md
@@ -0,0 +1,116 @@
+**Feature or improvement description**
+Pull request to merge `rc-4.0.5` into `main` and create a tagged release for v4.0.5
+
+See the milestone and project pages for additional information
+
+    https://github.com/OpenFAST/openfast/milestone/22
+
+Test results, if applicable
+See GitHub Actions
+
+### Release checklist:
+- [ ] Update the documentation version in docs/conf.py
+- [ ] Update the versions in docs/source/user/api\_change.rst
+- [ ] Update version info in openfast\_io/pyproject.toml
+- [ ] Verify readthedocs builds correctly
+- [ ] Create an annotated tag in OpenFAST during merge (mark as most recent if necessary)
+- [ ] Create a merge commit in r-test and add a corresponding annotated tag
+- [ ] Upload Docker image
+- [ ] Compile executables for Windows builds
+    - [ ] `AeroDisk_Driver_x64.exe`
+    - [ ] `AeroDyn_Driver_x64.exe`
+    - [ ] `AeroDyn_Driver_x64_OpenMP.exe`
+    - [ ] `AeroDyn_Inflow_c_binding_x64.dll`
+    - [ ] `AeroDyn_Inflow_c_binding_x64_OpenMP.dll`
+    - [ ] `BeamDyn_Driver_x64.exe`
+    - [ ] `DISCON.dll (x64)`
+    - [ ] `DISCON_ITIBarge.dll (x64)`
+    - [ ] `DISCON_OC3Hywind.dll (x64)`
+    - [ ] `DISCON_SC.dll (x64)`
+    - [ ] `FAST.Farm_x64.exe`
+    - [ ] `FAST.Farm_x64_OMP.exe`
+    - [ ] `FAST_SFunc.mexw64`
+    - [ ] `HydroDynDriver_x64.exe`
+    - [ ] `HydroDyn_C_Binding_x64.dll`
+    - [ ] `IinflowWind_c_binding_x64.dll`
+    - [ ] `InflowWind_Driver_x64.exe`
+    - [ ] `InflowWind_Driver_x64_OpenMP.exe`
+    - [ ] `MoorDyn_Driver_x64.exe`
+    - [ ] `MoorDyn_c_binding_x64.dll`
+    - [ ] `OpenFAST-Simulink_x64.dll`
+    - [ ] `openfast_x64.exe`
+    - [ ] `SeaStateDriver_x64.exe`
+    - [ ] `SimpleElastoDyn_x64.exe`
+    - [ ] `SubDyn_x64.exe`
+    - [ ] `Turbsim_x64.exe`
+    - [ ] `UnsteadyAero_x64.exe`
+
+# Changelog
+
+## Overview
+
+This release includes several bug fixes and improvements for _OpenFAST_, GitHub actions, and _openfast\_io_.
+
+## General
+
+### CMake build system
+
+### GitHub actions
+
+#2825 Simplify GitHub Action for regression tests (backport from dev-tc) (@deslaughter)
+
+
+### openfast_io
+
+#2828 updated outlist reading in openfast\_io (@mayankchetan)
+
+#2818 OpenFAST IO updates: MoorDyn and StC (@dzalkind)
+
+
+
+## Solvers
+
+### OpenFAST
+
+#2831 [BugFix] WrVTK with VTK\_fps fails (@andrew-platt)
+
+
+## Interfaces
+
+### cpp interface
+
+#2792 Fix openfastcpp restart parsing of file name (@marchdf)
+
+#2804 Add a checkError in openfast cpp (@marchdf)
+
+#2815 Fix restart parsing of file name (backport of #2792 and #2793) (@marchdf)
+
+
+## Module changes
+
+### AeroDyn
+
+#2853 Backport #2848 (@bjonkman)
+
+
+### BeamDyn
+
+#2811 BD: new output - aero only loads mapped to the root (@andrew-platt)
+
+
+### IceFlow
+
+#2855 Fix Typo in "interpolation" in Ice Crushing Modules (@leopardracer)
+
+
+### SubDyn
+
+#2821 bugfix: SD maximum number of output channels was incorrectly set (@andrew-platt)
+
+
+## Input file changes
+
+No input file changes since v4.0.0
+
+#2829 FF: typo in SeaState names in `MD_Shared` .fst files - this is not an API change (@andrew-platt)
+
diff --git a/docs/conf.py b/docs/conf.py
@@ -138,7 +138,7 @@ def runDoxygen(sourcfile, doxyfileIn, doxyfileOut):
 # The short X.Y version.
 version = u'4.0'
 # The full version, including alpha/beta/rc tags.
-release = u'v4.0.3'
+release = u'v4.0.5'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

diff --git a/docs/source/dev/index.rst b/docs/source/dev/index.rst
@@ -61,7 +61,7 @@ with the NREL OpenFAST team to define the scope of the work and coordinate
 development efforts. This is particularly important since many groups
 work on OpenFAST simultaneously. By engaging early, all developers can
 stay up to date and minimize conflicts during the code merge.
-The prefered method of communication is `GitHub Issues <https://github.com/openfast/openfast/issues>`_.
+The preferred method of communication is `GitHub Issues <https://github.com/openfast/openfast/issues>`_.
 An initial post should contain all relevant information about the planned
 development work, the areas of the software that will be impacted,
 and any model validation materials. See :ref:`development_plan`

diff --git a/docs/source/install/index.rst b/docs/source/install/index.rst
@@ -478,7 +478,7 @@ The CMake options specific to OpenFAST and their default settings are:
     ORCA_DLL_LOAD                  - Enable OrcaFlex library load (Default: ON)
     USE_DLL_INTERFACE              - Enable runtime loading of dynamic libraries (Default: ON)
     USE_LOCAL_STATIC_LAPACK        - Enable downloading and building static LAPACK and BLAS libs (Default: OFF)
-    VARIABLE_TRACKING              - Enables variable tracking for better runtime debugging output. May increase compile time. Valid only for GNU. (Defualt: ON)
+    VARIABLE_TRACKING              - Enables variable tracking for better runtime debugging output. May increase compile time. Valid only for GNU. (Default: ON)
 
 
 Additional system-specific options may exist for a given system, but those

diff --git a/docs/source/user/aerodyn-olaf/OLAFTheory.rst b/docs/source/user/aerodyn-olaf/OLAFTheory.rst
@@ -94,7 +94,7 @@ a line of varying circulation. The line follows the motion of the blade and is
 referred to as “bound” circulation. The bound circulation does not follow the
 same dynamic equation as the free vorticity of the wake. Instead, the intensity
 is linked to airfoil lift via the Kutta-Joukowski theorem. Spanwise variation of
-the bound circulation results in vorticity being emitted into the the wake. This
+the bound circulation results in vorticity being emitted into the wake. This
 is referred to as “trailed vorticity”. Time changes of the bound circulation are
 also emitted in the wake, referred to as “shed” vorticity. The subsequent
 paragraphs describe the representation of the bound vorticity.

diff --git a/docs/source/user/aerodyn/input.rst b/docs/source/user/aerodyn/input.rst
@@ -187,7 +187,7 @@ Determines the kind of BEM algorithm to use.
 
 .. warning::
 
-    ``BEM_Mod`` currently governs the coordinate system used for "ill-defined" outputs (outputs that don't have a specified coordinate system) such as the ones that ends with "x" and "y". Other ill-defined outputs are the typical BEM quantities such as "AxInd", "TnInd", "Phi", etc. These are defined in a different coordinate system depending on `BEM_Mod`. For consistency accross differents `Wake_Mod` (even when `Wake_Mod/=1`), we use `BEM_Mod` to determine the coordinate system of the ill-defined outputs. 
+    ``BEM_Mod`` currently governs the coordinate system used for "ill-defined" outputs (outputs that don't have a specified coordinate system) such as the ones that ends with "x" and "y". Other ill-defined outputs are the typical BEM quantities such as "AxInd", "TnInd", "Phi", etc. These are defined in a different coordinate system depending on `BEM_Mod`. For consistency across differents `Wake_Mod` (even when `Wake_Mod/=1`), we use `BEM_Mod` to determine the coordinate system of the ill-defined outputs. 
 
 The following inputs in this section are only used when ``Wake_Mod = 1``.
 

diff --git a/docs/source/user/aerodyn/theory.rst b/docs/source/user/aerodyn/theory.rst
@@ -4,7 +4,7 @@
 AeroDyn Theory
 ==============
 
-This theory manual is work in progress, please refer to the AeroDyn 14 manual for more details :cite:`ad-AeroDyn:manual`. Many changes have occured since AeroDyn 14 (e.g. BEM formulation, coordinate system used in the BEM equations, dynamic stall, dynamic BEM), but these changes are not yet documented here.
+This theory manual is work in progress, please refer to the AeroDyn 14 manual for more details :cite:`ad-AeroDyn:manual`. Many changes have occurred since AeroDyn 14 (e.g. BEM formulation, coordinate system used in the BEM equations, dynamic stall, dynamic BEM), but these changes are not yet documented here.
 
 
 

diff --git a/docs/source/user/api_change.rst b/docs/source/user/api_change.rst
@@ -24,6 +24,18 @@ FAST.Farm                                     12   SC_FileName     "SC_DLL.dll"
 ============================================= ==== =============== ========================================================================================================================================================================================================
 
 
+OpenFAST v4.0.4 to OpenFAST v4.0.5
+----------------------------------
+
+No input file changes were made.
+
+
+OpenFAST v4.0.3 to OpenFAST v4.0.4
+----------------------------------
+
+No input file changes were made.
+
+
 OpenFAST v4.0.2 to OpenFAST v4.0.3
 ----------------------------------
 

diff --git a/docs/source/user/beamdyn/theory.rst b/docs/source/user/beamdyn/theory.rst
@@ -82,7 +82,7 @@ Local blade coordinate system
 
 The local blade coordinate system is used for some input and output
 quantities, for example, the cross-sectional mass and stiffness matrices
-and the the sectional force and moment resultants. This coordinate
+and the sectional force and moment resultants. This coordinate
 system is different from the blade reference coordinate system in that
 its :math:`Z_l` axis is always tangent to the blade axis as the blade
 deflects. Note that a subscript :math:`l` denotes the local blade

diff --git a/docs/source/user/cppapi/files/cDriver.i b/docs/source/user/cppapi/files/cDriver.i
@@ -27,7 +27,7 @@ n_substeps: 1            # Number of substeps per timestep of the glue-code
 
 n_checkpoint: 160        # Restart files will be written every so many time steps
 
-set_exp_law_wind: false  # Set velocity at the the turbine using an exponential law profile.
+set_exp_law_wind: false  # Set velocity at the turbine using an exponential law profile.
 
 Turbine0:
 

diff --git a/docs/source/user/elastodyn/theory.rst b/docs/source/user/elastodyn/theory.rst
@@ -5,7 +5,7 @@ ElastoDyn Theory
 ================
 
 Note this document is work in progress and is greatly incomplete. 
-This documentation was started to document some code changes to the the tail furl and rotor furl part of ElastoDyn. 
+This documentation was started to document some code changes to the tail furl and rotor furl part of ElastoDyn. 
 Please refer to the different ressources provided in :numref:`ed_intro` for additional documents.
 
 

diff --git a/docs/source/user/fast.farm/FFarmTheory.rst b/docs/source/user/fast.farm/FFarmTheory.rst
@@ -1278,7 +1278,7 @@ where :math:`D` is a reference diameter, and :math:`\bar{U}` is the mean
 velocity taken as the filtered velocity at the turbine location normal to the
 rotor disk.  The coordinates :math:`x,y,z` and :math:`r,\theta` are taken in the
 meandering frame of reference.  The parameters :math:`k_\text{def}^\text{WAT}`
-and :math:`k_\text{grad}^\text{WAT}` are tuning paramters of the model
+and :math:`k_\text{grad}^\text{WAT}` are tuning parameters of the model
 respectively multiplying the quasi-steady wake deficit and the gradient of the
 wake deficit. These are based on an eddy-viscosity filter with five calibrated
 parameters to give a more realistic dependence on downstream position.  The

diff --git a/docs/source/user/fast.farm/OutputFiles.rst b/docs/source/user/fast.farm/OutputFiles.rst
@@ -138,5 +138,5 @@ module levels, as specified within the OpenFAST input files) are
 described in the OpenFAST documentation and include summary (*.sum*)
 files, time-series results (ASCI *.out* or binary *.outb*) files,
 visualization (*.vtk*) files, etc. FAST.Farm simulations will generate
-these same files, but with the the path/rootname changed to *<RootName
+these same files, but with the path/rootname changed to *<RootName
 of WT_FASTInFile>.T<n*\ :sub:`t`\ *>*.
diff --git a/docs/source/user/servodyn/SrvD--Ex.sum b/docs/source/user/servodyn/SrvD--Ex.sum
@@ -56,7 +56,7 @@
           60      -->  Rotor azimuth angle (rad) [SrvD input]
           61      -->  Number of blades (-) [SrvD NumBl parameter]
           62      -->  Maximum number of values which can be returned for logging (-) [set to 300]
-          63      <--  Number logging channels
+          63      -->  Record number for start of logging output (-) [set to ###]
           64      -->  Maximum number of characters which can be returned in "OUTNAME" (-) [set to 12601 (including the C NULL CHARACTER)]
           65      <--  Number of variables returned for logging [anything greater than MaxLoggingChannels is an error]
           69      -->  Blade 1 root in-plane bending moment (Nm) [SrvD input]

diff --git a/docs/source/user/subdyn/theory.rst b/docs/source/user/subdyn/theory.rst
@@ -1879,7 +1879,7 @@ This applies e.g.: to :math:`F_{R,e}, F_{L,e}, F_{R,g}, F_{L,g}`, where the foll
 
 
 The dependency of the load vectors on :math:`U_{TP}` introduces some complications for the state space representation, where for instance the :math:`B` and  :math:`F_X` matrices should be modified to account for the dependency in :math:`U_{TP}` in Eq. :eq:`ABFx`.
-The equation remains valid even if :math:`F_{L,e}` and :math:`F_{L,g}` contains a dependency in :math:`U_{TP}`, but the matrix :math:`B` shouldn't be used for the linearization (numerical differentiation is then prefered for simplicity).
+The equation remains valid even if :math:`F_{L,e}` and :math:`F_{L,g}` contains a dependency in :math:`U_{TP}`, but the matrix :math:`B` shouldn't be used for the linearization (numerical differentiation is then preferred for simplicity).
 Similar considerations apply for Eq. :eq:`bigY2`.
 
 

diff --git a/glue-codes/fast-farm/src/FAST_Farm.f90 b/glue-codes/fast-farm/src/FAST_Farm.f90
@@ -49,8 +49,8 @@ PROGRAM FAST_Farm
 REAL(ReKi)                            :: PrevClockTime      !< Previous clock time in seconds past midnight
 INTEGER                               :: SimStrtTime (8)    !< An array containing the elements of the start time (after initialization).
 INTEGER                               :: ProgStrtTime (8)   !< An array containing the elements of the program start time (before initialization).
-REAL(ReKi)                            :: SimStrtCPU         !< User CPU time for simulation (without intialization)
-REAL(ReKi)                            :: ProgStrtCPU        !< User CPU time for program (with intialization)
+REAL(ReKi)                            :: SimStrtCPU         !< User CPU time for simulation (without initialization)
+REAL(ReKi)                            :: ProgStrtCPU        !< User CPU time for program (with initialization)
 
 ! these should probably go in the FAST.Farm registry:
 type(All_FastFarm_Data)               :: farm  

diff --git a/glue-codes/fast-farm/src/FAST_Farm_Subs.f90 b/glue-codes/fast-farm/src/FAST_Farm_Subs.f90
@@ -341,7 +341,7 @@ SUBROUTINE WAT_init( p, WAT_IfW, AWAE_InitInput, ErrStat, ErrMsg )
    HAWC_InitInput%WindFileName(3) = trim(BoxFileRoot)//trim(FileEnding(3))
 
    ! HAWC spatial grid
-   if (p%WAT == Mod_WAT_PreDef) then       ! from libary of WAT files, set the NxNyNz and DxDyDz terms
+   if (p%WAT == Mod_WAT_PreDef) then       ! from library of WAT files, set the NxNyNz and DxDyDz terms
       call MannLibDims(BoxFileRoot, p%RotorDiamRef, p%WAT_NxNyNz, p%WAT_DxDyDz, ErrStat2, ErrMsg2);  if (Failed()) return
       write(sDummy, '(3(I8,1X))') p%WAT_NxNyNz
       call WrScr('  WAT: NxNyNz set to: '//trim(sDummy)//' (inferred from filename)')