Skip to content

Commit 464112e

Browse files
RyanDavies19sanguinariojoe
authored andcommitted
docs: Updated docs for OpenFAST/openfast#2597
1 parent 880d24a commit 464112e

File tree

3 files changed

+32
-2
lines changed

3 files changed

+32
-2
lines changed

docs/inputs.rst

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -569,6 +569,31 @@ to run the .mdl file are available in the OpenFAST GitHub repo under `glue-codes
569569
to show how to pass in values. A .dll OpenFAST shared library file and .mex OpenFAST S function file need to be in
570570
the same directory the controller is being run from.
571571

572+
External Loads (MoorDyn-F only)
573+
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
574+
575+
This section (optional) allows users to specify external forces (constant) and translational linear and quadratic
576+
damping coefficients to MoorDyn point, rod, and body objects.
577+
578+
.. code-block:: none
579+
580+
---------------------- EXTERNAL LOADS --------------------------------
581+
ID Object Fext Blin Bquad CSys
582+
(#) (name) (N) (Ns/m) (Ns^2/m^2) (-)
583+
1 Body1 0.0|0.0|0.0 0.0|0.0|0.0 0.0|0.0|0.0 G
584+
2 Body1 0.0|0.0|0.0 0.0|0.0|0.0 0.0|0.0|0.0 L
585+
3 Point1 0.0|0.0|0.0 0.0|0.0|0.0 0.0|0.0|0.0 -
586+
4 Rod1 0.0|0.0|0.0 0.0|0.0 0.0|0.0 -
587+
588+
For bodies, the force and damping are applied at the
589+
body reference point in the global earth-fixed coordinate system if CSys is G for global or in the local body-fixed
590+
coordinate system if CSys is L for local. CSys can only be G or L for bodies. For points, the force and damping are
591+
applied at the point location in the global earth-fixed coordinate system always. CSys should be -. Otherwise, a
592+
warning message with explanation will be shown. For rods, the force is applied at the rod end A in the earth-fixed
593+
coordinate system always. Only two linear and two quadratic damping coefficients can be specified for rods. The first
594+
one is for the transverse direction, and the second one is for the axial/tangential direction. The damping force is
595+
always evaluated in the body-fixed system. CSys should be -. Otherwise, a warning message with explanation will be shown.
596+
572597
Options
573598
^^^^^^^
574599

docs/references.rst

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ Version 1
5151
The v1 lumped-mass formulation of MoorDyn as well as its validation against experiments:
5252

5353
`M. Hall and A. Goupee, “Validation of a lumped-mass mooring line model with DeepCwind semisubmersible model test data,”
54-
Ocean Engineering, vol. 104, pp. 590–603, Aug. 2015.' <http://www.sciencedirect.com/science/article/pii/S0029801815002279>`_
54+
Ocean Engineering, vol. 104, pp. 590–603, Aug. 2015. <http://www.sciencedirect.com/science/article/pii/S0029801815002279>`_
5555

5656
Coupling with WEC-Sim or any Simulink code for wave energy converter simulation:
5757

@@ -102,6 +102,11 @@ Viscoelastic approach for non-linear rope behavior:
102102
`Hall, Matthew, Brian Duong, and Ericka Lozon, “Streamlined Loads Analysis of Floating Wind Turbines With Fiber Rope Mooring Lines.” In ASME 2023
103103
5th International Offshore Wind Technical Conference, V001T01A029. Exeter, UK: American Society of Mechanical Engineers, 2023. <https://doi.org/10.1115/IOWTC2023-119524>`_
104104

105+
Updated MoorDyn-OpenFOAM Coupling:
106+
`Haifei Chen, Tanausú Almeida Medina, and Jose Luis Cercos-Pita, "CFD simulation of multiple moored floating structures using OpenFOAM: An open-access mooring restraints
107+
library." Ocean Engineering, vol. 303, Jul. 2024. <https://doi.org/10.1016/j.oceaneng.2024.117697>`_`
108+
109+
105110
The Fortran version of MoorDyn is available as a module inside of OpenFAST:
106111

107112
https://openfast.readthedocs.io/en/main/

docs/troubleshooting.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ lines. The highest axial vibration mode of the lumped-mass cable representation
1515
be when adjacent nodes oscillate out of phase with each other, as depicted below.
1616

1717
In this mode, the midpoint of each segment would not move. The motion of each node can
18-
then be characterized by mass-spring-damper values of
18+
then be characterized by mass-spring-damper values of (where *w* is mass per length):
1919

2020
.. math::
2121

0 commit comments

Comments
 (0)