Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

MD: User-specified external forces and translational damping for MoorDyn point, rod, and body objects #2597

Merged
merged 13 commits into from
Jan 30, 2025

Conversation

luwang00
Copy link
Contributor

@luwang00 luwang00 commented Jan 4, 2025

This PR is ready to be merged.

Feature or improvement description
This PR adds user-specified external forces (constant) and translational linear and quadratic damping coefficients to MoorDyn point, rod, and body objects.

A new optional input file section called EXTERNAL LOADS is added to the MoorDyn input file for these purposes, so no change to existing input files is necessary. Below is an example of the new optional MoorDyn input file section.

---------------------- EXTERNAL LOADS --------------------------------
ID    Object          Fext             Blin          Bquad         CSys
(#)   (name)           (N)            (Ns/m)       (Ns^2/m^2)      (-)
 1    Body1        0.0|0.0|0.0     0.0|0.0|0.0     0.0|0.0|0.0      G
 2    Body1        0.0|0.0|0.0     0.0|0.0|0.0     0.0|0.0|0.0      L
 3    Point1       0.0|0.0|0.0     0.0|0.0|0.0     0.0|0.0|0.0      -
 4    Rod1         0.0|0.0|0.0     0.0|0.0         0.0|0.0          -

For BODY, the force and damping are applied at the body reference point in the global earth-fixed coordinate system if CSys is G for global or in the local body-fixed coordinate system if CSys is L for local. CSys can only be G or L for BODY.

For POINT, the force and damping are applied at the point location in the global earth-fixed coordinate system always. CSys should be -. Otherwise, a warning message with explanation will be shown.

For ROD, the force is applied at the rod end A in the earth-fixed coordinate system always. Only two linear and two quadratic damping coefficients can be specified for rods. The first one is for the transverse direction, and the second one is for the axial/tangential direction. The damping force is always evaluated in the body-fixed system. CSys should be -. Otherwise, a warning message with explanation will be shown. Note that this new implementation serves as an extension and replacement of PR #2342.

This PR also addresses issue #2565.

The new feature and implementation are finalized after consulting with @RyanDavies19 and @mattEhall.

Jointly developed with @RyanDavies19.

Impacted areas of the software
MoorDyn

Test results, if applicable
No changes to existing input files or test results. Added a new MoorDyn module regression test md_BdyExtLdDmpg with external loads and damping on a body object.

…onal damping, and/or quadratic translational damping for bodies in an optional section of the input file
RyanDavies19 and others added 4 commits January 8, 2025 12:59
Combining Rod Damping and improving input file format
…ther defined in the global earth-fixed coordinate system or the local body-fixed coordinate system through a new input switch

External force and damping of point objects must always be in the global coordinate system due to a lack of rotational DoFs. The distributed transverse and axial damping of rod objects only make sense in the local body-fixed coordinate system. The behavior of external force on rod objects need to be clarified in the future.
…on with the coordinate system flag for rod and point objects
@luwang00 luwang00 changed the title MD: User-specified external forces and translational damping for MoorDyn body objects MD: User-specified external forces and translational damping for MoorDyn point, rod, and body objects Jan 10, 2025
RyanDavies19 added a commit to RyanDavies19/MoorDynC_ryan that referenced this pull request Jan 10, 2025
RyanDavies19 added a commit to RyanDavies19/MoorDynC_ryan that referenced this pull request Jan 10, 2025
sanguinariojoe pushed a commit to FloatingArrayDesign/MoorDyn that referenced this pull request Jan 13, 2025
@andrew-platt andrew-platt changed the base branch from dev to rc-4.0.1 January 21, 2025 17:54
@luwang00 luwang00 added this to the v4.0.1 milestone Jan 21, 2025
@andrew-platt andrew-platt mentioned this pull request Jan 30, 2025
29 tasks
@andrew-platt
Copy link
Collaborator

  • Updates to regression tests -- make sure to merge that into r-test dev

@andrew-platt andrew-platt merged commit 6bc8462 into OpenFAST:rc-4.0.1 Jan 30, 2025
22 checks passed
andrew-platt added a commit that referenced this pull request Jan 30, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants