MIKE
MIKE
MIKE
User Guide
MIKE 2017
2 MIKE 21 Mooring Analysis - © DHI
PLEASE NOTE
LIMITED LIABILITY The liability of DHI is limited as specified in Section III of your 'DHI
Software Licence Agreement':
3
4 MIKE 21 Mooring Analysis - © DHI
CONTENTS
5
5.6.1 Port data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
5.6.2 Port view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
5.7 Mooring setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
5.7.1 Vessel position and mooring lines . . . . . . . . . . . . . . . . . . . 44
5.7.2 Mooring line data . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
5.8 Environmental conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
5.8.1 Physical parameters . . . . . . . . . . . . . . . . . . . . . . . . . . 47
5.8.2 Drift forces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
5.8.3 Waves . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
5.8.4 Current . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
5.8.5 Wind . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
5.9 Convergence Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
5.10 Vessel displacements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
5.11 Outputs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
5.12 Convergence output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
5.12.1 Global files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
5.12.2 Vessel specific files . . . . . . . . . . . . . . . . . . . . . . . . . . 56
5.13 Final output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
5.13.1 Global files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
5.13.2 Vessel specific files . . . . . . . . . . . . . . . . . . . . . . . . . . 58
6 References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
6.1 Further reading on MIKE 21 MA and its predecessors . . . . . . . . . . . . . 61
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63
1.1 Purpose
The main purpose of this User Guide is to get you started in the use of the
MIKE 21 Mooring Analysis modelling system, for analysis of moored vessels
(or a floating body in general) subject to wave, current and wind forcings,
whether located in ports, coastal or offshore areas. The effect of breakwaters
and other port structures on the wave field is included in the model
This guide will explain how to operate MIKE 21 MA, which is the final applica-
tion to consider in a mooring analysis workflow.
It is assumed that you are familiar with the basic elements of MIKE Zero: File
types and file editors, the Plot Composer, the MIKE Zero Toolbox, the Data
Viewer and the Mesh Generator. An introduction to these can be found in the
documentation.
7
About this User Guide
To the left is a navigation tree, that shows the structure of the model setup
file, and is used to navigate through the separate sections of the file. By
selecting an item in this tree, the corresponding editor is shown in the central
pane of the setup editor.
The editor for the selected section is shown in the central pane. The content
of this editor is specific for the selected section, and might contain several
property pages.
The MIKE 21 MA editor windows offer the user an overall tool where:
This grants the user an easy-to-use graphically based environment, and the
possibility for a full quantitative analysis of vessel/floating body motions.
Further options may be available in the context menu depending on the sec-
tion being edited.
The bottom pane of the editor shows possible validation errors, and is
dynamically updated to reflect the current status of the setup specifications.
By double-clicking on an error in this window, the editor in which this error
occurs will be selected.
9
About this User Guide
2 Introduction
MIKE 21 MA is an independent software application, which serves the overall
purpose:
The basis for a MIKE 21 MA simulation, is always the output (.vre) file gener-
ated by the associated application Frequency Response Calculator (FRC).
The (.vre) file contains the bundled set of various data relevant for a vessel
submerged to a certain draft (geometric and frequency response data etc.),
all of which is necessary for MIKE 21 MA as input.
MIKE 21 MA will thus always be part of a "double team" together with the
FRC application.
11
Introduction
Figure 3.1 Ship motions in six degrees of freedom: displacements (surge, sway,
heave) and rotations (roll, pitch, yaw)
When ship motions exceed certain criteria, safe working limits and safe moor-
ing limits will eventually be exceeded.Ultimately, damage to the ship and port
installations may occur.
13
Vessel Response Simulations
Fishing vessels
Fishing vessels range from small ships of 10-100 GRT (Gross Register Ton-
nage) up to large trawlers, liners and net boats of 3,000 GRT. These vessels
are mainly moored in their home ports. Fishing vessels are typically moored
with polypropylene lines against truck tire fenders or rubber fenders. Cranes,
elevators and suction pumps are used for unloading.
15
Vessel Response Simulations
Container ships
Container ships are cargo ships that carry all of their load in containers. They
are a common means of commercial freight transport. Containers are loaded
and unloaded using cranes and ship motions that affect container handling
productivity vary with equipment specification, skill of the operator, crane
size, distribution and location of the cranes on the ship and landside opera-
tions. Ref. /3/ provides a more detailed description of container vessels and
the impact of ship motions on container handling productivity.
Bulk carriers are mainly moored with 8 to 10 lines. Mooring lines are attached
to bollards located at the front side of the quay walls.
Oil tankers
Oil tankers are used to transport crude oil and oil products. Oil products are
generally transported in tankers under 70,000 DWT, while crude oil is trans-
ported in high-capacity tankers up to 420,000 DWT. Tankers are loaded and
unloaded through the manifold located in the middle and close to the side of
the ship. A typical berth layout for an oil tanker comprises breasting and
mooring dolphins, and a loading platform. Tankers are moored with spring
lines, breast lines and (optionally) head and stern lines. The mooring lines for
large tankers are in general steel wires and steel wires with nylon tails.
A typical mooring pattern at a tanker terminal is shown in Figure 3.7. This was
derived from OCIMF /4/.This document provides much useful information on
all aspects of offshore moorings.
Berths for large tankers are generally located in deep water at more exposed
locations. Due attention should be given to align a berth with the predominant
wave and current conditions. Tanker motions may be reduced by pre-tension-
ing the breast lines in order to maintain sufficient friction between the ship's
hull and fenders.
17
Vessel Response Simulations
Gas tankers
Gas tankers may range from refrigerated ships of over 100,000 m3 for the
transportation of liquefied natural gas (LNG) and liquefied petroleum gas
(LPG) to small tankers of up to 5,000 m3 for the shipment of propane, butane
and chemical gases in pressure tankers. The berths and mooring arrange-
ments for gas tankers are similar to those of oil tankers. Motions of moored
gas tankers are in particular induced by currents and low-frequency wind and
wave effects. Wind effects on gas tankers are more important compared to oil
tankers because of the higher freeboard and the possible presence of spheri-
cal tankers.
The two most common types of gas tankers likely to be encountered in MIKE
21 MA projects are prismatic and spherical tankers. Prismatic (membrane)
tankers have a relatively wide base with holding tanks mostly contained
below deck level. Spherical (moss) tankers have a relatively narrow base with
holding tanks that extend far above the deck. When modelling tankers it is
essential to check that the correct vessel hull type is being used.
The mooring arrangements for ships moored at berths and terminals com-
prise of the following elements:
Spring lines - these are used to reduce the surge motion of a moored
vessel. These lines should be as parallel as possible to the ship. (PIANC
guidelines /3/ recommend a maximum angle of 10 degrees)
Breast lines - these are used to reduce sway and yaw motions. These
lines should be as perpendicular to the ship as possible and should be
connected to the ship's bollards positioned at the bow and stern
Head and stern lines - these are used in addition to spring and breast
lines to reduce overall ship motions.
19
Vessel Response Simulations
Table 3.1 Recommended Motion Criteria for Safe Working Conditions (PIANC /2/)
Ship Type Cargo Handing Surge Sway Heave Roll Pitch Yaw
Equipment (m) (m) (m) (o) (o ) (o)
Fishing Elevator crane 0.15 0.15 0.4 3 3 3
vessels Lift-on-Lift-off 1.0 1.0
Suction pump 2.0 1.0
Freighters, Ship’s gear 1.0 1.2 0.6 2 1 1
Coasters Quarry cranes 1.0 1.2 0.8 3 1 2
Ferries, Side-rampb 0.6 0.6 0.6 2 1 1
Ro-Ro vessels Dew/storm-ramp 0.8 0.6 0.8 4 1 1
Linkspan 0.4 0.6 0.8 4 2 3
Rail ramp 0.1 0.1 0.4 1 1 -
General Cargo - 2.0 1.5 1.0 5 2 3
Container vessels 100% efficiency 1.0 0.6 0.8 5 2 3
50% efficiency 2.0 1.2 1.2 6 2 1.5
Bulk Carriers Cranes 2.0 0.6 0.8 3 1 1
Elevator/bucket wheel 1.0 0.5 1.0 2 2 2
Conveyor belt 5.0 2.5 3
Oil Tankers Loading arms 3.0c 3.0
Gas Tankers Loading arms 2.0 2.0 2 2 2
Remarks:
a) Motions refer to peak to peak values (except for sway: zero peak)
b) Ramps equipped with rollers
c) For exposed locations 5.0 m (regular loading arms allow large movements)
The full software suite for moored vessel modelling is spanned by:
21
Vessel Response Simulations
4 Examples
One of the best ways of learning how to use a modelling system like the
MIKE 21 Maritime Tools is through practice. Therefore examples are included
which you can go through yourself and which you can modify, if you like, in
order to see what happens if one or the other parameter is changed.
The specification files for the examples are included with the installation of
MIKE Zero in the folder ‘MIKE_21\Maritime\MooringAnalysis’:
The second example in folder '.\2D Wave forcing' is more advanced and
representative of a real-life mooring study and shows the combined
usage of Frequency Response Calculator (FRC) and MIKE 21 MA, when
the vessel is positioned in a geographic based domain and the moored
vessel is affected by a drawdown wave induced by a passing vessel
(two-dimensional (2D) wave).
Note: If you have executed previous models from MIKE Zero project mode,
where the output data is going to be used as input data in a subsequent MIKE
21 MA execution, please be aware that all the result files will be gathered in a
common Result folder next to the (.mzp) file.
This means that if you are running the examples within a MIKE Zero project
mode, then the paths to these files need to be updated, as the default state of
the examples are based on non-project mode, where all output data is stored
in a Result Files folder next to each individual Setup file.
The first of these examples showcase the combined usage of FRC and MIKE
21 MA in order to perform a simple mooring analysis and is presented in short
form in the following sections.
This example demonstrates the work flow for a mooring analysis investigation
using the MIKE 21 Maritime tools. The example calculates vessel motions in
six degrees of freedom of a moored tanker under a time series (0D) of inci-
dent wave conditions. The waves are described by 0D wave forcing, which
represents a horizontal water surface in the entire domain that moves verti-
cally with time.
23
Examples
The details of the input data are described in the MIKE 21 Mooring Analysis
Step-by-step training guide, see MIKE 21 Documentation Index.
The outline of the vessel and defined mooring lines once the model is setup
will be as shown in Figure 4.1.
Figure 4.1 Outline of vessel located at port with specified mooring lines
The first step in any mooring analysis is to obtain frequency response data for
the vessel in question. This is done by using the FRC where you specify the
characteristics of the vessel and common conditions for mooring.
For this example the setup is saved in the file 'Frequency Response
setup.fresponse'.
Vessel configuration
The vessel layout is specified by a vessel grid file (.grd). A grd file is an ascii
file that contains the node positions for all elements describing the vessel out-
line. The vessel is described by the file 'tanker.grd'. A graphical overview illus-
trates the horizontal outline of the vessel as shown in Figure 4.2.
When the vessel grid is loaded, the remaining parameters on the Vessel
Characteristics tab will automatically be supplied with some default values
derived from the vessel hull itself.
Computational settings
This setup use the default settings, i.e. “M21 Mooring Analysis compatible
mode”, using 256 frequencies.
Outputs
All relevant output are per default included.
Note that the Vessel Response output file (.vre) is a binary file and this will be
the basis for the subsequent mooring analysis simulations.
The FRC simulation will take some time depending on how complex the ves-
sel is defined. The simulation for this example will take about 1 hour on a 4
core PC.
Next step is to setup a model describing the vessel and how it is moored to
the port.
When adding mooring lines to the model they will each influence the position
of the ship. Hence an initial simulation is required to find the initial vessel dis-
placement under constant (or low-frequency) governing conditions, leading to
a uniform (pre-set) tension distribution among all mooring lines (described
later in this section).
25
Examples
The various inputs required for such a simulation are described below. The
actual setup for the convergence calculations is saved in the file 'Mooring
Setup.m21ma'.
Domain
Precise domain files displaying the exact positions of berths and breakwater
structures are essential when utilizing 2D environmental forcings in a mooring
study, but for 0D wave data a local domain file with enough spatial extent to
surround the full mooring system will be sufficient.
It is not necessary for the domain file to hold any bathymetry values as they
are not relevant for this simple type of setup, but they can be included to add
to the illustrative layout in the editor, which can easily be exported by right-
clicking on the illustration for reporting. In this example the domain extent is
as illustrated in Figure 4.1.
Time
The simulation time is specified by a start time, time step and number of time
steps.
This example setup is set to simulate wave disturbance during more than one
hour.
Simulation mode
Initially the simulation setup is set to run in Convergence mode in order to
attempt to find the initial vessel displacement under governing constant or
low-frequency conditions, leading to a uniform (pre-set) tension distribution
among all mooring lines.
The result from this mode is entered into the final computation as initial vessel
displacement to ensure a subsequent stable time-domain analysis.
Material profiles
It is necessary to define the properties of each type of line, fender or chain
that is used for the mooring. This entails e.g. total breaking strength for a line
or friction coefficients for a fender, as well as force increment curves for the
given types for fenders and lines specified in (.dfs0) files.
Both a nylon rope and a steel wire are included in this model setup to hold the
ship in position along with fenders.
Vessels
The vessel characteristics defines the given vessel instance and are defined
independently from the mooring setup.
First the vessel response file generated from the previously executed FRC
setup is included. Next additional vessel parameters such as loading condi-
tions and vessel class is specified. Finally, the position of fairleads, winches
and chains on the vessel must be defined. The positions are given in a ship-
Figure 4.3 Vessel view after fairlead and winch positions have been specified
Port data
Similar to the spatial attributes for the vessel, it is necessary to define the
position of bollards and fenders in the port. The coordinates are related to a
map projection. Similar to the vessel, a graphical overview illustrates where
the full set of bollards and fenders are positioned in the domain.
Mooring setup
The mooring setup is where you specify where the ship is located and ori-
ented in the port layout and how the ship is constrained in the port using
mooring lines.
The mooring line data for the present example is illustrated in the graphical
overview as shown in Figure 4.1.
Environmental conditions
The environmental conditions represent the physical conditions and forcings
that applies in the domain where the vessel is located.
This example is only considering the forcings from simpe 0D wave data. As
the convergence mode run does not consider the influence of wave data, no
forces are included here.
Convergence parameters
The convergence parameters control the iteration. In the present example the
values have been defined to obtain a more accurate solution than obtained
by default parameters.
27
Examples
Vessel displacements
The vessel displacements can be considered an initial condition. When exe-
cuting the first convergence simulation the vessel displacement will typically
start from zero.
Convergence output
The convergence process in the simulation can be reviewed by inspecting
various output dfs0 files.
After specifying all the input, ensure that all the data in the (.m21ma) setup
are saved and run the simulation to obtain the initial vessel displacement for
the final mooring analysis. The resulting vessel displacement is saved in the
last time step of the Vessel motion file.
Having calculated the initial vessel displacement, we can move on with the
final time-domain computation.
Normally the initial task is to save the setup file used for convergence calcula-
tions under a new file name, e.g. ‘Final mooring setup.m21ma’ as it is the
case here. Then only a few editions are necessary in order to calculate the
final resulting vessel displacements in time. All variables besides the below
mentioned are kept as in the preceding convergence simulation.
Simulation mode
The simulation mode must be changed to 'Final Computation Mode'.
Environmental Conditions
The environmental conditions are the same as for the convergence run apart
from the wave forcings in the Waves dialog (these can only be applied when
in 'Final Computation mode')
In this example the wave field is constant in domain but varying in time (i.e.
same surface level variations over the domain) and defined by a dfs0 file. The
wave direction is assumed to be 120 true north in the entire simulation
period. The applied surface elevation is shown in Figure 4.4.
Figure 4.4 Water surface elevation time series with a zero warmup period
Vessel Displacements
The convergence simulation saved the vessel displacement in a default out-
put file. By using the same setup file as a template for the present setup file
you should by now see an enabled Load button in the dialog.
Click on this button to populate the six initial vessel displacement fields
(surge, sway, heave, roll, pitch and yaw) from the output file we previously
produced from the convergence mode execution.
This action ensures the final time-domain computation starts from a vessel
state where the pre-tension settings are reflected sufficiently by the vessel's
position.
Final output
The resulting vessel motion and other output parameters are saved in pre-
defined dfs0 files. Here all output files except 'External forces' and 'Chain
forces' are included.
These small changes complete the final mooring setup and you are ready to
simulate the final vessel motion. This simulation will be fast and produces the
relevant output files for the time-domain analysis.
After running the simulation the various results can be evaluated and pre-
sented by various tools within MIKE Zero.
Operability summaries for lines and fenders are given at the end of the
log file. They disclose if the critical load for an individual line or fender is
exceeded or if a line snaps.
Data statistics tools can be used to assess e.g. the maximum move-
ments of the vessel.
29
Examples
Plot composer can plot e.g. the resulting vessel motions in time, see
Figure 4.5.
Figure 4.5 Time series of vessel motions (surge, sway and roll)
31
Examples
5 Reference guide
The MIKE 21 Mooring Analysis (MA) model calculates the response of a ves-
sel subject to external forcings such as waves, currents and winds while con-
sidering the mooring setup.
5.1 Domain
On this dialog you must specify the Domain under consideration (Berth lay-
out). The required input file is a Bathymetry file of (.dfs2) format. Geographic
based map projections where the domain resolution is in degrees are not
supported for the domain file or an extracted area from the entire bathymetry,
which corresponds to size and position of two-dimensional (2D) forcing files
(see Section 5.8).
If using MIKE 21 BW or MIKE 21 Flow Model (both structured grid models) for
modelling of wave generated flux, you should use the Bathymetry file from
these setups as domain file.
The geographical information from the (.dfs2) domain file will be fully inter-
preted and utilized in both the editor and the computational engine, so it is
important that you ensure the geographical information of the (.dfs2) grid is
meaningfully declared, relative to the utilized map projection.
Once the file is loaded you will see the domain in the projection plane associ-
ated with the domain file.
By default the plot extent is set to Automatic, which means that the plot extent
will fit the spatial extent of the domain file. But the plot extent can be user
defined by setting the plot extent to custom, and changing the values of (Min
Easting, Min Northing) and (Max Easting, Max Northing). Increasing the plot
extent can be necessary if certain mooring attributes (Bollards and Fenders)
are located outside the domain.
Note: Advanced interactive features like Pan and Mouse Wheel based
zoom, are available for the most flexible work flow, e.g. when certain details
are to be looked up and inspected. These two features become active when
you click on the plot and hold down the shift key on the keyboard.
5.2 Time
The period to be covered by the simulation is specified on this dialog. You
have to specify the simulation start date, the overall number of time steps and
the overall time step interval.
33
Reference guide
The simulation always starts with time step number 0 and the simulation start-
date is the historical data and time corresponding to time step 0. The simula-
tion end date is presented for reference.
The number of time steps to be included for warm-up and warm-down of the
applied environmental conditions is also to be set. By default the warm
up/down no. of time steps are both 10% of the overall number of time steps.
Convergence mode
Final computation mode
Note: If a convergence mode run is not executed prior to the final time-
domain computation (final computation mode), the mooring system can
cause the vessel to move. This will change the tension in each mooring line.
For unbalanced mooring systems, the vessel response can be so significant
that tension in some lines disappear completely. The subsequent vessel
response in an incident wave/current/wind field will resultantly be significant
different to specified design conditions and will most often be regarded as a
serious flaw in the model setup.
The following additional dialog is specific for the final computation mode:
Waves
In such a study a convergence run only needs to be executed for the first sce-
nario. The resulting vessel displacement can then subsequently be re-used in
all the remaining scenarios. In practice you'd just need to copy the (.m21ma)
setup with final computation mode enabled and correctly set vessel displace-
ment, as many times as you have scenarios, and just update the wave data in
each setup.
These (.dfs0) curves for line stiffness and fender compression can be copied
and used instantly as part of a mooring analysis.
The mooring line stiffness curves have been digitized from OCIMF guidelines
/4/ and the fender compression curves are obtained from Trelleborg manuals.
This dialog allows you to declare a number of material mooring line profiles.
By clicking 'Go to ..' you will be taken to the specific Line instance, where the
specific mooring line data must be declared.
35
Reference guide
Line instance
In the line instance dialog you specify the following properties:
When preparing your own material profile files, the (.dfs0) file must have Axis
Type as Relative Item Axis, and the data should consist of (x-axis)
strain/elongation in [percent] and (y-axis) relative force increment in [percent],
see Figure 5.1.
The full set of data will characterise a certain material line profile, e.g.: steel
wire, polyamide. During simulation the engine will rely on linear interpolation
between the given points in the (.dfs0) file in order to retrieve the relevant line
data from this curve.
The failure load will be used as part of an operability summary in the (.log)
file, and represents the critical load for the line material (as a percentage of
the total breaking strength). The default failure load is 50% of the total break-
ing strength.
Steel wires - Steel wires are stiff, have a high load/diameter ratio and low
elongation proportional to the line reaction force. However, they are diffi-
cult to handle and are not suitable under dynamic conditions. High line
forces occur for small ship displacements and they have a high potential
for breakage.
Combi lines - Combination of steel wires and synthetic tails and are par-
ticularly useful for mooring tankers. These lines have good shock
absorption. Tails in most cases should be no longer than 10m. MIKE 21
MA is able to simulate combi lines.
37
Reference guide
Fender instance
In the fender instance dialog you specify the following properties:
When preparing your own material profiles, the (.dfs0) file must have Axis
Type as Relative Item Axis, and the data should consist of (x-axis) compres-
sion in [percent] and (y-axis) relative force increment in [percent].
This full set of data will characterise a certain fender type (rubber, foam, …).
The engine will rely on linear interpolation in order to retrieve the relevant
fender data from this curve at run-time.
The line and fender response curves can usually be digitised directly from the
manufacturer catalogue. Where unavailable, mooring line information can
often be obtained from /4/.
This dialog allows you to declare a number of material chain profiles. By click-
ing 'Go to ..' you will be taken to the specific Chain instance, where the spe-
cific chain data must be declared.
Chain instance
In the chain instance dialog you specify the following properties:
Max tension
Failure load
Submerged mass
Quadratic damping coefficient
Unlike lines and fenders, the chain profile does not require a (.dfs0) file char-
acteristic to be specified. The full chain type is only characterised by the four
scalar values above.
The failure load will be used as part of an operability summary in the (.log)
file, and represents the critical load for the chain (as percentage of Max ten-
sion). The default failure load is 85% of the maximum tension.
5.5 Vessels
In the vessels dialog you are to select the (.vre) file, which is the main output
file produced by the Frequency Response Calculator (FRC).
When loading the (.vre) file the editor will instantly retrieve the number of ves-
sels and their names, as well as the full geometric data for each vessel.
Vessel data
Spatial attributes
Vessel view
Vessel data
On this tab you specify:
39
Reference guide
1. Bulk Carrier
2. VLCC Cylindrical
3. VLCC Conventional (default)
4. Container
5. General Cargo
6. Gas Carrier Prismatic
7. Gas Carrier Spherical
The vertical parameters will be displayed again, as set in the At this stage
though only the deck plane height can still be edited, if needed.
The deck plane height does not play any computational role in MIKE 21 MA.
The deck plane height only determines the displayed deck plane contour on
the graphical plots of the vessel (red polygon). The deck plane height is thus
a tool for graphical inspection of the vessels extent in the x-y plane at a par-
ticular height above the keel. This is particularly useful when positioning fair-
leads.
Spatial attributes
On this tab you are to specify the XYZ coordinates of full set of the vessel-
fixed spatial attributes for the vessel in question:
Fairleads
Winches
Chains
'Vessel origo at' will determine the reference point on the vessel with respect
to which the XY values are to be provided. The Z coordinates are to be pro-
vided positive upwards from the keel of the vessel for fairleads and winches,
whereas the Z coordinate for chains are with respect to the water line.
The XYZ data for fairleads, winches and chains can be inserted record-by-
record, but can also be imported from an (.xyz) file, where the following
delimiter choices are supported: space, comma and tab.
If importing from an (.xyz) file to populate chain data, a special rule applies,
as the (.xyz) file must contain a total of 6 columns, giving data to the six fields:
X (from), Y (from), Z (from), X (to), Y (to) and Z (to) - 'from' meaning start
point of the chain, and 'to' meaning end point of the chain.
For a chain you must furthermore choose a value for Horizontal force, as well
as selecting a previously declared chain material profile, among the full set of
earlier declared chain profiles, to be associated with the spatial chain.
The symbol orientation for fairlead and winch can be controlled by the value
for ‘Symbol orient’ (0° in the ship coordinate system by default). This symbol
orientation has no computational impact, it is only for making the illustration
more realistic.
Vessel view
On this tab you can see the full set of declared vessel-fixed Fairleads,
Winches and Chains plotted on top of the vessel contours for deck plane
height (editable) and water line (fixed at this stage).
This plot offers an interactive feature, allowing you to select (by choosing the
select mode radio button) on any given Fairlead, Winch or Chain. The table
record for the selected attribute will then be displayed in the lower part of the
dialog, and you can then edit the property of the selected attribute.
Note: Advanced interactive features like Pan and Mouse Wheel based
zoom, are available for the most flexible work flow. The features can be uti-
lized during any graphical activity, e.g. selection of attributes or when certain
details are to be looked up and inspected. These two features becomes
active when you click on the plot and hold down the shift key on the keyboard.
Port data
41
Reference guide
Port view
On this dialog you are to provide the data for port-fixed attributes relevant for
a mooring arrangement: bollards and port-fixed fenders.
The XYZ data for bollards and fenders can be inserted record-by-record, but
can also be imported from an (.xyz) file, where the following delimiter choices
are supported: space, comma and tab.
For each fender you furthermore have to provide a direction in which the
fender force works, as well as associating the spatial fender with one of the
earlier declared fender material profiles.
The fender force must point towards the vessel and it’s direction is defined as
counter-clockwise positive from Easting axis (going to), see Figure 5.4.
The symbol orientation for bollards and fender can be controlled by the value
for ‘Symbol orient’ (90° by default for bollards and 0° by default for fenders).
The port coordinate system is in the Domain dialog - see Section 5.1.These
symbol orientations have no computational impact, it is only for making the
illustration more realistic (symbol orientation relative to the domain).
On this tab you can see the full set of specified port-fixed bollards and fend-
ers plotted on top of the (.dfs2) domain file as provided on the Domain dialog,
as shown in Figure 5.5.
If bollards and fenders are declared, but you cannot see them on the Port
view tab, it is likely because there is a mismatch between the horizontal coor-
dinates for the Fenders and Bollards, relative to the geographical information
in and the extent of the domain file. As a user you must be cautious about
consistency in horizontal coordinates and projections.
To see the full set of bollards and fenders you might also need to increase the
plot extent.This is controlled on the Domain dialog.
This plot offers an interactive feature, allowing you to select (by clicking) on
any given bollard or fender. The table record for the selected attribute will
then be displayed in the lower part of the dialog, and you can then edit the
property of the selected attribute.
Note: Advanced interactive features like Pan and Mouse Wheel based
zoom, are available for the most flexible work flow. The features can be uti-
lized during any graphical activity, e.g. selection of attributes or when certain
details are to be looked up and inspected. These two features become active
when you click on the plot and hold down the shift key on the keyboard.
43
Reference guide
On this tab you will see the domain as a background layer with the earlier
declared bollards and fenders. The toolbar grants you the necessary func-
tionality to insert the vessel into the domain as desired.
Position vessel
The vessel position is provided according to a given Map projection. The fol-
lowing rules apply:
The position type reflects which reference point on the vessel you insert into
the domain. For the moment we only support 'amidship in domain'.
Rotation type reflects how the vessel rotation is to be interpreted. For the
moment we only support 'Counter clockwise from Easting', meaning this is
the convention for a positive rotation value.
When clicking Apply, the specified state for vessel position and rotation will be
effectuated. If editing the latest specified state for position and rotation, the
Apply button will be active again (indicating that a new state has been
declared).
When finished positioning the vessel, you should see the vessel meaningfully
positioned somewhere in the Domain/Berth layout. An example view is given
in Figure 5.6.
Two icons exist for the insertion and deletion of Vessel-Berth lines:
Insert line
Delete line
If lines are specified incorrectly, they can be deleted at any time by clicking
the delete line icon and subsequently clicking on the graphical symbol repre-
senting the full vessel-berth line. Figure 5.7shows an example for inserting
mooring lines.
This plot offers an interactive feature, allowing you to select (by clicking) on
any given Vessel-Berth Line. The data record for the selected line will then be
displayed in the lower part of the dialog, and you can then edit the property of
the selected line. This functionality is useful when you need to set the correct
line and tail profile, and line pretension and tail length for each spatial line.
Note: Advanced interactive features like Pan and Mouse Wheel based
zoom, are available for the most flexible work flow. The features can be uti-
lized during any graphical activity: vessel-berth line insertion/deletion, selec-
tion of attributes or when certain details are to be looked up and inspected.
These two features become active when you click on the plot and hold down
the shift key on the keyboard.
45
Reference guide
On this tab you can see the full set of data representing all declared Vessel-
Berth mooring lines.
When inserting mooring lines interactively, the line profile will by default be
the first line material profile. The line pretension will per default be 10 tons
and there will by default not be a tail profile. Changes to this must be made in
either the full Vessel-Berth Mooring lines table or by selecting and editing
each line data record individually on the vessel position and mooring lines
tab.
Alternatively, you can also specify the full set of Vessel-Berth Mooring lines
manually record-by-record directly from the Vessel-Berth lines table, and go
see the consequence on the graphical plot on the Vessel position and moor-
ing lines tab. But the easiest way to define mooring lines is to define them
interactively one by one, and subsequently edit their properties individually by
selecting them and afterwards edit them.
Note: The tail lines should always be more elastic than the mooring line. Tails
are added to the end of mooring lines to increase the overall elasticity of the
mooring system.
Here you can specify the values of densities and kinematic viscosities of
water and air, using other than their default values, if needed.
It is only possible to include Drift Forces, if 2nd order wave drift force data
exists in the (.vre) file (e.g. if this phenomenon was included in the previously
executed FRC simulation). Otherwise the 'Include wave drift forces' checkbox
is disabled.
Since drift forces rely on wave data, inclusion of drift forces will require you to
specify wave data.
5.8.3 Waves
The first order wave forcing conditions applying in the domain can be speci-
fied on the Wave dialog.
In Final computation mode (see Section 5.3.2), the first order wave forcing
will be taken fully into account in the wave pressure computation on the ves-
sel hull. This should only be done when an initial vessel displacement has
been achieved in advance, from running a previous simulation in conver-
gence mode.
In Convergence mode (see Section 5.3.1), the first order wave forcing will
be ignored in the wave pressure computation on the vessel hull. In Conver-
gence mode the first order wave forcing can only be provided if including drift
forces, and the first order wave forcing data will for this mode only be applied
implicitly as part of the 2nd order drift forces computation.
By default the wave data is set to be included in the warm up and warm down
durations as specified on the Time dialog.
47
Reference guide
Drift forces
If 2nd order wave drift forces are available and included, it is required that
wave data is provided in order to support the computation of drift forces.
If the wave file furthermore is specified as ‘Varying in time and domain’, you
must also provide the Mean wave direction.
Number of waves determines how many wave item pairs (wave direction, sur-
face elevation) the wave file must contain. For example, you can chose to
have two, when distinguishing between wind-induced waves and swell
waves.
The directional data for each wave in this format is interpreted as clockwise
positive from true north (coming from) as seen in Figure 5.8:
For this format you must provide three items, which should represent a pure
wave induced flux field:
This file must come from a pre-executed MIKE 21 model, e.g. MIKE 21 BW,
MIKE 21 Flow Model or MIKE 21 Flow Model FM.
Then the wave input file is already in (.dfs2) format, and can be used
instantly here.
Then the wave data will be in (.dfsu) file format, so you must convert it to
(.dfs2) format (using the MIKE Zero Toolbox) and very importantly
ensure that this resulting (H,P,Q) (.dfs2) file matches the utilized (.dfs2)
domain file in horizontal and vertical cell extent.
For a (.dfs2) wave file, there are associated frequency limits. By default the
frequency band is [0, 0.5] hertz, which is the frequency band of induced flux
due to wave motion.
Unlike all other MIKE 21 models, the M21 MA engine does not simply interpo-
late the wave data to each computational time step in the simulation period,
during the simulation.
Instead the wave data plays an implicit role in the computation, as it is the
foundation for the computation of the diffraction forces the vessel hull is
exposed to due to the wave induced pressure. The engine interpolates the
computed diffraction force to each computational time step, see Figure 5.9.
49
Reference guide
The computation of diffraction forces on the vessel hull takes place in the fre-
quency domain, through usage of FFT and the IFFT (Inverse Fast Fourier
Transformation) algorithms.
In signal processing terms, the wave file thus represents the available full
sample (of wave steps), which the FFT can resolve into a discrete spectrum
of frequency bins. The more points (wave steps) included in the FFT, the
more frequency bins will be available to identify the frequency spectrum of
the sample.
The precision/quality of the wave forcing computation on the vessel hull (dif-
fraction force), will thus strongly depend on how many wave steps are
included in the FFT.
The Min. FFT size (2^N) on the Waves GUI grants the user a tool for con-
trolling how many Wave steps are to be processed in FFT/IFFT. It has the
interpretation:
The minimum number of steps from the wave file, covering the simula-
tion period, required to resolve all the wave frequencies and be pro-
cessed in the FFT/IFFT.
The M21 MA engine identifies the specific wave steps to be FFT/IFFT pro-
cessed using the following steps:
1. Find the largest interval of 2^N wave steps covering the simulation
period ≥ Min. FFT Size (2^N)
How to set the Min. FFT Size (2^N) will depend on the individual case. There
are two possibilities, which are presented in the following.
Case 1: Simulation period and wave file period are identical or almost identi-
cal
Given that the wave file contains sufficiently many steps to resolve the waves
full frequency content by FFT/IFFT (general recommendation of minimum
wave steps is 4096), then the Min. FFT Size (2^N) will not play a role here.
Because the simulation and the wave covers the same time axis extent, the
engine will use a sufficient amount of wave steps for FFT/IFFT (regardless of
how they're identified), hence the diffraction forces used in the simulation will
be computed as precise as possible. This case is illustrated in Figure 5.10.
It is in cases like these where the Min. FFT Size (2^N) will be most relevant
to apply.
Here the simulation duration is small, but in order to produce diffraction force
data for the simulation timesteps of sufficient quality (include enough steps
for FFT/IFFT), many more wave steps than what just covers the simulation
period is needed to be processed.
Here a sufficiently high Min. FFT Size (2^N) will help ensure that enough
wave steps will be processed in FFT/IFFT for the diffraction forces to be com-
puted with appropriate accuracy. This case is illustrated in Figure 5.11.
Recommendation: In order for the FFT to capture enough of the waves fre-
quency content, it must be assessed if enough wave steps cover the simula-
tion period. If this is not the case, then the Min. FFT Size (2^N) should be
increased to a value assessed to be high enough to capture enough fre-
quency content (the general recommendation of minimum number of wave
steps is 4096).
51
Reference guide
5.8.4 Current
By default the current data is set to be included in the warm up and warm
down durations as specified on the Time dialog.
If providing the current field as Speed and direction, the direction is inter-
preted as clockwise positive from true north (going to) as seen in Figure 5.12.
Regardless of how the current field is given, both of these formats are sup-
ported:
At the bottom of the Current dialog, you are to enter drag coefficients for Rear
and Front of each vessel, if specifying the current field in (.dfs2) format.
The Drag coefficients are dependent on the Water depth/Draft ratio, and the
recommended values are as shown in Table 5.1.
5.8.5 Wind
By default the wind data is set to be included in the warm up and warm down
durations as specified on the Time dialog.
If providing the wind field as Speed and direction, the direction is interpreted
as clockwise positive from true north (coming from) as seen in Figure 5.13.
Regardless of how the wind field is given, both of these formats are sup-
ported:
53
Reference guide
Max no. iterations is by default set to 100, and this value represents the upper
limit of iterations used in a convergence mode simulation.
Each iteration in convergence mode consists of running the simulation with
the specified number of time steps and mooring and environmental forcing
conditions (wave forcing excluded). Each iteration leads to a new vessel dis-
placement, which is then input in the next iteration. This iterative procedure
will stop when line convergence is reached.
If
Any initial values for Surge, Sway, Heave, Roll, Pitch and Yaw can be speci-
fied, but the idea is that this data should come from the results of a previous
Convergence mode execution.
If a vessel motion file exists from a convergence mode execution, the Load
button will be active and if clicked it will transfer the data from the last iteration
of the vessel motion file to the table.
It may take more than one convergence simulation to actually obtain conver-
gence. In such cases previous convergence vessel displacements can be
loaded, so that the next convergence simulation builds on top of previous
convergence results instead of starting from zero displacements.
5.11 Outputs
Two classes of outputs can be generated by MIKE 21 MA dependent on the
Simulation mode:
Convergence output
Final output
If running the final simulation you must load in the final vessel displacement
from the convergence results.
These files are all (.dfs0) files with a Relative Item axis. The x-axis will contain
integers corresponding to elapsed iterations, and the y-axis will contain the
item data.
It is not possible in advance to tell how many iteration steps the convergence
output files will contain. If convergence is never reached, the files will contain
the maximum number of iterations (see Section 5.9), whereas if convergence
does set in, then output files will contain steps up to the iteration step at the
point of convergence.
This output file can only be included if mooring lines are defined (see Section
5.7.1).
55
Reference guide
Line forces:
This file contains an item for every specified spatial mooring line, showing the
dynamic computed line force of each iteration.
This output file can only be included if lines are defined (see Section 5.7.1).
Fender forces:
This file contains an item for every specified spatial fender, showing the
dynamic computed fender force as a function of the iteration number.
This output file can only be included if there are fenders defined (see Section
5.6).
Vessel motion:
This file contains 6 items for the six degrees of freedom for each vessel. The
last iteration step in this file contains (if convergence is reached) the most
important result of the convergence mode execution: the initial vessel dis-
placement leading to a (sufficiently) even tension distribution among all the
mooring lines.
It is this result which is important to get transferred to the initial vessel dis-
placement dialog, when continuing with the Final time-domain simulation.
This output file can only be included if there are mooring lines, fenders or
chains defined (see Sections 5.5.1, 5.6.1 and 5.7.1, respectively).
External forces:
For every external forcing applied (wind, current and 2nd order drift forces)
this file will contain 6 items (3 force items, 3 direction items), thus represent-
ing the force from each external forcing on the vessel.
This output file can only be included if a current or a wind field or drift forces
are included.
Chain forces:
This file will contain as many items as there are chains declared. The files
display the chain force for each.
This output file can only be included if there are chains defined (see Section
5.5.1).
These files are all (.dfs0) files with an Equidistant Calendar Axis. The x-axis
will contain the time line extent as specified on the Time dialog, and the y-axis
will contain the item data (see Section 5.2).
Line forces:
This file contains an item for every specified mooring line, showing the
dynamically computed line force at each time step.
This output file can only be included if number of mooring lines > 0.
Fender forces:
This file contains an item for every specified spatial fender, showing the
dynamic computed fender force as a function of time.
This output file can only be included if fenders are defined (see Section
5.6.1).
57
Reference guide
Vessel motion:
This file contains 6 items for the six degrees of freedom for each vessel, as a
function of time.
This output file can only be included if mooring lines, fenders or chains are
defined (see Sections 5.5.1, 5.6.1 and 5.7.1, respectively).
External forces:
For every external forcing applied (wind, current and 2nd order drift forces)
this file will contain 6 items (3 force items, 3 direction items), thus represent-
ing the force from each external forcing on the vessel for each time step.
This output file can only be included if a current or wind or drift forces are
included.
Surface elevation:
This file contains the surface elevation at the vessels midpoint for each time
step.
Diffraction force:
This file contains 6 items (3 force items, 3 direction items) representing the
diffraction force on the vessel for each time step.
Chain forces:
This file will contain as many items as there are chains declared. The file dis-
plays the chain force evolution for each time step.
This output can only be include if chains are defined (see Section 5.5.1).
59
Reference guide
6 References
/1/ Christensen, E.D., Jensen, B., Mortensen, S., Hansen, H.F. and Kir-
kegaard J. 2008, Numerical Simulation of Ship Motion in Offshore
and Harbour Areas, OMAE2008-57206, Proc. ASME 27th Int. Conf.
on Offshore Mechanics and Arctic Engineering, Estoril, Portugal
Bingham, H.B., 2000, A hybrid Boussinesq panel method for predicting the
motion of a moored ship. Coast. Eng. 40, 21–38.
Brüning, A.et. al., 2011, A hybrid modelling approach for floating breakwater
dimensioning, 5th International Short Conference on Applied Coastal
Research 2011.
Brüning, A. et. al., 2014, Assessing mooring forces at an offshore wind termi-
nal in Bremerhaven, Germany, PIANC World Congress San Francisco USA.
Hansen, H.F. et al., 2009, Multi vessel interaction in shallow water, Proceed-
ings of the 28th International Conference on Ocean, Offshore and Arctic
Engineering OMAE2009 , Honolulu, Hawaii, USA, May 31 - June 5, 2009.
Jensen, B., Hansen, H.F. and Kirkegaard, J., 2015, Estimating Quadratic
Transfer Functions for Floating Structures using Model Test Data from Irregu-
lar Sea States, Proceedings of the Twenty-fifth (2015) International Ocean
61
References
and Polar Engineering Conference, Kona, Big Island, Hawaii, USA, June 21-
26, 2015
Kerper, D. et. al., 2017, Nearshore FSO Response under Rapidly Varying
Landslide Tsunami Hydrodynamic Loads, Proceedings of the Twenty-seventh
(2017) International Ocean and Polar Engineering Conference, San Fran-
cisco, CA, USA, June 25-30, 2017
63
Index
B G
bollards . . . . . . . . . . . . . 19, 42 gas tankers . . . . . . . . . . . . . .18
breast lines . . . . . . . . . . . 17, 19 General cargo vessel . . . . . . . .40
breasting dolphins . . . . . . . . . . 19
bulk carrier . . . . . . . . . . . . . . 40 H
bulk carriers . . . . . . . . . . . . . 16 head lines . . . . . . . . . . . .17, 19
Heave . . . . . . . . . . . . . . . .13
C horizontal force . . . . . . . . . . . .41
cargo vessels . . . . . . . . . . . . 15
chain forces . . . . . . . . . . . 57, 59 I
chains . . . . . . . . . . . . . . . . 40 IFFT . . . . . . . . . . . . . . .50, 51
coasters . . . . . . . . . . . . . . . 14 inverse fast Fourier transformation
combi lines . . . . . . . . . . . . . . 37 (IFFT) . . . . . . . . . . . . . . . .50
container ship . . . . . . . . . . . . 40
container ships . . . . . . . . . . . 16 K
convergence . . . . . . . . . . . . . 34 kinematic viscosities . . . . . . . . .47
convergence mode . . . . . . . . . 34
convergence threshold . . . . . . . 54 L
length between perpendiculars (LPP) .
D 39
deflection . . . . . . . . . . . . . . 38 line forces . . . . . . . . . . . .56, 57
degrees of freedom . . . . . 13, 20, 56 line profile . . . . . . . . . . . . . .36
diffraction force . . . . . . . . . . . 59 line stiffness . . . . . . . . . . . . . 35
Domain . . . . . . . . . . . . . . . 33 linear damping coefficient . . . .36, 38
drag coefficient . . . . . . . . . . . 53 lines . . . . . . . . . . . . . . . . .36
dry bulk carriers . . . . . . . . . . . 16 loading conditions . . . . . . . . . .39
longitudinal area . . . . . . . . . . .39
E
external forces . . . . . . . . . . 57, 58 M
map projections . . . . . . . . . . .33
F material characteristics . . . . . . . .35
failure deflection . . . . . . . . . . . 38 mooring force . . . . . . . . . .57, 58
failure load . . . . . . . . . . . . 36, 39 mooring hooks . . . . . . . . . . . .19
fairleads . . . . . . . . . . . . . . . 40 mooring line . . . . . . . . . . . . . 45
fast Fourier transformation (FFT) . . 47 mooring lines . . . . . . . . . . . . .19
fender compression . . . . . . . . . 35 motion criteria for safe working
fender forces . . . . . . . . . . . . . 56 conditions . . . . . . . . . . . . . .20
fender friction coefficient . . . . . . . 38 multibody moorings . . . . . . . . .19
fenders . . . . . . . . . . . . 19, 38, 42
ferries . . . . . . . . . . . . . . . . 15 N
FFT . . . . . . . . . . . 47, 49, 50, 51 natural fibre lines . . . . . . . . . . .37
final computation mode . . . . . 34, 35 nylon lines . . . . . . . . . . . . . .37
nylon ropes . . . . . . . . . . . . . 15 V
vessel class . . . . . . . . . . . . . 39
O vessel motion . . . . . . . . . . 56, 58
offshore moorings . . . . . . . . . 19 VLCC conventional . . . . . . . . . 40
oil tankers . . . . . . . . . . . . . . 16 VLCC cylindrical . . . . . . . . . . . 40
P W
pitch . . . . . . . . . . . . . . . . . 13 warm-up . . . . . . . . . . . . . . . 34
polypropylene lines . . . . . 14, 15, 37 winches . . . . . . . . . . . . . 19, 40
prismatic (membrane) tankers . . . 18
Prismatic gas carrier . . . . . . . . 40 Y
yaw . . . . . . . . . . . . . . . . . 13
Q
quadratic damping coefficient . 36, 39
R
reaction force . . . . . . . . . . . . 38
roll . . . . . . . . . . . . . . . . . 13
Ro-Ro vessels . . . . . . . . . . . 15
rubber fenders . . . . . . . . . . . 14
S
ship motions . . . . . . . . . . . . 13
single point moorings (SPM) . . . . 19
spherical (moss) tankers . . . . . . 18
Spherical gas carrier . . . . . . . . 40
spring lines . . . . . . . . . . . 17, 19
steel wires . . . . . . . . . . . 15, 37
stern lines . . . . . . . . . . . . 17, 19
submerged mass . . . . . . . . . . 39
surface elevation . . . . . . . . . . 58
surge . . . . . . . . . . . . . . . . 13
sway . . . . . . . . . . . . . . . . 13
synthetic fibre lines . . . . . . . . . 37
T
tail line . . . . . . . . . . . . . . . 46
tails . . . . . . . . . . . . . . . . . 37
tension . . . . . . . . . . . . . . . 39
terylene lines . . . . . . . . . . . . 37
torm bitts . . . . . . . . . . . . . . 19
total breaking strength . . . . . . . 36
transverse area . . . . . . . . . . . 39
truck tire fenders . . . . . . . . . . 14
65
Index