Importing hydrodynamic data: MOSES

OrcaFlex can import MOSES data in a straightforward way, with the following caveats:

RAOs

See this example for MOSES displacement RAOs, and this one for MOSES wave load RAOs. Remember that RAO and phase origins are not imported from text files – you should take particular care with MOSES output to set these correctly, since in this case the RAO origin and phase origin may differ.

Newman QTFs

Newman QTFs in all six degrees of freedom are included in this example of MOSES output.

Added mass and damping

Added mass and damping may be output in two forms by MOSES:

(i) full matrices

MOSES will optionally output the full $6{\times}6$ matrices to a .ppo file, and this is the only format which is supported by OrcaFlex import. MOSES presents these matrices scaled by mass. Since OrcaFlex requires non-normalized data, the import process must account for this scaling factor. To do so, note that towards the beginning of this example is a section of the form

OrcaFlex Scaling Factor Start
1381.8
OrcaFlex Scaling Factor End
        

The number 1381.8 in this case is the mass of the vessel, as specified in the standard MOSES output file. OrcaFlex will scale all the imported data by this value.

Warning: You must ensure that your OrcaFlex model units are the same as the units of your MOSES added mass and damping data, including the unit of mass for the scaling factor, before importing the data.

(ii) diagonal elements only

The standard MOSES output file may also contain tables of the diagonal elements (surge-surge, sway-sway, yaw-yaw etc terms only) of the added mass and damping matrices. OrcaFlex cannot however import these data directly, since the rotational components are presented as radii of gyration. If you wish to import these data, you will need first to convert the rotational values from radii of gyration to added inertia and rotational damping, according to the formulation used by MOSES.

Example data

MOSES output – displacement RAOs

Page    1              Licensee -  Ultramarine, Inc                                      Rev DEVLOP                          Ser201
               ***************************************************************************************************************
               *                                                ***  MOSES   ***                                             *
               *                                                ----------------                         November 23, 2009   *
               *          Step 4 - Response Amplitude Operators                                                              *
               *                                                                                                             *
               *   Draft             =   6.8  Feet        Trim Angle       =   0.03 Deg.     GMT              =  28.1  Feet  *
               *   Roll Gy. Radius   =  18.0  Feet        Pitch Gy. Radius =  45.9  Feet     Yaw Gy. Radius   =  48.5  Feet  *
               *   Heading           =  90.00 Deg.        Forward Speed    =  0.00 Knots     Linearization Based on 1/ 20    *
               *                                                                                                             *
               ***************************************************************************************************************

    *** OrcaFlex Conventions Start ***
    RAOResponseUnits = degrees
    RAOWaveUnit = amplitude
    RAOPhaseConvention = leads
    RAOPhaseUnitsConvention = degrees
    RAOPhaseRelativeToConvention = crest
    SurgePositive = aft
    SwayPositive = starboard
    HeavePositive = up
    RollPositiveStarboard = up
    PitchPositiveBow = up
    YawPositiveBow = port
    *** OrcaFlex Conventions End ***

    *** OrcaFlex Units Start ***
    LengthUnits = ft
    *** OrcaFlex Units End ***

                                         +++ M O T I O N   R E S P O N S E   O P E R A T O R S +++
                                         =========================================================

                                                         Results are in Body System

                                        Of Point On Body CBRG180 At X =   90.0 Y =    0.0 Z =    7.0

                                  Process is DEFAULT: Units Are Degrees,  Feet, and  Kips Unless Specified

          E N C O U N T E R     Surge /          Sway /           Heave /          Roll /           Pitch /          Yaw /
         --------------------        Wave Ampl.       Wave Ampl.       Wave Ampl.       Wave Ampl.       Wave Ampl.       Wave Ampl.
          Frequency   Period   /--------------/ /--------------/ /--------------/ /--------------/ /--------------/ /--------------/
         -(Rad/Sec)-  -(Sec)-     Ampl.   Phase    Ampl.   Phase    Ampl.   Phase    Ampl.   Phase    Ampl.   Phase    Ampl.   Phase
    *** OrcaFlex Displacement RAO Start ***
    Draught "6.8'"
    Direction 90
              N/A       WP          XA        XP      YA      YP      ZA      ZP        RXA     RXP     RYA     RYP       RZA     RZP
             0.2513    25.00        0.007    97      0.973    93      0.985     0      0.110    89      0.027   174      0.002    96
             1.2566     5.00        0.004    71      0.321    73      0.835   -22      5.104    26      0.073    68      0.010  -157
             1.3963     4.50        0.003    31      0.259   140      0.625   -30      2.997   -10      0.066    36      0.006   157
             1.5708     4.00        0.001   -43      0.309   156      0.367   -34      1.423   -17      0.041    10      0.003   132
             2.0944     3.00        0.000     0      0.187  -143      0.067    27      0.259    35      0.009    49      0.001    98
    *** OrcaFlex Displacement RAO End ***
    Page    2              Licensee -  Ultramarine, Inc                                      Rev DEVLOP                          Ser201
               ***************************************************************************************************************
               *                                                ***  MOSES   ***                                             *
               *                                                ----------------                         November 23, 2009   *
               *          Step 4 - Response Amplitude Operators                                                              *
               *                                                                                                             *
               *   Draft             =   6.8  Feet        Trim Angle       =   0.03 Deg.     GMT              =  28.1  Feet  *
               *   Roll Gy. Radius   =  18.0  Feet        Pitch Gy. Radius =  45.9  Feet     Yaw Gy. Radius   =  48.5  Feet  *
               *   Heading           = 135.00 Deg.        Forward Speed    =  0.00 Knots     Linearization Based on 1/ 20    *
               *                                                                                                             *
               ***************************************************************************************************************

                                         +++ M O T I O N   R E S P O N S E   O P E R A T O R S +++
                                         =========================================================

                                                         Results are in Body System

                                        Of Point On Body CBRG180 At X =   90.0 Y =    0.0 Z =    7.0

                                  Process is DEFAULT: Units Are Degrees,  Feet, and  Kips Unless Specified

          E N C O U N T E R     Surge /          Sway /           Heave /          Roll /           Pitch /          Yaw /
         --------------------        Wave Ampl.       Wave Ampl.       Wave Ampl.       Wave Ampl.       Wave Ampl.       Wave Ampl.
          Frequency   Period   /--------------/ /--------------/ /--------------/ /--------------/ /--------------/ /--------------/
         -(Rad/Sec)-  -(Sec)-     Ampl.   Phase    Ampl.   Phase    Ampl.   Phase    Ampl.   Phase    Ampl.   Phase    Ampl.   Phase
    *** OrcaFlex Displacement RAO Start ***
    Draught "6.8'"
    Direction 135
              N/A       WP          XA        XP      YA      YP      ZA      ZP        RXA     RXP     RYA     RYP       RZA     RZP
             0.2513    25.00        0.646   -97      0.696    83      0.983    -6      0.079    82      0.084   101      0.055    -6
             1.2566     5.00        0.042    67      0.048   -39      0.030   -81      0.033   160      0.546  -114      0.313  -174
             1.3963     4.50        0.061  -143      0.026    20      0.113   -87      0.381   -65      0.206  -161      0.170   145
             1.5708     4.00        0.107   148      0.060     6      0.081  -131      0.222  -126      0.061   -57      0.009   -63
             2.0944     3.00        0.049    91      0.017   -12      0.014  -133      0.038   -84      0.027   -73      0.015  -103
    *** OrcaFlex Displacement RAO End ***
    Page    3              Licensee -  Ultramarine, Inc                                      Rev DEVLOP                          Ser201
               ***************************************************************************************************************
               *                                                ***  MOSES   ***                                             *
               *                                                ----------------                         November 23, 2009   *
               *          Step 4 - Response Amplitude Operators                                                              *
               *                                                                                                             *
               *   Draft             =   6.8  Feet        Trim Angle       =   0.03 Deg.     GMT              =  28.1  Feet  *
               *   Roll Gy. Radius   =  18.0  Feet        Pitch Gy. Radius =  45.9  Feet     Yaw Gy. Radius   =  48.5  Feet  *
               *   Heading           = 180.00 Deg.        Forward Speed    =  0.00 Knots     Linearization Based on 1/ 20    *
               *                                                                                                             *
               ***************************************************************************************************************

                                         +++ M O T I O N   R E S P O N S E   O P E R A T O R S +++
                                         =========================================================

                                                         Results are in Body System

                                        Of Point On Body CBRG180 At X =   90.0 Y =    0.0 Z =    7.0

                                  Process is DEFAULT: Units Are Degrees,  Feet, and  Kips Unless Specified

          E N C O U N T E R     Surge /          Sway /           Heave /          Roll /           Pitch /          Yaw /
         --------------------        Wave Ampl.       Wave Ampl.       Wave Ampl.       Wave Ampl.       Wave Ampl.       Wave Ampl.
          Frequency   Period   /--------------/ /--------------/ /--------------/ /--------------/ /--------------/ /--------------/
         -(Rad/Sec)-  -(Sec)-     Ampl.   Phase    Ampl.   Phase    Ampl.   Phase    Ampl.   Phase    Ampl.   Phase    Ampl.   Phase
    *** OrcaFlex Displacement RAO Start ***
    Draught "6.8'"
    Direction 180
              N/A       WP          XA        XP      YA      YP      ZA      ZP        RXA     RXP     RYA     RYP       RZA     RZP
             0.2513    25.00        0.911  -100      0.000     0      0.982    -9      0.000     0      0.115    93      0.000     0
             1.2566     5.00        0.151   178      0.000     0      0.153  -109      0.000     0      0.032   170      0.000     0
             1.3963     4.50        0.138   112      0.000     0      0.067  -149      0.000     0      0.177   -79      0.000     0
             1.5708     4.00        0.008  -122      0.000     0      0.045   -96      0.000     0      0.116  -142      0.000     0
             2.0944     3.00        0.046    47      0.000     0      0.024  -154      0.000     0      0.054  -111      0.000     0
    *** OrcaFlex Displacement RAO End ***
    Page    4              Licensee -  Ultramarine, Inc                                      Rev DEVLOP                          Ser201
               ***************************************************************************************************************
               *                                                ***  MOSES   ***                                             *
               *                                                ----------------                         November 23, 2009   *
               *          Step 4 - Response Amplitude Operators                                                              *
               *                                                                                                             *
               *                                                                                                             *
               ***************************************************************************************************************

                                                   +++ I N D E X   O F   O U T P U T +++
                                                   =====================================

                                         MOTION RESPONSE OPERATORS  . . . . . . . . . . . . . .     1

                                         INDEX OF OUTPUT  . . . . . . . . . . . . . . . . . . .     4
        

MOSES output – load RAOs and QTFs

*** OrcaFlex Conventions Start ***
    RAOResponseUnits = degrees
    RAOWaveUnit = amplitude
    RAOPhaseConvention = leads
    RAOPhaseUnitsConvention = degrees
    RAOPhaseRelativeToConvention = crest
    SurgePositive = aft
    SwayPositive = starboard
    HeavePositive = up
    RollPositiveStarboard = up
    PitchPositiveBow = up
    YawPositiveBow = port
    *** OrcaFlex Conventions End ***
    *** OrcaFlex Units Start ***
    LengthUnits = ft
    ForceUnits = kpf
    *** OrcaFlex Units End ***

    [header page omitted for brevity]
    Page    4              Licensee -  Ultramarine, Inc                                      Rev DEVLOP                          Ser201
               ***************************************************************************************************************
               *                                                ***  MOSES   ***                                             *
               *                                                ----------------                         December 18, 2007   *
               *          test of 3d diffraction                                                                             *
               *                                                                                                             *
               ***************************************************************************************************************

                              +++ P A N E L   W A V E   F R E Q U E N C Y   F O R C E S   F O R   O C 9 1 +++
                              ===============================================================================

                                                  Pressure Name = OC91    Heading = 90.00

                                  Process is DEFAULT: Units Are Degrees,  Feet, and  Kips Unless Specified

          E N C O U N T E R     Surge Force /    Sway Force /     Heave Force /    Roll Moment /    Pitch Moment /   Yaw Moment /
         --------------------        Wave Ampl.       Wave Ampl.       Wave Ampl.       Wave Ampl.       Wave Ampl.       Wave Ampl.
          Frequency   Period   /--------------/ /--------------/ /--------------/ /--------------/ /--------------/ /--------------/
         -(Rad/Sec)-  -(Sec)-     Ampl.   Phase    Ampl.   Phase   Ampl.   Phase    Ampl.   Phase    Ampl.   Phase    Ampl.   Phase

    *** OrcaFlex Load RAO Start ***
    Draught OC91
    Direction 90
              N/A       WP          XA        XP      YA      YP      ZA      ZP        RXA     RXP     RYA     RYP       RZA     RZP
             0.6283    10.00            0     0         25   -90         70     5        337    89          0     0          0     0
             1.4784     4.25            0     0         48   -94         16    57        555    85          0     0          0     0
             1.5708     4.00            0     0         43   -87         13    67        492    92          0     0          0     0
             1.6755     3.75            0     0         38   -75         10    78        431   103          0     0          0     0
             1.7952     3.50            0     0         35   -58          7    93        386   119          0     0          0     0
    *** OrcaFlex Load RAO End ***
    Page    5              Licensee -  Ultramarine, Inc                                      Rev DEVLOP                          Ser201
               ***************************************************************************************************************
               *                                                ***  MOSES   ***                                             *
               *                                                ----------------                         December 18, 2007   *
               *          test of 3d diffraction                                                                             *
               *                                                                                                             *
               ***************************************************************************************************************

                              +++ P A N E L   W A V E   F R E Q U E N C Y   F O R C E S   F O R   O C 9 1 +++
                              ===============================================================================

                                                  Pressure Name = OC91    Heading = 180.00

                                  Process is DEFAULT: Units Are Degrees,  Feet, and  Kips Unless Specified

          E N C O U N T E R     Surge Force /    Sway Force /     Heave Force /    Roll Moment /    Pitch Moment /   Yaw Moment /
         --------------------        Wave Ampl.       Wave Ampl.       Wave Ampl.       Wave Ampl.       Wave Ampl.       Wave Ampl.
          Frequency   Period   /--------------/ /--------------/ /--------------/ /--------------/ /--------------/ /--------------/
         -(Rad/Sec)-  -(Sec)-     Ampl.   Phase    Ampl.   Phase   Ampl.   Phase    Ampl.   Phase    Ampl.   Phase    Ampl.   Phase

    *** OrcaFlex Load RAO Start ***
    Draught OC91
    Direction 180
              N/A       WP          XA        XP      YA      YP      ZA      ZP        RXA     RXP     RYA     RYP       RZA     RZP
             0.6283    10.00           25    89          0     0         70     5          0     0        336    89          0     0
             1.4784     4.25           48    85          0     0         16    57          0     0        554    85          0     0
             1.5708     4.00           43    92          0     0         13    66          0     0        491    92          0     0
             1.6755     3.75           38   104          0     0         10    78          0     0        430   103          0     0
             1.7952     3.50           35   121          0     0          7    92          0     0        386   119          0     0
    *** OrcaFlex Load RAO End ***
    Page    6              Licensee -  Ultramarine, Inc                                      Rev DEVLOP                          Ser201
               ***************************************************************************************************************
               *                                                ***  MOSES   ***                                             *
               *                                                ----------------                         December 18, 2007   *
               *          test of 3d diffraction                                                                             *
               *                                                                                                             *
               ***************************************************************************************************************

                                   +++ M E A N   W A V E   D R I F T   F O R C E S   F O R   O C 9 1 +++
                                   =====================================================================

                                      Drift Name = OC91      Heading = 90.00     Computed by Salvesen

                                             Motion Factor =   0.0000   Force Factor =   1.0000

                                  Process is DEFAULT: Units Are Degrees,  Feet, and  Kips Unless Specified

                                         Mean Drift Force ( With No Factor ) / (Wave Amplitude)**2

                         E N C O U N T E R             T R A N S L A T I O N                  R O T A T I O N
                         --------------------     /-----------------------------/     /-----------------------------/
                          Frequency   Period       Surge        Sway       Heave        Roll       Pitch        Yaw
    *** OrcaFlex QTF Start ***
    Draught OC91
    Direction 90
                           N/A          WP          surge        sway       heave        roll       pitch         yaw
                           0.6283     10.000          0.0         0.0        -0.3         0.5         0.0         0.0
                           1.4784      4.250          0.0        -1.0         0.4         8.0         0.0         0.0
                           1.5708      4.000          0.0        -1.2         0.4        10.0         0.0         0.0
                           1.6755      3.750          0.0        -1.3         0.3        11.0         0.0         0.0
                           1.7952      3.500          0.0        -1.3         0.2        11.6         0.0         0.0
    *** OrcaFlex QTF End ***
    Page    7              Licensee -  Ultramarine, Inc                                      Rev DEVLOP                          Ser201
               ***************************************************************************************************************
               *                                                ***  MOSES   ***                                             *
               *                                                ----------------                         December 18, 2007   *
               *          test of 3d diffraction                                                                             *
               *                                                                                                             *
               ***************************************************************************************************************

                                   +++ M E A N   W A V E   D R I F T   F O R C E S   F O R   O C 9 1 +++
                                   =====================================================================

                                      Drift Name = OC91      Heading = 180.00    Computed by Salvesen

                                             Motion Factor =   0.0000   Force Factor =   1.0000

                                  Process is DEFAULT: Units Are Degrees,  Feet, and  Kips Unless Specified

                                         Mean Drift Force ( With No Factor ) / (Wave Amplitude)**2

                         E N C O U N T E R             T R A N S L A T I O N                  R O T A T I O N
                         --------------------     /-----------------------------/     /-----------------------------/
                          Frequency   Period       Surge        Sway       Heave        Roll       Pitch        Yaw
    *** OrcaFlex QTF Start ***
    Draught OC91
    Direction 180
                           N/A          WP          surge        sway       heave        roll       pitch         yaw
                           0.6283     10.000          0.0         0.0        -0.3         0.0         0.5         0.0
                           1.4784      4.250          1.0         0.0         0.4         0.0         8.0         0.0
                           1.5708      4.000          1.2         0.0         0.4         0.0        10.0         0.0
                           1.6755      3.750          1.3         0.0         0.3         0.0        11.0         0.0
                           1.7952      3.500          1.3         0.0         0.2         0.0        11.6         0.0
    *** OrcaFlex QTF End ***
        

Moses .ppo output – added mass and damping matrices

For demonstration purposes, the data for period 10 seconds have not been marked for import in this example. You can see what text has been added to the data for periods 25 and 3 seconds.

$ MATRICES
    $ Dimensions are Meters   and M-Tons

    *** OrcaFlex Scaling Factor Start ***
    1381.8
    *** OrcaFlex Scaling Factor End ***

    *** OrcaFlex Conventions Start ***
    SurgePositive = aft
    SwayPositive = starboard
    HeavePositive = up
    RollPositiveStarboard = up
    PitchPositiveBow = up
    YawPositiveBow = port
    *** OrcaFlex Conventions End ***

    Frequency     0.2513          Period       25.0000
    Added Mass
    *** OrcaFlex Added Mass Matrix Start  ***
    Draught AnotherDraught
    WP 25
      7.27419E-02 -1.03859E-08 -4.62948E-02  1.69317E-06  2.74299E+00  9.91199E-07
      7.98527E-09  4.70212E-01 -8.07100E-07 -4.60229E+00 -1.13847E-04  3.01228E+01
     -4.62948E-02  1.07046E-06  4.72563E+00 -1.69966E-04 -2.75714E+02 -9.96570E-05
      1.69317E-06 -4.60229E+00 -1.69966E-04  1.37442E+02  1.85538E-02 -2.93111E+02
      2.74299E+00 -1.13847E-04 -2.75714E+02 -1.33822E-02  1.99124E+04 -1.25064E-02
      9.91199E-07  3.01228E+01 -9.96570E-05 -2.93737E+02  1.10314E-02  2.33744E+03
    *** OrcaFlex Added Mass Matrix End ***
    Damping
    *** OrcaFlex Damping Matrix Start ***
    Draught AnotherDraught
    WP 25
      1.13931E-04  3.18018E-10 -1.14519E-02 -2.22923E-09  6.72508E-01 -1.91657E-08
     -5.18165E-10  2.93072E-03  5.20776E-08 -4.37366E-02  4.06262E-06  1.90861E-01
     -1.14519E-02 -3.48886E-08  1.15109E+00  2.24026E-07 -6.75975E+01  1.92522E-06
     -2.22923E-09 -4.37366E-02  2.24026E-07  6.89538E-01 -1.51774E-05 -2.81241E+00
      6.72508E-01  4.06262E-06 -6.75975E+01  5.72135E-04  4.91463E+03  4.37046E-04
     -1.91657E-08  1.90861E-01  1.92522E-06 -2.86780E+00 -1.45733E-04  1.49420E+01
    *** OrcaFlex Damping Matrix End ***
    Frequency     0.3142          Period       10.0000
    Added Mass
      7.26575E-02 -1.05154E-08 -3.88891E-02  1.63635E-06  2.30748E+00  1.29998E-06
      1.16511E-08  4.95352E-01 -1.16804E-06 -4.90549E+00 -1.11450E-04  3.17468E+01
     -3.81700E-02  1.07480E-06  3.98124E+00 -1.64680E-04 -2.31938E+02 -1.30483E-04
      1.63635E-06 -4.90549E+00 -1.64680E-04  1.41316E+02  1.78915E-02 -3.12508E+02
      2.30748E+00 -1.11450E-04 -2.31938E+02 -1.25740E-02  1.67264E+04 -1.22910E-02
      1.29998E-06  3.17468E+01 -1.30483E-04 -3.13248E+02  1.43120E-02  2.46384E+03
    Damping
      1.26489E-04  6.23468E-10 -1.27141E-02 -2.37699E-09  7.45921E-01 -1.14327E-08
     -2.04045E-10  8.85484E-03  2.04453E-08 -1.29779E-01  7.07358E-06  5.76860E-01
     -1.27141E-02 -6.25750E-08  1.27796E+00  2.39656E-07 -7.49767E+01  1.13285E-06
     -2.37699E-09 -1.29779E-01  2.39656E-07  2.00759E+00 -3.17400E-05 -8.34787E+00
      7.45921E-01  7.07358E-06 -7.49767E+01  1.03390E-03  5.44731E+03  7.49781E-04
     -1.14327E-08  5.76860E-01  1.13285E-06 -8.50670E+00 -6.30361E-05  4.51613E+01
    Frequency     2.0944          Period        3.0000
    Added Mass
    *** OrcaFlex Added Mass Matrix Start ***
    Draught AnotherDraught
    WP 3
      6.93807E-02 -1.38449E-08 -2.92718E-02 -3.86817E-06  1.76513E+00  1.71664E-06
      1.72638E-08  2.82871E-02 -1.73413E-06 -6.25036E-02 -1.44301E-04  1.94354E+00
     -8.70653E-03  1.38723E-06  3.01157E+00  3.88882E-04 -1.77423E+02 -1.72574E-04
     -3.86817E-06 -6.25036E-02  3.88882E-04  8.84137E+01 -4.24594E-02 -8.32917E+00
      1.76513E+00 -1.44301E-04 -1.77423E+02  1.03461E-01  1.28932E+04 -1.43709E-02
      1.71664E-06  1.94354E+00 -1.72574E-04 -1.42196E+01  1.88896E-02  1.55396E+02
    *** OrcaFlex Added Mass Matrix End ***
    Damping
    *** OrcaFlex Damping Matrix Start ***
    Draught AnotherDraught
    WP 3
      7.10863E-07  8.57925E-08 -7.14528E-05 -1.19046E-06 -1.34968E-03  1.39262E-05
      1.26454E-07  2.24899E-01 -1.27109E-05 -8.88217E-01  9.38920E-04  1.44738E+01
     -7.14538E-05 -8.61165E-06  7.18222E-03  1.19672E-04  1.35664E-01 -1.39975E-03
     -1.19046E-06 -8.88217E-01  1.19672E-04 -4.46140E-01 -1.31348E-02 -6.04964E+01
     -1.34968E-03  9.38920E-04  1.35664E-01  1.31833E-02 -4.90675E+01  1.02491E-01
      1.39262E-05  1.44738E+01 -1.39975E-03 -7.48632E+01  1.53212E-01  1.10320E+03
    *** OrcaFlex Damping Matrix End ***
        

[Remaining data removed for brevity]