Merge pull request #3248 from deslaughter/main_to_dev

Merge `main` into `dev` after 4.2.1 Release

Author: deslaughter

docs/changelogs/v4.2.1.md

@@ -0,0 +1,141 @@
+**Feature or improvement description**
+Pull request to merge `dev` into `main` for release version 4.2.1
+
+See the milestone and project pages for additional information
+
+    https://github.com/OpenFAST/openfast/milestone/27
+
+No test results change
+
+### 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 (`openfast_io` package)
+- [ ] Update version info in glue-codes/python/pyproject.toml (`pyOpenFAST` package for testing)
+- [ ] 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)`
+    - [ ] `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`
+    - [ ] `SeaState_c_binding_x64.dll`
+    - [ ] `SimpleElastoDyn_x64.exe`
+    - [ ] `SubDyn_x64.exe`
+    - [ ] `Turbsim_x64.exe`
+    - [ ] `UnsteadyAero_x64.exe`
+
+
+
+# Release Overview
+------------------
+
+
+
+### Contribution Acknowledgements
+
+We are grateful for a first time code contributions from @IrisMeasure.
+
+
+
+# Changelog (from 4.2.1)
+------------------------
+
+
+## Solvers
+
+### FAST.Farm
+
+#3243 Add high res windslice at `T=t_low - DT_high` (Fix for FAST.Farm issue #3183) (@andrew-platt)
+
+
+
+## Modules
+
+## AeroDyn
+
+#### AeroDyn Driver / AeroDyn\_Inflow\_C\_Bindings interface
+
+#3214 [BugFix] ADI c-bind: comment out code that causes segfaults with interface debugging (@andrew-platt)
+
+#3227 [BugFix] AD: DTAero from input file was ignored (@andrew-platt)
+
+#3230 [BugFix] AD driver: hub acceleration value incorrect in RotMotionType==1 (@andrew-platt)
+
+
+### NWTC-Library
+
+#3123 Switch from xPPTRF to xPOTRF to improve TurbSim speed on macOS (@IrisMeasure)
+
+#3229 Re-add the xPPTRF routines (rename xPOTRF routines from #3123) (@andrew-platt)
+
+
+### SeaState
+
+#3235 backport of #3231 - SS WaveTp logic (@andrew-platt, @RBergua)
+
+#3236 Add SeaSt\_C\_GetFluidDynP routine to SeaState\_C\_Binding interface (@andrew-platt)
+
+
+### TurbSim
+
+#3224 Fix TurbSim compile with OpenMP and IFX compiler (@deslaughter)
+
+
+
+## Testing and input file processing
+
+### Regression and Unit testing
+
+#3228 regtest: check if destination dirs exist before copyTree call (@andrew-platt)
+
+
+
+## Input file changes
+
+No input file changes since v4.2.0
+
+
+## Known issues
+There are several issues that have not been addressed in this release due to time constraints, but will be addressed in future releases.  These include:
+
+- No visualization of rectangular members from _HydroDyn_ or _SubDyn_ through the VTK output options
+- Missing and broken features from several c-binding library interfaces:
+   - the _AeroDyn\_Inflow\_c-binding_ library interface does not allow for coupling to the tower.  This will require an interface update.
+   - the _HydroDyn\_c-binding_ library interface does not currently support vizualization.  This will require an interface update.
+   - the `InitNodePositions` input to _HydroDyn\_c-binding_ library interface does not currently work with any non-zero `x` or `y` coordinates (non-zero `z` is ok)
+   - the _MoorDyn\_c-binding_ library interface does not currently support vizualization.  This will require an interface update.
+- Documentation on the new _pyOpenFAST_ module is incomplete.  Partial documentation exists on how to use it in regression testing, but no documentation or examples exist on using it to call c-bindings modules from Python.
+- Documentation is incomplete for _HydroDyn_, _SubDyn_, and a few other modules.
+
+
+# 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 Essentials 2025.3.0.333
+- Microsoft Visual Studio 2022 Version 17.14.23.
+- MATLAB 2025.2.999 (R2025b)
+- 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](https://registrationcenter-download.intel.com/akdlm/IRC_NAS/0dc56e76-d2c0-4bb8-9c83-c2ee3952b855/w_ifx_runtime_p_2025.2.1.1001.exe) installed to use these executables if you do not already have Intel Fortran OneAPI 2024 installed. See the installation instructions [here](https://software.intel.com/content/www/us/en/develop/articles/redistributable-libraries-for-intel-c-and-fortran-2022-compilers-for-windows.html).
+
+**The other OpenFAST executables DO NOT require these redistributable libraries to be installed. Instead, they were built with static libraries.**

docs/conf.py

@@ -139,7 +139,7 @@ def runDoxygen(sourcfile, doxyfileIn, doxyfileOut):
 # The short X.Y version.
 version = f'4.2'
 # The full version, including alpha/beta/rc tags.
-release = f'v4.2.0'
+release = f'v4.2.1'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

docs/source/user/api_change.rst

@@ -113,6 +113,13 @@ ElastoDyn Blade Input File                    \*                            The
 ============================================= ======== ==================== ========================================================================================================================================================================================================
 
 
+OpenFAST v4.2.0 to OpenFAST v4.2.1
+----------------------------------
+
+No input file changes were made.
+
+
+
 OpenFAST v4.1.x to OpenFAST v4.2.0
 ----------------------------------