Files
OpenFOAM-12/tutorials/multiphase/interFoam/RAS/planingHullW3
Henry Weller 818eed7a3d rigidBodyState, sixDoFRigidBodyState: Change angleFormat -> angleUnits with backwards-compatibility
angleUnits is a more logical name for the user-input as it specifies the units
of the angles written rather than the format of the numbers.  The previous name
angleFormat is supported for backwards-compatibility

Class
    Foam::functionObjects::rigidBodyState

Description
    Writes the rigid body motion state.

Usage
    \table
        Property     | Description                  | Required | Default value
        type         | type name: rigidBodyState    | yes      |
        angleUnits   | degrees or radians           | no       | radians
    \endtable

    Example of function object specification:
    \verbatim
    rigidBodyState
    {
        type           rigidBodyState;
        libs           ("librigidBodyState.so");
        angleUnits     degrees;
    }
    \endverbatim

Class
    Foam::functionObjects::sixDoFRigidBodyState

Description
    Writes the 6-DoF motion state.

    Example of function object specification:
    \verbatim
    sixDoFRigidBodyState
    {
        type           sixDoFRigidBodyState;
        libs           ("libsixDoFRigidBodyState.so");
        angleUnits     degrees;
    }
    \endverbatim

Usage
    \table
        Property     | Description                  | Required | Default value
        type         | type name: sixDoFRigidBodyState    | yes |
        angleUnits  | degrees or radians           | no       | radian
    \endtable
2022-12-05 19:57:12 +00:00
..
2022-05-20 10:42:25 +01:00

Overview
========
+ W3 example case of hydrodynamics of a planing hull

Mesh
====
+ The example includes two different approaches for meshing the case
+ The first approach uses no cell refinement in the vertical direction
+ The second approach includes local cell refinement, producing a smaller mesh
+ Cell refinement can cause disturbances of the interface
+ Where refinement is present, PLIC-based schemes perform much better,
  producing far less interface disturbance than the standard interface
  compression scheme.
+ The first approach has the advantage of avoiding interface disturbances but
  for the potential cost of a larger mesh than with local refinement

Experimental results (ref. 1)
=============================
+ Velocity = 4.598 m/s
+ Trim angle = 3.485 deg
+ Drag = 50.691 N

Numerical results mesh 1
========================
Without local refinement
+ Velocity = 4.598 m/s
+ Trim angle = 2.794 deg
+ Drag = 48.616 N

Numerical results mesh 2
========================
With local refinement
+ Velocity = 4.598 m/s
+ Trim angle = 3.027 deg
+ Drag = 47.987 N

Acknowledgment
==============
+ Thanks to Raffaele Ponzini, Ph.D. Eng. from CINECA, for kindly sharing the
  W3 hull geometry and for his valuable insight into the science of ship hulls

References
==========
1. Begovic, E. and Bertorello, C., 2012. Resistance assessment of warped
hullform. Ocean Engineering, 56, pp.28-42

2. Ponzini, R., Salvadore, F., Begovic, E. and Bertorello, C., 2020.
Automatic CFD Analysis Of Planing Hulls By Means Of A New Web-Based Application:
Usage, Experimental Data Comparison And Opportunities