<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
	<head>
		<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
		<link type="text/css" rel="stylesheet" href="doxygen.css"/>
		<link type="text/css" rel="stylesheet" href="tabs.css"/>
	</head>
	<body>
	<div>
<!-- Generated by Doxygen 1.8.5 -->
</div><!-- top -->
<div class="header">
  <div class="headertitle">
<div class="title">Body Data Specification </div>  </div>
</div><!--header-->
<div class="contents">
<div class="toc"><h3>Table of Contents</h3>
<ul><li class="level1"><a href="#ug_body_body_type">Body type</a><ul><li class="level2"><a href="#ug_body_body_type_import_position_file">Body type 4 - Import position from file</a></li>
<li class="level2"><a href="#ug_body_body_type_import_position_hla">Body type 4 - Import position from HLA</a></li>
<li class="level2"><a href="#ug_body_body_type_articulated">Body type 4 - Articulated structural member</a><ul><li class="level3"><a href="#ug_body_body_type_articulated_predefined">Predefined run</a></li>
<li class="level3"><a href="#ug_body_body_type_articulated_import">Import displacements from HLA</a></li>
</ul>
</li>
<li class="level2"><a href="#ug_body_body_type_hla">HLA export of body position, velocity and acceleration</a></li>
</ul>
</li>
<li class="level1"><a href="#ug_body_initial">Initial position</a></li>
<li class="level1"><a href="#ug_body_geometry">Geometry data</a></li>
<li class="level1"><a href="#ug_body_mass">Mass Data</a><ul><li class="level2"><a href="#ug_body_mass_structure">Structure mass</a></li>
<li class="level2"><a href="#ug_body_mass_gravity">Gravity force</a></li>
<li class="level2"><a href="#ug_body_mass_added">Added mass</a></li>
<li class="level2"><a href="#ug_body_mass_time">Time dependent mass (TDM)</a></li>
</ul>
</li>
<li class="level1"><a href="#ug_body_retardation">Retardation function</a></li>
<li class="level1"><a href="#ug_body_hydrostatic">Hydrostatic stiffness</a></li>
<li class="level1"><a href="#ug_body_nonlinear">Nonlinear modification of buoyancy and wave forces</a></li>
<li class="level1"><a href="#ug_body_linear_damping">Linear damping</a></li>
<li class="level1"><a href="#ug_body_quadratic_damping">Quadratic damping</a></li>
<li class="level1"><a href="#ug_body_fist_wave">First-order wave force transfer functions</a></li>
<li class="level1"><a href="#ug_body_first_motion">First-order motion transfer functions (RAO)</a></li>
<li class="level1"><a href="#ug_body_wind_force">Wind force coefficients</a></li>
<li class="level1"><a href="#ug_body_diffracted">Diffracted wave transfer functions in points</a><ul><li class="level2"><a href="#ug_body_diffracted_hla">HLA export or visualisation of diffracted wave elevation</a></li>
</ul>
</li>
<li class="level1"><a href="#ug_body_linear_current">Linear current coefficients</a></li>
<li class="level1"><a href="#ug_body_quadratic_current">Quadratic current coefficients</a></li>
<li class="level1"><a href="#ug_body_second_drift">Second-order wave drift coefficients</a><ul><li class="level2"><a href="#ug_body_second_drift_wave">Wave drift damping</a></li>
<li class="level2"><a href="#ug_body_second_drift_simplified">Simplified method (ICOF=1)</a></li>
<li class="level2"><a href="#ug_body_second_drift_newman">Newman’s method (ICOF=2)</a></li>
</ul>
</li>
<li class="level1"><a href="#ug_body_second_force">Second-order wave force transfer functions</a></li>
<li class="level1"><a href="#ug_body_distributed">Distributed element forces</a><ul><li class="level2"><a href="#ug_body_distributed_slender">Slender elements</a><ul><li class="level3"><a href="#ug_body_distributed_slender_application">Application of diffracted waves</a></li>
<li class="level3"><a href="#ug_body_distributed_slender_depth">Depth dependent scaling of hydrodynamic coefficients</a></li>
<li class="level3"><a href="#ug_body_distributed_slender_wind">Wind force on slender element.</a></li>
</ul>
</li>
<li class="level2"><a href="#ug_body_distributed_fixed">Fixed body element</a><ul><li class="level3"><a href="#ug_body_distributed_fixed_application">Application of diffracted waves</a></li>
<li class="level3"><a href="#ug_body_distributed_fixed_depth">Depth dependent scaling coefficients</a></li>
<li class="level3"><a href="#ug_body_distributed_fixed_wind">Wind force on fixed body element.</a></li>
</ul>
</li>
</ul>
</li>
<li class="level1"><a href="#ug_body_small">Small body hydrodynamic data (including soil penetration)</a><ul><li class="level2"><a href="#ug_body_small_depth">Depth dependent hydrodynamic forces</a></li>
<li class="level2"><a href="#ug_body_small_application">Application of diffracted waves</a></li>
<li class="level2"><a href="#ug_body_small_soil">Soil penetration model</a></li>
</ul>
</li>
<li class="level1"><a href="#ug_body_specified">Specified forces</a></li>
<li class="level1"><a href="#ug_body_general">General external forces</a></li>
<li class="level1"><a href="#ug_body_wind_turbine">Wind turbine specification</a></li>
<li class="level1"><a href="#ug_body_vawt">Vertical axis wind turbine specification</a></li>
<li class="level1"><a href="#ug_body_positioning">Positioning system data</a><ul><li class="level2"><a href="#ug_body_positioning_catenary">Catenary anchor lines</a></li>
<li class="level2"><a href="#ug_body_positioning_force">Force elongation with fixed attack points</a></li>
<li class="level2"><a href="#ug_body_positioning_docking">Docking cone positioning</a></li>
<li class="level2"><a href="#ug_body_positioning_fender">Fender</a></li>
<li class="level2"><a href="#ug_body_positioning_bumper">Bumper element data</a></li>
<li class="level2"><a href="#ug_body_positioning_thrusters_deprecated">Thrusters (Deprecated model)</a></li>
<li class="level2"><a href="#ug_body_positioning_thrusters">Thruster sytem</a></li>
<li class="level2"><a href="#ug_body_positioning_lift">Lift and drag force</a></li>
<li class="level2"><a href="#ug_body_positioning_dynamic_deprecated">Dynamic positioning data (Deprecated model)</a></li>
<li class="level2"><a href="#ug_body_positioning_dynamic">Dynamic positioning</a></li>
</ul>
</li>
<li class="level1"><a href="#ug_body_body_components">Body components</a><ul><li class="level2"><a href="#ug_body_body_components_control">Control of fixed coupling point</a></li>
<li class="level2"><a href="#ug_body_body_components_connectable">Connectable fixed coupling point</a></li>
<li class="level2"><a href="#ug_body_body_components_motion">Motion compensator at fixed coupling point</a><ul><li class="level3"><a href="#ug_body_body_components_motion_simo">SIMO heave compensator</a></li>
<li class="level3"><a href="#ug_body_body_components_motion_dll">DLL heave compensator</a></li>
</ul>
</li>
<li class="level2"><a href="#ug_body_body_components_tensioner">Tensioner at fixed coupling point</a></li>
<li class="level2"><a href="#ug_body_body_components_winch">Winch at fixed coupling point</a></li>
<li class="level2"><a href="#ug_body_body_components_guide">Guide point</a></li>
</ul>
</li>
<li class="level1"><a href="#ug_body_generic">Generic External Control System</a></li>
</ul>
</div>
<div class="textblock"><p><a class="anchor" id="body_data_specification"></a> This data group is given once for each body to be included in the simulation. It represents the start of all data related to a body. Consequently, this data group must be given first, for each body.</p>
<p>For the different body types there are restrictions on the data types to be specified on the system description file. Mandatory means that the data group must be given, allowed means that the data group can be given, dummy means that the data group can be given, but is not used for <code>STAMOD</code> or <code>DYNMOD</code> calculations.</p>
<table class="doxtable">
<tr>
<th align="center">Data group identifier </th><th align="center">IBDTYP 1 </th><th align="center">IBDTYP 2 </th><th align="center">IBDTYP 3  </th></tr>
<tr>
<td align="center">BODY LOCAtion DATA </td><td align="center">Mandatory </td><td align="center">Mandatory </td><td align="center">Mandatory </td></tr>
<tr>
<td align="center">BODY GEOMetry DATA </td><td align="center">Allowed </td><td align="center">Allowed </td><td align="center">Allowed </td></tr>
<tr>
<td align="center">BODY MASS DATA </td><td align="center">Allowed </td><td align="center">Allowed </td><td align="center">Allowed </td></tr>
<tr>
<td align="center">MASS COEFficients </td><td align="center">Allowed </td><td align="center">Allowed </td><td align="center">Allowed </td></tr>
<tr>
<td align="center">TIME DEPEndent MASS </td><td align="center">Allowed </td><td align="center">Allowed </td><td align="center">Allowed </td></tr>
<tr>
<td align="center">ADDEd MASS ZERO </td><td align="center">Not allowed </td><td align="center">Allowed </td><td align="center">Not allowed </td></tr>
<tr>
<td align="center">ADDEd MASS INFInite </td><td align="center">Allowed </td><td align="center">Not allowed </td><td align="center">Not allowed </td></tr>
<tr>
<td align="center">RETArdation FUNCtion </td><td align="center">Allowed </td><td align="center">Dummy </td><td align="center">Not allowed </td></tr>
<tr>
<td align="center">HYDRostatic STIFfness DATA </td><td align="center">Allowed </td><td align="center">Allowed </td><td align="center">Allowed </td></tr>
<tr>
<td align="center">LINEar DAMPing </td><td align="center">Allowed </td><td align="center">Allowed </td><td align="center">Allowed </td></tr>
<tr>
<td align="center">QUADratic DAMPing </td><td align="center">Allowed </td><td align="center">Allowed </td><td align="center">Allowed </td></tr>
<tr>
<td align="center">FIRSt ORDEr WAVE force tr. f. </td><td align="center">Allowed </td><td align="center">Dummy </td><td align="center">Not allowed </td></tr>
<tr>
<td align="center">FIRSt ORDEr MOTIon tr. f. </td><td align="center">Dummy </td><td align="center">Allowed </td><td align="center">Not allowed </td></tr>
<tr>
<td align="center">FIRSt ORDEr DIFFracted wave tr. f. </td><td align="center">Allowed </td><td align="center">Allowed </td><td align="center">Not allowed </td></tr>
<tr>
<td align="center">WIND FORCe COEFficients </td><td align="center">Allowed </td><td align="center">Allowed </td><td align="center">Not allowed </td></tr>
<tr>
<td align="center">LINEar CURRent COEFficients </td><td align="center">Allowed </td><td align="center">Allowed </td><td align="center">Allowed </td></tr>
<tr>
<td align="center">QUADratic CURRent COEFficients </td><td align="center">Allowed </td><td align="center">Allowed </td><td align="center">Not allowed </td></tr>
<tr>
<td align="center">SECOnd ORDEr WAVE drift forces </td><td align="center">Allowed </td><td align="center">Allowed </td><td align="center">Not allowed </td></tr>
<tr>
<td align="center">WAVE DRIFt DAMPing </td><td align="center">Allowed </td><td align="center">Allowed </td><td align="center">Not allowed </td></tr>
<tr>
<td align="center">QUADratic TRANsfer FUNCtions </td><td align="center">Allowed </td><td align="center">Allowed </td><td align="center">Not allowed </td></tr>
<tr>
<td align="center">SMALl BODY HYDRodynamic data </td><td align="center">Allowed </td><td align="center">Not allowed </td><td align="center">Allowed </td></tr>
<tr>
<td align="center">DISTributed ELEMent FORCes </td><td align="center">Allowed </td><td align="center">Allowed </td><td align="center">Not allowed </td></tr>
<tr>
<td align="center">SPECified FORCes </td><td align="center">Allowed </td><td align="center">Allowed </td><td align="center">Allowed </td></tr>
<tr>
<td align="center">POSItioning SYSTem DATA </td><td align="center">Allowed </td><td align="center">Allowed </td><td align="center">Allowed </td></tr>
<tr>
<td align="center">BODY COMPonent </td><td align="center">Allowed </td><td align="center">Allowed </td><td align="center">Allowed </td></tr>
</table>
<p>Data groups for <code>IBDTYP = 4</code> as for <code>IBDTYP = 1</code>.</p>
<h4>1 identification input line:</h4>
<div class="fragment"><div class="line">BODY DATA SPECification</div>
</div><!-- fragment --><h4>1 input line:</h4>
<div class="fragment"><div class="line">CHBDY</div>
</div><!-- fragment --><ul>
<li><code>CHBDY: character(8)</code>: Body identification, must be unique</li>
</ul>
<h4>Text for identifying the body, 3 input lines:</h4>
<div class="fragment"><div class="line">TXBDY</div>
</div><!-- fragment --><ul>
<li><code>TXBDY: character(60)</code>: Character string describing the body</li>
</ul>
<h1><a class="anchor" id="ug_body_body_type"></a>
Body type</h1>
<h4>1 input line.</h4>
<div class="fragment"><div class="line">IBDTYP IMPTYP</div>
</div><!-- fragment --><ul>
<li><code>IBDTYP: integer</code>: Body type<ul>
<li><code>= 1</code>: Large volume, total motion is simulated in time domain, 6 degrees of freedom</li>
<li><code>= 2</code>: Large volume, separation of motions in frequency domain HF motions and time domain LF motions, 6 degrees of freedom</li>
<li><code>= 3</code>: Small volume, position dependent hydrodynamic coefficients are allowed, 3 translational degrees of freedom</li>
<li><code>= 4</code>: As <code>IBDTYP=1</code>, but fixed or prescribed body position</li>
</ul>
</li>
<li><code>IMPTYP: integer</code>: Type of import for positions. Applicable for body type 4, else dummy<ul>
<li><code>= 0</code>: No import - fixed position</li>
<li><code>= 1</code>: Import from file</li>
<li><code>= 2</code>: Import from HLA</li>
<li><code>= 3</code>: Articulated structure, Relative motion specified or imported from HLA</li>
</ul>
</li>
</ul>
<h2><a class="anchor" id="ug_body_body_type_import_position_file"></a>
Body type 4 - Import position from file</h2>
<h4>1 input line.</h4>
<div class="fragment"><div class="line">CHIMP</div>
</div><!-- fragment --><ul>
<li><code>CHIMP: character(120)</code>: Filename for body positions</li>
</ul>
<p>The file format is described in <a class="el" href="a00036.html#ug_description_body">Body type 4, Pre-scribed positions imported from file</a>.</p>
<h2><a class="anchor" id="ug_body_body_type_import_position_hla"></a>
Body type 4 - Import position from HLA</h2>
<h4>1 input line.</h4>
<div class="fragment"><div class="line">CHIMP</div>
</div><!-- fragment --><ul>
<li><code>CHIMP: character(120)</code>: HLA object name for the body</li>
</ul>
<h2><a class="anchor" id="ug_body_body_type_articulated"></a>
Body type 4 - Articulated structural member</h2>
<p>This data group enables modelling of one member of an articulated structure, such as a rigid member of a crane as illustrated in the figure below. The body may be specified to move along or around one of the degrees of freedom of its master body.</p>
<div class="image">
<img src="app-a_image001.png" alt="app-a_image001.png"/>
<div class="caption">
Crane manoeuvrability</div></div>
<p>Series of articulated structures can be specified to model movable mechanisms such as A-frames, cranes and gangways. The rigid members of the structure are connected in a master-slave fashion. In the present version of <code>SIMO</code> a time history of prescribed motion can be specified for each member of such a mechanism.</p>
<p>Important modelling issues and restrictions:</p>
<ul>
<li>The mechanism is a series of linked master / slave members</li>
<li>The main master (support body) of the articulated structure cannot itself be specified as an articulated structural member</li>
<li>Each of the members has its own body-fixed coordinate system</li>
<li>The link between a master and a slave member cannot be disconnected</li>
<li>The relative motion (translation or rotation) between the slave and the master can only take place along or around one of the principle axis of master's coordinate system</li>
<li>The series of bodies must not be arranged in loops</li>
</ul>
<h4>Name of master body for the given structure member, 1 input line:</h4>
<div class="fragment"><div class="line">CHMASTER</div>
</div><!-- fragment --><ul>
<li><code>CHMASTER: character(8)</code>: Name of master body</li>
</ul>
<h4>Coordinates in the body fixed reference system, specifying where the present body is attached to its master, 1 input line:</h4>
<div class="fragment"><div class="line">XAP  YAP  ZAP</div>
</div><!-- fragment --><ul>
<li><code>XAP: real</code>: X-position of the attachment point <img class="formulaInl" alt="$ [L] $" src="form_75.png"/></li>
<li><code>YAP: real</code>: Y-position of the attachment point <img class="formulaInl" alt="$ [L] $" src="form_75.png"/></li>
<li><code>ZAP: real</code>: Z-position of the attachment point <img class="formulaInl" alt="$ [L] $" src="form_75.png"/></li>
</ul>
<h4>Coordinates in the master body-fixed reference system specifying where the present body is attached to its master, 1 input line:</h4>
<div class="fragment"><div class="line">XAPM  YAPM  ZAPM</div>
</div><!-- fragment --><ul>
<li><code>XAPM: real</code>: X-position of the attachment point given in the master body's reference system <img class="formulaInl" alt="$ [L] $" src="form_75.png"/></li>
<li><code>YAPM: real</code>: Y- position of the attachment point given in the master body's reference system <img class="formulaInl" alt="$ [L] $" src="form_75.png"/></li>
<li><code>ZAPM: real</code>: Z- position of the attachment point given in the master body's reference system <img class="formulaInl" alt="$ [L] $" src="form_75.png"/></li>
</ul>
<h4>Mode of relative motion, 1 input line:</h4>
<div class="fragment"><div class="line">CHMOD</div>
</div><!-- fragment --><ul>
<li><code>CHMOD: character(4)</code>: Mode of motion (<code>X,Y,Z,PHI,THETA,PSI</code>)</li>
</ul>
<h4>Initial displacement and limitations for specified mode of motion relative to point of attachment, 1 input line:</h4>
<div class="fragment"><div class="line">DISINI  DISMIN  DISMAX  VMAX  AMAX</div>
</div><!-- fragment --><ul>
<li><code>DISINI: real</code>: Initial displacement <img class="formulaInl" alt="$ [L, \mathrm{deg}] $" src="form_76.png"/></li>
<li><code>DISMIN: real</code>: Lower limit for displacement <img class="formulaInl" alt="$ [L, \mathrm{deg}] $" src="form_76.png"/></li>
<li><code>DISMAX: real</code>: Upper limit for displacement <img class="formulaInl" alt="$ [L, \mathrm{deg}] $" src="form_76.png"/></li>
<li><code>VMAX: real</code>: Maximum velocity (absolute value) <img class="formulaInl" alt="$ [L/T, \mathrm{deg}/T] $" src="form_77.png"/></li>
<li><code>AMAX: real</code>: Maximum acceleration (absolute value) <img class="formulaInl" alt="$ [L/T^2, \mathrm{deg}/T^2] $" src="form_78.png"/></li>
</ul>
<p>Note that <code>DISMIN</code>, <code>DISMAX</code>, <code>VMAX</code> and <code>AMAX</code> are dummy if <code>CAST = "NONE"</code>, confer next input line</p>
<h4>Type of control, 1 input line:</h4>
<div class="fragment"><div class="line">CAST</div>
</div><!-- fragment --><ul>
<li><code>CAST: character(4)</code>: Type of articulated structure coupling control<ul>
<li><code>= NRUN</code>: Predefined run</li>
<li><code>= HLA</code>: HLA Joystick (not implemented)</li>
<li><code>= NONE</code>: Member is fixed to its master</li>
</ul>
</li>
</ul>
<h3><a class="anchor" id="ug_body_body_type_articulated_predefined"></a>
Predefined run</h3>
<h4>(<code>CAST = NRUN</code>), number and type of motion intervals, 1 input line:</h4>
<div class="fragment"><div class="line">NRUN   ISEQTYPE</div>
</div><!-- fragment --><ul>
<li><code>NRUN: integer, default: 1</code>: Number of motion intervals</li>
<li><code>ISEQTYP: integer, default: 1</code>: Motion sequence type (1-3):<ul>
<li><code>= 1</code>: Compute <code>TSTOP</code> (<code>DISPL</code> and <code>VEL</code> to be specified)</li>
<li><code>= 2</code>: Compute <code>DELTA</code> (<code>TSTOP</code> and <code>VEL</code> to be specified)</li>
<li><code>= 3</code>: Compute <code>VEL</code> (<code>TSTOP</code> and <code>DELTA</code> to be specified)</li>
</ul>
</li>
</ul>
<h4>For <code>ISEQTYP = 1</code>, <code>NRUN</code> input lines:</h4>
<div class="fragment"><div class="line">TSTART  DELTA  VEL  ACC</div>
</div><!-- fragment --><ul>
<li><code>TSTART: real</code>: Interval start time <img class="formulaInl" alt="$ [T]$" src="form_79.png"/></li>
<li><code>DELTA: real</code>: Displacement during interval <img class="formulaInl" alt="$ [L, \mathrm{deg}] $" src="form_76.png"/></li>
<li><code>VEL: real, default: VMAX</code>: Interval absolute velocity after ramp-up <img class="formulaInl" alt="$ [L/T, \mathrm{deg}/T] $" src="form_77.png"/></li>
<li><code>ACC: real, default: AMAX</code>: Interval ramp-up/ramp-down acceleration <img class="formulaInl" alt="$ [L/T^2, \mathrm{deg}/T^2] $" src="form_78.png"/></li>
</ul>
<h4>For <code>ISEQTYP = 2</code>, <code>NRUN</code> input lines:</h4>
<div class="fragment"><div class="line">TSTART  TSTOP  VEL  ACC</div>
</div><!-- fragment --><ul>
<li><code>TSTART: real</code>: Interval start time <img class="formulaInl" alt="$ [T]$" src="form_79.png"/></li>
<li><code>TSTOP: real</code>: Interval stop time <img class="formulaInl" alt="$ [T]$" src="form_79.png"/></li>
<li><code>VEL: real, default: VMAX</code>: Interval absolute velocity after ramp-up <img class="formulaInl" alt="$ [L/T, \mathrm{deg}/T] $" src="form_77.png"/></li>
<li><code>ACC: real, default: AMAX</code>: Interval ramp-up/ramp-down acceleration <img class="formulaInl" alt="$ [L/T^2, \mathrm{deg}/T^2] $" src="form_78.png"/></li>
</ul>
<h4>For <code>ISEQTYP = 3</code>, <code>NRUN</code> input lines:</h4>
<div class="fragment"><div class="line">TSTART  TSTOP  DELTA  ACC</div>
</div><!-- fragment --><ul>
<li><code>TSTART: real</code>: Interval start time <img class="formulaInl" alt="$ [T]$" src="form_79.png"/></li>
<li><code>TSTOP: real</code>: Interval stop time <img class="formulaInl" alt="$ [T]$" src="form_79.png"/></li>
<li><code>DELTA: real</code>: Displacement during interval <img class="formulaInl" alt="$ [L, \mathrm{deg}] $" src="form_76.png"/></li>
<li><code>ACC: real, default: AMAX</code>: Interval ramp-up/ramp-down acceleration <img class="formulaInl" alt="$ [L/T^2, \mathrm{deg}/T^2] $" src="form_78.png"/></li>
</ul>
<h3><a class="anchor" id="ug_body_body_type_articulated_import"></a>
Import displacements from HLA</h3>
<h4>For <code>CAST = "HLA"</code>, HLA coupling with name, 1 input line (Not implemented in present version):</h4>
<div class="fragment"><div class="line">CHCOAST</div>
</div><!-- fragment --><ul>
<li><code>CHCOAST: character</code>: HLA coupling name</li>
</ul>
<h2><a class="anchor" id="ug_body_body_type_hla"></a>
HLA export of body position, velocity and acceleration</h2>
<p>HLA body data group for publishing 6 DOF global positions, velocities, accelerations and estimated next positions and velocities.</p>
<h4>1 identification input line:</h4>
<div class="fragment"><div class="line">HLA EXPOrt</div>
</div><!-- fragment --><h4>1 input line:</h4>
<div class="fragment"><div class="line">CHBHLA</div>
</div><!-- fragment --><ul>
<li><code>CHBHLA: character(120)</code>: HLA name of this body</li>
</ul>
<h1><a class="anchor" id="ug_body_initial"></a>
Initial position</h1>
<p>This is the position of the body's origin in the global coordinate system. This position may be modified during <code>STAMOD</code> calculations.</p>
<p>1 identification input line (Note: If body type is 4 (<code>IBDTYP=4</code>) and the import type is 3 (<code>IMPTYP=3</code>) the initial position is given under the body data specification, and hence body location data should be omitted here):</p>
<div class="fragment"><div class="line">BODY  LOCAtion  DATA</div>
</div><!-- fragment --><h4>1 input line:</h4>
<div class="fragment"><div class="line">XGLOB  YGLOB  ZGLOB  PHI  THETA  PSI</div>
</div><!-- fragment --><ul>
<li><code>XGLOB: real</code>: Global X-coordinate of origin of body fixed coordinate system, <img class="formulaInl" alt="$ [L]$" src="form_80.png"/></li>
<li><code>YGLOB: real</code>: Global Y-coordinate of origin of body fixed coordinate system, <img class="formulaInl" alt="$ [L]$" src="form_80.png"/></li>
<li><code>ZGLOB: real</code>: Global Z-coordinate of origin of body fixed coordinate system, <img class="formulaInl" alt="$ [L]$" src="form_80.png"/></li>
<li><code>PHI: real</code>: Euler angle, rotation about x-axis <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
<li><code>THETA: real</code>: Euler angle, rotation about y-axis <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
<li><code>PSI: real</code>: Euler angle, rotation about z-axis <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
</ul>
<p>Note that the orientation of the body system of axes is obtained by rotations from the global coordinate system about body z, y and x axis in succession. <code>PHI</code> and <code>THETA</code> are dummy for <code>IBDTYP = 3</code> (will be set to 0.)</p>
<h1><a class="anchor" id="ug_body_geometry"></a>
Geometry data</h1>
<p>Body geometry data is read only in <code>OUTMOD</code> and is used for preparing plots of static geometry and "snapshots". The data group is skipped whenever encountered in <code>STAMOD</code>.</p>
<p>In order to ease change of body geometry after <code>STAMOD</code> and/or <code>DYNMOD</code> have been run, body geometry data may be read from a reduced <code>SYSFIL</code>. This file must at least contain the main data group identifiers:</p>
<ul>
<li><code>SYSTem DESCription SIMO</code></li>
<li><code>BODY DATA SPECification</code></li>
<li><code>END</code></li>
</ul>
<p>The reduced <code>SYSFIL</code> must contain the same bodies as the original file, and they must be given in the same sequence. Only the body identifiers, CHBDY, needs to be specified on the reduced file in addition to main data group identifiers and geometry data.</p>
<h4>1 identification input line:</h4>
<div class="fragment"><div class="line">BODY  GEOMetry  DATA</div>
</div><!-- fragment --><h3>Curve data</h3>
<p>The geometry of a body may consist of a number of curves. Each curve is described by a number of points between which lines are to be drawn. Each curve must be defined by at least two points.</p>
<h4>1 identification input line for each curve:</h4>
<div class="fragment"><div class="line">CURVe   DATA</div>
</div><!-- fragment --><h4>Each point of the curve is specified on a separate input line:</h4>
<div class="fragment"><div class="line">XGEOM  YGEOM  ZGEOM</div>
</div><!-- fragment --><ul>
<li><code>XGEOM: real</code>: X-coordinate, <img class="formulaInl" alt="$ [L]$" src="form_80.png"/></li>
<li><code>YGEOM: real</code>: Y-coordinate, <img class="formulaInl" alt="$ [L]$" src="form_80.png"/></li>
<li><code>ZGEOM: real</code>: Z-coordinate, <img class="formulaInl" alt="$ [L]$" src="form_80.png"/></li>
</ul>
<h1><a class="anchor" id="ug_body_mass"></a>
Mass Data</h1>
<h2><a class="anchor" id="ug_body_mass_structure"></a>
Structure mass</h2>
<h4>1 identification input line:</h4>
<div class="fragment"><div class="line">BODY  MASS  DATA</div>
</div><!-- fragment --><h4>Text for describing the added mass coefficients, 2 input lines:</h4>
<div class="fragment"><div class="line">TXMASS</div>
</div><!-- fragment --><ul>
<li><code>TXMASS: character(60)</code>: Character string describing the mass and added mass coefficients</li>
</ul>
<h4>Location of centre of gravity, 1 input line:</h4>
<div class="fragment"><div class="line">XCOG  YCOG  ZCOG</div>
</div><!-- fragment --><ul>
<li><code>XCOG: real</code>: X-coordinate of centre of gravity, <img class="formulaInl" alt="$ [L] $" src="form_75.png"/></li>
<li><code>YCOG: real</code>: Y-coordinate of centre of gravity, <img class="formulaInl" alt="$ [L] $" src="form_75.png"/></li>
<li><code>ZCOG: real</code>: Z-coordinate of centre of gravity, <img class="formulaInl" alt="$ [L] $" src="form_75.png"/></li>
</ul>
<p>The coordinates and all other body data should be given in the local coordinate system. The input line is dummy for <code>IBDTYP = 3</code></p>
<h4>1 input line:</h4>
<div class="fragment"><div class="line">MASS COEFficients</div>
</div><!-- fragment --><h4>The body mass, moment of inertia and centrifugal moment, 1 input line:</h4>
<div class="fragment"><div class="line">RM  RIXX  RIYX  RIYY  RIZX  RIZY  RIZZ</div>
</div><!-- fragment --><ul>
<li><code>RM: real</code>: Mass, <img class="formulaInl" alt="$ [M] $" src="form_82.png"/></li>
<li><code>RIXX: real</code>: Moment of inertia about X-axis <img class="formulaInl" alt="$ [ML^2] $" src="form_83.png"/></li>
<li><code>RIYX: real</code>: Centrifugal moment about Y-axis due to unit angular acceleration about X-axis <img class="formulaInl" alt="$ [ML^2] $" src="form_83.png"/></li>
<li><code>RIYY: real</code>: Moment of inertia about Y-axis <img class="formulaInl" alt="$ [ML^2] $" src="form_83.png"/></li>
<li><code>RIZX: real</code>: Centrifugal moment about Z-axis due to unit angular acceleration about X-axis <img class="formulaInl" alt="$ [ML^2] $" src="form_83.png"/></li>
<li><code>RIZY: real</code>: Centrifugal moment about Z-axis due to unit angular acceleration about Y-axis <img class="formulaInl" alt="$ [ML^2] $" src="form_83.png"/></li>
<li><code>RIZZ: real</code>: Moment of inertia about Z-axis <img class="formulaInl" alt="$ [ML^2] $" src="form_83.png"/></li>
</ul>
<p>Note that the moment of inertia, e.g. <img class="formulaInl" alt="$ \mathrm{I_{XX}} $" src="form_84.png"/> and centrifugal moment eg. <img class="formulaInl" alt="$ \mathrm{I_{XY}} $" src="form_85.png"/> are to be specified in the body fixed coordinate system and about the origin of the body fixed system</p>
<p>The applied symmetrical structural mass matrix is written:</p>
<p><img class="formulaInl" alt="$ \begin{bmatrix} \mathrm{AMS} &amp; 0 &amp; 0 &amp; I_{14} &amp; I_{15} &amp; I_{16} \\ 0 &amp; \mathrm{AMS} &amp; 0 &amp; I_{24} &amp; I_{25} &amp; I_{26} \\ 0 &amp; 0 &amp; \mathrm{AMS} &amp; I_{34} &amp; I_{35} &amp; I_{36} \\ I_{41} &amp; I_{42} &amp; I_{43} &amp; \mathrm{RIXX} &amp; \mathrm{-RIYX} &amp; \mathrm{-RIZX} \\ I_{51} &amp; I_{52} &amp; I_{53} &amp; \mathrm{-RIYX} &amp; \mathrm{RIYY} &amp; \mathrm{-RIZY} \\ I_{61} &amp; I_{62} &amp; I_{63} &amp; \mathrm{-RIZX} &amp; \mathrm{-RIZY} &amp; \mathrm{RIZZ} \\ \end{bmatrix} $" src="form_86.png"/></p>
<p>where the coupling term between rotational- and translational degrees of freedom, <img class="formulaInl" alt="$ I_{ij} $" src="form_87.png"/> are computed based on the system mass and the centre of gravity.</p>
<p>In case that the moments of inertia and centrifugal moments are know at centre of gravity they transform to the body fixed origin by the following expressions:</p>
<ul>
<li><img class="formulaInl" alt="$ \mathrm{RIXX = I^{cog}_{xx} + M \times \left( Y^2_{cog} + Z^2_{cog} \right)}$" src="form_88.png"/></li>
<li><img class="formulaInl" alt="$ \mathrm{RIYY = I^{cog}_{yy} + M \times \left( X^2_{cog} + Z^2_{cog} \right)}$" src="form_89.png"/></li>
<li><img class="formulaInl" alt="$ \mathrm{RIZZ = I^{cog}_{zz} + M \times \left( X^2_{cog} + Y^2_{cog} \right)}$" src="form_90.png"/></li>
<li><img class="formulaInl" alt="$ \mathrm{RIYX = I^{cog}_{xy} + M \times \left( X_{cog} \times Y_{cog} \right)}$" src="form_91.png"/></li>
<li><img class="formulaInl" alt="$ \mathrm{RIZX = I^{cog}_{xz} + M \times \left( X_{cog} \times Z_{cog} \right)}$" src="form_92.png"/></li>
<li><img class="formulaInl" alt="$ \mathrm{RIZY = I^{cog}_{zy} + M \times \left( Y_{cog} \times Z_{cog} \right)}$" src="form_93.png"/></li>
</ul>
<p>where <img class="formulaInl" alt="$ \mathrm{M}$" src="form_94.png"/> is the structural mass (AMS) and <img class="formulaInl" alt="$ \mathrm{X_{cog}}$" src="form_95.png"/>, <img class="formulaInl" alt="$ \mathrm{Y_{cog}}$" src="form_96.png"/> and <img class="formulaInl" alt="$ \mathrm{Z_{cog}}$" src="form_97.png"/> are the coordinates of centre of gravity in the body fixed system.</p>
<p>Additional mass may be given by specifying</p>
<ul>
<li>Time dependent mass</li>
<li>Distributed element force</li>
</ul>
<h2><a class="anchor" id="ug_body_mass_gravity"></a>
Gravity force</h2>
<p>For floating vessels the gravity and buoyancy forces are normally modelled by use of the hydrostatic stiffness matrix, where the reference point for stiffness is taken as the position where the buoyancy and weight are in equilibrium.</p>
<p>Optionally, the gravity force due to the structural mass (AMS) and acting at the centre of gravity may be computed. This will normally involve modifications to the hydrostatic stiffness, the <img class="formulaInl" alt="$ \mathrm{K_{44}}$" src="form_98.png"/> and <img class="formulaInl" alt="$ \mathrm{K_{55}}$" src="form_99.png"/> terms.</p>
<p>Activating gravity forces by this data group will not affect gravity forces due to the mass term of distributed element forces or time dependent mass.</p>
<h4>1 input line:</h4>
<div class="fragment"><div class="line">GRAVity FORCe INCLuded</div>
</div><!-- fragment --><h2><a class="anchor" id="ug_body_mass_added"></a>
Added mass</h2>
<p>For body type 1 (<code>IBDTYP=1</code>), the frequency dependent added mass and damping are taken care of by the retardation function. The asymptotic value of added mass (at high frequency) from the retardation function is zero. The constant part of the frequency dependent added mass is specified by the instruction: "added mass infinite".</p>
<h4>1 input line:</h4>
<div class="fragment"><div class="line">ADDEd  MASS  INFInite</div>
</div><!-- fragment --><h4>6 input lines:</h4>
<div class="fragment"><div class="line">AMi1  AMi2  AMi3  AMi4  AMi5  AMi6</div>
</div><!-- fragment --><ul>
<li><code>AMij: real</code>: Added mass force in dof i due to unit acceleration in dof j <img class="formulaInl" alt="$ [M, ML, ML^2]$" src="form_100.png"/></li>
</ul>
<p>For body type 2 (<code>IBDTYP=2</code>), the added mass used for low frequency time domain integration is assumed independent of frequency and specified by the instruction "added mass zero". In this case the frequency dependent added mass and damping are included in the wave frequency motion transfer function (RAO).</p>
<h4>1 input line:</h4>
<div class="fragment"><div class="line">ADDEd  MASS  ZERO</div>
</div><!-- fragment --><h4>6 input lines:</h4>
<div class="fragment"><div class="line">AMi1  AMi2  AMi3  AMi4  AMi5  AMi6</div>
</div><!-- fragment --><ul>
<li><code>AMij: real</code>: Added mass force in dof i due to unit acceleration in dof no j <img class="formulaInl" alt="$ [M, ML, ML^2]$" src="form_100.png"/></li>
</ul>
<h2><a class="anchor" id="ug_body_mass_time"></a>
Time dependent mass (TDM)</h2>
<p>The input data should be given after the data group ’BODY MASS DATA’. It should be noted that time dependent mass always will contribute to gravity forces. This data group may also be used to model a constant mass at a specified location.</p>
<h4>1 identification input line:</h4>
<div class="fragment"><div class="line">TIME DEPEndent MASS</div>
</div><!-- fragment --><h4>1 input line:</h4>
<div class="fragment"><div class="line">CTDMTY   NTTDM   IHLA</div>
</div><!-- fragment --><ul>
<li><code>CHTYPE: character(4)</code>: Type of Time Dependent Mass (TDM):<ul>
<li><code>= POINt</code>: Point mass</li>
<li><code>= TANK</code>: TDM with geometry</li>
</ul>
</li>
<li><code>NTTDM: integer</code>: Number of time intervals for which the mass/volume flow is given (must be 1 for <code>IHLA=1</code>)</li>
<li><code>IHLA: integer, default: 0</code>: HLA control parameter<ul>
<li><code>= 0</code>: Mass/volume flow rate specified in this group</li>
<li><code>= 1</code>: Mass/volume flow rate imported from HLA</li>
</ul>
</li>
</ul>
<h4>If <code>IHLA=1</code>, one line:</h4>
<div class="fragment"><div class="line">CTDMHLA</div>
</div><!-- fragment --><ul>
<li><code>CTDMHLA: character(120)</code>: HLA name of this TDM</li>
</ul>
<h4>For TDM of type point mass (<code>CTDMTY = POINT</code>), 1 input line:</h4>
<div class="fragment"><div class="line">XTDM   YTDM   ZTDM   MAS0   MASMAX   MASMIN   MRATMAX   MRATMIN</div>
</div><!-- fragment --><ul>
<li><code>XTDM: real</code>: X-position of TDM in body fixed system, <img class="formulaInl" alt="$ [L]$" src="form_80.png"/></li>
<li><code>YTDM: real</code>: Y-position of TDM in body fixed system, <img class="formulaInl" alt="$ [L]$" src="form_80.png"/></li>
<li><code>ZTDM: real</code>: Z-position of TDM in body fixed system, <img class="formulaInl" alt="$ [L]$" src="form_80.png"/></li>
<li><code>MAS0: real</code>: Mass at t = 0., (may be negative) <img class="formulaInl" alt="$ [M]$" src="form_101.png"/></li>
<li><code>MASMAX: real</code>: Maximum allowable mass, <img class="formulaInl" alt="$ [M]$" src="form_101.png"/> (may be negative)</li>
<li><code>MASMIN: real</code>: Minimum allowable mass, <img class="formulaInl" alt="$ [M]$" src="form_101.png"/> (may be negative)</li>
<li><code>MRATMAX: real</code>: Maximum allowable mass rate, <img class="formulaInl" alt="$ [M/T]$" src="form_102.png"/>, only <code>IHLA=1</code></li>
<li><code>MRATMIN: real</code>: Minimum allowable mass rate, <img class="formulaInl" alt="$ [M/T]$" src="form_102.png"/>, only <code>IHLA=1</code></li>
</ul>
<h4>For TDM of type tank with geometry (<code>CTDMTY = TANK</code>), 1 input line:</h4>
<div class="fragment"><div class="line">XTDM   YTDM   ZTDM   VOL0   VOLMAX   VOLMIN   VRATMAX   VRATMIN</div>
</div><!-- fragment --><ul>
<li><code>XTDM: real</code>: X-position of TDM in body fixed system, <img class="formulaInl" alt="$ [L]$" src="form_80.png"/></li>
<li><code>YTDM: real</code>: Y-position of TDM in body fixed system, <img class="formulaInl" alt="$ [L]$" src="form_80.png"/></li>
<li><code>ZTDM: real</code>: Z-position of TDM in body fixed system, <img class="formulaInl" alt="$ [L]$" src="form_80.png"/></li>
<li><code>VOL0: real</code>: Volume of liquid at t = 0. , <img class="formulaInl" alt="$ [L^3]$" src="form_103.png"/></li>
<li><code>VOLMAX: real</code>: Maximum allowable volume, <img class="formulaInl" alt="$ [L^3]$" src="form_103.png"/></li>
<li><code>VOLMIN: real</code>: Minimum allowable volume, <img class="formulaInl" alt="$ [L^3]$" src="form_103.png"/></li>
<li><code>VRATMAX: real</code>: Maximum allowable volume rate, <img class="formulaInl" alt="$ [L^3/T]$" src="form_104.png"/>, only <code>IHLA=1</code></li>
<li><code>VRATMIN: real</code>: Minimum allowable volume rate, <img class="formulaInl" alt="$ [L^3/T]$" src="form_104.png"/>, only <code>IHLA=1</code></li>
</ul>
<p>Note that if the calculated volume of the tank is less than <code>VOLMAX</code>, the actual volume will be used as maximum volume. The minimum allowable volume is <code>0.0</code>.</p>
<h4>For TDM of type tank with geometry (<code>CTDMTY = TANK</code>), 1 input line:</h4>
<div class="fragment"><div class="line">NPORT   DENSL   DVZ1   DVZ2   DVZ3   DVXZ1   DVXZ2   DVXZ3</div>
</div><!-- fragment --><ul>
<li><code>NPORT: integer</code>: Number of PORTIONS, (<code>NPORT &lt;= 5</code>)</li>
<li><code>DENSL: real</code>: Density of liquid in tank (must be positive) <img class="formulaInl" alt="$ [M/L^3]$" src="form_105.png"/></li>
<li><code>DVZ1: real</code>: X component of TDMs local Z-axis referred in body-fixed system <img class="formulaInl" alt="$ [1]$" src="form_106.png"/></li>
<li><code>DVZ2: real</code>: Y component of TDMs local Z-axis referred in body-fixed system <img class="formulaInl" alt="$ [1]$" src="form_106.png"/></li>
<li><code>DVZ3: real</code>: Z component of TDMs local Z-axis referred in body-fixed system <img class="formulaInl" alt="$ [1]$" src="form_106.png"/></li>
<li><code>DVXZ1: real</code>: X-component of vector in TDM's XZ-plane referred in body-fixed system</li>
<li><code>DVXZ2: real</code>: Y-component of vector in TDM's XZ-plane referred in body-fixed system</li>
<li><code>DVXZ3: real</code>: Z-component of vector in TDM's XZ-plane referred in body-fixed system</li>
</ul>
<p>Note that the maximum number of portions, <code>NPORT</code>, is <code>5</code></p>
<p>The local TDM coordinate system is illustrated in the figure below.</p>
<div class="image">
<img src="tdm_loc_coord.svg" alt="tdm_loc_coord.svg"/>
<div class="caption">
Definition of the TDM local coordinate system</div></div>
<h4>For TDM of type tank with geometry (<code>CTDMTY = TANK</code>), <code>NPORT</code> input lines:</h4>
<div class="fragment"><div class="line">IADD   CPOTYP   XRPOR   YRPOR   ZRPOR   RLBP    DIA1   DIA2    IAXIS</div>
</div><!-- fragment --><p> or </p>
<div class="fragment"><div class="line">IADD   CPOTYP   XRPOR   YRPOR   ZRPOR    BLX   BLY   BLZ</div>
</div><!-- fragment --><ul>
<li><code>IADD: integer</code>:<ul>
<li><code>+1</code> =&gt; Volume shall be added</li>
<li><code>-1</code> =&gt; Subtracted</li>
</ul>
</li>
<li><code>CPOTYP: character(4)</code>:<ul>
<li><code>= CONE</code>: Cone with circular cross section</li>
<li><code>= BOX</code>:</li>
</ul>
</li>
<li><code>XRPOR: real</code>: Location of centre of plane 1 in local TDM coordinate system <img class="formulaInl" alt="$ [L]$" src="form_80.png"/></li>
<li><code>YRPOR: real</code>:</li>
<li><code>ZRPOR: real</code>:</li>
</ul>
<p>For <code>CPOTYP = CONE</code>:</p>
<ul>
<li><code>RLBP: real</code>: Length of cone</li>
<li><code>DIA1: real</code>: Diameter of plane 1 (bottom plane)</li>
<li><code>DIA2: real</code>: Diameter of plane 2</li>
<li><code>IAXIS: integer, Code for direction of cone axis:</code><ul>
<li><code>= 1</code>: Axis parallel to TDM's X axis</li>
<li><code>= 2</code>: Axis parallel to TDM's Y axis</li>
<li><code>= 3</code>: Axis parallel to TDM's Z axis (Default)</li>
</ul>
</li>
</ul>
<p>For <code>CPOTYP = BOX</code>:</p>
<ul>
<li><code>BLX: real</code>: Length of box in TDM x-direction <img class="formulaInl" alt="$ [L]$" src="form_80.png"/></li>
<li><code>BLY: real</code>: Length of box in TDM y-direction <img class="formulaInl" alt="$ [L]$" src="form_80.png"/></li>
<li><code>BLZ: real</code>: Length of box in TDM z-direction <img class="formulaInl" alt="$ [L]$" src="form_80.png"/></li>
</ul>
<p>The box and cone portion types are illustrated in the figure 'Illustration of potion types BOX and CONE' below.</p>
<p>If the volume of portion B shall be subtracted from portion A (<code>IADD = -1</code>), then no part of portion B must be “outside” portion A, see the figure 'Example of physical tank and unphysical tanks (IADD=-1)' below. There is no check in <code>SIMO</code> that this event does not occur. If the geometry of a TDM is defined by “adding” portions, the portions must not be “overlapping” (The intersection must be zero).</p>
<h4><code>NTTDM</code> input lines:</h4>
<div class="fragment"><div class="line">TVM    FLOW</div>
</div><!-- fragment --><ul>
<li><code>TVM: real</code>: Start of time interval, <img class="formulaInl" alt="$ [T]$" src="form_79.png"/></li>
<li><code>FLOW: real</code>: Mass or Volume rate used until next time instant, <img class="formulaInl" alt="$ [$" src="form_107.png"/>* <img class="formulaInl" alt="$ /T]$" src="form_108.png"/></li>
</ul>
<p>The first time value must be zero</p>
<p>This data line is dummy for import from HLA (<code>IHLA=1</code>) where <code>NTTDM</code> must be 1</p>
<div class="image">
<img src="app-a_image005.png" alt="app-a_image005.png"/>
<div class="caption">
Illustration of portion types BOX and CONE</div></div>
<div class="image">
<img src="app-a_image006.png" alt="app-a_image006.png"/>
<div class="caption">
Example of physical tank and unphysical tanks (IADD=-1)</div></div>
<h1><a class="anchor" id="ug_body_retardation"></a>
Retardation function</h1>
<p>This data group is used for body type 1 (<code>IBDTYP = 1</code>) to account for frequency dependent added mass and damping in the time domain.</p>
<h4>1 identification input line:</h4>
<div class="fragment"><div class="line">RETArdation  FUNCtion</div>
</div><!-- fragment --><h4>Text for describing the retardation function, 2 input lines:</h4>
<div class="fragment"><div class="line">TXRET</div>
</div><!-- fragment --><ul>
<li><code>TXRET: character(60)</code>: Character string</li>
</ul>
<h4>1 input line:</h4>
<div class="fragment"><div class="line">TIMDEL</div>
</div><!-- fragment --><ul>
<li><code>TIMDEL: real</code>: Time step in retardation function, will also be used as default time step in time domain simulation, <img class="formulaInl" alt="$ [T]$" src="form_79.png"/></li>
</ul>
<h4>1 identification input line:</h4>
<div class="fragment"><div class="line">RETArdation  ELEMent  DATA</div>
</div><!-- fragment --><h4>1 input line:</h4>
<div class="fragment"><div class="line">NRET  IDOF   JDOF</div>
</div><!-- fragment --><ul>
<li><code>NRET: integer</code>: Number of values in retardation function for (idof, jdof)</li>
<li><code>IDOF: integer</code>: Force in dof <code>IDOF</code> due to velocity in dof <code>JDOF</code></li>
<li><code>JDOF: integer</code>:</li>
</ul>
<h4>Retardation function, 1 input line:</h4>
<div class="fragment"><div class="line">RET(1), RET(2), .... RET(NRET)</div>
</div><!-- fragment --><ul>
<li><code>RET(k): real</code>: Retardation function value, Time k is present time <img class="formulaInl" alt="$[F/L,FT,FL] $" src="form_109.png"/></li>
</ul>
<h1><a class="anchor" id="ug_body_hydrostatic"></a>
Hydrostatic stiffness</h1>
<h4>1 identification input line:</h4>
<div class="fragment"><div class="line">HYDRostatic  STIFfness  DATA</div>
</div><!-- fragment --><h4>Text for describing the hydrostatic stiffness, 2 input lines:</h4>
<div class="fragment"><div class="line">TXSTF</div>
</div><!-- fragment --><ul>
<li><code>TXSTF: character(60)</code>: Character string</li>
</ul>
<h4>1 input line:</h4>
<div class="fragment"><div class="line">ISTMOD</div>
</div><!-- fragment --><ul>
<li><code>ISTMOD: integer, default: 1</code>: Stiffness model<ul>
<li><code>= 1</code>: Linear stiffness matrix</li>
</ul>
</li>
</ul>
<p>Note that <code>ISTMOD</code> must be 1 in the present version</p>
<h3>Stiffness reference</h3>
<h4>1 identification input line:</h4>
<div class="fragment"><div class="line">STIFfness REFErence</div>
</div><!-- fragment --><h4>Reference position for stiffness force, i.e. the global position where stiffness force is zero. 1 input line:</h4>
<div class="fragment"><div class="line">XREF  YREF   ZREF    PHI   THETA    PSI</div>
</div><!-- fragment --><ul>
<li><code>XREF: real</code>: Global X-coordinate of body origin, <img class="formulaInl" alt="$ [L]$" src="form_80.png"/></li>
<li><code>YREF: real</code>: Global Y-coordinate of body origin, <img class="formulaInl" alt="$ [L]$" src="form_80.png"/></li>
<li><code>ZREF: real</code>: Global Z-coordinate of body origin, <img class="formulaInl" alt="$ [L]$" src="form_80.png"/></li>
<li><code>PHI: real</code>: Euler angle, rotation about x-axis <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
<li><code>THETA: real</code>: Euler angle, rotation about y-axis <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
<li><code>PSI: real</code>: Euler angle, rotation about z-axis <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
</ul>
<p>The orientation of the body system is obtained by the rotation sequence: rotation about global Z, local Y and local X. <code>PHI</code> and <code>THETA</code> are dummy for body type 3 (<code>IBDTYP = 3</code>)</p>
<div class="fragment"><div class="line">LINEar  STIFfness  MATRix</div>
</div><!-- fragment --><h4>Stiffness matrix, 6 input lines:</h4>
<div class="fragment"><div class="line">KMATi1  KMATi2  KMATi3  KMATi4  KMATi5  KMATi6</div>
</div><!-- fragment --><ul>
<li><code>KMATij: real</code>: Stiffness force in dof <code>i</code> due to unit displacement in dof <code>j</code>, <img class="formulaInl" alt="$ [F/L,F,FL]$" src="form_110.png"/></li>
</ul>
<p>The rotations related to the stiffness matrix are in <img class="formulaInl" alt="$ \mathrm{[rad]}$" src="form_111.png"/>, i.e. the unit of <code>KMAT66</code> is <img class="formulaInl" alt="$ [FL/\mathrm{rad}]$" src="form_112.png"/>.</p>
<p>The hydrostatic forces/moments are calculated as follows.</p>
<ul>
<li>The global displacements are computed by subtracting reference position for stiffness force (i.e. <code>XREF</code>, <code>YREF</code>, <code>ZREF</code>, <code>PHI</code>, <code>THETA</code>, <code>PSI</code>) from the global vessel position.</li>
<li>The global displacements are transformed to body related system.</li>
<li>These displacements are multiplied with the stiffness matrix and resulting forces and moments are calculated. The forces/moments are then transformed to body fixed coordinate system.</li>
</ul>
<p>This formulation will give correct hydrostatic stiffness (in heave, roll and pitch). However, it should be noted that this formulation gives stiffness in the body related system, and stiffness in e.g. X- and y-axis hence are referred to body surge and sway. Consequently the stiffness will be applied as a simplified “gain” coefficient in a DP system. It can however, not be used to represent surge and sway stiffness of a mooring system for a body with relatively large yaw motions.</p>
<h1><a class="anchor" id="ug_body_nonlinear"></a>
Nonlinear modification of buoyancy and wave forces</h1>
<p>The applied models for wave- and hydrostatic stiffness loading acting on a "large volume" body are based on a hydrodynamic input description pre-calculated for a certain draught assuming constant geometry of the intersection between the hull and the mean water level. This means that the body-fixed coordinate system has to coincide with the system used for computation of the hydrodynamic potential flow solution, and that the load model for nonlinear modification of buoyancy and wave forces has to be initialized at the appropriate draught.</p>
<p>The nonlinear modification of buoyancy- and wave forces load model is applied to give more accurate results when the wave height and motions are large and the hull geometry is draft-dependent. This is done by a quasistatic correction of the pressure forces that act on the hull. The correction uses a numerical panel model for the hull's geometry in the splash zone. The coordinate axes of the panel model are the same as the body axes, except that the origin may be offset from that of the body axes system. When the panel description extends beyond the anticipated splash zone, the number of panels to be considered in the computation can be reduced by specifying a lower and an upper bound for the draught.</p>
<p>Note that the correction load model is initialized at the reference position for hydrostatic stiffness forces. As a consequence, the reference position has to coincide with the origin of the system used for hydrodynamic calculations. This implies that the reference position can not be used to introduce specified force in global Z-direction, nor moments for roll or pitch.</p>
<p>The following input must be given:</p>
<h4>1 identification input line:</h4>
<div class="fragment"><div class="line">NONLinear  BUOYancy  CORRection</div>
</div><!-- fragment --><h4>Descriptive text, 2 input lines:</h4>
<div class="fragment"><div class="line">TXSTF</div>
</div><!-- fragment --><ul>
<li><code>TXSTF: character(60)</code>: Character string</li>
</ul>
<h4>Name of geometry file (gdf-file), 1 input line:</h4>
<div class="fragment"><div class="line">GDF_FILE</div>
</div><!-- fragment --><ul>
<li><code>FILE_NAME: character(256)</code>: Character string</li>
</ul>
<h4>Reference point of the coordinates in the geometry file (body coordinates) and vertical range to be used. 1 input line:</h4>
<div class="fragment"><div class="line">XGEO  YGEO  ZGEO  ZMIN  ZMAX  CHMET</div>
</div><!-- fragment --><ul>
<li><code>XGEO: real</code>: X-coordinate of zero of geometry coordinates</li>
<li><code>YGEO: real</code>: Y-coordinate of d.o.</li>
<li><code>ZGEO: real</code>: Z-coordinate of d.o.</li>
<li><code>ZMIN: real</code>: Minimum vertical position to be used (geometry file coordinates)</li>
<li><code>ZMAX: real</code>: Maximum vertical position to be used (geometry file coordinates)</li>
<li><code>CHMET: character(4)</code>: Correction method. Must be <code>'MWL'</code> or <code>'WAVE'</code><ul>
<li><code>CHMET = MWL</code> =&gt; Nonlinear modification of buoyancy force based on panel locations with respect to mean water level</li>
</ul>
</li>
</ul>
<p>Note that modification to wave forces is performed only if waves are present and 1st order wave forces are specified. In this case also the modification to drift forces will be computed if specified.</p>
<div class="image">
<img src="panel_nbc.svg" alt="panel_nbc.svg"/>
<div class="caption">
Example of panel system for buoyancy correction. ZMIN and ZMAX indicate the bounds of the draught band to be considered in the computation. Only panels having their centre between these bounds are included in the calculation. SWL indicates the mean water level.</div></div>
<h1><a class="anchor" id="ug_body_linear_damping"></a>
Linear damping</h1>
<p>The damping affects the total motion for <code>IBDTYP = 1</code> or <code>3</code> and the low-frequency motion if <code>IBDTYP = 2</code>.</p>
<h4>1 identification input line:</h4>
<div class="fragment"><div class="line">LINEar  DAMPing</div>
</div><!-- fragment --><h4>Text for describing the linear damping, 2 input lines:</h4>
<div class="fragment"><div class="line">TXDPL</div>
</div><!-- fragment --><ul>
<li><code>TXDPL: character(60)</code>: Character string</li>
</ul>
<h4>6 input lines, linear damping matrix:</h4>
<div class="fragment"><div class="line">DLi1    DLi2    DLi3    DLi4    DLi5    DLi6</div>
</div><!-- fragment --><ul>
<li><code>DLij: real</code>: Linear damping forces in dof i due to a unit velocity in dof j, <img class="formulaInl" alt="$ [FT/L, FT, FTL] $" src="form_113.png"/></li>
</ul>
<p>The rotation velocities are given in <img class="formulaInl" alt="$ [\mathrm{rad}/T]$" src="form_114.png"/> =&gt; Unit of <code>DL66</code> is <img class="formulaInl" alt="$ [FL / (\mathrm{rad}/T)]$" src="form_115.png"/></p>
<h1><a class="anchor" id="ug_body_quadratic_damping"></a>
Quadratic damping</h1>
<p>The quadratic damping affects the total motion for <code>IBDTYP = 1</code> or <code>3</code> and the low-frequency motion for <code>IBDTYP = 2</code>.</p>
<h4>1 identification input line:</h4>
<div class="fragment"><div class="line">QUADratic  DAMPing</div>
</div><!-- fragment --><h4>Text for describing the quadratic damping, 2 input lines:</h4>
<div class="fragment"><div class="line">TXDPQ</div>
</div><!-- fragment --><ul>
<li><code>TXDPQ: character(60)</code>: Character string</li>
</ul>
<h4>6 input line, quadratic damping matrix:</h4>
<div class="fragment"><div class="line">DQi1    DQi2    DQi3    DQi4    DQi5    DQi6</div>
</div><!-- fragment --><ul>
<li><code>DQij: real</code>: Quadratic damping force in dof i due to a unit velocity in dof j, <img class="formulaInl" alt="$ [FT^2/L^2, FT^2, FT^2/L, FT^2 L] $" src="form_116.png"/></li>
</ul>
<p>The rotation velocities are in <img class="formulaInl" alt="$ [\mathrm{rad}/T]$" src="form_114.png"/> =&gt; Unit of <code>DQ66</code> is <img class="formulaInl" alt="$ [FL / (\mathrm{rad}/T)^2] $" src="form_117.png"/></p>
<h1><a class="anchor" id="ug_body_fist_wave"></a>
First-order wave force transfer functions</h1>
<h4>1 identification input line.</h4>
<div class="fragment"><div class="line">FIRSt  ORDEr  WAVE  force  transfer  functions</div>
</div><!-- fragment --><h4>Text for describing the first-order wave force transfer functions, 2 input lines.</h4>
<div class="fragment"><div class="line">TXFO1</div>
</div><!-- fragment --><ul>
<li><code>TXFO1: character(60)</code>: Character string</li>
</ul>
<h4>1 input line.</h4>
<div class="fragment"><div class="line">NFODIR   NFOFRE   IFOSYM   ITYPIN</div>
</div><!-- fragment --><ul>
<li><code>NFODIR: integer</code>: Number of directions</li>
<li><code>NFOFRE: integer</code>: Number of frequencies</li>
<li><code>IFOSYM: integer, default: 0</code>: Symmetry code<ul>
<li><code>= 0</code>: No symmetry</li>
<li><code>= 1</code>: Single symmetry about x-z plane</li>
<li><code>= 2</code>: Double symmetry, x-z and y-z planes</li>
</ul>
</li>
<li><code>ITYPIN: integer</code>: Code for which format the transfer functions are given in<ul>
<li><code>= 1</code>: Complex form</li>
<li><code>= 2</code>: Amplitude ratio and phase <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
<li><code>= 3</code>: Amplitude ratio and phase <img class="formulaInl" alt="$ \mathrm{[rad]}$" src="form_111.png"/></li>
</ul>
</li>
</ul>
<h4>1 identification input line.</h4>
<div class="fragment"><div class="line">WAVE  DIREctions  FORCe  transfer  functions</div>
</div><!-- fragment --><h4>Directions, NFODIR input lines.</h4>
<div class="fragment"><div class="line">IFODIR    FODIR</div>
</div><!-- fragment --><ul>
<li><code>IFODIR: integer</code>: Direction number</li>
<li><code>FODIR: real</code>: Propagation direction, <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
</ul>
<p>Note that</p>
<ul>
<li>If <code>IFOSYM = 1</code><ul>
<li><code>0</code> deg <code>&lt;=</code> <code>IFODIR</code> <code>&lt;=</code> <code>180</code> deg.</li>
<li>Both <code>0</code> and <code>180</code> deg must be included</li>
</ul>
</li>
<li>If <code>IFOSYM = 2</code><ul>
<li><code>0</code> deg <code>&lt;=</code> <code>IFODIR</code> <code>&lt;=</code> <code>90</code> deg.</li>
<li>Both <code>0</code> and <code>90</code> deg must be included</li>
</ul>
</li>
</ul>
<h4>1 identification input line.</h4>
<div class="fragment"><div class="line">WAVE  FREQuencies  FORCe  transfer  functions</div>
</div><!-- fragment --><h4>Frequencies, NFOFRE input lines.</h4>
<div class="fragment"><div class="line">IFREQ  FOFRE</div>
</div><!-- fragment --><ul>
<li><code>IFREQ: integer</code>: Frequency number</li>
<li><code>FOFRE: real</code>: Angular frequency, <img class="formulaInl" alt="$ [\mathrm{rad}/T] $" src="form_118.png"/></li>
</ul>
<h4>1 identification input line. "DOF" is either SURGe, SWAY, HEAVe, ROLL, PITCh or YAW.</h4>
<div class="fragment"><div class="line"><span class="stringliteral">&quot;DOF&quot;</span>  FORCe  TRANsfer <span class="keyword">function</span></div>
</div><!-- fragment --><h4>Transfer function, for WF "DOF" force, NFOFRE*NFODIR input lines</h4>
<div class="fragment"><div class="line">IDIR  IFREQ  A  B</div>
</div><!-- fragment --><ul>
<li><code>IDIR: integer</code>: Direction number</li>
<li><code>IFREQ: integer</code>: Frequency number</li>
<li><code>A: real</code>: Interpretation according to the value of <code>ITYPIN</code><ul>
<li><code>ITYPIN=1</code>: Real part</li>
<li><code>ITYPIN=2</code>: Amplitude ratio <img class="formulaInl" alt="$ [F/L], [F] $" src="form_119.png"/></li>
<li><code>ITYPIN=3</code>: Amplitude ratio <img class="formulaInl" alt="$ [F/L], [F] $" src="form_119.png"/></li>
</ul>
</li>
<li><code>B: real</code>: Interpretation according to the value of <code>ITYPIN</code><ul>
<li><code>ITYPIN=1</code>: Imaginary part</li>
<li><code>ITYPIN=2</code>: Phase angle <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
<li><code>ITYPIN=3</code>: Phase angle <img class="formulaInl" alt="$ \mathrm{[rad]}$" src="form_111.png"/></li>
</ul>
</li>
</ul>
<p>Both translational and rotational transfer functions must be given for unit wave amplitude.</p>
<p>For angular motions the dimension of the amplitude ratio is <img class="formulaInl" alt="$[\mathrm{rad}/L]$" src="form_120.png"/>, while for translations: <img class="formulaInl" alt="$[L/L]$" src="form_121.png"/>.</p>
<h1><a class="anchor" id="ug_body_first_motion"></a>
First-order motion transfer functions (RAO)</h1>
<h4>1 identification input line.</h4>
<div class="fragment"><div class="line">FIRSt  ORDEr  MOTIon  transfer  functions</div>
</div><!-- fragment --><h4>Text for describing the first-order motion transfer functions, 2 lines.</h4>
<div class="fragment"><div class="line">TXMO1</div>
</div><!-- fragment --><ul>
<li><code>TXMO1: character(60)</code>: Character string</li>
</ul>
<h4>1 input line.</h4>
<div class="fragment"><div class="line">NMODIR   NMOFRE   IMOSYM   ITYPIN</div>
</div><!-- fragment --><ul>
<li><code>NMODIR: integer</code>: Number of directions</li>
<li><code>NMOFRE: integer</code>: Number of frequencies</li>
<li><code>IMOSYM: integer, default: 0</code>: Symmetry code<ul>
<li><code>= 0</code>: No symmetry</li>
<li><code>= 1</code>: Single symmetry about x-z plane</li>
<li><code>= 2</code>: Double symmetry, x-z and y-z planes</li>
</ul>
</li>
<li><code>ITYPIN: integer</code>: Code for which format the transfer functions are given in<ul>
<li><code>= 1</code>: Complex form</li>
<li><code>= 2</code>: Amplitude ratio and phase <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
<li><code>= 3</code>: Amplitude ratio and phase <img class="formulaInl" alt="$ \mathrm{[rad]}$" src="form_111.png"/></li>
</ul>
</li>
</ul>
<h4>1 identification input line.</h4>
<div class="fragment"><div class="line">WAVE  DIREctions  MOTIon  transfer  functions</div>
</div><!-- fragment --><h4>Directions, NMODIR input lines.</h4>
<div class="fragment"><div class="line">IMODIR    MODIR</div>
</div><!-- fragment --><ul>
<li><code>IMODIR: integer</code>: Direction number</li>
<li><code>MODIR: real</code>: Propagation direction, <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
</ul>
<p>Note that</p>
<ul>
<li>If <code>IMOSYM = 1</code><ul>
<li><code>0</code> deg <code>&lt;=</code> <code>IMODIR</code> <code>&lt;=</code> <code>180</code> deg.</li>
<li>Both <code>0</code> and <code>180</code> deg must be included</li>
</ul>
</li>
<li>If <code>IMOSYM = 2</code><ul>
<li><code>0</code> deg <code>&lt;=</code> <code>IMODIR</code> <code>&lt;=</code> <code>90</code> deg.</li>
<li>Both <code>0</code> and <code>90</code> deg must be included</li>
</ul>
</li>
</ul>
<h4>1 identification input line.</h4>
<div class="fragment"><div class="line">WAVE  FREQuencies  MOTIon  transfer  functions</div>
</div><!-- fragment --><h4>Frequencies, NMOFRE input lines.</h4>
<div class="fragment"><div class="line">IFREQ  MOFRE</div>
</div><!-- fragment --><ul>
<li><code>IFREQ: integer</code>: Frequency number</li>
<li><code>MOFRE: real</code>: Angular frequency, <img class="formulaInl" alt="$ [\mathrm{rad}/T]$" src="form_114.png"/></li>
</ul>
<h4>1 identification input line. "DOF" is either SURGe, SWAY, HEAVe, ROLL, PITCh or YAW.</h4>
<div class="fragment"><div class="line"><span class="stringliteral">&quot;DOF&quot;</span>  MOTIon  TRANsfer <span class="keyword">function</span></div>
</div><!-- fragment --><h4>Transfer function, for HF "DOF" motion, NMOFRE*NMODIR input lines</h4>
<div class="fragment"><div class="line">IDIR  IFREQ  A  B</div>
</div><!-- fragment --><ul>
<li><code>IDIR: integer</code>: Direction number</li>
<li><code>IFREQ: integer</code>: Frequency number</li>
<li><code>A: real</code>: Interpretation according to the value of <code>ITYPIN</code><ul>
<li><code>ITYPIN=1</code>: Real part</li>
<li><code>ITYPIN=2</code>: Amplitude ratio <img class="formulaInl" alt="$ [1], [\mathrm{rad}] $" src="form_122.png"/></li>
<li><code>ITYPIN=3</code>: Amplitude ratio <img class="formulaInl" alt="$ [1], [\mathrm{rad}] $" src="form_122.png"/></li>
</ul>
</li>
<li><code>B: real</code>: Interpretation according to the value of <code>ITYPIN</code><ul>
<li><code>ITYPIN=1</code>: Imaginary part</li>
<li><code>ITYPIN=2</code>: Phase angle <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
<li><code>ITYPIN=3</code>: Phase angle <img class="formulaInl" alt="$ \mathrm{[rad]}$" src="form_111.png"/></li>
</ul>
</li>
</ul>
<p>The amplitude ratio rotational transfer functions must be given as <img class="formulaInl" alt="$[\mathrm{rad}/L]$" src="form_120.png"/>. Both translational and rotational transfer functions must be given for unit wave amplitude.</p>
<h1><a class="anchor" id="ug_body_wind_force"></a>
Wind force coefficients</h1>
<h4>1 identification input line.</h4>
<div class="fragment"><div class="line">WIND   FORCe    COEFficients</div>
</div><!-- fragment --><h4>Text for describing the wind force coefficients, 2 input lines.</h4>
<div class="fragment"><div class="line">TXWICO</div>
</div><!-- fragment --><ul>
<li><code>TXWICO: character(60)</code>: Character string</li>
</ul>
<h4>1 input line.</h4>
<div class="fragment"><div class="line">NWIDIR   IWISYM   WIAREA   ZCOEF</div>
</div><!-- fragment --><ul>
<li><code>NWIDIR: integer</code>: Number of directions</li>
<li><code>IWISYM: integer, default: 0</code>: Symmetry code<ul>
<li><code>= 0</code>: No symmetry</li>
<li><code>= 1</code>: Single symmetry about x-z plane</li>
<li><code>= 2</code>: Double symmetry, x-z and y-z planes</li>
</ul>
</li>
<li><code>WIAREA: real, default: 2000</code>: Characteristic area for admittance function (ref. Theory Manual)</li>
<li><code>ZCOEFF: real, default: 10</code>: Height referred to still water level for which wind velocity will be calculated.</li>
</ul>
<h4>Coefficients, NWIDIR input lines.</h4>
<div class="fragment"><div class="line">WIDIR   WI1   WI2   WI3   WI4   WI5   WI6</div>
</div><!-- fragment --><ul>
<li><code>WIDIR: real</code>: Wind direction, <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
<li><code>WIn: real</code>: Wind force coefficient for degree of freedom n, <img class="formulaInl" alt="$ [FT^2/L^2, FT^2/L] $" src="form_123.png"/></li>
</ul>
<p>Note that when 'No symmetry' is selected, coefficients for both <code>0</code> and <code>360</code> deg ought to be included and that they must be equal.</p>
<h1><a class="anchor" id="ug_body_diffracted"></a>
Diffracted wave transfer functions in points</h1>
<h4>1 identification input line.</h4>
<div class="fragment"><div class="line">FIRSt ORDEr DIFFracted  wave transfer  functions</div>
</div><!-- fragment --><h4>Text for describing the linear incoming wave to diffracted wave transfer functions, 2 lines.</h4>
<div class="fragment"><div class="line">TXDI1</div>
</div><!-- fragment --><ul>
<li><code>TXDI1: character(60)</code>: Character string</li>
</ul>
<h4>1 input line.</h4>
<div class="fragment"><div class="line">PTNOUS</div>
</div><!-- fragment --><ul>
<li><code>PTNOUS: integer</code>: Point number defined by user</li>
</ul>
<h4>1 input line.</h4>
<div class="fragment"><div class="line">XBDY   YBDY   ZBDY</div>
</div><!-- fragment --><ul>
<li><code>XBDY: real</code>: x-coordinate of where transfer function is calculated <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>YBDY: real</code>: y-coordinate of where transfer function is calculated <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>ZBDY: real</code>: z-coordinate of where transfer function is calculated <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
</ul>
<p>Note that the coordinates are specified in body related system</p>
<h4>1 input line.</h4>
<div class="fragment"><div class="line">NDIR   NFRE   ITYPIN</div>
</div><!-- fragment --><ul>
<li><code>NDIR: integer</code>: Total number of wave directions (for this point)</li>
<li><code>NFRE: integer</code>: Total number of frequencies (for this point)</li>
<li><code>ITYPIN: integer</code>: Code for which format the transfer functions are given in<ul>
<li><code>= 1</code>: Complex form</li>
<li><code>= 2</code>: Amplitude ratio and phase <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
<li><code>= 3</code>: Amplitude ratio and phase <img class="formulaInl" alt="$ \mathrm{[rad]}$" src="form_111.png"/></li>
</ul>
</li>
</ul>
<h4>1 identification input line.</h4>
<div class="fragment"><div class="line">WAVE  DIREctions  DIFFracted wave transfer  functions</div>
</div><!-- fragment --><h4>Directions, NDIR input lines.</h4>
<div class="fragment"><div class="line">IDIR    DIR</div>
</div><!-- fragment --><ul>
<li><code>IDIR: integer</code>: Direction number (between <code>1</code> and <code>NDIR</code>)</li>
<li><code>DIR: real</code>: Propagation direction of incoming wave, <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
</ul>
<h4>1 identification input line.</h4>
<div class="fragment"><div class="line">WAVE  FREQuencies  DIFFracted wave transfer  functions</div>
</div><!-- fragment --><h4>Frequencies, NFRE input lines.</h4>
<div class="fragment"><div class="line">IFRE  FRE</div>
</div><!-- fragment --><ul>
<li><code>IFRE: integer</code>: Frequency number (between <code>1</code> and <code>NFRE</code>)</li>
<li><code>FRE: real</code>: Angular frequency of incoming wave, <img class="formulaInl" alt="$ [\mathrm{rad}/T]$" src="form_114.png"/></li>
</ul>
<h4>1 identification input line.</h4>
<div class="fragment"><div class="line">WAVE ELEVation DIFFracted wave transfer <span class="keyword">function</span></div>
</div><!-- fragment --><p>And / or</p>
<div class="fragment"><div class="line">XVELocity DIFFracted WAVE transfer <span class="keyword">function</span></div>
</div><!-- fragment --><div class="fragment"><div class="line">YVELocity DIFFracted WAVE transfer <span class="keyword">function</span></div>
</div><!-- fragment --><div class="fragment"><div class="line">ZVELocity DIFFracted WAVE transfer <span class="keyword">function</span></div>
</div><!-- fragment --><h4>Transfer function from incoming wave to diffracted wave, NDIR*NFRE input lines.</h4>
<div class="fragment"><div class="line">IDIR  IFRE  A  B</div>
</div><!-- fragment --><ul>
<li><code>IDIR: integer</code>: Direction number</li>
<li><code>IFRE: integer</code>: Frequency number</li>
<li><code>A: real</code>: Interpretation according to value of <code>ITYPIN</code><ul>
<li><code>ITYPIN=1</code>: Real part</li>
<li><code>ITYPIN=2</code>: Amplitude ratio <img class="formulaInl" alt="$[1]$" src="form_124.png"/>, <img class="formulaInl" alt="$ [\mathrm{rad}/L]$" src="form_125.png"/></li>
<li><code>ITYPIN=3</code>: Amplitude ratio <img class="formulaInl" alt="$[1]$" src="form_124.png"/>, <img class="formulaInl" alt="$ [\mathrm{rad}/L]$" src="form_125.png"/></li>
</ul>
</li>
<li><code>B: real</code>: Interpretation according to value of <code>ITYPIN</code><ul>
<li><code>ITYPIN=1</code>: Imaginary part</li>
<li><code>ITYPIN=2</code>: Phase angle <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
<li><code>ITYPIN=3</code>: Phase angle <img class="formulaInl" alt="$ \mathrm{[rad]}$" src="form_111.png"/></li>
</ul>
</li>
</ul>
<p>If transfer functions of X-, Y- or Z-velocity are given, corresponding acceleration time series will also be computed.</p>
<h2><a class="anchor" id="ug_body_diffracted_hla"></a>
HLA export or visualisation of diffracted wave elevation</h2>
<p>One or more fields of diffracted wave elevations can be exported for visualization, or to HLA, in a simulator setting. In these points the "WAVE ELEVation DIFFracted wave transfer function" has to be specified, and the points must be equidistant in X and Y direction, respectively. The generation and visualisation of a field of diffracted wave elevations is computationally demanding and time consuming.</p>
<p>In order to increase the simulation speed in an HLA simulation session, the computation can be distributed between several computers in the HLA network.</p>
<p>In that case one computer (i.e. HLA federate, identified as the "DIFFRACTED WAVE MASTER") will specify the wave field and a number of computers (called "DIFFRACTED WAVE WORKERS") that cooperate in the generation of wave elevations.</p>
<p>In case that a diffracted wave field from a stand-alone <code>SIMO</code> analysis shall be visualised, the <code>SIMO</code> sys-file should both specify the wave field and generate the diffracted wave elevations, and should thus include both "MASTER" and "WORKER".</p>
<p>The following input sequence will enable visualization of one rectangular patch of diffracted wave elevations:</p>
<h4>1 identification input line</h4>
<div class="fragment"><div class="line">DIFFracted WAVE EXPOrt</div>
</div><!-- fragment --><h4>Diffracted wave patch name, 1 input line</h4>
<div class="fragment"><div class="line">CHDWP</div>
</div><!-- fragment --><ul>
<li><code>CHDWP: character(120)</code>: Diffracted wave patch name</li>
</ul>
<p>Either the diffracted wave master or the diffracted wave worker or both have to be specified.</p>
<h4>1 identification input line</h4>
<div class="fragment"><div class="line">DIFFracted WAVE MASTer</div>
</div><!-- fragment --><h4>Specification of number of points for diffracted wave MASTER, 1 input line</h4>
<div class="fragment"><div class="line">NWRK  NPX  NPY</div>
</div><!-- fragment --><ul>
<li><code>NWRK: integer</code>: Number of 'WORKERs' (divisions) for the diffracted wave elevation patch</li>
<li><code>NPX: integer</code>: Number of points in X-direction</li>
<li><code>NPY: integer</code>: Number of points in Y-direction</li>
</ul>
<p><code>SIMO</code> stand-alone analysis: <code>NWRK = 1</code></p>
<h4>Specification of patch for wave MASTER, 1 input line</h4>
<div class="fragment"><div class="line">DWDX   DWDY  DWX  DWY  DWPSI</div>
</div><!-- fragment --><ul>
<li><code>DWDX: real</code>: Equidistant length between diffracted wave points in X-direction <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>DWDY: real</code>: Equidistant length between diffracted wave points in Y-direction <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>DWX: real</code>: Minimum X-coordinate of the diffracted wave patch referred to the body-fixed coordinate system <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>DWY: real</code>: Minimum Y-coordinate of the diffracted wave patch referred to the body-fixed coordinate system <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>DWPSI: real</code>: Yaw angle of the diffracted wave patch relative to the body-fixed coordinate system <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
</ul>
<h4>1 identification input line</h4>
<div class="fragment"><div class="line">DIFFracted WAVE WORKer</div>
</div><!-- fragment --><h4>Specification of number of points for diffracted wave WORKER , 1 input line</h4>
<div class="fragment"><div class="line">IDWW       NDWWP</div>
</div><!-- fragment --><ul>
<li><code>IDWW: integer</code>: Worker number</li>
<li><code>NDWWP: integer</code>: Number of points for the worker<ul>
<li><code>NDWWP = NPX * NPY / NWRK</code></li>
</ul>
</li>
</ul>
<div class="image">
<img src="app-a_image007.png" alt="app-a_image007.png"/>
<div class="caption">
Diffracted wave patch with NPX = 5, NPY = 3.</div></div>
<h1><a class="anchor" id="ug_body_linear_current"></a>
Linear current coefficients</h1>
<h4>1 identification input line.</h4>
<div class="fragment"><div class="line">LINEar  CURRent  COEFficients</div>
</div><!-- fragment --><h4>Text for describing the linear current coefficients, 2 input lines.</h4>
<div class="fragment"><div class="line">TXC1CO</div>
</div><!-- fragment --><ul>
<li><code>TXC1CO: character(60)</code>: Character string</li>
</ul>
<h4>1 input line.</h4>
<div class="fragment"><div class="line">NC1DIR  IC1SYM</div>
</div><!-- fragment --><ul>
<li><code>NC1DIR: integer</code>: Number of directions</li>
<li><code>IC1SYM: integer, default: 0</code>: Symmetry code<ul>
<li><code>= 0</code>: No symmetry</li>
<li><code>= 1</code>: Single symmetry about x-z plane</li>
<li><code>= 2</code>: Double symmetry, x-z and y-z planes</li>
</ul>
</li>
</ul>
<h4>Coefficients, NC1DIR input lines.</h4>
<div class="fragment"><div class="line">C1DIR  C11  C12  C13  C14  C15  C16</div>
</div><!-- fragment --><ul>
<li><code>C1DIR: real</code>: Direction, <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
<li><code>C1n: real</code>: Linear current force coefficient for degree of freedom n, <img class="formulaInl" alt="$[FT/L,FT]$" src="form_126.png"/></li>
</ul>
<p>Note that when 'No symmetry' is selected, coefficients for both <code>0</code> and <code>360</code> deg ought to be included and that they must be equal.</p>
<h1><a class="anchor" id="ug_body_quadratic_current"></a>
Quadratic current coefficients</h1>
<h4>1 identification input line.</h4>
<div class="fragment"><div class="line">QUADratic  CURRent  COEFficients</div>
</div><!-- fragment --><h4>Text for describing the quadratic current coefficients, 2 input lines.</h4>
<div class="fragment"><div class="line">TXC2CO</div>
</div><!-- fragment --><ul>
<li><code>TXC2CO: character(60)</code>: Character string</li>
</ul>
<h4>1 input line.</h4>
<div class="fragment"><div class="line">NC2DIR IC2SYM ISTRIP RLTOT RLORI</div>
</div><!-- fragment --><ul>
<li><code>NC2DIR: integer</code>: Number of directions</li>
<li><code>IC2SYM: integer, default: 0</code>: Symmetry code<ul>
<li><code>= 0</code>: No symmetry</li>
<li><code>= 1</code>: Single symmetry about x-z plane</li>
<li><code>= 2</code>: Double symmetry, x-z and y-z planes</li>
</ul>
</li>
<li><code>ISTRIP: integer, default: 0</code>: Strip model number<ul>
<li><code>= 0</code>: No strip model</li>
<li><code>= 1</code>: Strip model no. 1</li>
<li><code>= 2</code>: Strip model no. 2</li>
</ul>
</li>
<li><code>RLTOT: real</code>: Total length</li>
<li><code>RLORI: real</code>: Length from <code>FP</code> to motion origin</li>
</ul>
<p>Note that when 'No symmetry' is selected, coefficients for both <code>0</code> and <code>360</code> deg ought to be included and that they must be equal.</p>
<p>For details on the strip model, confer the Theory Manual. <code>RLTOT</code> and <code>RLORI</code> apply for strip models only.</p>
<h4>Coefficients, NC2DIR input lines.</h4>
<div class="fragment"><div class="line">C2DIR  C21  C22  C23  C24  C25  C26</div>
</div><!-- fragment --><ul>
<li><code>C2DIR: real</code>: Direction, <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
<li><code>C2n: real</code>: Quadratic current force coefficient for degree of freedom n, <img class="formulaInl" alt="$[FT^2/L^2,FT^2/L]$" src="form_127.png"/></li>
</ul>
<p>The coefficient <code>C26</code> is dummy for <code>ISTRIP = 1</code> or <code>2</code></p>
<h1><a class="anchor" id="ug_body_second_drift"></a>
Second-order wave drift coefficients</h1>
<h4>1 identification input line.</h4>
<div class="fragment"><div class="line">SECOnd   ORDer   WAVE   drift   forces</div>
</div><!-- fragment --><h4>Text for describing the second-order wave drift force coefficients, 2 input lines.</h4>
<div class="fragment"><div class="line">TXWADR</div>
</div><!-- fragment --><ul>
<li><code>TXWADR: character(60)</code>: Character string</li>
</ul>
<h4>1 input line.</h4>
<div class="fragment"><div class="line">NDRDIR   NDRFRE   IDRSYM</div>
</div><!-- fragment --><ul>
<li><code>NDRDIR: integer</code>: Number of directions</li>
<li><code>NDRFRE: integer</code>: Number of frequencies</li>
<li><code>IDRSYM: integer, default: 0</code>: Symmetry code<ul>
<li><code>= 0</code>: No symmetry</li>
<li><code>= 1</code>: Single symmetry about x-z plane</li>
<li><code>= 2</code>: Double symmetry, x-z and y-z planes</li>
</ul>
</li>
</ul>
<h4>1 identification input line.</h4>
<div class="fragment"><div class="line">WAVE  DIREctions  DRIFt coefficients</div>
</div><!-- fragment --><h4>NDRDIR input lines.</h4>
<div class="fragment"><div class="line">IDRDIR   DRDIR</div>
</div><!-- fragment --><ul>
<li><code>IDRDIR: integer</code>: Direction number</li>
<li><code>DRDIR: real</code>: Direction, <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
</ul>
<p>Note that:</p>
<ul>
<li>If <code>IDRSYM = 1</code><ul>
<li><code>0</code> deg <code>&lt;=</code> <code>DRDIR</code> <code>&lt;=</code> <code>180</code> deg.</li>
<li><code>0</code> deg must be included.</li>
</ul>
</li>
<li>If <code>IDRSYM = 2</code><ul>
<li><code>0</code> deg <code>&lt;=</code> <code>DRDIR</code> <code>&lt;=</code> <code>90</code> deg.</li>
</ul>
</li>
</ul>
<h4>1 identification input line.</h4>
<div class="fragment"><div class="line">WAVE  FREQuencies  DRIFt coefficients</div>
</div><!-- fragment --><h4>Frequencies, NDRFRE input lines.</h4>
<div class="fragment"><div class="line">IDRFRE   DRFRE</div>
</div><!-- fragment --><ul>
<li><code>IDRFRE: integer</code>: Frequency number</li>
<li><code>DRFRE: real</code>: Angular frequency, <img class="formulaInl" alt="$ \mathrm{[rad}/T]$" src="form_128.png"/></li>
</ul>
<h4>1 identification input line, "DOF" is either SURGe, SWAY, HEAVe, ROLL, PITCh or YAW.</h4>
<div class="fragment"><div class="line"><span class="stringliteral">&quot;DOF&quot;</span>  WAVE  DRIFt coefficients</div>
</div><!-- fragment --><h4>Force coefficients, NDRFRE*NDRDIR input lines</h4>
<div class="fragment"><div class="line">IDRDIR   IDRFRE   TDR</div>
</div><!-- fragment --><ul>
<li><code>IDRDIR: integer</code>: Direction number</li>
<li><code>IDRFRE: integer</code>: Frequency number</li>
<li><code>TDR: real</code>: Wave drift force coefficient, <img class="formulaInl" alt="$[F/L^2,F/L]$" src="form_129.png"/></li>
</ul>
<h2><a class="anchor" id="ug_body_second_drift_wave"></a>
Wave drift damping</h2>
<h4>1 identification input line.</h4>
<div class="fragment"><div class="line">WAVE DRIFt DAMPing</div>
</div><!-- fragment --><h4>Text for describing the wave drift damping, 2 input lines.</h4>
<div class="fragment"><div class="line">TXWADD</div>
</div><!-- fragment --><ul>
<li><code>TXWADD: character(60)</code>: Character string</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">ICOF</div>
</div><!-- fragment --><ul>
<li><code>ICOF: integer</code>: Calculation method<ul>
<li><code>= 1</code>: Simplified method</li>
<li><code>= 2</code>: Newman’s method</li>
</ul>
</li>
</ul>
<h2><a class="anchor" id="ug_body_second_drift_simplified"></a>
Simplified method (ICOF=1)</h2>
<h4>1 input line</h4>
<div class="fragment"><div class="line">NWADD</div>
</div><!-- fragment --><ul>
<li><code>NWADD: integer</code>: Number of peak periods for which coefficients are given</li>
</ul>
<h4>Wave drift damping coefficients, NWADD input lines</h4>
<div class="fragment"><div class="line">WDPER WD11 WD12</div>
</div><!-- fragment --><ul>
<li><code>WDPER: real</code>: Peak period in wave spectrum <img class="formulaInl" alt="$[T]$" src="form_70.png"/></li>
<li><code>WD1n: real</code>: Wave drift damping coefficient for degree of freedom n, (i.e. relative change in average wave drift force for unit velocity), <img class="formulaInl" alt="$[T/L]$" src="form_130.png"/></li>
</ul>
<h2><a class="anchor" id="ug_body_second_drift_newman"></a>
Newman’s method (ICOF=2)</h2>
<h4>1 input line</h4>
<div class="fragment"><div class="line">NDDDIR NDDFRE</div>
</div><!-- fragment --><ul>
<li><code>NDDDIR: integer</code>: Number of directions</li>
<li><code>NDDFRE: integer</code>: Number of frequencies</li>
</ul>
<h4>1 identification input line</h4>
<div class="fragment"><div class="line">WAVE DIREction DAMPing coefficients</div>
</div><!-- fragment --><h4>Directions, NDDDIR input lines</h4>
<div class="fragment"><div class="line">IDDDIR DDDIR</div>
</div><!-- fragment --><ul>
<li><code>IDDDIR: integer</code>: Direction number</li>
<li><code>DDDIR: real</code>: Direction, <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
</ul>
<h4>1 identification input line</h4>
<div class="fragment"><div class="line">WAVE FREQuencies DAMPing coefficients</div>
</div><!-- fragment --><h4>Frequencies, NDDFRE input lines</h4>
<div class="fragment"><div class="line">IDDFRE DDFRE</div>
</div><!-- fragment --><ul>
<li><code>IDDFRE: integer</code>: Frequency number</li>
<li><code>DDFRE: real</code>: Angular frequency, <img class="formulaInl" alt="$ \mathrm{[rad}/T]$" src="form_128.png"/></li>
</ul>
<h4>1 identification input line, “BIJ” is B11,B12,B16,B21,B22,B26,B61,B62 or B66</h4>
<div class="fragment"><div class="line">BIJ DRIFt DAMPing coefficients</div>
</div><!-- fragment --><h4>Damping force coefficients, NDDFRE*NDDDIR input lines</h4>
<div class="fragment"><div class="line">IDDDIR IDDFRE WAD2</div>
</div><!-- fragment --><ul>
<li><code>IDDDIR: integer</code>: Direction number</li>
<li><code>IDDFRE: integer</code>: Frequency number</li>
<li><code>WAD2: real</code>: Wave drift damping force coefficient<ul>
<li><code>B11, B21, B22, B12</code>: <img class="formulaInl" alt="$\left[(F/(L/T))/L^2\right]$" src="form_131.png"/></li>
<li><code>B16, B26, B61, B62</code>: <img class="formulaInl" alt="$\left[(F/(1/T))/L^2\right]$" src="form_132.png"/></li>
<li><code>B66</code>: <img class="formulaInl" alt="$\left[(FL/(1/T))/L^2\right]$" src="form_133.png"/></li>
</ul>
</li>
</ul>
<h1><a class="anchor" id="ug_body_second_force"></a>
Second-order wave force transfer functions</h1>
<p>To do simulations with full Quadratic Transfer Functions (QTFs), the number of frequencies along both axes must be equal. This is given by the parameters <code>NWQTF1</code> and <code>NWQTF2</code>. When running <code>DYNMOD</code> the option "Full
QTF" will then be available in the menu "Frequency variation of QTF
force".</p>
<h4>1 identification input line.</h4>
<div class="fragment"><div class="line">QUADratic TRANsfer FUNCtions</div>
</div><!-- fragment --><h4>Text for describing the second-order wave force transfer functions, 2 input lines.</h4>
<div class="fragment"><div class="line">TXFO2</div>
</div><!-- fragment --><ul>
<li><code>TXFO2: character(60)</code>: Character string</li>
</ul>
<h4>1 input line.</h4>
<div class="fragment"><div class="line">NDQTF1  NDQTF2   NWQTF1  NWQTF2  MODQTF   IQTSYM   ITYPIN</div>
</div><!-- fragment --><ul>
<li><code>NDQTF1: integer</code>: Number of directions</li>
<li><code>NDQTF2: integer</code>: Number of directions (1 or <code>NDQTF1</code>)</li>
<li><code>NWQTF1: integer</code>: Number of frequencies</li>
<li><code>NWQTF2: integer</code>: Number of frequencies (1 or <code>NWQTF1</code>)</li>
<li><code>MODQTF: integer</code>: Mode for transfer functions<ul>
<li><code>= 1</code>: Difference frequency transfer functions</li>
<li><code>= 2</code>: Sum frequency transfer functions</li>
</ul>
</li>
<li><code>IQTSYM: integer, default: 0</code>: Symmetry code<ul>
<li><code>= 0</code>: No symmetry is mandatory</li>
</ul>
</li>
<li><code>ITYPIN: integer</code>: Code for which format the transfer functions are given in<ul>
<li><code>= 1</code>: Complex form</li>
<li><code>= 2</code>: Amplitude ratio and phase <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
<li><code>= 3</code>: Amplitude ratio and phase <img class="formulaInl" alt="$ \mathrm{[rad]}$" src="form_111.png"/></li>
</ul>
</li>
</ul>
<h4>1 identification input line.</h4>
<div class="fragment"><div class="line">WAVE  DIREctions  QTF</div>
</div><!-- fragment --><h4>Directions, NDQTF1 input lines.</h4>
<div class="fragment"><div class="line">IQTDIR    QTFDIR</div>
</div><!-- fragment --><ul>
<li><code>IQTDIR: integer</code>: Direction number</li>
<li><code>QTFDIR: real</code>: Direction, <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
</ul>
<h4>1 identification input line.</h4>
<div class="fragment"><div class="line">WAVE  FREQuencies  QTF</div>
</div><!-- fragment --><h4>Frequencies, NWQTF1 input lines.</h4>
<div class="fragment"><div class="line">IQTFRE  QTFFRE</div>
</div><!-- fragment --><ul>
<li><code>IQTFRE: integer</code>: Frequency number</li>
<li><code>QTFFRE: real</code>: Angular frequency, <img class="formulaInl" alt="$ \mathrm{[rad}/T]$" src="form_128.png"/></li>
</ul>
<h4>1 identification input line. "DOF" is SURGe, SWAY, HEAVe, ROLL, PITCh or YAW.</h4>
<div class="fragment"><div class="line"><span class="stringliteral">&quot;DOF&quot;</span>  QUADratic  TRANsfer <span class="keyword">function</span></div>
</div><!-- fragment --><h4>Transfer function, for HF "DOF" force,</h4>
<p><code>NWQTF1</code>*((<code>NWQTF2</code>+1)/2)*<code>NDQTF1</code>*((<code>NDQTF2</code>+1)/2) input lines, where either <code>NWQTF2</code> or <code>NDQTF2</code> must be equal to 1. </p>
<div class="fragment"><div class="line">IDQTF1 IDQTF2 IWQTF1 IWQTF2  A  B</div>
</div><!-- fragment --><ul>
<li><code>IDQTF1: integer</code>: Direction number 1</li>
<li><code>IDQTF2: integer</code>: Direction number 2</li>
<li><code>IWQTF1: integer</code>: Frequency number 1</li>
<li><code>IWQTF2: integer</code>: Frequency number 2</li>
<li><code>A: real</code>: Interpretation according to value of <code>ITYPIN</code><ul>
<li><code>ITYPIN=1</code>: Real part</li>
<li><code>ITYPIN=2</code>: Amplitude ratio <img class="formulaInl" alt="$ \mathrm{[1,rad}/L]$" src="form_134.png"/></li>
<li><code>ITYPIN=3</code>: Amplitude ratio <img class="formulaInl" alt="$ \mathrm{[1,rad}/L]$" src="form_134.png"/></li>
</ul>
</li>
<li><code>B: real</code>: Interpretation according to value of <code>ITYPIN</code><ul>
<li><code>ITYPIN=1</code>: Imaginary part</li>
<li><code>ITYPIN=2</code>: Phase angle <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
<li><code>ITYPIN=3</code>: Phase angle <img class="formulaInl" alt="$ \mathrm{[rad]}$" src="form_111.png"/></li>
</ul>
</li>
</ul>
<p>Both translational and rotational transfer functions must be given for unit wave height.</p>
<h1><a class="anchor" id="ug_body_distributed"></a>
Distributed element forces</h1>
<p>This force model applies to two types of elements:</p>
<ul>
<li>Slender elements (example: spoolpiece)</li>
<li>Fixed body elements with zero extension (giving forces acting at a specified point)</li>
</ul>
<p>Both give 6 d.o.f. forces on the body on which the elements are attached. Make sure that any forces here are not otherwise included in the integral force coefficients for the body.</p>
<p>For each body where either of these two force models shall be used, the following 3 input lines shall precede the input sequence for all the attached elements:</p>
<p>The elements can be grouped for HLA export. In that case the following 3 input lines shall precede the input sequence for each element group:</p>
<h4>1 identification input line.</h4>
<div class="fragment"><div class="line">DISTributed ELEMent FORCe</div>
</div><!-- fragment --><h4>Text for describing distributed hydrodynamic forces, 2 input lines.</h4>
<div class="fragment"><div class="line">TXDIST</div>
</div><!-- fragment --><ul>
<li><code>TXDIST: character(60)</code>: Character string</li>
</ul>
<h3>HLA export of distributed element forces</h3>
<p>If the global coordinates of all nodes and the hydrodynamic forces on each strip shall be exported to HLA, the following 2 input lines shall follow directly after the first 3 lines:</p>
<h4>1 identification line</h4>
<div class="fragment"><div class="line">HLA EXPOrt</div>
</div><!-- fragment --><h4>Unique name of the exported element group data, 1 input line.</h4>
<div class="fragment"><div class="line">CHDELF</div>
</div><!-- fragment --><ul>
<li><code>CHDELF: character(120)</code>: HLA name (identifier) of the element group</li>
</ul>
<h2><a class="anchor" id="ug_body_distributed_slender"></a>
Slender elements</h2>
<h4>1 identification input line:</h4>
<div class="fragment"><div class="line">SLENder ELEMent</div>
</div><!-- fragment --><h4>1 input line</h4>
<div class="fragment"><div class="line">SPEVOL  DSTMAS  IFOADD  IVOL  IWDHF  NSTRIP</div>
</div><!-- fragment --><ul>
<li><code>SPEVOL: real</code>: Specific volume (cross-section area) of element, <img class="formulaInl" alt="$[L^2]$" src="form_135.png"/></li>
<li><code>DSTMAS: real</code>: Distributed mass of element, <img class="formulaInl" alt="$[M/L]$" src="form_136.png"/></li>
<li><code>IFOADD: integer, default: 1</code>: Parameter defining wave force integration method:<ul>
<li><code>IFOADD = 1</code>: Force integrated to actual wave elevation</li>
<li><code>IFOADD = 0</code>: Force integrated to z=0 (strictly linear wave theory)</li>
</ul>
</li>
<li><code>IVOL: integer, default: 1</code>: Parameter for load types<ul>
<li><code>IVOL = 0</code>: Gravity and buoyancy NOT included</li>
<li><code>IVOL = 1</code>: Gravity and buoyancy force included</li>
</ul>
</li>
<li><code>IWDHF: integer, default: 2</code>: Include wave particle velocity and acceleration?<ul>
<li><code>IWDHF = 0</code>: No</li>
<li><code>IWDHF = 1</code>: Velocity only (drag forces)</li>
<li><code>IWDHF = 2</code>: Velocity and acceleration</li>
<li><code>IWDHF= 3</code>: Velocity only (strip 1 and <code>NSTRIP</code> only)</li>
<li><code>IWDHF= 4</code>: Velocity and acceleration (strip 1 and <code>NSTRIP</code> only)</li>
</ul>
</li>
<li><code>NSTRIP: integer, default: 10</code>: Number of strips</li>
</ul>
<p>For <code>IWDHF = 3</code> or <code>4</code>, the wave kinematics will only be calculated in the mid point of strip 1 and <code>NSTRIP</code>. Linear interpolation is used to find velocity, acceleration and wave elevation for the other strips.</p>
<p>In a normal analysis of a pipe (or other slender element) in the splash zone, the following values should be used: <code>IFOADD = 1</code>, <code>IVOL = 1</code>, <code>IWDHF = 2</code></p>
<h4>Element end coordinates in body fixed coordinate system and a reference point to specify the direction of the local y-axis</h4>
<p>1 input line. </p>
<div class="fragment"><div class="line">XEL1 YEL1 ZEL1 XEL2 YEL2 ZEL2 XREF YREF ZREF</div>
</div><!-- fragment --><ul>
<li><code>XEL1: real</code>: X-coordinate end point 1, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>YEL1: real</code>: Y-coordinate end point 1, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>ZEL1: real</code>: Z-coordinate end point 1, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>XEL2: real</code>: X-coordinate end point 2, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>YEL2: real</code>: Y-coordinate end point 2, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>ZEL2: real</code>: Z-coordinate end point 2, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>XREF: real</code>:</li>
<li><code>YREF: real</code>:</li>
<li><code>ZREF: real</code>:</li>
</ul>
<p>[<code>XREF,YREF,ZREF</code>] is used to specify the orientation of the local XY-plane of the slender element. The local X-axis goes from point 1 to point 2. This point is an arbitrary point in the local XY-plane off the X-axis which defines the direction of the positive Y-axis.</p>
<p>The longitudinal axis is the element x-axis, directed from end 1 to end 2.</p>
<div class="image">
<img src="app-a_image008.png" alt="app-a_image008.png"/>
<div class="caption">
Coordinate system [XS,YS,ZS] of the slender element</div></div>
<h4>Hydrodynamic coefficients, in local element coordinate system, 1 input line.</h4>
<div class="fragment"><div class="line">C2X C2Y  C2Z  C1X  C1Y  C1Z  AMX  AMY  AMZ</div>
</div><!-- fragment --><ul>
<li><code>C2X: real</code>: Quadratic longitudinal drag coefficient <img class="formulaInl" alt="$[FT^2/L^3]$" src="form_137.png"/></li>
<li><code>C2Y: real</code>: Quadratic transverse (Y) drag coefficient <img class="formulaInl" alt="$[FT^2/L^3]$" src="form_137.png"/></li>
<li><code>C2Z: real</code>: Quadratic transverse (Z) drag coefficient <img class="formulaInl" alt="$[FT^2/L^3]$" src="form_137.png"/></li>
<li><code>C1X: real</code>: Linear longitudinal drag coefficient <img class="formulaInl" alt="$[FT^2/L^3]$" src="form_137.png"/></li>
<li><code>C1Y: real</code>: Linear transverse (Y) drag coefficient <img class="formulaInl" alt="$[FT/L^2]$" src="form_138.png"/></li>
<li><code>C1Z: real</code>: Linear longitudinal (Z) drag coefficient <img class="formulaInl" alt="$[FT/L^2]$" src="form_138.png"/></li>
<li><code>AMX: real</code>: Longitudinal added mass coefficient <img class="formulaInl" alt="$[M/L]$" src="form_136.png"/></li>
<li><code>AMY: real</code>: Transverse (Y) added mass coefficient <img class="formulaInl" alt="$[M/L]$" src="form_136.png"/></li>
<li><code>AMZ: real</code>: Transverse (Z) added mass coefficient <img class="formulaInl" alt="$[M/L]$" src="form_136.png"/></li>
</ul>
<p>The coefficients are given with dimension, and are valid for a fully submerged strip.</p>
<h3><a class="anchor" id="ug_body_distributed_slender_application"></a>
Application of diffracted waves</h3>
<p>The diffracted wave points given below must contain diffracted wave transfer functions both for wave elevation and for velocity in x, y and z direction.</p>
<h4>1 identification input line.</h4>
<div class="fragment"><div class="line">DIFFracted WAVE APPLication</div>
</div><!-- fragment --><h4>1 input line.</h4>
<div class="fragment"><div class="line">CHBDYD</div>
</div><!-- fragment --><ul>
<li><code>CHBDYD: character(8)</code>: Name of body for which transfer functions for diffracted waves are given</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">IPDIFF1</div>
</div><!-- fragment --><ul>
<li><code>IPDIFF1: integer</code>: Diffracted wave point number associated with element end 1</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">IPDIFF2</div>
</div><!-- fragment --><ul>
<li><code>IPDIFF2: integer</code>: Diffracted wave point number associated with element end 2</li>
</ul>
<h3><a class="anchor" id="ug_body_distributed_slender_depth"></a>
Depth dependent scaling of hydrodynamic coefficients</h3>
<p>As an additional modelling option, the user may specify depth dependent scaling of hydrodynamic coefficients. The following group (position dependent data) is not mandatory. If the element will be fully submerged and assumed unaffected by surface effects throughout the simulation, the data group will not be relevant and can be omitted. However, if a fixed element or a slender element with nearly horizontal angle crosses the water surface, the slamming force is calculated only if the position depended data are given.</p>
<p>The depth dependent scaling coefficients are applied to the centre of each strip, and are mainly intended for nearly horizontal slender elements or fixed body elements. For tilted elements a scaling factor will be calculated, proportional to the submerged part of each strip.</p>
<h4>1 identification input line</h4>
<div class="fragment"><div class="line">DEPTH-dependent HYDRodynamic COEFficients</div>
</div><!-- fragment --><h4>1 input line</h4>
<div class="fragment"><div class="line">NDEPTH ZCOEF</div>
</div><!-- fragment --><ul>
<li><code>NDEPTH: integer</code>: Number of depths for which hydrodynamic coefficients are given</li>
<li><code>ZCOEF: real, default: 0</code>: Vertical position used as reference for depth dependency, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
</ul>
<p>The hydrodynamic coefficients will be found by interpolation. Input for interpolation in the ZD table is</p>
<ul>
<li><img class="formulaInl" alt="$ \mathrm{Zin = Z - ZCOEF - \xi \quad (IFOADD = 1)}$" src="form_139.png"/></li>
<li><img class="formulaInl" alt="$ \mathrm{Zin = Z - ZCOEF \quad \quad \:\; (IFOADD = 0)}$" src="form_140.png"/></li>
</ul>
<p>where <img class="formulaInl" alt="$ \mathrm{Zin}$" src="form_141.png"/> is the vertical position of the strip center, and <img class="formulaInl" alt="$ \xi $" src="form_142.png"/> is the wave elevation.</p>
<h4>The following pairs of input lines have to be given for increasing or decreasing vertical position, ZD.</h4>
<p>2*<code>NDEPTH</code> input lines </p>
<div class="fragment"><div class="line">ZD RVOL RAMX RAMY RAMZ</div>
</div><!-- fragment --><ul>
<li><code>ZD: real, default: 1</code>: Vertical position, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>RVOL: real, default: 1</code>: Volume relative to fully submerged volume</li>
<li><code>RAMX: real, default: 1</code>: Relative added mass in longitudinal, local element x-direction</li>
<li><code>RAMY: real, default: 1</code>: Relative added mass in local element y-direction</li>
<li><code>RAMZ: real, default: 1</code>: Relative added mass in local element z-direction</li>
</ul>
<div class="fragment"><div class="line">RCLX RCLY RCLZ RCQX RCQY RCQZ</div>
</div><!-- fragment --><ul>
<li><code>RCLX: real</code>: Relative linear drag in longitudinal direction (local element x-direction)</li>
<li><code>RCLY: real</code>: Relative linear drag in local element y-direction</li>
<li><code>RCLZ: real</code>: Relative linear drag in local element z-direction</li>
<li><code>RCQX: real</code>: Relative quadratic drag in longitudinal direction (local element x-direction)</li>
<li><code>RCQY: real</code>: Relative quadratic drag in local element y-direction</li>
<li><code>RCQZ: real</code>: Relative quadratic drag in local element z-direction</li>
</ul>
<h3><a class="anchor" id="ug_body_distributed_slender_wind"></a>
Wind force on slender element.</h3>
<p>As an option, the user may get wind forces on slender elements. This is obtained by adding the new optional sub-group <code>AERODYNAMIC DESCRIPTION</code>.</p>
<h4>1 identification input line</h4>
<div class="fragment"><div class="line">AEROdynamic   DESCription</div>
</div><!-- fragment --><h4>Load description type</h4>
<div class="fragment"><div class="line">CHTYPE</div>
</div><!-- fragment --><ul>
<li><code>CHTYPE: character</code>: Type of aerodynamic force (only option available at the moment)<ul>
<li><code>= DRAG</code> =&gt; Morison-like loading. Drag term</li>
</ul>
</li>
</ul>
<h4>If CHTYPE=DRAG, Wind drag coefficients, in local element coordinate system, 1 input line.</h4>
<div class="fragment"><div class="line">CVX    CVY    CVZ</div>
</div><!-- fragment --><ul>
<li><code>CVX: real</code>: Quadratic longitudinal drag coefficient <img class="formulaInl" alt="$[FT^2/L^3]$" src="form_137.png"/></li>
<li><code>CVY: real</code>: Quadratic transverse (Y) drag coefficient <img class="formulaInl" alt="$[FT^2/L^3]$" src="form_137.png"/></li>
<li><code>CVZ: real</code>: Quadratic transverse (Z) drag coefficient <img class="formulaInl" alt="$[FT^2/L^3]$" src="form_137.png"/></li>
</ul>
<h2><a class="anchor" id="ug_body_distributed_fixed"></a>
Fixed body element</h2>
<h4>1 identification input line.</h4>
<div class="fragment"><div class="line">FIXEd BODY ELEMent</div>
</div><!-- fragment --><h4>1 input line</h4>
<div class="fragment"><div class="line">VOL  MASS  IFOADD  IVOL  IWDHF</div>
</div><!-- fragment --><ul>
<li><code>VOL: real</code>: Volume of element, <img class="formulaInl" alt="$[L^3]$" src="form_143.png"/></li>
<li><code>MASS: real</code>: Mass of element, <img class="formulaInl" alt="$[M]$" src="form_71.png"/></li>
<li><code>IFOADD: integer, default: 1</code>: Parameter defining wave force integration method:<ul>
<li><code>IFOADD = 1</code>: Force integrated to actual wave elevation</li>
<li><code>IFOADD = 0</code>: Force integrated to z=0 (strictly linear wave theory)</li>
</ul>
</li>
<li><code>IVOL: integer, default: 1</code>: Include gravity and buoyancy forces?<ul>
<li><code>IVOL = 0</code>: Gravity and buoyancy NOT included</li>
<li><code>IVOL = 1</code>: Gravity and buoyancy force included</li>
</ul>
</li>
<li><code>IWDHF: integer</code>: Include wave particle velocity and acceleration<ul>
<li><code>IWDHF = 0</code>: No</li>
<li><code>IWDHF = 1</code>: Velocity only (drag forces)</li>
<li><code>IWDHF = 2</code>: Velocity and acceleration</li>
</ul>
</li>
</ul>
<p>In a normal analysis of a concentrated, force attracting element in the splash zone, the following values should be used: <code>IFOADD = 1</code>, <code>IVOL = 1</code>, <code>IWDHF = 2</code></p>
<h4>Element coordinates and axis definition in body fixed coordinate system, 1 input line.</h4>
<div class="fragment"><div class="line">XEL  YEL  ZEL  XELX YELX ZELX XELY YELY ZELY</div>
</div><!-- fragment --><ul>
<li><code>XEL: real</code>: X-coordinate of element, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>YEL: real</code>: Y-coordinate of element, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>ZEL: real</code>: Z-coordinate of element, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>XELX: real</code>:</li>
<li><code>YELX: real</code>:</li>
<li><code>ZELX: real</code>:</li>
<li><code>XELY: real</code>:</li>
<li><code>YELY: real</code>:</li>
<li><code>ZELY: real</code>:</li>
</ul>
<p>[<code>XELX,YELX,ZELX</code>] = reference point defining the element X axis</p>
<p>[<code>XELY,YELY,ZELY</code>] = reference point in the local XY-plane of the element.</p>
<div class="image">
<img src="coord_sys_bf_element.svg" alt="coord_sys_bf_element.svg"/>
<div class="caption">
Coordinate system of the body fixed element</div></div>
<h4>Hydrodynamic coefficients, in local element coordinate system, 1 input line.</h4>
<div class="fragment"><div class="line">C2X C2Y  C2Z  C1X  C1Y  C1Z  AMX  AMY  AMZ</div>
</div><!-- fragment --><ul>
<li><code>C2X: real</code>: Quadratic longitudinal (X) drag <img class="formulaInl" alt="$[FT^2/L^2]$" src="form_144.png"/></li>
<li><code>C2Y: real</code>: Quadratic transverse (Y) drag <img class="formulaInl" alt="$[FT^2/L^2]$" src="form_144.png"/></li>
<li><code>C2Z: real</code>: Quadratic transverse (Z) drag <img class="formulaInl" alt="$[FT^2/L^2]$" src="form_144.png"/></li>
<li><code>C1X: real</code>: Linear longitudinal (X) drag <img class="formulaInl" alt="$[FT/L]$" src="form_145.png"/></li>
<li><code>C1Y: real</code>: Linear transverse (Y) drag <img class="formulaInl" alt="$[FT/L]$" src="form_145.png"/></li>
<li><code>C1Z: real</code>: Linear transverse (Z) drag <img class="formulaInl" alt="$[FT/L]$" src="form_145.png"/></li>
<li><code>AMX: real</code>: Longitudinal added mass <img class="formulaInl" alt="$[M]$" src="form_71.png"/></li>
<li><code>AMY: real</code>: Transverse (Y) added mass <img class="formulaInl" alt="$[M]$" src="form_71.png"/></li>
<li><code>AMZ: real</code>: Transverse (Z) added mass <img class="formulaInl" alt="$[M]$" src="form_71.png"/></li>
</ul>
<p>The coefficients are given with dimension, and are valid for a fully submerged element.</p>
<h3><a class="anchor" id="ug_body_distributed_fixed_application"></a>
Application of diffracted waves</h3>
<p>The diffracted wave points given below must contain diffracted wave transfer functions both for wave elevation and for velocity in x, y and z direction.</p>
<h4>1 identification input line.</h4>
<div class="fragment"><div class="line">DIFFracted WAVE APPLication</div>
</div><!-- fragment --><h4>1 input line.</h4>
<div class="fragment"><div class="line">CHBDYD</div>
</div><!-- fragment --><ul>
<li><code>CHBDYD: character(8)</code>: Name of body for which diff. wave TRF’s are given</li>
</ul>
<h4>1 line</h4>
<div class="fragment"><div class="line">IPDIFF</div>
</div><!-- fragment --><ul>
<li><code>IPDIFF: integer</code>: Diffracted point number to be associated with element</li>
</ul>
<h3><a class="anchor" id="ug_body_distributed_fixed_depth"></a>
Depth dependent scaling coefficients</h3>
<p>As an additional modelling option, the user may specify depth dependent hydrodynamic scaling coefficients. The following group (position dependent data) is not mandatory. If the element will be fully submerged and assumed unaffected by surface effects throughout the simulation, the data group will not be relevant and can be omitted. However, if a fixed element or a slender element with nearly horizontal angle crosses the water surface, omitting the position dependent data may result in large impulse forces.</p>
<p>The depth dependent scaling coefficients are applied to the centre of each strip, and are mainly intended for nearly horizontal slender elements or fixed body elements. For tilted elements a scaling factor will be calculated, proportional to the submerged part of each strip.</p>
<p>This data group, when used, should follow directly after the four input lines for the element.</p>
<h4>1 identification input line</h4>
<div class="fragment"><div class="line">DEPTh-dependent HYDRodynamic COEFficients</div>
</div><!-- fragment --><h4>1 input line</h4>
<div class="fragment"><div class="line">NDEPTH ZCOEF</div>
</div><!-- fragment --><ul>
<li><code>NDEPTH: integer</code>: Number of depths for which hydrodynamic coefficients are given</li>
<li><code>ZCOEF: real, default: 0</code>: Vertical position used as reference for depth dependency, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
</ul>
<p>The hydrodynamic coefficients will be found by interpolation. Input for interpolation in the ZD table is</p>
<ul>
<li><img class="formulaInl" alt="$ \mathrm{Zin = Z - ZCOEF - \xi \quad (IFOADD = 1)}$" src="form_139.png"/></li>
<li><img class="formulaInl" alt="$ \mathrm{Zin = Z - ZCOEF \quad \quad \:\; (IFOADD = 0)}$" src="form_140.png"/></li>
</ul>
<p>where <img class="formulaInl" alt="$ \mathrm{Zin}$" src="form_141.png"/> is the vertical position and <img class="formulaInl" alt="$ \xi $" src="form_142.png"/> is the wave elevation.</p>
<h4>The following pairs of input lines have to be given for increasing or decreasing vertical position, ZD.</h4>
<p>2*<code>NDEPTH</code> input lines </p>
<div class="fragment"><div class="line">ZD RVOL RAMX RAMY RAMZ</div>
</div><!-- fragment --><ul>
<li><code>ZD: real, default: 1</code>: Vertical position, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>RVOL: real, default: 1</code>: Volume relative to fully submerged volume</li>
<li><code>RAMX: real, default: 1</code>: Relative added mass in longitudinal direction (local element x-direction)</li>
<li><code>RAMY: real, default: 1</code>: Relative added mass in local element y-direction.</li>
<li><code>RAMZ: real, default: 1</code>: Relative added mass in local element z-direction</li>
</ul>
<div class="fragment"><div class="line">RCLX RCLY RCLZ RCQX RCQY RCQZ</div>
</div><!-- fragment --><ul>
<li><code>RCLX: real</code>: Relative linear drag in longitudinal direction (local element x-direction)</li>
<li><code>RCLY: real</code>: Relative linear drag in local element y-direction</li>
<li><code>RCLZ: real</code>: Relative linear drag in local element z-direction</li>
<li><code>RCQX: real</code>: Relative quadratic drag in longitudinal, local element x-direction</li>
<li><code>RCQY: real</code>: Relative quadratic drag in local element y-direction</li>
<li><code>RCQZ: real</code>: Relative quadratic drag in local element z-direction</li>
</ul>
<h3><a class="anchor" id="ug_body_distributed_fixed_wind"></a>
Wind force on fixed body element.</h3>
<p>As an additional option, the user may get wind forces at slender elements. This is obtained by adding the new optional sub-group <code>AERODYNAMIC DESCRIPTION</code>. The obtained wind force will be added to the wind force time series.</p>
<h4>1 identification input line</h4>
<div class="fragment"><div class="line">AEROdynamic   DESCription</div>
</div><!-- fragment --><h4>Load description type</h4>
<div class="fragment"><div class="line">CHTYPE</div>
</div><!-- fragment --><ul>
<li><code>CHTYPE: character</code>: Type of aerodynamic force (only one option available at the moment)<ul>
<li><code>= DRAG</code> =&gt; Morison-like loading. Drag term</li>
</ul>
</li>
</ul>
<h4>If CHTYPE=DRAG, Wind drag coefficients, in local element coordinate system, 1 input line.</h4>
<div class="fragment"><div class="line">CVX    CVY    CVZ</div>
</div><!-- fragment --><ul>
<li><code>CVX: real</code>: Quadratic longitudinal drag coefficient <img class="formulaInl" alt="$[FT^2/L^2]$" src="form_144.png"/></li>
<li><code>CVY: real</code>: Quadratic transverse (Y) drag coefficient <img class="formulaInl" alt="$[FT^2/L^2]$" src="form_144.png"/></li>
<li><code>CVZ: real</code>: Quadratic transverse (Z) drag coefficient <img class="formulaInl" alt="$[FT^2/L^2]$" src="form_144.png"/></li>
</ul>
<h1><a class="anchor" id="ug_body_small"></a>
Small body hydrodynamic data (including soil penetration)</h1>
<h4>1 identification input line</h4>
<div class="fragment"><div class="line">SMALl BODY HYDRodynamic data</div>
</div><!-- fragment --><h4>Text for describing small-body hydrodynamic data, 2 input lines</h4>
<div class="fragment"><div class="line">CHTEXT</div>
</div><!-- fragment --><ul>
<li><code>CHTEXT: character(60)</code>: Character string</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">SVOL</div>
</div><!-- fragment --><ul>
<li><code>SVOL: real</code>: Fully submerged volume, <img class="formulaInl" alt="$[L^3]$" src="form_143.png"/></li>
</ul>
<p>Added mass and drag force coefficients are specified for the fully submerged body in 3 degrees of freedom that coincide with the body fixed X, Y and Z directions:</p>
<h4>Added mass data, 1 input line</h4>
<div class="fragment"><div class="line">SAMX SAMY SAMZ</div>
</div><!-- fragment --><ul>
<li><code>SAMX: real</code>: Added mass in X-direction <img class="formulaInl" alt="$[M]$" src="form_71.png"/></li>
<li><code>SAMY: real</code>: Added mass in Y-direction <img class="formulaInl" alt="$[M]$" src="form_71.png"/></li>
<li><code>SAMZ: real</code>: Added mass in Z-direction <img class="formulaInl" alt="$[M]$" src="form_71.png"/></li>
</ul>
<h4>Linear drag data, 1 input line</h4>
<div class="fragment"><div class="line">SC1X   SC1Y   SC1Z</div>
</div><!-- fragment --><ul>
<li><code>SC1X: real</code>: Linear drag coefficient in X-direction, <img class="formulaInl" alt="$[FT/L]$" src="form_145.png"/></li>
<li><code>SC1Y: real</code>: Linear drag coefficient in Y-direction, <img class="formulaInl" alt="$[FT/L]$" src="form_145.png"/></li>
<li><code>SC1Z: real</code>: Linear drag coefficient in Z-direction, <img class="formulaInl" alt="$[FT/L]$" src="form_145.png"/></li>
</ul>
<h4>Quadratic drag data, 1 input line</h4>
<div class="fragment"><div class="line">SC2X   SC2Y   SC2Z</div>
</div><!-- fragment --><ul>
<li><code>SC2X: real</code>: Quadratic drag coefficient in X-direction, <img class="formulaInl" alt="$[F(T/L)^2]$" src="form_146.png"/></li>
<li><code>SC2Y: real</code>: Quadratic drag coefficient in Y-direction, <img class="formulaInl" alt="$[F(T/L)^2]$" src="form_146.png"/></li>
<li><code>SC2Z: real</code>: Quadratic drag coefficient in Z-direction, <img class="formulaInl" alt="$[F(T/L)^2]$" src="form_146.png"/></li>
</ul>
<h2><a class="anchor" id="ug_body_small_depth"></a>
Depth dependent hydrodynamic forces</h2>
<h4>1 identification input line</h4>
<div class="fragment"><div class="line">DEPTH-dependent HYDRodynamic COEFficients</div>
</div><!-- fragment --><h4>1 input line</h4>
<div class="fragment"><div class="line">NDEPTH ZCOEF IREF</div>
</div><!-- fragment --><ul>
<li><code>NDEPTH: integer</code>: Number of depths for which hydrodynamic coefficients are given</li>
<li><code>ZCOEF: real</code>: Vertical position used as reference for depth dependency, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>IREF: integer, default: 1</code>: Reference for depth dependency<ul>
<li><code>= 1</code>: Wave elevation</li>
<li><code>= 2</code>: Still water level</li>
</ul>
</li>
</ul>
<h4>2*NDEPTH input lines</h4>
<div class="fragment"><div class="line">ZD  RVOL  RAMX  RAMY  RAMZ</div>
</div><!-- fragment --><ul>
<li><code>ZD: real</code>: Vertical position, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>RVOL: real</code>: Volume relative to fully submerged volume</li>
<li><code>RAMX: real</code>: Relative added mass in X-direction</li>
<li><code>RAMY: real</code>: Relative added mass in Y-direction</li>
<li><code>RAMZ: real</code>: Relative added mass in Z-direction</li>
</ul>
<div class="fragment"><div class="line">RC1X   RC1Y   RC1Z   RC2X   RC2Y   RC2Z</div>
</div><!-- fragment --><ul>
<li><code>RC1X: real</code>: Relative linear drag in X-direction</li>
<li><code>RC1Y: real</code>: Relative linear drag in Y-direction</li>
<li><code>RC1Z: real</code>: Relative linear drag in Z-direction</li>
<li><code>RC2X: real</code>: Relative quadratic drag in X-direction</li>
<li><code>RC2Y: real</code>: Relative quadratic drag in Y-direction</li>
<li><code>RC2Z: real</code>: Relative quadratic drag in Z-direction</li>
</ul>
<h2><a class="anchor" id="ug_body_small_application"></a>
Application of diffracted waves</h2>
<p>The diffracted wave points given below must contain diffracted wave transfer functions both for wave elevation and for velocity in x, y and z direction.</p>
<h4>1 identification input line.</h4>
<div class="fragment"><div class="line">DIFFracted WAVE APPLication</div>
</div><!-- fragment --><h4>1 input line</h4>
<div class="fragment"><div class="line">CHBDYD</div>
</div><!-- fragment --><ul>
<li><code>CHBDYD: character(8)</code>: Name of body for which diff. wave TRF’s are given</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">IPDIFF</div>
</div><!-- fragment --><ul>
<li><code>IPDIFF: integer</code>: Diffracted point number to be associated with this body</li>
</ul>
<h2><a class="anchor" id="ug_body_small_soil"></a>
Soil penetration model</h2>
<h4>1 identifying input line</h4>
<div class="fragment"><div class="line">SOIL PENEtration</div>
</div><!-- fragment --><h4>1 input line</h4>
<div class="fragment"><div class="line">ISOIL   NDFRIC   NDCAP</div>
</div><!-- fragment --><ul>
<li><code>ISOIL: integer</code>: Soil force control parameter<ul>
<li><code>= 1</code>: Friction model for open compartment</li>
<li><code>= 2</code>: Friction model with soil fracture</li>
<li><code>= 11</code>: Friction model for open compartment including horizontal sliding</li>
</ul>
</li>
<li><code>NDFRIC: integer</code>: Number of depths with friction forces</li>
<li><code>NDCAP: integer</code>: Number of depths with soil capacity (dummy for <code>ISOIL = 1</code> and <code>11</code>)</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">ZCONT   PENETR  BAREA   SODENS   CAREA    IHSOIL</div>
</div><!-- fragment --><ul>
<li><code>ZCONT: real</code>: Vertical global coordinate of the body giving first contact with the soil (landing), <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>BAREA: real</code>: Soil buoyancy cross section area, <img class="formulaInl" alt="$[L^2]$" src="form_135.png"/></li>
<li><code>SODENS: real</code>: Soil mass density, <img class="formulaInl" alt="$[M/L^3]$" src="form_147.png"/></li>
<li><code>CAREA: real</code>: Section area of cavity <img class="formulaInl" alt="$[L^2]$" src="form_135.png"/> (Dummy for <code>ISOIL 1</code> &amp; <code>11</code>)</li>
<li><code>IHSOIL: integer, default: 0</code>: Import of seabed depth values from HLA, Depth value replaces <code>ZCONT</code><ul>
<li><code>IHSOIL = 0</code>: No import</li>
<li><code>IHSOIL = 1</code>: Import</li>
</ul>
</li>
</ul>
<h4>NDFRIC input lines</h4>
<div class="fragment"><div class="line">DFRIC   FTIPDO   FTIPUP   FWALL FRICH</div>
</div><!-- fragment --><ul>
<li><code>DFRIC: real</code>: Penetration relative to <code>ZCONT</code> (positive upwards), <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>FTIPDO: real</code>: Depth dependent tip force for DOWNward motion, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>FTIPUP: real</code>: Depth dependent tip force for UPward motion, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>FWALL: real</code>: Depth dependent skirt friction force for both upwards and downwards motion, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>FRICH: real &gt;= 0</code>: Depth dependent friction force in horizontal direction, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
</ul>
<p><code>FRICH</code> is dummy for <code>ISOIL = 1</code>, <code>2</code></p>
<p><code>FTIPUP</code> should be negative</p>
<div class="image">
<img src="app-a_image010.png" alt="app-a_image010.png"/>
<div class="caption">
Soil penetration parameters</div></div>
<h3>Soil penetration parameters for friction model with soil fracture</h3>
<h4>For ISOIL = 2, NDCAP input lines</h4>
<div class="fragment"><div class="line">DCAP  SOILFR  FRCDEP PSUCT</div>
</div><!-- fragment --><ul>
<li><code>DCAP: real</code>: Penetration relative to <code>ZCONT</code> (positive upwards)</li>
<li><code>SOILFR: real</code>: Soil capacity against failure at soil surface, <img class="formulaInl" alt="$\left[F/L^2\right]$" src="form_149.png"/></li>
<li><code>FRCDEP: real</code>: Depth of each new soil failure, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>PSUCT: real</code>: Suction pressure <img class="formulaInl" alt="$\left[F/L^2\right]$" src="form_149.png"/></li>
</ul>
<h4>For ISOIL = 2, 1 input line</h4>
<div class="fragment"><div class="line">WSTIFF  TSUCT CFLOW</div>
</div><!-- fragment --><ul>
<li><code>WSTIFF: real</code>: Stiffness due to compressibility of water inside the cavity, <img class="formulaInl" alt="$[F/L]$" src="form_150.png"/></li>
<li><code>TSUCT: real</code>: Time for starting suction pumps, <img class="formulaInl" alt="$[T]$" src="form_70.png"/></li>
<li><code>CFLOW: real</code>: Flow coefficient in/out of closed compartment, <img class="formulaInl" alt="$\left[L^3/T\left(F/L^3\right)^{0.5}\right]$" src="form_151.png"/></li>
</ul>
<h1><a class="anchor" id="ug_body_specified"></a>
Specified forces</h1>
<h4>1 identification input line</h4>
<div class="fragment"><div class="line">SPECified FORCe</div>
</div><!-- fragment --><h4>Text describing the specified force, 2 input lines</h4>
<div class="fragment"><div class="line">TXSPF</div>
</div><!-- fragment --><ul>
<li><code>TXSPF: character(60)</code>: Character string</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">NCOMP   EHLA</div>
</div><!-- fragment --><ul>
<li><code>NCOMP: integer</code>: Number of force components</li>
<li><code>EHLA: integer, default: 0</code>: HLA export flag for specified force<ul>
<li><code>EHLA = 0</code>: No export</li>
<li><code>EHLA = 1</code>: HLA export</li>
</ul>
</li>
</ul>
<h4>For EHLA = 1, 1 input line, HLA name of specified force object,</h4>
<div class="fragment"><div class="line">CHSHLA</div>
</div><!-- fragment --><ul>
<li><code>CHSHLA: character(120)</code>: HLA force object name (identifier)</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">IMETH  IDOF/IMOM</div>
</div><!-- fragment --><ul>
<li><code>IMETH: integer</code>: Method for applying the force<ul>
<li><code>= 1</code>: Force/moment in specified degree of freedom (body fixed system)</li>
<li><code>= 2</code>: Force/moment acting in a point on the body, direction specified in the body fixed system and following its motion.</li>
<li><code>= 3</code>: Force/moment acting in a point on the body, direction is constant and specified in the global coordinate system.</li>
</ul>
</li>
<li><code>IDOF / IMOM: integer</code>:<ul>
<li>Degree of freedom (<code>IDOF=1-6</code>) for <code>IMETH=1</code></li>
<li>Force or moment (<code>IMOM</code>) for <code>IMETH=2</code> or <code>3</code><ul>
<li><code>IMOM = 0</code>: Force</li>
<li><code>IMOM = 1</code>: Moment</li>
</ul>
</li>
</ul>
</li>
</ul>
<h4>1 input line for IMETH=2, IMETH=3</h4>
<div class="fragment"><div class="line">XP  YP  ZP  DV1  DV2  DV3</div>
</div><!-- fragment --><ul>
<li><code>XP: real</code>: X-coordinate in body fixed coordinate system</li>
<li><code>YP: real</code>: Y-coordinate in body fixed coordinate system</li>
<li><code>ZP: real</code>: Z-coordinate in body fixed coordinate system</li>
<li><code>DV1: real</code>: Direction vector, x-component</li>
<li><code>DV2: real</code>: Direction vector, y-component</li>
<li><code>DV3: real</code>: Direction vector, z-component</li>
</ul>
<p>Direction vectors are defined in body fixed coordinate system for <code>IMETH=2</code> and in global coordinate system for <code>IMETH=3</code>. They will be normalized in the input module. Coordinates <code>XP</code>, <code>YP</code>, and <code>ZP</code> are dummy for <code>IMOM=1</code>.</p>
<h4>Force component description, NCOMP input lines.</h4>
<div class="fragment"><div class="line">IFORTY TON TOFF P1 P2 P3</div>
</div><!-- fragment --><ul>
<li><code>IFORTY: integer</code>: Force component type<ul>
<li><code>= 1</code>: Constant force</li>
<li><code>= 2</code>: Harmonic force</li>
<li><code>= 3</code>: Ramp</li>
</ul>
</li>
<li><code>TON: real, default: 0</code>: Time for switching component on, <img class="formulaInl" alt="$[T]$" src="form_70.png"/></li>
<li><code>TOFF: real, default: 100000</code>: Time for switching component off, <img class="formulaInl" alt="$[T]$" src="form_70.png"/><ul>
<li>Force comp. <code>= 0.</code> if time &gt;= <code>TOFF</code></li>
</ul>
</li>
<li><code>P1: real</code>: Force component parameter<ul>
<li><code>IFORTY=1</code>: Magnitude, <img class="formulaInl" alt="$[F,FL]$" src="form_152.png"/></li>
<li><code>IFORTY=2</code>: Amplitude, <img class="formulaInl" alt="$[F,FL]$" src="form_152.png"/></li>
<li><code>IFORTY=3</code>: Force derivative, <img class="formulaInl" alt="$[F/T,FL/T]$" src="form_153.png"/></li>
</ul>
</li>
<li><code>P2: real</code>: Force component parameter<ul>
<li><code>IFORTY=1</code>: Dummy</li>
<li><code>IFORTY=2</code>: Period, <img class="formulaInl" alt="$[T]$" src="form_70.png"/></li>
<li><code>IFORTY=3</code>: Dummy</li>
</ul>
</li>
<li><code>P3: real</code>: Force component parameter<ul>
<li><code>IFORTY=1</code>: Dummy</li>
<li><code>IFORTY=2</code>: Phase, forward phase shift to a sine wave (cf. Theory Manual) <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
<li><code>IFORTY=3</code>: Dummy</li>
</ul>
</li>
</ul>
<h1><a class="anchor" id="ug_body_general"></a>
General external forces</h1>
<p>For each body there may be defined several external force models. They are numbered according to the location on the system description file.</p>
<h4>1 identification input line.</h4>
<div class="fragment"><div class="line">EXTErnal FORCes</div>
</div><!-- fragment --><h4>Text for describing external forces, 2 input lines.</h4>
<div class="fragment"><div class="line">TXEXT</div>
</div><!-- fragment --><ul>
<li><code>TXEXT: character(60)</code>: Character string describing external force</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">IEXTF  ICOORD    EHLA</div>
</div><!-- fragment --><ul>
<li><code>IEXTF: integer, default: 2</code>: Flag for type of external force interface<ul>
<li><code>= 1</code>: User-supplied general external force library (DLL)</li>
<li><code>= 2</code>: External force time series from file</li>
<li><code>= 3</code>: HLA, attack point of force given in sysfile</li>
<li><code>= 4</code>: HLA, attack point of force is imported from HLA</li>
</ul>
</li>
<li><code>ICOORD: integer, default: 0</code>: Flag for which coordinate system the force is given in<ul>
<li><code>= 0</code>: Global coordinate system</li>
<li><code>= 1</code>: Body fixed coordinate system</li>
</ul>
</li>
<li><code>EHLA: integer, default: 0</code>: HLA export flag for external force<ul>
<li><code>= 0</code>: No export</li>
<li><code>= 1</code>: HLA export <code>EHLA</code> is dummy for <code>IEXTF = 3</code> and <code>4</code>. HLA name is automatically set to <code>ExtFor[No]_[HLA_Bodyname]</code>.</li>
</ul>
</li>
</ul>
<h4>Main parameters, 1 input line (Dummy for external force time series from file, IEXTF = 2)</h4>
<div class="fragment"><div class="line">NINT  NREA  NSTO  NSTR</div>
</div><!-- fragment --><ul>
<li><code>NINT: integer, default: 0</code>: Number of integer input parameters</li>
<li><code>NREA: integer, default: 0</code>: Number of real input parameters</li>
<li><code>NSTO: integer, default: 0</code>: Number of parameters for intermediate storage</li>
<li><code>NSTR: integer, default: 0</code>: Number of input strings</li>
</ul>
<h4>Integer parameters, NINT pairs of input lines (Dummy for external force time series from file, IEXTF = 2)</h4>
<div class="fragment"><div class="line">TXINT</div>
</div><!-- fragment --><ul>
<li><code>TXINT: character(60)</code>: Character string describing integer parameter</li>
</ul>
<div class="fragment"><div class="line">INTn</div>
</div><!-- fragment --><ul>
<li><code>INTn: integer</code>: Integer parameter no n</li>
</ul>
<h4>Real parameters, NREA pairs of input lines (Dummy for external force time series from file, IEXTF = 2)</h4>
<div class="fragment"><div class="line">TXREA</div>
</div><!-- fragment --><ul>
<li><code>TXREA: character(60)</code>: Character string describing real parameter</li>
</ul>
<div class="fragment"><div class="line">REAn</div>
</div><!-- fragment --><ul>
<li><code>REAn: real</code>: Real parameter no n</li>
</ul>
<h4>String parameters, NSTR input lines (Dummy for external force time series from file, IEXTF = 2)</h4>
<div class="fragment"><div class="line">TXSTRn</div>
</div><!-- fragment --><ul>
<li><code>TXSTRn: character(120)</code>: Character string no n</li>
</ul>
<h4>Force point of attack, 1 input line (Dummy for IEXTF = 3)</h4>
<div class="fragment"><div class="line">XP YP ZP</div>
</div><!-- fragment --><ul>
<li><code>XP: real, default: 0</code>: X-coordinate in body fixed coordinate system</li>
<li><code>YP: real, default: 0</code>: Y-coordinate in body fixed coordinate system</li>
<li><code>ZP: real, default: 0</code>: Z-coordinate in body fixed coordinate system</li>
</ul>
<h4>Initial force used by STAMOD, 1 input line, (Dummy for IEXTF=1)</h4>
<div class="fragment"><div class="line">FX  FY  FZ  MX  MY  MZ</div>
</div><!-- fragment --><ul>
<li><code>FX: real, default: 0</code>: Force in X-direction, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>FY: real, default: 0</code>: Force in Y-direction, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>FX: real, default: 0</code>: Force in Z-direction, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>MX: real, default: 0</code>: Moment about X-axis, <img class="formulaInl" alt="$[FL]$" src="form_154.png"/></li>
<li><code>MY: real, default: 0</code>: Moment about Y-axis, <img class="formulaInl" alt="$[FL]$" src="form_154.png"/></li>
<li><code>MZ: real, default: 0</code>: Moment about Z-axis, <img class="formulaInl" alt="$[FL]$" src="form_154.png"/></li>
</ul>
<p>For HLA import the forces and moments are given in global system (<code>IEXTFO=3</code> or <code>IEXTFO=4</code>)</p>
<h4>1 input line</h4>
<div class="fragment"><div class="line">TXXGF</div>
</div><!-- fragment --><ul>
<li><code>TXXGF: character(120)</code>:<ul>
<li><code>IEXTF = 1</code>: Character string, path and library filename</li>
<li><code>IEXTF = 2</code>: Character string, path and force filename</li>
<li><code>IEXTF = 3</code>: Character string, HLA object name</li>
<li><code>IEXTF = 4</code>: Character string, HLA object name</li>
</ul>
</li>
</ul>
<p>The file format for forces imported from file (<code>IEXTFO = 2</code>) is described in the section <a class="el" href="a00036.html#ug_description_external">External force time series imported from file</a>.</p>
<h4>For DLL import of force (IEXTF = 1), 1 input line</h4>
<div class="fragment"><div class="line">NPCUR</div>
</div><!-- fragment --><ul>
<li><code>NPCUR: integer &gt; 0</code>: Number of points where current velocities shall be given to the external force library.</li>
</ul>
<h1><a class="anchor" id="ug_body_wind_turbine"></a>
Wind turbine specification</h1>
<p>This data group enables the user to model a Horizontal Axis Wind Turbine (HAWT) considering wind load acting on the rigid blades and control system for blade pitch and electrical power extraction.</p>
<p>In order to model a wind turbine a minimum of two bodies is required; one body to represent the blades, hub and the slow-speed shaft (the present rotor body) and one body to represent the support structure for the rotor. For application of the electrical torque moment a moment coupling between the bodies has to be included.</p>
<p>It is assumed that the origin of the body fixed rotor coordinate system coincides with the hub centre with X-axis aligned in the direction with the rotor (slow speed) shaft i.e. from the hub towards the support.</p>
<p>The wind loads on the blades are computed based on the load coefficient description in the air foil library file and together with a blade element momentum (BEM) method. The applied BEM code includes dynamic inflow, i.e. a time delay on changes of induced velocity related to the time it takes to convect vorticity in the wake downstream, away from the rotor. With dynamic inflow, the BEM method will give correct time series of rotor and blade loads under conditions of changing blade pitch angle, wind speed and direction, and tower motion. The main features of the BEM theory are:</p>
<ul>
<li>Induced velocity is calculated assuming momentum balance for a ring-shaped control volume.</li>
<li>Blade sections are treated as independent.</li>
<li>Aerodynamic coefficients from wind tunnel tests are used for the blades.</li>
<li>Empirical corrections are used for tip-vortices and cascade effects / lift amplification.</li>
</ul>
<p>The BEM theory is a proven, simple and CPU efficient method to simulate rotor aerodynamics and the method represents the industry standard.</p>
<h3>Requirements to wind turbine modelling</h3>
<ul>
<li>Support body and rotor (present) body with 6 degrees of freedom.</li>
<li>Moment coupling attached to the rotor body in direction parallel with body fixed X-axis, i.e. moment around the X-axis.</li>
</ul>
<h3>Recommendations to wind turbine modelling</h3>
<p>The rotor body and the support body may be connected by use of</p>
<ul>
<li>2 docking cone couplings to transfer radial forces.<ul>
<li>Each docking cone coupling has its contact point located in the rotor body X-axis and its cone attached to the support body. A distance between the two contact points on the rotor axis is necessary in order to transfer moments about y- and z-axes. The orientation of the direction vector of the docking cones should be coincident with the rotor body X-axis.</li>
</ul>
</li>
<li>1 axial force coupling between the rotor body and the support body to transfer axial rotor force.<ul>
<li>The axial force coupling should be aligned with the rotor body X-axis.</li>
</ul>
</li>
</ul>
<p>Note that the applied electrical torque is handled by <code>MOMENT COUPLING</code>. Thus, no constant moment should be specified for the coupling. Any specified torsional stiffness will be set to zero during dynamic analysis.</p>
<p>A principal sketch of a coupling system between rotor body and support body of a wind turbine system is presented in the figure <a class="el" href="a00024.html#Principal_sketch_of_the_coupling_system">Principal sketch of the coupling system between rotor body and support body (nacelle) of a wind turbine system</a>.</p>
<h4>1 identification input line</h4>
<div class="fragment"><div class="line">WIND TURBine SPECification</div>
</div><!-- fragment --><h4>1 input line</h4>
<div class="fragment"><div class="line">AIRFOILIB</div>
</div><!-- fragment --><ul>
<li><code>AIRFOILIB: character(256)</code>: Name including the path of the file that contains the airfoil coefficient library</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">CH_WITURB</div>
</div><!-- fragment --><ul>
<li><code>CH_WITURB: character(8)</code>: Wind turbine identifier</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">ZCOEF   WIAREA</div>
</div><!-- fragment --><ul>
<li><code>ZCOEF: real</code>: Ref. height for calc of wind</li>
<li><code>WIAREA: real</code>: Admittance function</li>
</ul>
<p>Note that <code>ZCOEF</code> and <code>WIAREA</code> are dummy for <code>IWITYP&gt;=10</code>.</p>
<h4>File for control system specification. 1 input line</h4>
<div class="fragment"><div class="line">CH_CONTROL</div>
</div><!-- fragment --><ul>
<li><code>CHCODE: character(4)</code>:<ul>
<li><code>CHCODE = INTC</code>: Internal control system</li>
<li><code>CHCODE = EXTC</code>: External control system</li>
</ul>
</li>
</ul>
<h4>Specification internal control system, CHCODE = INTC, 1 input line</h4>
<div class="fragment"><div class="line">CONTROLFILE</div>
</div><!-- fragment --><ul>
<li><code>CONTROLFILE: character(256)</code>: Name including the path of the file that contains input to the internal control system</li>
</ul>
<p>For additional details regarding the internal control system specification, see the RIFLEX User Manual, Input to INPMOD, Additional Input Files, Specification of internal control system for blade pitch and electrical power. Note that the internal controller is not identical to the one specified during the <code>NREL</code> study.</p>
<h4>Specification external control system, CHCODE = EXTC, 3 input lines</h4>
<p>The input to SIMO for the external wind turbine control system requires the (path and) name of the executable .jar file, the class to be used within that .jar file, and the (path and) name of a file which may contain input data for the external control. For additional details regarding the interface, see the RIFLEX User Manual, Input to Inpmod, Additional Input Files, Interface for external wind turbine control system.</p>
<div class="fragment"><div class="line">JarName</div>
</div><!-- fragment --><div class="fragment"><div class="line">ClassName</div>
</div><!-- fragment --><div class="fragment"><div class="line">Config</div>
</div><!-- fragment --><h4>1 input line</h4>
<div class="fragment"><div class="line">CH_CPL</div>
</div><!-- fragment --><ul>
<li><code>CH_CPL: character(8)</code>: Name of moment coupling (<code>MOMENT1</code>)</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">ROUT   RCANG</div>
</div><!-- fragment --><ul>
<li><code>ROUT: real</code>: Outer airfoil radius <img class="formulaInl" alt="$ [L]$" src="form_80.png"/></li>
<li><code>RCANG: real</code>: Cone angle <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">NB   NEB</div>
</div><!-- fragment --><ul>
<li><code>NB: integer</code>: Number of blades</li>
<li><code>NEB: integer</code>: Number of el. per blade</li>
</ul>
<h4>NEB input lines</h4>
<div class="fragment"><div class="line">CH_FOIL   EL_LENG   CHORD     TWIST</div>
</div><!-- fragment --><ul>
<li><code>CH_FOIL: character(8)</code>: Airfoil identifier</li>
<li><code>EL_LENG: real</code>: Blade element length <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>CHORD: real</code>: Chord length of the foil profile <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>TWIST: real</code>: Twist angle <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
</ul>
<p><a class="anchor" id="Principal_sketch_of_the_coupling_system"></a> </p>
<div class="image">
<img src="app-a_image011.png" alt="app-a_image011.png"/>
<div class="caption">
Principal sketch of the coupling system between rotor body and support body (nacelle) of a wind turbine system</div></div>
<h1><a class="anchor" id="ug_body_vawt"></a>
Vertical axis wind turbine specification</h1>
<p>This data group enables the user to model a Vertical Axis Wind Turbine (VAWT), considering wind loads acting on the rigid blades and a control system for generator torque.</p>
<p>In order to model a wind turbine a minimum of two bodies is required; one body to represent the blades, hub and the slow-speed shaft (the present rotor body) and one body to represent the support structure for the rotor. For application of the electrical torque moment a moment coupling between the bodies has to be included. It is assumed that the origin of the body fixed rotor coordinate system coincides with the hub centre with Z-axis aligned in the direction with the rotor (slow speed) shaft, i.e from the support to the hub. The wind loads on the blades are computed based on the load coefficient description in the airfoil library file together with a double-multiple streamtube blade element momentum method. The approach includes dynamic stall effects (Øye-type model).</p>
<h3>Requirements for vertical axis wind turbine modelling</h3>
<ul>
<li>Support body and rotor (present) body with 6 degrees of freedom.</li>
<li>Moment coupling attached to the rotor body in direction parallel with body fixed Z-axis, ie. moment around the Z-axis</li>
</ul>
<h3>Recommendations for vertical axis wind turbine modelling</h3>
<p>The rotor body and the support body may be connected by use of</p>
<ul>
<li>2 docking cone couplings to transfer radial forces.<ul>
<li>Each docking cone coupling has its contact point located in the rotor body Z-axis and its cone attached to the support body. A distance between the two contact points on the rotor axis is necessary in order to transfer moments about x- and y-axes. The orientation of the direction vector of the docking cones should be coincident with the rotor body Z-axis.</li>
</ul>
</li>
<li>1 axial force coupling between the rotor body and the support body to transfer axial rotor force.<ul>
<li>The axial force coupling should be aligned with the rotor body Z-axis.</li>
</ul>
</li>
</ul>
<p>Note that the applied electrical torque is handled by <code>MOMENT COUPLING</code>. Thus, no constant moment should be specified for the coupling. Any specified torsional stiffness will be set to zero during dynamic analysis.</p>
<p>The coupling system between rotor body and support body of a vertical axis wind turbine system is the same as in the figure <a class="el" href="a00024.html#Principal_sketch_of_the_coupling_system">Principal sketch of the coupling system between rotor body and support body (nacelle) of a wind turbine system</a>, but rotated by 90 degrees.</p>
<h4>1 identification input line</h4>
<div class="fragment"><div class="line">VERTical AXIS TURBine </div>
</div><!-- fragment --><h4>1 input line</h4>
<div class="fragment"><div class="line">AIRFOILIB</div>
</div><!-- fragment --><ul>
<li><code>AIRFOILIB: character(256)</code>: Name including the path of the file that contains the airfoil coefficient library</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">CH_WITURB</div>
</div><!-- fragment --><ul>
<li><code>CH_WITURB: character(8)</code>: Wind turbine identifier</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">ZCOEF   WIAREA</div>
</div><!-- fragment --><ul>
<li><code>ZCOEF: real</code>: Ref. height for calc of wind</li>
<li><code>WIAREA: real</code>: Admittance function</li>
</ul>
<p>Note that <code>ZCOEF</code> and <code>WIAREA</code> are dummy for <code>IWITYP&gt;=10</code>.</p>
<h4>File for control system specification. 1 input line</h4>
<div class="fragment"><div class="line">CH_CONTROL</div>
</div><!-- fragment --><ul>
<li><code>CH_CONTROL: character(4)</code>: <code>= INTC</code> Internal control system</li>
</ul>
<p>For control system specification, see <a class="el" href="a00036.html#vawt_intc_specification">Specification of internal control system for VAWT generator torque and electrical power</a>.</p>
<h4>1 input line</h4>
<p>Note that the controller is not identical to the one specified during the <code>NREL</code> study. </p>
<div class="fragment"><div class="line">CONTROLFILE</div>
</div><!-- fragment --><ul>
<li><code>CONTROLFILE: character(256)</code>: Name including the path of the file that contains input to the internal control system</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">CH_CPL</div>
</div><!-- fragment --><ul>
<li><code>CH_CPL: character(8)</code>: Name of moment coupling (<code>MOMENT1</code>)</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">R0   Z0   VW_OFF</div>
</div><!-- fragment --><ul>
<li><code>R0: real</code>: Blade radius at lowest node <img class="formulaInl" alt="$ [L]$" src="form_80.png"/></li>
<li><code>Z0: real</code>: Elevation of the lowest node <img class="formulaInl" alt="$ [L]$" src="form_80.png"/></li>
<li><code>VW_OFF: real</code>: Tangential offset of the first blade node <img class="formulaInl" alt="$ [L]$" src="form_80.png"/></li>
</ul>
<p><code>R0</code>, <code>Z0</code> and <code>VW_OFF</code> (indicated as <code>offset</code>) are shown in the figure <a class="el" href="a00024.html#Vertical_axis_wind_turbine">Vertical axis wind turbine geometrical input (side views of one blade)</a>.</p>
<h4>1 input line</h4>
<div class="fragment"><div class="line">NB   NEB  NCOL</div>
</div><!-- fragment --><ul>
<li><code>NB: integer</code>: Number of blades</li>
<li><code>NEB: integer</code>: Number of elements per blade</li>
<li><code>NCOL: integer</code>: Number of azimuthal elements</li>
</ul>
<p>Note that <code>NEB</code> must be at least 2.</p>
<h4>NEB input lines</h4>
<div class="fragment"><div class="line">CH_FOIL   NODE_R NODE_Z NODE_OFF  CHORD     TWIST</div>
</div><!-- fragment --><ul>
<li><code>CH_FOIL: character(8)</code>: Airfoil identifier</li>
<li><code>NODE_R: real</code>: Radius of the second node of the element <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>NODE_Z: real</code>: Elevation of the second node of the element <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>NODE_OFF: real</code>: Offset of the second node of the element from the <img class="formulaInl" alt="$(r,z)$" src="form_155.png"/> plane <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>CHORD: real</code>: Chord length of the foil profile <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>TWIST: real</code>: Static twist angle <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
</ul>
<p>The node coordinates <code>NODE_R</code> and <code>NODE_Z</code> are denoted as <img class="formulaInl" alt="$ (R,Z)_i $" src="form_156.png"/> for element i in the figure <a class="el" href="a00024.html#Vertical_axis_wind_turbine">Vertical axis wind turbine geometrical input (side views of one blade)</a>.</p>
<h4>1 input line</h4>
<div class="fragment"><div class="line">PRAND</div>
</div><!-- fragment --><ul>
<li><code>PRAND: real, default: -1 (calculated by program)</code>: Prandtl factor.</li>
</ul>
<p>For <code>PRAND</code> greater than or equal to zero, the given Prandtl factor is applied to all elements. For <code>PRAND</code> less than zero or default, the Prandtl factor is calculated in the normal way by the program. It is recommended to set the factor to 1.0 when analyzing a Darrieus rotor. The Prandtl factor should be calculated by the program when analyzing an H-rotor.</p>
<p><a class="anchor" id="Vertical_axis_wind_turbine"></a></p>
<div class="image">
<img src="VAWT_input.svg" alt="VAWT_input.svg"/>
<div class="caption">
Vertical axis wind turbine geometrical input (side views of one blade)</div></div>
<h1><a class="anchor" id="ug_body_positioning"></a>
Positioning system data</h1>
<h4>1 identification input line</h4>
<div class="fragment"><div class="line">POSItioning SYSTem DATA</div>
</div><!-- fragment --><h4>Text describing the positioning system, 2 input lines.</h4>
<div class="fragment"><div class="line">TXPOS</div>
</div><!-- fragment --><ul>
<li><code>TXPOS: character(60)</code>: Character string</li>
</ul>
<p>The positioning elements are divided into the following groups:</p>
<ul>
<li>Catenary anchor lines described by line properties. This is the recommended method to specify mooring lines. Line characteristics will be calculated within the program.</li>
<li>Directly specified catenary anchor line characteristic. Horizontal and vertical components can be specified for different vertical positions of fairlead.</li>
<li>Force-elongation relationship with fixed attack points. The force is directed between the end points. - Docking cone, giving a radial force at offset from target.</li>
<li>Force-elongation relationship with sliding attack points, fender.</li>
<li>Thrusters.</li>
</ul>
<p>If the positioning system includes thrusters, they may be controlled by a dynamic positioning system (DP), which is specified separately.</p>
<h2><a class="anchor" id="ug_body_positioning_catenary"></a>
Catenary anchor lines</h2>
<h4>1 identifying input line</h4>
<div class="fragment"><div class="line">CATEnary SYSTem  DATA</div>
</div><!-- fragment --><h4>1 identifying line if HLA export of catenary system is wanted</h4>
<div class="fragment"><div class="line">HLA EXPOrt</div>
</div><!-- fragment --><h4>If HLA EXPOrt is specified the HLA name (identifier) of the catenary system has to be specified:</h4>
<p>1 input line </p>
<div class="fragment"><div class="line">CHPHLA</div>
</div><!-- fragment --><ul>
<li><code>CHPHLA: character(120)</code>: Character string describing HLA catenary object name</li>
</ul>
<p>By <b>catenary mooring system</b> is meant all the catenary mooring lines connected to one body. A catenary mooring system is built from three data groups:</p>
<ul>
<li><code>LINE DATA</code></li>
<li><code>LINE CHARACTERISTICS DATA</code></li>
<li><code>BUOY DATA</code></li>
</ul>
<p>Each mooring line must be uniquely specified by a set of <code>LINE DATA</code>. Typical line data are fairlead coordinates, line direction, pre-tension and winch run length.</p>
<p>Each line must refer to a line characteristics specified by <code>LINE CHARacteristics DATA</code>. The line characteristics (force-displacement relationship) may be given directly, or by the data needed by <code>SIMO</code> to calculate it. Such data may typically be segment properties (weight, stiffness, drag coefficients), vertical position of the anchor and bottom slope. Several lines within one catenary system may refer to the same line characteristics.</p>
<p>If the line characteristics are to be calculated by <code>SIMO</code>, the user may include buoys in the intersection between line segments. The buoys may have depth dependent buoyancy, and are specified by the <code>BUOY DATA</code>. Several line characteristics may refer to the same buoy data.</p>
<p>It is important that for one catenary system, the data are given in the correct order:</p>
<ol type="1">
<li>the LINE DATA for all the lines</li>
<li>the LINE CHARacteristics DATA</li>
<li>the BUOY DATA.</li>
</ol>
<h3>Line data</h3>
<h4>1 identifying input line</h4>
<div class="fragment"><div class="line">LINE  DATA</div>
</div><!-- fragment --><h4>1 input line</h4>
<div class="fragment"><div class="line">ILINE   LICHAR   IMETH   IWIRUN     ICPRO</div>
</div><!-- fragment --><ul>
<li><code>ILINE: integer</code>: Line number. The line numbers must be given in increasing order.</li>
<li><code>LICHAR: integer</code>: Identification number for line characteristics data which shall be used for this line (confer data group <code>LINE CHARacteristics DATA</code>)</li>
<li><code>IMETH: integer</code>: Method for initialization of line<ul>
<li><code>= 1</code>: Initial tension and local direction specified</li>
<li><code>= 2</code>: Distance to anchor and local direction specified</li>
<li><code>= 3</code>: Anchor coordinates (global) specified</li>
</ul>
</li>
<li><code>IWIRUN: integer</code>: Parameter for winch running<ul>
<li><code>= 0</code>: The winch is not run</li>
<li><code>= 1</code>: The winch may be run</li>
</ul>
</li>
<li><code>ICPRO: integer, default: 0</code>: Calculate line profile to be exported for visualization<ul>
<li><code>= 0</code>: Export line profile as a straight line</li>
<li><code>= 1</code>: Export catenary line profile</li>
</ul>
</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">XBDY   YBDY   ZBDY</div>
</div><!-- fragment --><ul>
<li><code>XBDY: real</code>: X-coordinate of attachment point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>YBDY: real</code>: Y-coordinate of attachment point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>ZBDY: real</code>: Z-coordinate of attachment point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
</ul>
<h4>for IMETH = 1, 1 input line</h4>
<div class="fragment"><div class="line">DIR   PRETEN   XWINCH</div>
</div><!-- fragment --><ul>
<li><code>DIR: real</code>: Direction of line in horizontal plane, <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
<li><code>PRETEN: real</code>: Pretension, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>XWINCH: real: default: 0</code>: Run length of winch, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
</ul>
<h4>for IMETH = 2, 1 input line</h4>
<div class="fragment"><div class="line">DIR   XHOR   XWINCH</div>
</div><!-- fragment --><ul>
<li><code>DIR: real</code>: Direction of line in horizontal plane, <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
<li><code>XHOR: real</code>: Horizontal distance from attachment point to anchor, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>XWINCH: real, default: 0</code>: Run length of winch, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
</ul>
<h4>for IMETH = 3, 1 input line</h4>
<div class="fragment"><div class="line">XGLB   YGLB    XWINCH</div>
</div><!-- fragment --><ul>
<li><code>XGLB: real</code>: X-coordinate of the anchor in global coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>YGLB: real</code>: Y-coordinate of the anchor in global coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>XWINCH: real, default: 0</code>: Run length of winch, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
</ul>
<h4>Element failure, 1 input line</h4>
<div class="fragment"><div class="line">IFMOPO FTIME BTENS</div>
</div><!-- fragment --><ul>
<li><code>IFMOPO: integer</code>: Failure mode of positioning element<ul>
<li><code>= 0</code>: no failure</li>
<li><code>= 1</code>: failure by exceedance of tension after specified time</li>
</ul>
</li>
<li><code>FTIME: real</code>: Earliest possible time of failure, <img class="formulaInl" alt="$[T]$" src="form_70.png"/></li>
<li><code>BTENS: real</code>: Breaking strength, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
</ul>
<p>The line breaks when both <code>FTIME</code> and <code>BTENS</code> are exceeded.</p>
<h3>Line characteristics data</h3>
<h4>1 identifying input line</h4>
<div class="fragment"><div class="line">LINE  CHARacteristics DATA</div>
</div><!-- fragment --><h4>1 input line</h4>
<div class="fragment"><div class="line">LICHAR   LINPTY   NPTH   NPTV   VMIN    VMAX</div>
</div><!-- fragment --><ul>
<li><code>LICHAR: integer</code>: Line characteristics number. The characteristics number must be given in increasing order.</li>
<li><code>LINPTY: integer</code>: Parameter for input of line characteristics<ul>
<li><code>= 1</code>: Direct input of line characteristics by the user</li>
<li><code>= 2</code>: Line segment data are given as input, and <code>SIMO</code> will compute the line characteristics, shooting method</li>
<li><code>= 3</code>: As 2, including a simplified line dynamics model. Allowed for body type = 2 only.</li>
<li><code>= 4</code>: Line segment data are given as input, and <code>SIMO</code> will compute the line characteristics based on Finite Element Model (FEM method).</li>
</ul>
</li>
<li><code>NPTH: integer, default: 40</code>: Number of points in the line characteristics matrix, offset variation in the horizontal plane.</li>
<li><code>NPTV: integer, default: 5</code>: Number of points in the line characteristics matrix, offset variation in the vertical plane.</li>
<li><code>VMIN: real &lt;= 0</code>: Minimum relative z-position for which the line characteristics will be calculated.<ul>
<li>Dummy for <code>LINPTY=1</code></li>
</ul>
</li>
<li><code>VMAX: real &gt;= 0</code>: Maximum relative z-position for which the line characteristics will be calculated.</li>
</ul>
<p>If <code>VMAX</code> is omitted, <code>VMIN</code> is taken as the vertical range, <code>VRANGE</code> (<code>&gt;0</code>) where <code>VMIN = -VRANGE/2</code> and <code>VMAX =VRANGE/2</code></p>
<h4>if LINPTY=1, NPTH input lines</h4>
<div class="fragment"><div class="line">DISTH</div>
</div><!-- fragment --><ul>
<li><code>DISTH: real</code>: Horizontal distance between attachment point on vessel and anchor, must be given in increasing order, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
</ul>
<h4>if LINPTY=1, NPTV input lines</h4>
<div class="fragment"><div class="line">DISTV</div>
</div><!-- fragment --><ul>
<li><code>DISTV: real</code>: Vertical distance between attachment point on vessel and anchor, must be given in increasing order, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
</ul>
<p><code>DISTV = DEPTH +Z_fairlead</code> where <code>DEPTH</code> is positive.</p>
<h4>NPTV*NPTH lines if LINPTY=1 (start with NPTH lines with IPTV = 1)</h4>
<div class="fragment"><div class="line">IPTV  IPTH STATEN  ANG</div>
</div><!-- fragment --><ul>
<li><code>IPTV: integer</code>: Vertical distance number.</li>
<li><code>IPTH: integer</code>: Horizontal distance number</li>
<li><code>STATEN: real</code>: Static tension in line, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>ANG: real</code>: Angle relative to horizontal plane, <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
</ul>
<div class="image">
<img src="app-a_image012.png" alt="app-a_image012.png"/>
<div class="caption">
Catenary element parameters</div></div>
<h4>if LINPTY &gt; 1, 1 input line</h4>
<div class="fragment"><div class="line">NSEG   IBOTCO   SLOPE   ZGLB   TMAX THMIN</div>
</div><!-- fragment --><ul>
<li><code>NSEG: integer</code>: Number of line segments</li>
<li><code>IBOTCO: integer</code>: Bottom tangent option<ul>
<li><code>= 0</code>: No seafloor contact except at line end</li>
<li><code>= 1</code>: Seafloor contact included in the vicinity of the anchor line end</li>
</ul>
</li>
<li><code>SLOPE: real, default: 0</code>: Slope of the seabed, <code>SLOPE=0</code> means horizontal bottom slope. Positive <code>SLOPE</code> means that the seabed is sloping downwards from the anchor towards the attachment point.</li>
<li><code>ZGLB: real</code>: Z-coordinate of the anchor in global coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>TMAX: real</code>: Maximum tension to be used in the line characteristics calculations, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>THMIN: real, default: 0</code>: Minimum horizontal tension to be used for calculation of line characteristics, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
</ul>
<p>If number of vertical levels in line characteristics, <code>NPTV</code>, is larger than 1, the characteristics for the lowest level is calculated first. <code>TMAX</code> and <code>THMIN</code> are used for this level. If <code>THMIN</code> is set to zero, the first point in the characteristics will be for a tension as low as possible for the algorithm. For the other vertical levels, the characteristics are calculated for the same horizontal distances <code>XHOR</code> as for the lowest level. (<code>XHOR</code>=horizontal distance between fairlead and anchor).</p>
<h4>if LINPTY &gt; 1, NSEG input lines</h4>
<div class="fragment"><div class="line">ISEG   IELTYP   NEL   IBUOY   SLENG   FRIC   NEA   ITYNEA</div>
</div><!-- fragment --><ul>
<li><code>ISEG: integer</code>: Local segment number</li>
<li><code>IELTYP: integer</code>: Segment type<ul>
<li><code>= 0</code>: Catenary segment</li>
<li><code>= 1</code>: Rigid segment</li>
</ul>
</li>
<li><code>NEL: integer</code>: Number of elements</li>
<li><code>IBUOY: integer</code>: Buoy in end 1 of the segment, which is the end closest to the anchor<ul>
<li><code>= 0</code>: No buoy in end 1</li>
<li><code>&gt; 0</code>: Buoy number <code>IBUOY</code> in end 1, referring to buoy in data group <code>BUOY</code></li>
</ul>
</li>
<li><code>SLENG: real</code>: Length of the segment, <img class="formulaInl" alt="$ [L]$" src="form_80.png"/></li>
<li><code>FRIC: real</code>: Friction coefficient between line and sea bottom</li>
<li><code>NEA: integer, default: 0</code>:<ul>
<li><code>= 0</code>: Linear elongation data for this segment</li>
<li><code>&gt; 1</code>: Number of points in elongation curve</li>
</ul>
</li>
<li><code>ITYNEA: integer</code>:<ul>
<li><code>= 1</code>: Stress-strain curve with <code>NEA</code> points is given</li>
<li><code>= 2</code>: Tension-strain curve with <code>NEA</code> points is given</li>
</ul>
</li>
</ul>
<p>The segment numbers must be given in increasing order and the first segment is at the anchor.</p>
<h4>if LINPTY &gt; 1, NSEG input lines</h4>
<div class="fragment"><div class="line">ISEG   DIA   EMOD   EMFACT   UWIA   WATFAC   CDN   CDL</div>
</div><!-- fragment --><ul>
<li><code>ISEG: integer</code>: Local segment number</li>
<li><code>DIA: real</code>: Segment diameter, <img class="formulaInl" alt="$ [L]$" src="form_80.png"/></li>
<li><code>EMOD: real</code>: Modulus of elasticity <img class="formulaInl" alt="$ [F/L^2]$" src="form_157.png"/></li>
<li><code>EMFAC: real</code>: Factor of elasticity<ul>
<li><code>= 2</code>: Chain</li>
<li><code>= 1</code>: Other segment types</li>
</ul>
</li>
<li><code>UWIA: real</code>: Unit weight in air, <img class="formulaInl" alt="$ [F/L]$" src="form_158.png"/></li>
<li><code>WATFAC: real</code>: The ratio of weight in water to weight in air<ul>
<li>Normally <code>0.81</code> for steel wire rope and <code>0.87</code> for chain</li>
</ul>
</li>
<li><code>CDN: real</code>: Transverse drag coefficient of the line</li>
<li><code>CDL: real</code>: Longitudinal drag coefficient of the line</li>
</ul>
<p>Total stiffness, <code>EA</code> = <code>EMOD</code> * <code>EMFAC</code> * <code>DIA</code>**2 * <img class="formulaInl" alt="$ \pi $" src="form_159.png"/>/4.</p>
<p>For the case where the simplified line dynamic model is used (<code>LINPTY = 3</code>) the (linear) <code>EMOD</code> is used as modulus of elasticity in the dynamic model.</p>
<p><code>CDN</code> and <code>CDL</code> are used in the line dynamics computation only.</p>
<ul>
<li>Drag force/length <code>= 0.5</code> * <code>RHOW</code> * <code>DIA</code> * <code>CDN</code> * <code>VN</code> <img class="formulaInl" alt="$^2 \quad $" src="form_160.png"/> Transverse</li>
<li>Drag force/length <code>= 0.5</code> * <code>RHOW</code> * <code>DIA</code> * <code>CDL</code> * <code>VL</code> <img class="formulaInl" alt="$^2 \quad $" src="form_160.png"/> Longitudinal</li>
</ul>
<p>where <code>VN</code> and <code>VL</code> are transverse and longitudinal velocity components.</p>
<h4>IF NEA &gt; 1, NEA input lines</h4>
<div class="fragment"><div class="line">STRESS/TENSION   STRAIN</div>
</div><!-- fragment --><ul>
<li><code>STRESS/ TENSION: real</code>: Stress or tension in segment</li>
<li><code>STRAIN: real</code>: Corresponding relative elongation of segment</li>
</ul>
<p>The first point has to be <code>(0., 0.)</code>. If stress-strain curve is given, a corresponding tension-strain curve will be calculated with</p>
<p><code>TENSION</code> <code>= STRESS</code> * <code>EMFAC</code> * <code>DIA</code>**2 * <img class="formulaInl" alt="$\pi$" src="form_161.png"/>/4</p>
<h4>Buoy data</h4>
<h4>1 identifying input line</h4>
<div class="fragment"><div class="line">BUOY DATA</div>
</div><!-- fragment --><h4>1 input line</h4>
<div class="fragment"><div class="line">IBUOY   NFZ</div>
</div><!-- fragment --><ul>
<li><code>IBUOY: integer</code>: Buoy number. <code>IBUOY</code> must be given from 1 to <code>NBUOY</code> in increasing order</li>
<li><code>NFZ: integer</code>: Number of points in the force vs. vertical position table</li>
</ul>
<h4>NFZ input lines</h4>
<div class="fragment"><div class="line">ZBUOY    FBUOY</div>
</div><!-- fragment --><ul>
<li><code>ZBUOY(i): real</code>: i'th vertical position in the force vs. vertical position table, <img class="formulaInl" alt="$[L]$" src="form_69.png"/><ul>
<li>For <code>NFZ=1</code>, <code>ZBUOY</code> is dummy, but must be given</li>
</ul>
</li>
<li><code>FBUOY(i): real</code>: Corresponding vertical force, positive upwards, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
</ul>
<p>Vertical Z-axis is positive upwards. <code>ZBUOY(i) = 0.0</code> means still water plane. <code>ZBUOY(i+1) &lt; ZBUOY(i)</code>. The buoy may first be specified in air by a positive z-value, and at last be specified fully submerged by a negative z-value.</p>
<h2><a class="anchor" id="ug_body_positioning_force"></a>
Force elongation with fixed attack points</h2>
<h4>1 identifying input line</h4>
<div class="fragment"><div class="line">FIXEd FORCe ELONgation</div>
</div><!-- fragment --><h4>1 input line</h4>
<div class="fragment"><div class="line">NPT  IMETH  EXP  PRETEN  DIR  ANG  INTPOM  VEMIFI  EHLA</div>
</div><!-- fragment --><ul>
<li><code>NPT: integer</code>: Number of points in characteristics</li>
<li><code>IMETH: integer</code>: Method for initialisation of positioning element<ul>
<li><code>= 1</code>: Pretension and local direction</li>
<li><code>= 2</code>: Pretension and global direction</li>
<li><code>= 3</code>: Coordinates of both end points</li>
<li><code>= 5</code>: “Constant tension winch", coordinates of both end points are given. Maximum and minimum tension specified in the characteristic will not be exceeded.</li>
</ul>
</li>
<li><code>EXP: real, default: 1</code>: Exponent of vel. in damping term</li>
<li><code>PRETEN: real</code>: Pretension, <img class="formulaInl" alt="$ [F]$" src="form_162.png"/><ul>
<li>Dummy for <code>IMETH = 3</code> and <code>5</code></li>
</ul>
</li>
<li><code>DIR: real</code>: Direction of line in horizontal plane, <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/><ul>
<li>Dummy for <code>IMETH = 3</code> and <code>5</code></li>
</ul>
</li>
<li><code>ANG: real</code>: Angle of line from horizontal plane (positive downwards), <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/><ul>
<li>Dummy for <code>IMETH = 3</code> and <code>5</code></li>
</ul>
</li>
<li><code>INTPOM: integer, default: 1</code>: Interpolation method = 1, 2, 3 or 4<ul>
<li><code>=1</code>: Linear force, linear damping.</li>
<li><code>=2</code>: Linear force, parabolic damping.</li>
<li><code>=3</code>: Parabolic force, linear damping.</li>
<li><code>=4</code>: Parabolic force, parabolic damping.</li>
</ul>
</li>
<li><code>VEMIFI: real, default: 0</code>: Velocity limit for friction force (<code>EXP = 0</code>) See below.</li>
<li><code>EHLA: integer, default: 0</code>: HLA export flag for positioning element<ul>
<li><code>EHLA = 0</code>: No export</li>
<li><code>EHLA = 1</code>: HLA export</li>
</ul>
</li>
</ul>
<p>Small velocities and <code>EXP=0.0</code> will result in problems in finding equilibrium position because the friction force (which may be relatively large) suddenly can change sign. To avoid this problem <code>SIMO</code> uses <code>EXP=1</code> when Abs(Vel.) &lt; <code>VEMIFI</code> and <code>EXP</code>&lt;1.</p>
<p>The damping force curve is continuous at Vel=<code>VEMIFI</code>.</p>
<h4>If EHLA = 1, a HLA name of force-elongation object has to specified, 1 input line</h4>
<div class="fragment"><div class="line">CHPHLA</div>
</div><!-- fragment --><ul>
<li><code>CHPHLA: character(120)</code>: Character string for HLA force-elongation object name</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">XBDY  YBDY  ZBDY   XGLB   YGLB   ZGLB</div>
</div><!-- fragment --><ul>
<li><code>XBDY: real</code>: X-coordinate of attack point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>YBDY: real</code>: Y-coordinate of attack point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>ZBDY: real</code>: Z-coordinate of attack point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>XGLB: real</code>: X-coordinate of end point in global coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/><ul>
<li>Dummy for <code>IMETH=1</code> and <code>IMETH=2</code></li>
</ul>
</li>
<li><code>YGLB: real</code>: Y-coordinate of end point in global coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/><ul>
<li>Dummy for <code>IMETH=1</code> and <code>IMETH=2</code></li>
</ul>
</li>
<li><code>ZGLB: real</code>: Z-coordinate of end point in global coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/><ul>
<li>Dummy for <code>IMETH=1</code> and <code>IMETH=2</code></li>
</ul>
</li>
</ul>
<h4>NPT input lines.</h4>
<div class="fragment"><div class="line">DIST  FORCE  DAMP</div>
</div><!-- fragment --><ul>
<li><code>DIST: real</code>: Distance between end points, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>FORCE: real</code>: Force in element, positive values signify attracting the body towards the element, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>DAMP: real</code>: Damping coefficient, <img class="formulaInl" alt="$\left[F(T/L)^{\mathrm{EXP}}\right]$" src="form_163.png"/></li>
</ul>
<p>Distances have to be given in increasing order and can not be negative.</p>
<h4>Element failure, 1 input line</h4>
<div class="fragment"><div class="line">IFMOPO FTIME BTENS</div>
</div><!-- fragment --><ul>
<li><code>IFMOPO: integer</code>: Failure mode of positioning element<ul>
<li><code>= 0</code>: No failure</li>
<li><code>= 1</code>: Failure by exceeding the breaking strength after specified time.</li>
<li><code>= 2</code>: Activation of positioning element after specified time if absolute value of force is below limit.</li>
</ul>
</li>
<li><code>FTIME: real</code>: Earliest possible time of failure (<code>IFMOPO = 1</code>) or earliest activation time (<code>IFMOPO = 2</code>), <img class="formulaInl" alt="$[T]$" src="form_70.png"/>.</li>
<li><code>BTENS: real</code>: Breaking strength (<code>IFMOPO = 1</code>) or maximum force for activation of positioning element (<code>IFMOPO = 2</code>), <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
</ul>
<p>For <code>IFMOPO = 1</code>, the element breaks when both <code>FTIME</code> and <code>BTENS</code> are exceeded.</p>
<p>For <code>IFMOPO = 2</code>, the element is activated when <code>FTIME</code> is exceeded and force is below <code>BTENS</code>.</p>
<h2><a class="anchor" id="ug_body_positioning_docking"></a>
Docking cone positioning</h2>
<h4>1 identifying input line</h4>
<div class="fragment"><div class="line">DOCKing CONE POSItioning</div>
</div><!-- fragment --><h4>1 input line</h4>
<div class="fragment"><div class="line">NPT  EXP  INTPOM  VEMIFI  EHLA</div>
</div><!-- fragment --><ul>
<li><code>NPT: integer</code>: Number of points in characteristics</li>
<li><code>EXP: real, default: 1</code>: Exponent of vel. in damping term</li>
<li><code>INTPOM: integer, default: 1</code>: Interpolation method = 1, 2, 3 or 4<ul>
<li><code>=1</code>: Linear force, linear damping.</li>
<li><code>=2</code>: Linear force, parabolic damping.</li>
<li><code>=3</code>: Parabolic force, linear damping.</li>
<li><code>=4</code>: Parabolic force, parabolic damping.</li>
</ul>
</li>
<li><code>VEMIFI: real, default: 0</code>: Velocity limit for friction force (<code>EXP = 0</code>) See below.</li>
<li><code>EHLA: integer, default: 0</code>: HLA export flag for positioning element<ul>
<li><code>EHLA = 0</code>: No export</li>
<li><code>EHLA = 1</code>: HLA export</li>
</ul>
</li>
</ul>
<p>Small velocities and <code>EXP=0</code> will result in problems in finding equilibrium position because the friction force (which may be relatively large) suddenly can change sign. To avoid this problem <code>SIMO</code> uses <code>EXP=1</code> when Abs(Vel.) &lt; <code>VEMIFI</code> and <code>EXP</code>&lt;1.</p>
<p>The damping force (<code>EXP=1</code>) for Vel=<code>VEMIFI</code> is equal to Damping force (<code>EXP</code>=as given).</p>
<h4>If EHLA = 1, a HLA name of force-elongation object has to be specified</h4>
<p>1 input line </p>
<div class="fragment"><div class="line">CHPHLA</div>
</div><!-- fragment --><ul>
<li><code>CHPHLA: character(120)</code>: Character string for HLA force-elongation object name</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">NAXPTS</div>
</div><!-- fragment --><ul>
<li><code>NAXPTS: integer</code>: Number of axial points with given force characteristics</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">RADMAX  FRIC</div>
</div><!-- fragment --><ul>
<li><code>RADMAX: real</code>: Maximum radial distance at entry</li>
<li><code>FRIC: real, default: 0</code>: Friction coefficient</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">XBDY YBDY ZBDY XGLB YGLB ZGLB</div>
</div><!-- fragment --><ul>
<li><code>XBDY: real</code>: X-coordinate of attack point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>YBDY: real</code>: Y-coordinate of attack point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>ZBDY: real</code>: Z-coordinate of attack point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>XGLB: real</code>: X-coordinate of end point (center of cone opening) in global coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>YGLB: real</code>: Y-coordinate of end point in global coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>ZGLB: real</code>: Z-coordinate of end point in global coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">DV1 DV2 DV3</div>
</div><!-- fragment --><ul>
<li><code>DV1: real, default: 0</code>: Direction vector, x-component</li>
<li><code>DV2: real, default: 0</code>: Direction vector, y-component</li>
<li><code>DV3: real, default: -1</code>: Direction vector, z-component</li>
</ul>
<p>The direction vector of the guide axis is defined in global coordinate system (direction from end of cylinder and inwards). It will be normalised in the input module.</p>
<h4>NAXPTS input lines</h4>
<div class="fragment"><div class="line">IAXPT AXPT</div>
</div><!-- fragment --><ul>
<li><code>IAXPT: integer</code>: Axial point number</li>
<li><code>AXPT: real</code>: Axial point, axial distance from end, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
</ul>
<h4>NAXPT * NPT input lines.</h4>
<div class="fragment"><div class="line">DIST FORCE DAMP</div>
</div><!-- fragment --><ul>
<li><code>DIST: real</code>: Radial distance (transverse offset), <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>FORCE: real</code>: Force in element, positive forces are attractive, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>DAMP: real</code>: Damping coefficient, <img class="formulaInl" alt="$\left[F(T/L)^{\mathrm{EXP}}\right]$" src="form_163.png"/></li>
</ul>
<p>Distances should be increasing and can not be negative, and each characteristic must have the same number of distances.</p>
<p>Force characteristics for each axial point, starting with point 1. At least one force value must be zero.</p>
<h4>Element failure, 1 input line</h4>
<div class="fragment"><div class="line">IFMOPO FTIME BTENS</div>
</div><!-- fragment --><ul>
<li><code>IFMOPO: integer</code>: Failure mode of positioning element<ul>
<li><code>= 0</code>: No failure</li>
<li><code>= 1</code>: Failure by exceeding the breaking strength after specified time.</li>
<li><code>= 2</code>: Activation of positioning element after specified time if absolute value of force is below limit.</li>
</ul>
</li>
<li><code>FTIME: real</code>: Earliest possible time of failure (<code>IFMOPO = 1</code>) or earliest activation time (<code>IFMOPO = 2</code>), <img class="formulaInl" alt="$[T]$" src="form_70.png"/>.</li>
<li><code>BTENS: real</code>: Breaking strength (<code>IFMOPO = 1</code>) or maximum force for activation of positioning element (<code>IFMOPO = 2</code>), <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
</ul>
<p>For <code>IFMOPO = 1</code>, the element breaks when both <code>FTIME</code> and <code>BTENS</code> are exceeded.</p>
<p>For <code>IFMOPO = 2</code>, the element is activated when <code>FTIME</code> is exceeded and force is below <code>BTENS</code>.</p>
<div class="image">
<img src="docking_cone_earth.svg" alt="docking_cone_earth.svg"/>
<div class="caption">
Example of docking device fixed to earth</div></div>
<h2><a class="anchor" id="ug_body_positioning_fender"></a>
Fender</h2>
<h4>1 identifying line</h4>
<div class="fragment"><div class="line">BERThing FENDer DATA</div>
</div><!-- fragment --><h4>1 input line</h4>
<div class="fragment"><div class="line">NPT  IFRIC  DYNFRIC  STAFRIC  STIFFRIC  EXP  IFIX  INTPO  VEMIN  EHLA</div>
</div><!-- fragment --><ul>
<li><code>NPT: integer</code>: Number of points in fender characteristics</li>
<li><code>IFRIC: integer</code>: Fender model<ul>
<li><code>= 1</code>: Fender point</li>
<li><code>= 2</code>: Fender roller (frictionless in one direction)</li>
</ul>
</li>
<li><code>DYNFRIC: real</code>: Friction coefficient, sliding</li>
<li><code>STAFRIC: real</code>: Friction coefficient, when not sliding (stiction)</li>
<li><code>STIFFRIC: real</code>: Shear stiffness associated with friction <img class="formulaInl" alt="$[F/L]$" src="form_150.png"/></li>
<li><code>EXP: real</code>: Exponent of velocity in damping term for compressive force</li>
<li><code>IFIX: integer, default: 0</code>: Fender attachment<ul>
<li><code>= 0</code>: Globally fixed point</li>
<li><code>= 1</code>: Body</li>
</ul>
</li>
<li><code>INTPO: integer, default: 1</code>: Interpolation method = 1,2,3 or 4<ul>
<li><code>=1</code>: Linear force, linear damping.</li>
<li><code>=2</code>: Linear force, parabolic damping.</li>
<li><code>=3</code>: Parabolic force, linear damping.</li>
<li><code>=4</code>: Parabolic force, parabolic damping.</li>
</ul>
</li>
<li><code>VEMIN: real, default: 0</code>: Velocity limit for normal friction force (<code>EXP=0</code>)</li>
<li><code>EHLA: integer, default: 0</code>: HLA export flag for fender<ul>
<li><code>EHLA = 0</code>: No export</li>
<li><code>EHLA = 1</code>: HLA export</li>
</ul>
</li>
</ul>
<p>Small velocities and <code>EXP=0</code> can result in a large normal friction force that suddenly changes sign. To avoid this, the value <code>EXP=1</code> is used when ABS(vel.) <code>&lt; VEMIN</code> and <code>EXP&lt;1</code>.</p>
<h4>If EHLA = 1, a HLA name of fender object has to be specified</h4>
<p>1 input line </p>
<div class="fragment"><div class="line">CHPHLA</div>
</div><!-- fragment --><ul>
<li><code>CHPHLA: character(120)</code>: Character string describing HLA fender object name</li>
</ul>
<div class="image">
<img src="app-a_image014.png" alt="app-a_image014.png"/>
<div class="caption">
Illustration of fender attachments</div></div>
<div class="image">
<img src="friction_force.svg" alt="friction_force.svg"/>
<div class="caption">
Example of friction force (here with constant normal force, AFORCE)</div></div>
<h4>Contact point,1 input line</h4>
<div class="fragment"><div class="line">XF   YF   ZF</div>
</div><!-- fragment --><ul>
<li><code>XF: real</code>: X-coordinate of fender attachment point, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>YF: real</code>: Y-coordinate of fender attachment point, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>ZF: real</code>: Z-coordinate of fender attachment point, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
</ul>
<p>Global coordinates if fender is attached to a globally fixed point (<code>IFIX = 0</code>).</p>
<p>Local body coordinates if fender is attached to the body (<code>IFIX = 1</code>).</p>
<h4>Definition of fender plane and roller axis, 1 input line</h4>
<div class="fragment"><div class="line">XP  YP   ZP   XN   YN   ZN   XA   YA   ZA</div>
</div><!-- fragment --><ul>
<li><code>XP: real</code>: X-coordinate of point in the fender plane <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>YP: real</code>: Y- coordinate of point in the fender plane <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>ZP: real</code>: Z- coordinate of point in the fender plane <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>XN: real</code>: X-comp. of vector normal to surface <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>YN: real</code>: Y-comp. of vector normal to surface <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>ZN: real</code>: Z-comp. of vector normal to surface <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>XA: real</code>: X-comp. of vector parallel to rotation axis <img class="formulaInl" alt="$[L]$" src="form_69.png"/><ul>
<li>Dummy for <code>IFRIC = 1</code></li>
</ul>
</li>
<li><code>YA: real</code>: Y-comp. of vector parallel to rotation axis <img class="formulaInl" alt="$[L]$" src="form_69.png"/><ul>
<li>Dummy for <code>IFRIC = 1</code></li>
</ul>
</li>
<li><code>ZA: real</code>: Z-comp. of vector parallel to rotation axis <img class="formulaInl" alt="$[L]$" src="form_69.png"/><ul>
<li>Dummy for <code>IFRIC = 1</code></li>
</ul>
</li>
</ul>
<p>Local body coordinates if fender is attached to a globally fixed point (<code>IFIX = 0</code>)</p>
<p>Global coordinates if fender is attached to the body (<code>IFIX = 1</code>)</p>
<p>For definition of fender plane dimensions, see the figure 'Illustration of fender plane dimensions' below.</p>
<h4>May be omitted in case of an unlimited fender plane is modeled, 1 input line</h4>
<div class="fragment"><div class="line">DV1X   DV1Y   DV1Z    RL1     RL2</div>
</div><!-- fragment --><p> Vector defining direction no. 1 of fender plane:</p>
<ul>
<li><code>DV1X: real</code>: X-component of vector defining direction no. 1</li>
<li><code>DV1Y: real</code>: Y-component of vector defining direction no. 1</li>
<li><code>DV1Z: real</code>: Z-component of vector defining direction no. 1</li>
<li><code>RL1: real</code>: Dimension of fender plane in direction 1</li>
<li><code>RL2: real</code>: Dimension of fender plane in direction 2</li>
</ul>
<p>Global coordinates are used if the fender plane is earth-fixed</p>
<p>Local body coordinates are used if the fender plane is on a body.</p>
<p>It is assumed that {XP,YP,ZP} is the centre point of the plane.</p>
<h4>NPT input lines</h4>
<div class="fragment"><div class="line">DIST   AFORCE   DAMP</div>
</div><!-- fragment --><ul>
<li><code>DIST: real</code>: Distance from fender point to fender plane <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>AFORCE: real</code>: Axial fender force, normal to surface <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>DAMP: real</code>: Damping coefficient <img class="formulaInl" alt="$\left[F(T/L)^{\mathrm{EXP}}\right]$" src="form_163.png"/></li>
</ul>
<p>The characteristics can be given for monotonic increasing or decreasing distances, <code>DIST</code>.</p>
<p>Point fender: All <code>DIST &lt;= 0</code></p>
<p>Spherical fender: The largest distance in the characteristics must be positive (<code>&gt;0</code>). This distance is the radius of the sphere around the fender point.</p>
<p><code>AFORCE = 0</code> at the largest distance</p>
<p>Compression force and damping are given as positive numbers.</p>
<div class="image">
<img src="fender_models.svg" alt="fender_models.svg"/>
<div class="caption">
Illustration of fender models</div></div>
<div class="image">
<img src="app-a_image017.png" alt="app-a_image017.png"/>
<div class="caption">
Illustration of fender plane dimensions</div></div>
<h2><a class="anchor" id="ug_body_positioning_bumper"></a>
Bumper element data</h2>
<h4>1 identifying line</h4>
<div class="fragment"><div class="line">BUMPer DATA</div>
</div><!-- fragment --><h4>1 input line</h4>
<div class="fragment"><div class="line">NPT    INTPOM    VEMIN    EXPD   EHLA</div>
</div><!-- fragment --><ul>
<li><code>NPT: integer</code>: Number of points in bumper force characteristics</li>
<li><code>INTPOM: integer, default: 1</code>: Interpolation method = 1,2,3 or 4<ul>
<li><code>=1</code>: Linear force, linear damping.</li>
<li><code>=2</code>: Linear force, parabolic damping.</li>
<li><code>=3</code>: Parabolic force, linear damping.</li>
<li><code>=4</code>: Parabolic force, parabolic damping.</li>
</ul>
</li>
<li><code>VEMIN: real, default: 0</code>: Velocity limit for damping force (<code>EXPD=0</code>)</li>
<li><code>EXPD: real</code>: Exponent in damping formula</li>
<li><code>EHLA: integer, default: 0</code>: HLA export flag for bumper<ul>
<li><code>EHLA = 0</code>: No export</li>
<li><code>EHLA = 1</code>: HLA export</li>
</ul>
</li>
</ul>
<p>Small velocities and <code>EXPD=0</code> can result in a large damping force that suddenly changes sign. To avoid this the value <code>EXPD=1</code> is used when Abs(vel.) <code>&lt; VEMIN</code> and <code>EXPD &lt; 1</code>.</p>
<h4>If EHLA = 1, a HLA name of bumper object has to be specified</h4>
<p>1 input line </p>
<div class="fragment"><div class="line">CHPHLA</div>
</div><!-- fragment --><ul>
<li><code>CHPHLA: character(120)</code>: Character string describing HLA bumper object name</li>
</ul>
<h4>Coordinate of bumper line attached to the body, 1 input line.</h4>
<div class="fragment"><div class="line">XB1   YB1   ZB1  XB2   YB2   ZB2</div>
</div><!-- fragment --><ul>
<li><code>XB1: real</code>: X-coordinate of bumper end 1, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>YB1: real</code>: Y-coordinate of bumper end 1, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>ZB1: real</code>: Z-coordinate of bumper end 1, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>XB2: real</code>: X-coordinate of bumper end 2, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>YB2: real</code>: Y-coordinate of bumper end 2, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>ZB2: real</code>: Z-coordinate of bumper end 2, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
</ul>
<p>Local body coordinates</p>
<h4>Coordinate of globally fixed bumper line, 1 input line.</h4>
<div class="fragment"><div class="line">XG1   YG1   ZG1  XG2   YG2   ZG2</div>
</div><!-- fragment --><ul>
<li><code>XG1: real</code>: X-coordinate of bumper end 1, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>YG1: real</code>: Y-coordinate of bumper end 1, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>ZG1: real</code>: Z-coordinate of bumper end 1, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>XG2: real</code>: X-coordinate of bumper end 2, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>YG2: real</code>: Y-coordinate of bumper end 2, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>ZG2: real</code>: Z-coordinate of bumper end 2, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
</ul>
<p>Global coordinates</p>
<h4>Contact force characteristics, NPT input lines</h4>
<div class="fragment"><div class="line">DIST   AFORCE   DAMP</div>
</div><!-- fragment --><ul>
<li><code>DIST: real</code>: Distance between bumper centrelines <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>AFORCE: real</code>: Bumper force, normal to elements <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>DAMP: real</code>: Damping coefficient <img class="formulaInl" alt="$\left[F(T/L)^{\mathrm{EXP}}\right]$" src="form_163.png"/></li>
</ul>
<p>The characteristics can be given for increasing or decreasing distances, <code>DIST</code>.</p>
<p>Compression force and damping are given as positive numbers.</p>
<h2><a class="anchor" id="ug_body_positioning_thrusters_deprecated"></a>
Thrusters (Deprecated model)</h2>
<p>This thruster model is deprecated. It will not be available anymore in the next release versions. This thruster model cannot be used on the same body together with the thruster model documented in the next section (<a class="el" href="a00024.html#ug_body_positioning_thrusters">Thruster system</a>).</p>
<h4>1 input line</h4>
<div class="fragment"><div class="line">THRUster DATA</div>
</div><!-- fragment --><h4>1 input line</h4>
<div class="fragment"><div class="line">ITRTYP NDIR NZON</div>
</div><!-- fragment --><ul>
<li><code>ITRTYP: integer</code>: Thruster type<ul>
<li><code>= 1</code>: Fixed, conventional</li>
<li><code>= 2</code>: Fixed, ducted</li>
<li><code>= 3</code>: Fixed, tunnel</li>
<li><code>= 4</code>: Rotatable, conventional</li>
<li><code>= 5</code>: Rotatable, ducted</li>
<li><code>= 6</code>: Open main propeller</li>
<li><code>= 7</code>: Ducted main propeller</li>
</ul>
</li>
<li><code>NDIR: integer</code>: Number of directions for which directional dependency is specified<ul>
<li>Dummy for <code>ITRTYP=1,2,3,6,7</code></li>
</ul>
</li>
<li><code>NZON: integer</code>: Number of sectors with forbidden zones<ul>
<li>Dummy for <code>ITRTYP=1,2,3,6,7</code></li>
</ul>
</li>
</ul>
<p>Directions are given as direction of thrust force acting on the body. Thruster types 1, 2 and 3 are equal and thruster types 4 and 5 are equal.</p>
<h4>1 input line</h4>
<div class="fragment"><div class="line">XTHR YTHR ZTHR DIRTHR FORCE FACALL  EHLA</div>
</div><!-- fragment --><ul>
<li><code>XTHR: real</code>: X-coordinate of thruster in body coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>YTHR: real</code>: Y-coordinate of thruster in body coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>ZTHR: real</code>: Z-coordinate of thruster in body coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>DIRTHR: real</code>: Direction of thrust force in body x-y plane, initial value if controlled by a DP-system, <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
<li><code>FORCE: real</code>: Resulting force, initial value if controlled by a DP-system, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>FACALL: real, default: 1</code>: Factor in weight function for thruster allocation, dummy if not controlled by a DP-system</li>
<li><code>EHLA: integer, default: 0</code>: HLA export flag for thruster force<ul>
<li><code>EHLA = 0</code>: No export</li>
<li><code>EHLA = 1</code>: HLA export</li>
</ul>
</li>
</ul>
<h4>If EHLA = 1, a HLA name of thruster object has to be specified. 1 input line</h4>
<div class="fragment"><div class="line">CHTHLA</div>
</div><!-- fragment --><ul>
<li><code>CHTHLA: character(120)</code>: Character string describing HLA thruster object name</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">TMIMA DBAND ANGL ANGH</div>
</div><!-- fragment --><ul>
<li><code>TMIMA: real</code>: Minimum time to change from minimum to maximum thrust, <img class="formulaInl" alt="$[T]$" src="form_70.png"/></li>
<li><code>DBAND: real, default: .01</code>: Relative dead band, minimum change of force relative to total range, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>ANGL: real, default: 0</code>: Minimum change in direction of thrusters force, <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/><ul>
<li>Dummy for <code>ITRTYP=1,2,3</code></li>
</ul>
</li>
<li><code>ANGH: real, default: 10</code>: Maximum revolving speed of rotatable thrusters, <img class="formulaInl" alt="$ \mathrm{[deg}/T]$" src="form_164.png"/><ul>
<li>Dummy for <code>ITRTYP=1,2,3,6,7</code></li>
</ul>
</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">FMIN    FMAX    DIAM    KTNEG    KTPOS</div>
</div><!-- fragment --><ul>
<li><code>FMIN: real</code>: Minimum thruster force, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>FMAX: real</code>: Maximum thruster force, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>DIAM: real, default: 1</code>: For <code>ITRTYP = 6</code> and <code>7</code> only. Thruster diameter, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>KTNEG: real, default: 0</code>: Thrust coefficient (KT) for negative thruster rotation</li>
<li><code>KTPOS: real, default: 0</code>: Thrust coefficient (KT) for positive thruster rotation</li>
</ul>
<p>The Thruster diameter must be <code>&gt; 0</code>.</p>
<p><code>KTNEG</code> and <code>KTPOS</code> are not presently used.</p>
<h4>1 input line If ITRTYP = 6, 7</h4>
<div class="fragment"><div class="line">RUCOEF    RUMAX</div>
</div><!-- fragment --><ul>
<li><code>RUCOEF: real</code>: Rudder coefficient, <img class="formulaInl" alt="$ \mathrm{[1/deg]}$" src="form_165.png"/></li>
<li><code>RUMAX: real</code>: Maximum rudder angle, <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
</ul>
<p><code>RUMAX &gt; 0</code>.</p>
<p>The angle of the rudder force ( <img class="formulaInl" alt="$ \alpha_f $" src="form_166.png"/>) is calculated as <img class="formulaInl" alt="$ \alpha_f = \sin{\alpha_r}/$" src="form_167.png"/> <code>RUCOEF</code>, where <img class="formulaInl" alt="$ \alpha_r$" src="form_168.png"/> is the rudder angle.</p>
<h4>1 input line if ITRTYP = 1,2,3</h4>
<div class="fragment"><div class="line">FACT</div>
</div><!-- fragment --><ul>
<li><code>FACT: real, default: 1</code>: Thrust reduction factor</li>
</ul>
<p>The resulting force from a dynamically controlled thruster is between <code>FMIN</code>*<code>FACT</code> and <code>FMAX</code>*<code>FACT</code></p>
<h4>NDIR input lines if ITRTYP = 4,5</h4>
<div class="fragment"><div class="line">DIR FACT DANG</div>
</div><!-- fragment --><ul>
<li><code>DIR: real</code>: Direction of propeller axis in body coordinate system, <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
<li><code>FACT: real, default: 1</code>: Thruster reduction factor</li>
<li><code>DANG: real, default: 0</code>: Dummy parameter. (Direction of thrust relative to propeller axis), <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
</ul>
<p><code>FACT</code> will be interpolated between the specified <code>DIR</code>.</p>
<p>The resulting force from a dynamically controlled thruster is between <code>FMIN</code>*<code>FACT</code> and <code>FMAX</code>*<code>FACT</code></p>
<p><code>DANG</code> is not implemented and is a dummy parameter</p>
<h4>NZON input lines if ITRTYP = 4,5</h4>
<div class="fragment"><div class="line">ZON1 ZON2</div>
</div><!-- fragment --><ul>
<li><code>ZON1: real</code>: Start of forbidden zone of thrust force, <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
<li><code>ZON2: real</code>: End of forbidden zone of thrust force, <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
</ul>
<p><code>ZON1</code>&lt;<code>ZON2</code>, allowed zone range is (<code>-360.</code>,<code>360.</code>)</p>
<p>Zones are related to force direction</p>
<p><code>ZON2</code> &gt; <code>ZON1</code> =&gt; the zone (<code>330 : 45</code>) must be given as ( <code>-30 : 45</code>)</p>
<h4>Thruster failure, 1 input line</h4>
<div class="fragment"><div class="line">IFMOTH FTIME</div>
</div><!-- fragment --><ul>
<li><code>IFMOTH: integer</code>: Failure mode<ul>
<li><code>= 0</code>: no failure</li>
<li><code>= 1</code>: thruster blackout after specified time</li>
</ul>
</li>
<li><code>FTIME: real</code>: Time for thruster failure if <code>IFMOTH = 1</code></li>
</ul>
<h2><a class="anchor" id="ug_body_positioning_thrusters"></a>
Thruster sytem</h2>
<div class="fragment"><div class="line">THRUster  SYSTem  DATA</div>
</div><!-- fragment --><h4>NAME &amp; TYPE, 1 input line</h4>
<div class="fragment"><div class="line">CTHRST    ITRTYP      EHLA</div>
</div><!-- fragment --><ul>
<li><code>CTHRST: character(8)</code>: Thruster identifier</li>
<li><code>ITRTYP: integer</code>: Thruster type<ul>
<li><code>= 1</code>: Fixed, conventional</li>
<li><code>= 2</code>: Fixed, ducted</li>
<li><code>= 3</code>: Fixed, tunnel</li>
<li><code>= 4</code>: Rotatable, conventional</li>
<li><code>= 5</code>: Rotatable, ducted</li>
<li><code>= 6</code>: Open main propeller</li>
<li><code>= 7</code>: Ducted main propeller</li>
</ul>
</li>
<li><code>EHLA: integer, default: 0</code>: HLA export flag for thruster force<ul>
<li><code>EHLA = 0</code>: No export</li>
<li><code>EHLA = 1</code>: HLA export</li>
</ul>
</li>
</ul>
<p><code>SIMO</code> makes no distinction between ducted and open thrusters. Hence, specifying the thruster type to be 1 or 2 is identical.</p>
<h4>If EHLA = 1, a HLA name of thruster object has to be specified. 1 input line</h4>
<div class="fragment"><div class="line">CHTHLA</div>
</div><!-- fragment --><ul>
<li><code>CHTHLA: character(120)</code>: Character string describing HLA thruster object name</li>
</ul>
<h4>Coordinates of thruster attachment given in body system, input line</h4>
<div class="fragment"><div class="line">XTHR   YTHR   ZTHR</div>
</div><!-- fragment --><ul>
<li><code>XTHR: real</code>: X-coordinate of thruster in body coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>YTHR: real</code>: Y-coordinate of thruster in body coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>ZTHR: real</code>: Z-coordinate of thruster in body coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
</ul>
<h4>Thruster diameter, thrust and direction, 1 input line</h4>
<div class="fragment"><div class="line">DIAM  THRUST    DIRTHR</div>
</div><!-- fragment --><ul>
<li><code>DIAM: real</code>: Thruster diameter, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>THRUST: real</code>: Thrust1, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>DIRTHR: real</code>: Direction1 of thrust body x-y plane <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
</ul>
<p>Initial values if thruster is controlled by a DP-system</p>
<p><code>DIAM</code> should be greater than <code>0.01</code></p>
<h4>Properties, 1 input line</h4>
<div class="fragment"><div class="line">FMIN  FMAX    TRISE  TCTHR</div>
</div><!-- fragment --><ul>
<li><code>FMIN: real</code>: Minimum thrust, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>FMAX: real</code>: Maximum thrust force, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>TRISE: real</code>: Minimum rise time of thrust from 10% to 90% of maximum thrust, <img class="formulaInl" alt="$[T]$" src="form_70.png"/></li>
<li><code>TCTHR: real</code>: Time constant of thruster servo controller, <img class="formulaInl" alt="$[T]$" src="form_70.png"/></li>
</ul>
<p><code>TCTHR</code> should be positive. <code>TCTHR</code> is used to determine the proportional gain of the controller that is used to minimize the error in thruster rotational speed. See the Theory Manual (Thruster control, speed control) for the determination of servo controller coefficients based on <code>FMAX</code>, <code>TRISE</code>, and <code>TCTHR</code>.</p>
<h4>Extra properties for azimuth thruster, i.e. ITRTYP=4 or 5, 1 input line</h4>
<div class="fragment"><div class="line">ANGVMAX     TCAZ</div>
</div><!-- fragment --><ul>
<li><code>ANGVMAX: real</code>: Maximum turning speed of azimuth thruster, <img class="formulaInl" alt="$ \mathrm{[deg}/T]$" src="form_164.png"/></li>
<li><code>TCAZ: real</code>: Time constant of azimuth change, <img class="formulaInl" alt="$[T]$" src="form_70.png"/></li>
</ul>
<h4>Property modifications, 1 input line</h4>
<div class="fragment"><div class="line">CTFWD  CQFWD  CTREV   CQREV</div>
</div><!-- fragment --><ul>
<li><code>CTFWD: real, default: 1</code>: Modification factor for forward thrust</li>
<li><code>CQFWD: real, default: 1</code>: Modification factor for forward torque</li>
<li><code>CTREV: real, default: 1</code>: Modification factor for reverse thrust</li>
<li><code>CQREV: real, default: 1</code>: Modification factor for revers torque</li>
</ul>
<h4>Option for thrust coefficient model, 1 input line</h4>
<div class="fragment"><div class="line">ITMOD</div>
</div><!-- fragment --><ul>
<li><code>ITMOD: integer</code>:<ul>
<li><code>= 0</code>: Use internal generic model for thrust coefficient KT and torque coefficient KQ<ul>
<li>See figure showing built-in coefficients in the Theory Manual</li>
</ul>
</li>
<li><code>= 1</code>: Coefficients of thrust and torque given for the forward direction (reverse thrust and torque obtained by using reduction factor)</li>
<li><code>= 2</code>: Coefficients of thrust and torque given separately for forward and reverse direction</li>
</ul>
</li>
</ul>
<h4>ITMOD=0, Pitch-diameter ratio, 1 input line</h4>
<div class="fragment"><div class="line">PDRAT</div>
</div><!-- fragment --><ul>
<li><code>PDRAT: real, default: 1</code>: Pitch-diameter ratio P/D</li>
</ul>
<h4>ITMOD=1 or 2, Thrust and torque coefficients for forward direction, number of points in table: 1 input lines</h4>
<div class="fragment"><div class="line">NKFWD</div>
</div><!-- fragment --><ul>
<li><code>NKFWD: integer</code>: Number of points in functions <code>KTFWD</code> and <code>KQFWD</code></li>
</ul>
<h4>ITMOD=1 or 2, Thrust and torque coefficients for forward direction, NKFWD input lines</h4>
<div class="fragment"><div class="line">JFWD(i), KTFWD(i),  KQFWD(i)</div>
</div><!-- fragment --><ul>
<li><code>JFWD (i): real</code>: Advance ratio (number i)</li>
<li><code>KTFWD (i): real</code>: Thrust coefficient (number i)</li>
<li><code>KQFWD(i): real</code>: Torque coefficient (number i)</li>
</ul>
<h4>ITMOD=2, Thrust and torque coefficients for reversed direction: 1 input line</h4>
<div class="fragment"><div class="line">NKREV</div>
</div><!-- fragment --><ul>
<li><code>NKREV: integer</code>: Number of points in functions KTREV and KQREV</li>
</ul>
<h4>ITMOD=2, Thrust and torque coefficients for reversed direction, NKREV input lines</h4>
<div class="fragment"><div class="line">JREV (i), KTREV(i),  KQREV(i)</div>
</div><!-- fragment --><ul>
<li><code>JREV (i): real</code>: Advance ratio value (number i)</li>
<li><code>KTREV (i): real</code>: Thrust coefficient (number i)</li>
<li><code>KQREV(i): real</code>: Torque coefficient (number i)</li>
</ul>
<h4>Option for thrust loss, 1 input line</h4>
<div class="fragment"><div class="line">ILOSS</div>
</div><!-- fragment --><ul>
<li><code>ILOSS: integer</code>:<ul>
<li><code>ILOSS = 0</code>: No loss effects are included</li>
<li><code>ILOSS = 1</code>: Surface proximity loss is included</li>
</ul>
</li>
</ul>
<h4>If ILOSS=1: 3 input lines</h4>
<div class="fragment"><div class="line">NSPL</div>
</div><!-- fragment --><ul>
<li><code>NSPL: integer</code>: Number of entries in table for surface proximity loss</li>
</ul>
<div class="fragment"><div class="line">ZD (1), ZD(2),  .... , ZD(NSPL)</div>
</div><!-- fragment --><ul>
<li><code>ZD(1): real</code>: First Z/D value in reduction factor table</li>
<li><code>ZD(2): real</code>: Second Z/D value in reduction factor table</li>
<li><code>...: real</code>:</li>
<li><code>ZD(NSPL): real</code>: Last Z/D value in reduction factor table</li>
</ul>
<div class="fragment"><div class="line">CSPL(1), CSPL(2),  .... , CSPL(NSPL)</div>
</div><!-- fragment --><ul>
<li><code>CSPL(1): real</code>: First value of reduction factor</li>
<li><code>CSPL(2): real</code>: Second value of reduction factor</li>
<li><code>...: real</code>:</li>
<li><code>CSPL (NSPL): real</code>: Last value of reduction factor</li>
</ul>
<p>Notes:</p>
<ol type="1">
<li>The values of <code>CSPL</code> outside the range of the data table provided by the user are extrapolated by using the end (or start) value of the table. Therefore it is strongly recommended to start the table by the submergence for which <code>CSPL=1</code>, in order to get <code>CSPL=1</code> when the thruster is submerged and "does not feel" the surface.</li>
<li>The values of <code>CSPL</code> inside the range of the data table provided by the user are interpolated linearly.</li>
<li>For a submerged thruster, Z/D&lt;0. For a thruster in the air, Z/D&gt;0.</li>
<li><code>CSPL=1</code> means no thrust loss (i.e. the thruster works properly). <code>CSPL=0</code> means <code>100</code>% thrust loss (i.e. the thruster does not provide any thrust).</li>
<li>The array ZD should be monotonic.</li>
<li>CSPL should always be positive (or zero)</li>
</ol>
<h4>Additional loss effects for azimuth thrusters, ITRTYP=4 or 5, Number of directions for direction dependent thrust reduction factors, 1 input lines</h4>
<div class="fragment"><div class="line">NDIR</div>
</div><!-- fragment --><ul>
<li><code>NDIR: integer</code>: Number of directions for which directional dependency is specified</li>
</ul>
<h4>ITRTYP=4 or 5, Direction dependent thrust reduction factors, NDIR input lines</h4>
<div class="fragment"><div class="line">DIR   FACT</div>
</div><!-- fragment --><ul>
<li><code>DIR: real</code>: Direction of propeller axis in body coordinate system, <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
<li><code>FACT: real, default: 1</code>: Thrust reduction factor</li>
</ul>
<p><code>FACT</code> will be interpolated between the specified <code>DIR</code>. The resulting force from a dynamically controlled thruster is between <code>FMIN</code>*<code>FACT</code> and <code>FMAX</code>*<code>FACT</code>.</p>
<h4>ITRTYP = 6, 7, Rudder data, 1 input line</h4>
<div class="fragment"><div class="line">RUCOEF    RUMAX</div>
</div><!-- fragment --><ul>
<li><code>RUCOEF: real</code>: Rudder coefficient, <img class="formulaInl" alt="$ \mathrm{[1/deg]}$" src="form_165.png"/></li>
<li><code>RUMAX: real &gt; 0</code>: Maximum rudder angle, <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
</ul>
<p>The angle of the rudder force ( <img class="formulaInl" alt="$ \alpha_f $" src="form_166.png"/>) is calculated as <img class="formulaInl" alt="$ \alpha_f = \sin{\alpha_r}/$" src="form_167.png"/> <code>RUCOEF</code>, where <img class="formulaInl" alt="$ \alpha_r$" src="form_168.png"/> is the rudder angle.</p>
<h4>Thruster failure, 1 input line</h4>
<div class="fragment"><div class="line">IFMOTH FTIME</div>
</div><!-- fragment --><ul>
<li><code>IFMOTH: integer</code>: Failure mode<ul>
<li><code>= 0</code>: no failure</li>
<li><code>= 1</code>: thruster blackout after specified time</li>
</ul>
</li>
<li><code>FTIME: real</code>: Time for thruster failure if <code>IFMOTH = 1</code></li>
</ul>
<h2><a class="anchor" id="ug_body_positioning_lift"></a>
Lift and drag force</h2>
<p>The intention of this option is, in a simplified way, to model the drag and lift forces for instance on a rudder as response to main propeller actions.</p>
<p>The lifting surface is described by a local "surface" plane. The location is defined by a point P1 and the rotation axis, both defined in the body fixed coordinate system as illustrated in the figure below. A "surface" coordinate system is defined, with the z-axis along the rotation axis and the surface located in the xz-plane.</p>
<p>To avoid confusion, it is recommended to use a “surface coordinate system” with approximately the same orientation as the local body coordinate system.</p>
<div class="image">
<img src="app-a_image018.png" alt="app-a_image018.png"/>
<div class="caption">
Lifting surface coordinate system</div></div>
<h4>1 identification input line</h4>
<div class="fragment"><div class="line">LIFT  AND  DRAG  force</div>
</div><!-- fragment --><h4>Lifting surface identifier, 1 input line</h4>
<div class="fragment"><div class="line">LIFT_NAME</div>
</div><!-- fragment --><ul>
<li><code>LIFT_NAME: character(32)</code>: Lifting surface identifier (name)</li>
</ul>
<h4>Lifting surface position referred in body fixed system, 1 input line</h4>
<div class="fragment"><div class="line">XP1  YP1  ZP1</div>
</div><!-- fragment --><ul>
<li><code>XP1: real</code>: X-coordinate of point P1 <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>YP1: real</code>: Y-coordinate of point P1 <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>ZP1: real</code>: Z-coordinate of point P1 <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
</ul>
<h4>Lifting surface orientation referred in body fixed system, 1 input line</h4>
<div class="fragment"><div class="line">DVZ1   DVZ2   DVZ3   DVXZ1   DVXZ2   DVXZ3</div>
</div><!-- fragment --><p> Direction vector parallel with the lift surface Zs -axis (rotation axis)</p>
<ul>
<li><code>DVZ1: real</code>: X-component <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>DVZ2: real</code>: Y-component <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>DVZ3: real</code>: Z-component <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
</ul>
<p>Vector in lift surface XZ plane for zero rotation around Zs</p>
<ul>
<li><code>DVXZ1: real</code>: X-component <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>DVXZ2: real</code>: Y-component <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>DVXZ3: real</code>: Z-component <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
</ul>
<h4>Lifting surface dimensions and initial rotation angle around Zs, 1 input line</h4>
<div class="fragment"><div class="line">XDIM   ZDIM   ANGLSU</div>
</div><!-- fragment --><ul>
<li><code>XDIM: real</code>: Dimension in Xs direction <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>ZDIM: real</code>: Dimension in Zs direction <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>ANGLSU: real</code>: Initial lifting surface angle <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
</ul>
<h4>Lift surface rotational properties, 1 input line</h4>
<div class="fragment"><div class="line">ANGMAX   RATE   IHLA</div>
</div><!-- fragment --><ul>
<li><code>ANGMAX: real</code>: Maximum rotation angle around ZS, absolute value <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
<li><code>RATE: real</code>: Maximum rotational velocity, absolute valute <img class="formulaInl" alt="$ \mathrm{[deg}/T]$" src="form_164.png"/></li>
<li><code>IHLA: integer</code>:<ul>
<li><code>= 0</code>: No control from HLA</li>
<li><code>= 1</code>: angle adjustable from HLA</li>
</ul>
</li>
</ul>
<h4>If IHLA = 1, HLA name of lifting surface object, 1 input line</h4>
<div class="fragment"><div class="line">CHTHLA</div>
</div><!-- fragment --><ul>
<li><code>CHTHLA: character(120)</code>: Character string describing HLA object name</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">ITHR  CURFAC  VESFAC  THRFAC</div>
</div><!-- fragment --><ul>
<li><code>ITHR: integer</code>: The number ID of the thruster associated with the lifting surface<ul>
<li>The thruster has to be type 6 or 7,</li>
<li><code>'0'</code> means that the rudder will give zero force</li>
</ul>
</li>
<li><code>CURFAC: real</code>: Factor that current velocity is multiplied with</li>
<li><code>VESFAC: real</code>: Factor that vessel velocity is multiplied with</li>
<li><code>THRFAC: real</code>: Factor that thruster induced vel. is multiplied with</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">NPLIFT  INTPOM  ISYM  ZDRAG</div>
</div><!-- fragment --><ul>
<li><code>NPLIFT: integer</code>: Number of points in force characteristics</li>
<li><code>INTPOM: integer</code>: Interpolation method<ul>
<li><code>= 1</code>: Linear interpolation</li>
<li><code>= 2</code>: Spline interpolation</li>
</ul>
</li>
<li><code>ISYM: integer</code>: Symmetry code<ul>
<li><code>= 0</code>: No symmetry</li>
<li><code>= 1</code>: Symmetry about x-axis</li>
</ul>
</li>
<li><code>ZDRAG: real</code>: Quadratic force coeff. in rudder z-dir. <img class="formulaInl" alt="$\left[F(T/L)^2\right]$" src="form_169.png"/></li>
</ul>
<h4>Force characteristics, NPLIFT input lines</h4>
<div class="fragment"><div class="line">BETA  FX  FY  ZMOM</div>
</div><!-- fragment --><ul>
<li><code>BETA: real</code>: Velocity direction relative to rudder x-axis</li>
<li><code>FX: real</code>: Quadratic force coeff. in rudder x-dir. <img class="formulaInl" alt="$\left[F(T/L)^2\right]$" src="form_169.png"/></li>
<li><code>FY: real</code>: Quadratic force coeff. in rudder y-dir. <img class="formulaInl" alt="$\left[F(T/L)^2\right]$" src="form_169.png"/></li>
<li><code>ZMOM: real</code>: Quadratic moment coeff. about rudder z-axis <img class="formulaInl" alt="$\left[F * T * T/L\right]$" src="form_170.png"/></li>
</ul>
<p>Lifting surface forces are computed based on the current, vessel, and thruster induced velocities (multiplied by the factors <code>CURFAC</code>, <code>VESFAC</code>, and <code>THRFAC</code>). Orbital wave velocities are not included.</p>
<h2><a class="anchor" id="ug_body_positioning_dynamic_deprecated"></a>
Dynamic positioning data (Deprecated model)</h2>
<p>This DP model is deprecated. It will not be available anymore in the next release versions. This DP model can only be used with the deprecated thruster model (<a class="el" href="a00024.html#ug_body_positioning_thrusters_deprecated">Thrusters (Deprecated model)</a>).</p>
<p>Dynamic positioning (DP) data must always belong to a positioning system. If the positioning system includes thrusters, they may be controlled by a dynamic positioning system, which is specified separately.</p>
<p>The dynamic positioning system will only control the motions in the horizontal plane (surge, sway and yaw). All dynamic positioning options are limited to one DP system for each body. Maximum number of thrusters per body is 20.</p>
<h4>1 input line.</h4>
<div class="fragment"><div class="line">DYNAmic POSItioning SYSTem</div>
</div><!-- fragment --><h4>Text for describing the positioning system, 2 input lines.</h4>
<div class="fragment"><div class="line">TXDP</div>
</div><!-- fragment --><ul>
<li><code>TXDP: character(60)</code>: Character string</li>
</ul>
<h4>Type of DP-system, 1 input line</h4>
<div class="fragment"><div class="line">IDP</div>
</div><!-- fragment --><ul>
<li><code>IDP: integer</code>: Type of dynamic positioning controller<ul>
<li><code>= 1</code>: PID controller</li>
<li><code>= 2</code>: Kalman filter based controller</li>
<li><code>= 3</code>: External controller function/library</li>
<li><code>= 4</code>: MTDP controller (internal MARINTEK DP-system)</li>
<li><code>= 5</code>: Velocity PI controller (HLA)</li>
</ul>
</li>
</ul>
<h4>Degree of freedom for thruster allocation for IDP = 1, 2 and 3, 1 input line.</h4>
<div class="fragment"><div class="line">IFO1  IFO2  IFO6  IDPMOD  ITALLOC  IMADP</div>
</div><!-- fragment --><ul>
<li><code>IFO1: integer</code>: Force allocation in surge (<code>0</code> or <code>1</code>)</li>
<li><code>IFO2: integer</code>: Force allocation in sway (<code>0</code> or <code>1</code>)</li>
<li><code>IFO6: integer</code>: Moment allocation in yaw (<code>0</code> or <code>1</code>)</li>
<li><code>IDPMOD: integer, default: 1</code>: Flag for mode of DP-system<ul>
<li><code>= 0</code>: DP-system OFF</li>
<li><code>&gt; 0</code>: DP-system ON</li>
<li><code>= 2</code>: Use any given &lt;<code>CHBDY</code>&gt; as reference</li>
</ul>
</li>
<li><code>ITALLOC: integer, default: 1</code>: Thrust allocation method<ul>
<li><code>= 1</code>: Ordinary allocation</li>
<li><code>= 2</code>: Heading priority</li>
</ul>
</li>
<li><code>IMADP: integer, default: 0</code>: Flag for option of manual-DP by commanded force from HLA<ul>
<li><code>0</code>: No HLA commanded force</li>
<li><code>1</code>: HLA commanded force, OFF</li>
<li><code>2</code>: HLA commanded force, ON</li>
</ul>
</li>
</ul>
<p><code>IFOX = 1</code>: Force shall be allocated. At least one parameter has to be 1.</p>
<p>If <code>IMADP = 2</code> the given DP-controller is deactivated.</p>
<h4>If IMADP = 1 and 2, 1 input line, describing HLA name of commanded force</h4>
<div class="fragment"><div class="line">TXHDP</div>
</div><!-- fragment --><ul>
<li><code>TXHDP: character(120)</code>: Character string for HLA name of commanded force</li>
</ul>
<h4>1 input line for IDP = 1, 2 and 3</h4>
<div class="fragment"><div class="line">XREF    YREF    DREF    XLOC    YLOC    CHREF</div>
</div><!-- fragment --><ul>
<li><code>XREF: real</code>:<ul>
<li>X-coordinate of reference/wanted position, <img class="formulaInl" alt="$[L]$" src="form_69.png"/> for <code>CHREF</code> <img class="formulaInl" alt="$\neq$" src="form_171.png"/> <code>GBCIRCLE</code></li>
<li>X-coordinate of the circle center <img class="formulaInl" alt="$[L]$" src="form_69.png"/> for <code>CHREF = GBCIRCLE</code></li>
</ul>
</li>
<li><code>YREF: real</code>:<ul>
<li>Y-coordinate of reference/wanted position, <img class="formulaInl" alt="$[L]$" src="form_69.png"/> for <code>CHREF</code> <img class="formulaInl" alt="$\neq$" src="form_171.png"/> <code>GBCIRCLE</code></li>
<li>Y-coordinate of the circle center <img class="formulaInl" alt="$[L]$" src="form_69.png"/> for <code>CHREF = GBCIRCLE</code></li>
</ul>
</li>
<li><code>DREF: real</code>:<ul>
<li>Reference/wanted heading, <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/> for <code>CHREF</code> <img class="formulaInl" alt="$\neq$" src="form_171.png"/> <code>GBCIRCLE</code></li>
<li>Radius of the circle <img class="formulaInl" alt="$[\mathrm{M}]$" src="form_172.png"/> for <code>CHREF = GBCIRCLE</code></li>
</ul>
</li>
<li><code>XLOC: real</code>: X-coordinate of the point on the body which shall be positioned at the specified reference, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>YLOC: real</code>: Y-coordinate of the point on the body which shall be positioned at the specified reference, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>CHREF: character(8), default: GLOBAL</code>: Reference frame identifier<ul>
<li><code>= GLOBAL</code>: Fixed reference point given in global coordinate system</li>
<li><code>= &lt;CHBDY&gt;</code>: A moving point given relative to body <code>&lt;CHBDY&gt;</code> shall be followed for one or more degrees of freedom. <code>IDPMOD</code> must be set to 2. (If <code>IDPMOD=1</code>, <code>CHREF = GLOBAL</code>)</li>
<li><code>= EXTREF</code>: Reference from an external function</li>
<li><code>= HLAREF</code>: Read global reference from HLA communication</li>
<li><code>= GUIDANCE</code>: Guidance System</li>
<li><code>= GBCIRCLE</code>: The circle perimeter is used as reference (see 'Weather vaning strategy (CHREF=GBCIRCLE)' in 'Force models' in the Theory Manual)</li>
</ul>
</li>
</ul>
<h4>If CHREF = &lt;CHBDY&gt;, 1 input line</h4>
<div class="fragment"><div class="line">IXYREF    IDREF    POSLPT</div>
</div><!-- fragment --><ul>
<li><code>IXYREF: integer</code>: Reference position flag, XY-position.<ul>
<li><code>= 1</code>: Fixed, given in global coordinate system</li>
<li><code>= 2</code>: Moving, given in local system of body to be followed</li>
</ul>
</li>
<li><code>IDREF: integer</code>: Reference position/heading flag<ul>
<li><code>= 1</code>: Fixed, given in global coordinate system</li>
<li><code>= 2</code>: Moving, given relative to heading of body to be followed</li>
</ul>
</li>
<li><code>POSLPT: real</code>: Cut-off time in low-pass filter for position measurement of body to follow</li>
</ul>
<p><code>XREF</code>, <code>YREF</code> are given values for &lt;<code>CHBDY</code>&gt; in the local coordinate system if <code>CHREF =</code> &lt;<code>CHBDY</code>&gt;, normally “outside” the body. <code>DREF</code> is the relative heading between the heading of the DP-body and the heading of &lt;<code>CHBDY</code>&gt;.</p>
<h4>If CHREF = EXTREF, 1 input line, name and path of external library</h4>
<div class="fragment"><div class="line">EXTRNA</div>
</div><!-- fragment --><ul>
<li><code>EXTRNA: character(120)</code>: Character string describing path and name of external DP-reference library</li>
</ul>
<p><code>XREF</code>, <code>YREF</code> and <code>ZREF</code> are initial values if <code>CHREF = EXTREF</code></p>
<h4>If CHREF = EXTREF, 1 input line</h4>
<div class="fragment"><div class="line">NPCUR</div>
</div><!-- fragment --><ul>
<li><code>NPCUR: integer &gt; 0</code>: Number of points where current velocities shall be given to the external reference library</li>
</ul>
<h4>If CHREF = HLAREF, 1 input line, name of HLA reference</h4>
<div class="fragment"><div class="line">HLARNA</div>
</div><!-- fragment --><ul>
<li><code>HLARNA: character(120)</code>: Character string describing HLA reference name</li>
</ul>
<p><code>XREF</code>, <code>YREF</code> and <code>ZREF</code> are initial values if <code>CHREF = HLAREF</code></p>
<h4>1 input line</h4>
<div class="fragment"><div class="line">IGTYP</div>
</div><!-- fragment --><ul>
<li><code>IGTYP: integer</code>: Type of <code>GUIDANCE</code><ul>
<li><code>= 1</code>: Straight lines and circular arcs</li>
<li><code>= 2</code>: Line of sight (LOS)</li>
</ul>
</li>
</ul>
<h4>If CHREF = GUIDANCE (Guidance System), 1 input line</h4>
<div class="fragment"><div class="line">NWAYP    IWPTYP    IHRTYP</div>
</div><!-- fragment --><ul>
<li><code>NWAYP: integer</code>: Number of waypoints</li>
<li><code>IWPTYP: integer</code>: Waypoint type<ul>
<li><code>= 1</code>: Locally defined relative to body location</li>
<li><code>= 2</code>: Globally defined</li>
</ul>
</li>
<li><code>IHRTYP: integer</code>: Heading reference type<ul>
<li><code>= 1</code>: Tangential to path</li>
<li><code>= 2</code>: Globally fixed</li>
</ul>
</li>
</ul>
<h4>If CHREF = GUIDANCE (Guidance System), 1 input line</h4>
<div class="fragment"><div class="line">TSTART    AMAXX    AMAXY</div>
</div><!-- fragment --><ul>
<li><code>TSTART: real, default: 200</code>: Start time for guidance system, <img class="formulaInl" alt="$[T]$" src="form_70.png"/></li>
<li><code>AMAXX: real</code>: Max. acceleration in local x-direction, <img class="formulaInl" alt="$[L/TT]$" src="form_173.png"/></li>
<li><code>AMAXY: real</code>: Max. acceleration in local y-direction, <img class="formulaInl" alt="$[L/TT]$" src="form_173.png"/></li>
</ul>
<h4>If CHREF = GUIDANCE (Guidance System) and IGTYP = 1,</h4>
<p>Waypoint table, <code>NWAYP</code> input lines, </p>
<div class="fragment"><div class="line">XP  YP  ZP  VREF  PSI  RADT</div>
</div><!-- fragment --><ul>
<li><code>XP: real</code>: X-coordinate of waypoint, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>YP: real</code>: Y-coordinate of waypoint, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>ZP: real</code>: Z-coordinate of waypoint, (dummy), <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>VREF: real &gt; 0</code>: Velocity towards next waypoint, <img class="formulaInl" alt="$[L/T]$" src="form_174.png"/></li>
<li><code>PSI: real</code>: Heading towards next waypoint, (<code>only for IHRTYP=1</code>), <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
<li><code>RADT: real &gt; 0</code>: Turning radius of waypoint, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
</ul>
<p>Maximum rate of turn <img class="formulaInl" alt="$ \mathrm{\dot{\theta} = \frac{VREF}{RADT}}$" src="form_175.png"/></p>
<h4>If CHREF = GUIDANCE (Guidance System) and IGTYP = 1,</h4>
<p>Waypoint table, <code>NWAYP</code> input lines, (<code>CHREF = GUIDANCE</code>) </p>
<div class="fragment"><div class="line">XP  YP  ZP  VREF  PSI  RADA  LOSLEN</div>
</div><!-- fragment --><ul>
<li><code>XP: real</code>: X-coordinate of waypoint, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>YP: real</code>: Y-coordinate of waypoint, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>ZP: real</code>: Z-coordinate of waypoint, (dummy), <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>VREF: real &gt; 0</code>: Velocity towards next waypoint, <img class="formulaInl" alt="$[L/T]$" src="form_174.png"/></li>
<li><code>PSI: real</code>: Heading towards next waypoint, (only for <code>IHRTYP=1</code>), <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
<li><code>RADA: real &gt; 0</code>: Radius of acceptance, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>LOSLEN: real &gt; 0</code>: ‘Line-of-sight’ length, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
</ul>
<h4>1 input line for IDP = 1, 2 and 3, some or all input in this line may be dummy for IDP = 3</h4>
<div class="fragment"><div class="line">IWIND  WILPT  IMAXTH  THRMAX</div>
</div><!-- fragment --><ul>
<li><code>IWIND: integer, default: 1</code>: Flag for measurement of wind forces to be included in the controller<ul>
<li><code>= 1</code>: No</li>
<li><code>= 2</code>: Yes, but no low-pass filtering</li>
<li><code>= 3</code>: Yes, with low-pass filtering</li>
</ul>
</li>
<li><code>WILPT: real</code>: Cut-off time in low-pass filter for wind measurements, <img class="formulaInl" alt="$[T]$" src="form_70.png"/></li>
<li><code>IMAXTH: integer, default: 0</code>: Flag for specification of maximum total thrust<ul>
<li><code>= 0</code>: No</li>
<li><code>= 1</code>: Yes, included</li>
</ul>
</li>
<li><code>THRMAX: real</code>: Maximum total thrust, i.e. thrust before any thrust reduction is accounted for, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
</ul>
<h4>Bias force estimation for IDP = 1, 2 and 3, 1 input line, may be dummy for IDP = 3</h4>
<div class="fragment"><div class="line">FSTAX  FSTAY  FSTAM</div>
</div><!-- fragment --><ul>
<li><code>FSTAX: real</code>: Start value on non-measured longitudinal external forces acting on the body, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>FSTAY: real</code>: Start value on non-measured transverse external forces acting on the body, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>FSTAM: real</code>: Start value on non-measured external moment acting on the body, <img class="formulaInl" alt="$[FL]$" src="form_154.png"/></li>
</ul>
<h3>PID controller (IDP = 1)</h3>
<h4>1 identification input line</h4>
<div class="fragment"><div class="line">PID CONTroller DATA</div>
</div><!-- fragment --><h4>1 input line, stiffness coefficients, <img class="formulaInl" alt="$ \mathrm{K_p} $" src="form_176.png"/></h4>
<div class="fragment"><div class="line">RKPOSX  RKPOSY  RKPOSM</div>
</div><!-- fragment --><ul>
<li><code>RKPOSX: real</code>: Position feedback in surge, <img class="formulaInl" alt="$[F/L]$" src="form_150.png"/></li>
<li><code>RKPOSY: real</code>: Position feedback in sway, <img class="formulaInl" alt="$[F/L]$" src="form_150.png"/></li>
<li><code>RKPOSM: real</code>: Position feedback in yaw, <img class="formulaInl" alt="$[FL]$" src="form_154.png"/></li>
</ul>
<h4>1 input line, damping coefficients, <img class="formulaInl" alt="$ \mathrm{K_v} $" src="form_177.png"/></h4>
<div class="fragment"><div class="line">RKVELX  RKVELY  RKVELM</div>
</div><!-- fragment --><ul>
<li><code>RKVELX: real</code>: Velocity feedback in surge, <img class="formulaInl" alt="$[FT/L]$" src="form_145.png"/></li>
<li><code>RKVELY: real</code>: Velocity feedback in sway, <img class="formulaInl" alt="$[FT/L]$" src="form_145.png"/></li>
<li><code>RKVELM: real</code>: Velocity feedback in yaw, <img class="formulaInl" alt="$[FLT]$" src="form_178.png"/></li>
</ul>
<h4>1 input line, <img class="formulaInl" alt="$ \mathrm{K_I} $" src="form_179.png"/></h4>
<div class="fragment"><div class="line">RKINTX  RKINTY  RKINTM</div>
</div><!-- fragment --><ul>
<li><code>RKINTX: real</code>: Integral feedback in surge, <img class="formulaInl" alt="$[F/LT]$" src="form_180.png"/></li>
<li><code>RKINTY: real</code>: Integral feedback in sway, <img class="formulaInl" alt="$[F/LT]$" src="form_180.png"/></li>
<li><code>RKINTM: real</code>: Integral feedback in yaw, <img class="formulaInl" alt="$[FL/T]$" src="form_181.png"/></li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">TCWF   ETAWF  TFILTX  TFILTY  TFILTM</div>
</div><!-- fragment --><ul>
<li><code>TCWF: real, default: 10</code>: Centre period of wave filter <img class="formulaInl" alt="$[T]$" src="form_70.png"/></li>
<li><code>ETAWF: real, default: 1</code>: Strength of wave filter, <code>0 &lt;= ETAWF &lt;= 1</code></li>
<li><code>TFILTX: real, default: 2.5</code>: Filter period for surge, <img class="formulaInl" alt="$[T]$" src="form_70.png"/></li>
<li><code>TFILTY: real, default: 2.5</code>: Filter period for sway, <img class="formulaInl" alt="$[T]$" src="form_70.png"/></li>
<li><code>TFILTM: real, default: 2.5</code>: Filter period for yaw, <img class="formulaInl" alt="$[T]$" src="form_70.png"/></li>
</ul>
<h4>Tuning a control system is no exact science. The following procedure should serve as a guideline.</h4>
<ol type="1">
<li>For each of the three motions surge, sway and yaw, determine position and velocity feedback gains <img class="formulaInl" alt="$K_P$" src="form_182.png"/> and <img class="formulaInl" alt="$K_V$" src="form_183.png"/> that give the wanted stiffness and damping. Set the integral gains <img class="formulaInl" alt="$K_I$" src="form_184.png"/> to zero. Turn off the wave frequency filter ( <img class="formulaInl" alt="$ \eta_{WF} = 0_{} $" src="form_185.png"/>) and set the cutoff frequency of the lowpass filter to 1/5 of the sampling rate. Thruster limitations must not be effective.</li>
<li>From an initial position of non-equilibrium and with no dynamic environmental forces acting, simulate the transient motion towards equilibrium (to avoid complications caused by possible cross-coupling effects, it is safest to do this for one motion at a time, that is simulating pure transients in surge, sway and yaw). The transients should be non-oscillating. If they are not, the damping coefficients must be increased.</li>
<li>Make a simulation with dynamic environmental excitation. Inspect the thruster outputs to see if the amount of wave frequency components is admissible. If it is, proceed to 5. If not, select the appropriate value for the strength parameter of the wave filter according to the description and the figures in 'PID controller' in 'Dynamic positioning' in 'Force models' in the Theory Manual.</li>
<li>With the selected wave filter, simulate transients again. The wave filter introduces negative phase in the control loop, which reduces stability. If any transient is unstable or shows oscillatory behaviour that does not die out rapidly (i.e. during one or two half cycles), stability must be improved. If it is unacceptable to reduce the strength of the wave filter, the remedy is to: 1) make the controller phase more positive at the frequency of oscillation, and/or 2) reduce the controller gain at the same frequency. Remedy (1) is carried out by reducing <img class="formulaInl" alt="$K_P$" src="form_182.png"/> while keeping <img class="formulaInl" alt="$K_V$" src="form_183.png"/> constant. Try this choice first, for example by halving the value of <img class="formulaInl" alt="$K_P$" src="form_182.png"/>. Remedy (2) is effectuated by reducing <img class="formulaInl" alt="$K_P$" src="form_182.png"/> and <img class="formulaInl" alt="$K_V$" src="form_183.png"/> by the same amount (e.g. halving them). Try this remedy if (1) fails or is insufficient.</li>
<li>If integral action is desired, determine the upper frequency limit <img class="formulaInl" alt="$\omega_I$" src="form_186.png"/> for this action, i.e. the frequency above which the integral action becomes insignificant (cf. the figure 'Frequency response of a PID controller (Dashed lines...)' in 'PID controller' in 'Dynamic positioning' in 'Force models' in the Theory Manual). Then set <img class="formulaInl" alt="$ K_I = \omega_I \cong K_P $" src="form_187.png"/> and simulate transients. The integral action too deteriorates stability. If stability is unsatisfactory, <img class="formulaInl" alt="$K_I$" src="form_184.png"/> must be reduced.</li>
<li>If it is known that the amount of measurement noise (the present version of <code>SIMO</code> does not simulate such noise) necessitates harder lowpass filtering of the position measurements, the cutoff frequency of the filter must be reduced from the value set according to paragraph 1 above. This may then lead to an adjustment of the controller gains as outlined in paragraph 4, until a satisfactory transient motion is obtained for all three motion variables.</li>
</ol>
<p>The above procedure reflects the standard knowledge from control theory that for a feedback system to be stable, the open-loop gain must be less than 1 (0 dB) at the crossover frequency (i.e. the frequency at which the open-loop phase is -180 deg.)</p>
<h3>Kalman filter based controller (IDP = 2)</h3>
<h4>1 identification input line</h4>
<div class="fragment"><div class="line">KALMan FILTer DATA</div>
</div><!-- fragment --><h4>1 input line</h4>
<div class="fragment"><div class="line">ILINE   ISTAT</div>
</div><!-- fragment --><ul>
<li><code>ILINE: integer</code>: Flag for measurement of line tensions to be included in the controller<ul>
<li><code>= 0</code>: No line tension/coupling measurements in the Kalman filter</li>
<li><code>= 1</code>: Line tension/coupling measurements in the Kalman filter</li>
<li><code>= 2</code>: Diagonal stiffness matrix included in the estimator of the Kalman filter</li>
<li><code>= 3</code>: Stiffness matrix included in the estimator of the Kalman filter</li>
<li><code>= 4</code>: Stiffness matrix for anchor system, data table for nonlinear lines, and hawser tension measurements are included in the estimator of the Kalman filter</li>
</ul>
</li>
<li><code>ISTAT: integer</code>: Estimation method flag<ul>
<li><code>= 0</code>: Current estimation, quadratic drag formula used</li>
<li><code>= 1</code>: Bias force estimation, linear drag formula used</li>
</ul>
</li>
</ul>
<h4>1 input line, drag coefficients and nominal velocity.</h4>
<p>The drag coefficients should be as correct as possible compared to the vessel to be positioned, but it is also important that <code>DRAGX</code> is not smaller than <code>DRAGY/4</code>. In such cases DRAGX should be overestimated. The nominal velocity, <code>VTYP</code>, should not be smaller than 0.1 m/s since this will give too high amplification for small current speeds. The drag forces on the vessel estimated by the Kalman filter are linearized with respect to this velocity.</p>
<div class="fragment"><div class="line">DRAGX     DRAGY     DRAGM    VTYP   TSTA</div>
</div><!-- fragment --><ul>
<li><code>DRAGX: real</code>: Longitudinal drag coefficient, <img class="formulaInl" alt="$[FT^2/L^2]$" src="form_144.png"/></li>
<li><code>DRAGY: real</code>: Transverse drag coefficient, <img class="formulaInl" alt="$[FT^2/L^2]$" src="form_144.png"/></li>
<li><code>DRAGM: real</code>: Rotational drag coefficient, <img class="formulaInl" alt="$[FLT^2]$" src="form_188.png"/></li>
<li><code>VTYP: real, default: 0.25</code>: Nominal velocity, <img class="formulaInl" alt="$[L/T]$" src="form_174.png"/></li>
<li><code>TSTA: real</code>: Starting period for HF_estimation, <img class="formulaInl" alt="$[T]$" src="form_70.png"/></li>
</ul>
<h4>1 input line if ILINE = 2. The stiffness matrix is given with the wanted position as reference.</h4>
<div class="fragment"><div class="line">STFLIX STFLIY STFLID</div>
</div><!-- fragment --><ul>
<li><code>STFLIX: real</code>: Linear stiffness in global X-direction (not from DP system), <img class="formulaInl" alt="$[F/L]$" src="form_150.png"/></li>
<li><code>STFLIY: real</code>: Linear stiffness in global Y-direction (not from DP system), <img class="formulaInl" alt="$[F/L]$" src="form_150.png"/></li>
<li><code>STFLID: real</code>: Linear stiffness for global heading (not from DP system), <img class="formulaInl" alt="$[FL]$" src="form_154.png"/></li>
</ul>
<h4>3 input lines if ILINE = 3 or 4. The stiffness matrix is given with the wanted position as reference.</h4>
<div class="fragment"><div class="line">STFLi1 STFLi2 STFLi6</div>
</div><!-- fragment --><ul>
<li><code>STFLij: real</code>: Force in global i-direction due to a unit displacement in the global j-direction (not from DP system) <img class="formulaInl" alt="$[F/L,F,FL]$" src="form_189.png"/></li>
</ul>
<p>Diagonal terms are negative for a common anchoring system.</p>
<ul>
<li>i=1 is the global X-direction</li>
<li>i=2 is the global Y-direction</li>
<li>i=6 is the global heading</li>
</ul>
<p>The rotation stiffness is per rad</p>
<h4>1 input line if ILINE = 4.</h4>
<div class="fragment"><div class="line">NNL</div>
</div><!-- fragment --><ul>
<li><code>NNL: integer</code>: Number of nonlinear lines of which forces are estimated in the Kalman filter</li>
</ul>
<h4>NNL times the following block if ILINE = 4.</h4>
<p>1 input line </p>
<div class="fragment"><div class="line">X0  Y0</div>
</div><!-- fragment --><ul>
<li><code>X0: real</code>: Global X-coord. of the line end point anchored at the sea bed <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>Y0: real</code>: Global Y-coord. of the line end point anchored at the sea bed <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
</ul>
<p>1 input line </p>
<div class="fragment"><div class="line">X1  Y1</div>
</div><!-- fragment --><ul>
<li><code>X1: real</code>: X-coord. of the line end point attached to the vessel (given in the body fixed coord. system) <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>Y1: real</code>: Y-coord. of the line end point attached to the vessel (given in the body fixed coord. system) <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
</ul>
<p>1 input line </p>
<div class="fragment"><div class="line">NLT</div>
</div><!-- fragment --><ul>
<li><code>NLT: integer</code>: Number of data lines in the table describing the tension of the anchored line as a function of the horizontal length.</li>
</ul>
<p><code>NLT</code> input lines (characteristic of the nonlinear line) </p>
<div class="fragment"><div class="line">Li  Ti</div>
</div><!-- fragment --><ul>
<li><code>Li: real</code>: Horizontal length of the nonlinear line <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>Ti: real</code>: Horizontal tension of the nonlinear line for the given length <code>Li</code> <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
</ul>
<h4>1 input line if ILINE = 4.</h4>
<div class="fragment"><div class="line">NH</div>
</div><!-- fragment --><ul>
<li><code>NH: integer</code>: Number of hawsers of which force is measured and used in the Kalman filter estimation model.</li>
</ul>
<h4>NH times the following block if ILINE = 4.</h4>
<p>1 input line </p>
<div class="fragment"><div class="line">HAWID</div>
</div><!-- fragment --><ul>
<li><code>HAWID: character(8)</code>: Name (identifier) of the coupling element modelling the hawser. The coupling element should be a simple wire coupling or a fixed elongation coupling.</li>
</ul>
<p>1 input line </p>
<div class="fragment"><div class="line">WNSTDV SEEDN</div>
</div><!-- fragment --><ul>
<li><code>WNSTDV: real</code>: White noise standard deviation of the measurement system, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>SEEDN: integer, default: 1</code>: Seed number for the realisation of the white noise</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">AMX AMY AMR</div>
</div><!-- fragment --><ul>
<li><code>AMX: real</code>: Total mass in surge to be used in Kalman filter, <img class="formulaInl" alt="$[M]$" src="form_71.png"/></li>
<li><code>AMY: real</code>: Total mass in sway to be used in Kalman filter, <img class="formulaInl" alt="$[M]$" src="form_71.png"/></li>
<li><code>AMR: real</code>: Total inertia to be used in Kalman filter, <img class="formulaInl" alt="$[ML^2]$" src="form_190.png"/></li>
</ul>
<p>Total masses and inertia includes body mass and typical hydrodynamic added mass</p>
<p>The linear controller matrix is defined on the next 3 input lines. The position gains will determine the natural periods in the system. It is possible to use:</p>
<ul>
<li><code>-0.01 AMX &lt;= GMATX1 &lt;= -0.005 AMX</code></li>
<li><code>-0.01 AMY &lt;= GMATY1 &lt;= -0.005 AMY</code></li>
<li><code>-0.01 AMR &lt;= GMATD1 &lt;= -0.005 AMR</code></li>
</ul>
<p>These position feedbacks will give natural periods in the range 90 s to 60 s. The higher feedbacks will give the best abilities to suppress disturbances, while the lower feedbacks will give less modulation of thruster signals.</p>
<p>Theoretically, the best vessel behaviour is obtained by approximately 70 % of critical damping, which is obtained by:</p>
<ul>
<li><img class="formulaInl" alt="$ \mathrm{GMATX2 = - \sqrt{2\: |GMATX1| \times AMX}}$" src="form_191.png"/></li>
<li><img class="formulaInl" alt="$ \mathrm{GMATY2 = - \sqrt{2\: |GMATY1| \times AMY}}$" src="form_192.png"/></li>
<li><img class="formulaInl" alt="$ \mathrm{GMATD2 = - \sqrt{2\: |GMATD1| \times AMR}}$" src="form_193.png"/></li>
</ul>
<p>Alternatively:</p>
<ul>
<li><img class="formulaInl" alt="$ \mathrm{GMATX1} = - \left( \frac{2\pi}{T_x} \right)^2 m_x \quad \quad \quad \mathrm{GMATX2} = -2 \xi_x \mathrm{\sqrt{|GMATX1| \times AMX}}$" src="form_194.png"/></li>
<li><img class="formulaInl" alt="$ \mathrm{GMATY1} = - \left( \frac{2\pi}{T_y} \right)^2 m_y \quad \quad \quad \mathrm{GMATY2} = -2 \xi_y \mathrm{\sqrt{|GMATY1| \times AMY}}$" src="form_195.png"/></li>
<li><img class="formulaInl" alt="$ \mathrm{GMATD1} = - \left( \frac{2\pi}{T_{\psi}} \right)^2 m_{\psi} \quad \quad \quad \mathrm{GMATD2} = -2 \xi_{\psi} \mathrm{\sqrt{|GMATD1| \times AMR}}$" src="form_196.png"/></li>
</ul>
<p>where <img class="formulaInl" alt="$T_x$" src="form_197.png"/>, <img class="formulaInl" alt="$T_y$" src="form_198.png"/> and <img class="formulaInl" alt="$T_{\psi} $" src="form_199.png"/> are the chosen/wanted natural periods for surge, sway and yaw, respectively. The damping factors are given as <img class="formulaInl" alt="$\xi_x$" src="form_200.png"/>, <img class="formulaInl" alt="$\xi_y$" src="form_201.png"/> and <img class="formulaInl" alt="$\xi_{\psi}$" src="form_202.png"/>, <img class="formulaInl" alt="$ _{}$" src="form_203.png"/> and they are typically set to a value of 0.7 which indicates a damping level of 70% of the critical damping.</p>
<p>As the first step in tuning the DP-system, the vessel can be moved to an offset position and released with no environmental forces. The DP-system should then be able to produce a wanted transient motion to the desired position. At this stage of the tuning, the thrusters data <b>TMIMA</b> (minimum time to change from minimum to maximum thrust) should be set to a small value, and <b>ANGH</b> (maximum angular velocity of azimuth thrusters) should be set to a large value. These thruster data should be set to their correct values after initial tuning.</p>
<h4>1 input line</h4>
<div class="fragment"><div class="line">GMATX1 GMATX2</div>
</div><!-- fragment --><ul>
<li><code>GMATX1: real</code>: Longitudinal position gain, <img class="formulaInl" alt="$[F/L]$" src="form_150.png"/></li>
<li><code>GMATX2: real</code>: Longitudinal velocity gain, <img class="formulaInl" alt="$[FT/L]$" src="form_145.png"/></li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">GMATY1 GMATY2</div>
</div><!-- fragment --><ul>
<li><code>GMATY1: real</code>: Transverse position gain, <img class="formulaInl" alt="$[F/L]$" src="form_150.png"/></li>
<li><code>GMATY2: real</code>: Transverse velocity gain, <img class="formulaInl" alt="$[FT/L]$" src="form_145.png"/></li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">GMATD1 GMATD2</div>
</div><!-- fragment --><ul>
<li><code>GMATD1: real</code>: Heading gain, <img class="formulaInl" alt="$[FL]$" src="form_154.png"/></li>
<li><code>GMATD2: real</code>: Heading rate gain, <img class="formulaInl" alt="$[FLT]$" src="form_178.png"/></li>
</ul>
<p>The Kalman filter gain matrix is defined on the next 3 input lines.</p>
<p>Depending on the natural periods of the motions (low frequency) and on the wave frequency motions, cut-off frequencies <img class="formulaInl" alt="$\omega_c$" src="form_204.png"/> for filtering the wave frequency motions are normally chosen. Typically, the cut-off periods for surge, sway and yaw of <img class="formulaInl" alt="$T_c = 2 \pi / \omega_c$" src="form_205.png"/> are given values between 25s and 50s.</p>
<p>Then Kalman filter coefficients (for initial tuning) may be chosen as:</p>
<ul>
<li><img class="formulaInl" alt="$ \mathrm{RKXI} = 2 \xi_x \omega_{c,x} \quad \quad \quad \mathrm{RKX2} = \omega^2_{c,x}$" src="form_206.png"/></li>
<li><img class="formulaInl" alt="$ \mathrm{RKYI} = 2 \xi_y \omega_{c,y} \quad \quad \quad \mathrm{RKY2} = \omega^2_{c,y}$" src="form_207.png"/></li>
<li><img class="formulaInl" alt="$ \mathrm{RKDI} = 2 \xi_{\psi} \omega_{c,\psi} \quad \quad \: \: \: \mathrm{RKD2} = \omega^2_{c,\psi}$" src="form_208.png"/></li>
</ul>
<p>The <img class="formulaInl" alt="$ _{} $" src="form_209.png"/> default values for the various <code>RK3</code>-gains are given as guidelines for the case of current estimation (<code>ISTAT = 0</code>). In the case of bias force estimation (<code>ISTAT = 1</code>), it is recommended to use <code>RKX3 = .00001AMX</code>, <code>RKY3 = .00001AMY</code>. In both cases <code>RKD3 = .00005AMR</code>.</p>
<h4>1 input line</h4>
<div class="fragment"><div class="line">RKX1   RKX2   RKX3   RKX4</div>
</div><!-- fragment --><ul>
<li><code>RKX1: real</code>: Longitudinal LF position gain, <img class="formulaInl" alt="$[1]$" src="form_124.png"/></li>
<li><code>RKX2: real</code>: Longitudinal LF velocity gain, <img class="formulaInl" alt="$[1/T]$" src="form_210.png"/></li>
<li><code>RKX3: real, default: 0.00025</code>: Longitudinal current or bias force gain, <img class="formulaInl" alt="$[1/T]$" src="form_210.png"/> or <img class="formulaInl" alt="$[F/L]$" src="form_150.png"/></li>
<li><code>RKX4: real, default: 0.2</code>: Longitudinal HF position gain, <img class="formulaInl" alt="$[1]$" src="form_124.png"/></li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">RKY1   RKY2   RKY3   RKY4</div>
</div><!-- fragment --><ul>
<li><code>RKY1: real</code>: Transverse LF position gain, <img class="formulaInl" alt="$[1]$" src="form_124.png"/></li>
<li><code>RKY2: real</code>: Transverse LF velocity gain, <img class="formulaInl" alt="$[1/T]$" src="form_210.png"/></li>
<li><code>RKY3: real, default: 0.00025</code>: Transverse current or bias force gain, <img class="formulaInl" alt="$[1/T]$" src="form_210.png"/> or <img class="formulaInl" alt="$[F/L]$" src="form_150.png"/></li>
<li><code>RKY4: real, default: 0.2</code>: Transverse HF position gain, <img class="formulaInl" alt="$[1]$" src="form_124.png"/></li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">RKD1  RKD2  RKD3  RKD4</div>
</div><!-- fragment --><ul>
<li><code>RKD1: real</code>: LF heading gain, <img class="formulaInl" alt="$[1]$" src="form_124.png"/></li>
<li><code>RKD2: real</code>: LF heading rate gain, <img class="formulaInl" alt="$[1/T]$" src="form_210.png"/></li>
<li><code>RKD3: real</code>: Bias moment gain, <img class="formulaInl" alt="$[FL]$" src="form_154.png"/></li>
<li><code>RKD4: real, default: 0.2</code>: HF heading gain, <img class="formulaInl" alt="$[1]$" src="form_124.png"/></li>
</ul>
<p>In a case with zero or negligible wave frequency yaw motion, <code>RKD4</code> should be set to zero.</p>
<h3>External controller function data (IDP = 3)</h3>
<h4>1 identification input line for a user-supplied external dynamic positioning controller</h4>
<div class="fragment"><div class="line">EXTErnal DYNAmic POSItioning</div>
</div><!-- fragment --><h4>1 input line, path and filename of library containing the controller</h4>
<div class="fragment"><div class="line">TXXDP</div>
</div><!-- fragment --><ul>
<li><code>TXXDP: character(120)</code>: Character string giving path and filename</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">NPCUR</div>
</div><!-- fragment --><ul>
<li><code>NPCUR: integer &gt; 0</code>: Number of points where current velocities shall be given to the external DP-system library</li>
</ul>
<h3>MTDP controller (IDP = 4)</h3>
<p>No input data on the system description file for this controller, but the communication settings must be given as described in <a class="el" href="a00022.html#ug_external_specification_mtdp">MTDP communication</a>.</p>
<h3>Velocity PI controller (IDP = 5)</h3>
<h4>1 identification input line, velocity reference from HLA</h4>
<div class="fragment"><div class="line">VELOcity CONTroller DATA</div>
</div><!-- fragment --><h4>1 input line, stiffness coefficients, <img class="formulaInl" alt="$ \mathrm{K_P}$" src="form_211.png"/></h4>
<div class="fragment"><div class="line">RKVELX  RKVELY  RKVELM</div>
</div><!-- fragment --><ul>
<li><code>RKVELX: real</code>: Velocity feedback in surge, <img class="formulaInl" alt="$[FT/L]$" src="form_145.png"/></li>
<li><code>RKVELY: real</code>: Velocity feedback in sway, <img class="formulaInl" alt="$[FT/L]$" src="form_145.png"/></li>
<li><code>RKVELM: real</code>: Velocity feedback in yaw, <img class="formulaInl" alt="$[FTL]$" src="form_212.png"/></li>
</ul>
<h4>1 input line, integral coefficients, <img class="formulaInl" alt="$ \mathrm{K_I}$" src="form_213.png"/></h4>
<div class="fragment"><div class="line">RKINTX  RKINTY  RKINTM</div>
</div><!-- fragment --><ul>
<li><code>RKINTX: real</code>: Integral feedback in surge, <img class="formulaInl" alt="$[F/L]$" src="form_150.png"/></li>
<li><code>RKINTY: real</code>: Integral feedback in sway, <img class="formulaInl" alt="$[F/L]$" src="form_150.png"/></li>
<li><code>RKINTM: real</code>: Integral feedback in yaw, <img class="formulaInl" alt="$[FL]$" src="form_154.png"/></li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">TCWF   ETAWF  TFILTX  TFILTY  TFILTM</div>
</div><!-- fragment --><ul>
<li><code>TCWF: real, default: 10</code>: Centre period of wave filter <img class="formulaInl" alt="$[T]$" src="form_70.png"/></li>
<li><code>ETAWF: real, default: 1</code>: Strength of wave filter, <code>0 &lt;= ETAWF &lt;= 1</code>:</li>
<li><code>TFILTX: real, default: 2.5</code>: Filter period for surge, <img class="formulaInl" alt="$[T]$" src="form_70.png"/></li>
<li><code>TFILTY: real, default: 2.5</code>: Filter period for sway, <img class="formulaInl" alt="$[T]$" src="form_70.png"/></li>
<li><code>TFILTM: real, default: 2.5</code>: Filter period for yaw, <img class="formulaInl" alt="$[T]$" src="form_70.png"/></li>
</ul>
<h2><a class="anchor" id="ug_body_positioning_dynamic"></a>
Dynamic positioning</h2>
<p>This DP model can only be used together with the new thruster model documented in <a class="el" href="a00024.html#ug_body_positioning_thrusters">Thrusters</a>.</p>
<h4>1 input line.</h4>
<div class="fragment"><div class="line">DYNAmic POSItioning CONTRol</div>
</div><!-- fragment --><h4>Text for describing the positioning system, 2 input lines.</h4>
<div class="fragment"><div class="line">TXDP</div>
</div><!-- fragment --><ul>
<li><code>TXDP: character(60)</code>: Character string</li>
</ul>
<h4>1 input line.</h4>
<div class="fragment"><div class="line">THRUster CONTrol DATA</div>
</div><!-- fragment --><h4>1 input line.</h4>
<div class="fragment"><div class="line">NTHRC</div>
</div><!-- fragment --><ul>
<li><code>NTHRC: integer</code>: Number of thrusters to be under DP control</li>
</ul>
<h4>1 input line per thruster, NTHRC lines in all</h4>
<div class="fragment"><div class="line">ITHR   ITYPE  XTH  YTH ZTH  DIR  FMIN  FMAX CFPOS  CFNEG  FRATE  ARATE</div>
</div><!-- fragment --><ul>
<li><code>CHTHR: character(8)</code>: Thruster name; Reference to thruster identifier for thruster to be controlled</li>
<li><code>ITYPE: integer</code>: Thruster type:<ul>
<li><code>1 =</code>: Fixed direction thruster</li>
<li><code>2 =</code>: Variable direction (azimuth) thruster</li>
</ul>
</li>
<li><code>XTH: real</code>: X-coordinate of thruster in body system</li>
<li><code>YTH: real</code>: Y-coordinate of thruster in body system</li>
<li><code>ZTH: real</code>: Z-coordinate of thruster in body system</li>
<li><code>DIR: real</code>: Direction of thruster <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/>.<ul>
<li>Start value for azimuthing thrusters</li>
</ul>
</li>
<li><code>FMIN: real</code>: Minimum force <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>FMAX: real</code>: Maximum force <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>FRATE: real</code>: Maximum rate of force <img class="formulaInl" alt="$[F/T]$" src="form_214.png"/></li>
<li><code>ARATE: real</code>: Maximum rate of azimuth angle <img class="formulaInl" alt="$ \mathrm{[deg}/T]$" src="form_164.png"/><ul>
<li>Dummy for fixed direction thrusters.</li>
</ul>
</li>
</ul>
<p>For azimuth thruster, <code>FMIN</code> should not be negative</p>
<h4>1 input line.</h4>
<div class="fragment"><div class="line">DYNAmic POSItioning DATA</div>
</div><!-- fragment --><h4>Type of DP-system, 1 input line</h4>
<div class="fragment"><div class="line">IDP</div>
</div><!-- fragment --><ul>
<li><code>IDP: integer</code>: Type of dynamic positioning controller<ul>
<li><code>= 1</code>: PID controller</li>
<li><code>= 2</code>: Kalman filter based controller</li>
<li><code>= 3</code>: External controller function/library</li>
<li><code>= 4</code>: MTDP controller (internal MARINTEK DP-system)</li>
<li><code>= 5</code>: Velocity PI controller (HLA)</li>
</ul>
</li>
</ul>
<p>If the MTDP controller type is selected <code>NTHRC</code> (specified in the previous section) must be zero.</p>
<h4>Degree of freedom for thruster allocation for IDP = 1, 2 and 3, 1 input line.</h4>
<div class="fragment"><div class="line">IFO1    IFO2    IFO6   IDPMOD   ITALLOC   IMADP    DTCI</div>
</div><!-- fragment --><ul>
<li><code>IFO1: integer</code>: Force allocation in surge (<code>0 or 1</code>)</li>
<li><code>IFO2: integer</code>: Force allocation in sway (<code>0 or 1</code>)</li>
<li><code>IFO6: integer</code>: Moment allocation in yaw (<code>0 or 1</code>)</li>
<li><code>IDPMOD: integer, default: 1</code>: Flag for mode of DP-system<ul>
<li><code>= 0</code>: DP-system OFF</li>
<li><code>&gt; 0</code>: DP-system ON</li>
<li><code>= 2</code>: Use any given <code>&lt;CHBDY&gt;</code> as reference</li>
</ul>
</li>
<li><code>ITALLOC: integer, default: 1</code>: Thrust allocation method<ul>
<li><code>= 1</code>: Ordinary allocation</li>
<li><code>= 2</code>: Heading priority</li>
</ul>
</li>
<li><code>IMADP: integer, default: 0</code>: Flag for option of manual-DP by commanded force from HLA<ul>
<li><code>= 0</code>: No HLA commanded force</li>
<li><code>= 1</code>: HLA commanded force, OFF</li>
<li><code>= 2</code>: HLA commanded force, ON</li>
</ul>
</li>
<li><code>DTCI: real, default: DT</code>: Control Interval</li>
</ul>
<p><code>IFOX = 1</code>: Force shall be allocated. At least one parameter has to be 1.</p>
<p>If <code>IMADP = 2</code> the given DP-controller is deactivated.</p>
<p><code>DT</code> is the <code>SIMO</code> storage interval (Main time step).</p>
<h4>If IMADP = 1 and 2, 1 input line, describing HLA name of commanded force</h4>
<div class="fragment"><div class="line">TXHDP</div>
</div><!-- fragment --><ul>
<li><code>TXHDP: character(120)</code>: Character string for HLA name of commanded force</li>
</ul>
<h4>1 input line for IDP = 1, 2 and 3</h4>
<div class="fragment"><div class="line">XREF    YREF    DREF    XLOC    YLOC    CHREF</div>
</div><!-- fragment --><ul>
<li><code>XREF: real</code>:<ul>
<li>X-coordinate of reference/wanted position, <img class="formulaInl" alt="$[L]$" src="form_69.png"/> for <code>CHREF != GBCIRCLE</code></li>
<li>X-coordinate of the circle center <img class="formulaInl" alt="$[L]$" src="form_69.png"/> for <code>CHREF = GBCIRCLE</code></li>
</ul>
</li>
<li><code>YREF: real</code>:<ul>
<li>Y-coordinate of reference/wanted position, <img class="formulaInl" alt="$[L]$" src="form_69.png"/> for <code>CHREF != GBCIRCLE</code></li>
<li>Y-coordinate of the circle center <img class="formulaInl" alt="$[L]$" src="form_69.png"/> for <code>CHREF = GBCIRCLE</code></li>
</ul>
</li>
<li><code>DREF: real</code>:<ul>
<li>Reference/wanted heading, <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/> for <code>CHREF != GBCIRCLE</code></li>
<li>Radius of the circle <img class="formulaInl" alt="$ \mathrm{[M]}$" src="form_215.png"/> for <code>CHREF = GBCIRCLE</code></li>
</ul>
</li>
<li><code>XLOC: real</code>: X-coordinate of the point on the body which shall be positioned at the specified reference, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>YLOC: real</code>: Y-coordinate of the point on the body which shall be positioned at the specified reference, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>CHREF: character(8), default: GLOBAL</code>: Reference frame identifier<ul>
<li><code>= GLOBAL</code>: Fixed reference point given in global coordinate system</li>
<li><code>= &lt;CHBDY&gt;</code>: A moving point given relative to body <code>&lt;CHBDY&gt;</code> shall be followed for one or more degrees of freedom. <code>IDPMOD</code> must be set to 2. (If <code>IDPMOD=1</code>, <code>CHREF = GLOBAL</code>)</li>
<li><code>= EXTREF</code>: Reference from an external function</li>
<li><code>= HLAREF</code>: Read global reference from HLA communication</li>
<li><code>= GUIDANCE</code>: Guidance System</li>
<li><code>= GBCIRCLE</code>: The circle perimeter is used as reference (see 'Weather vaning strategy (CHREF=GBCIRCLE)' in 'Force models' in the Theory Manual)</li>
</ul>
</li>
</ul>
<h4>If CHREF = &lt;CHBDY&gt;, 1 input line</h4>
<div class="fragment"><div class="line">IXYREF    IDREF    POSLPT</div>
</div><!-- fragment --><ul>
<li><code>IXYREF: integer</code>: Reference position flag, XY-position.<ul>
<li><code>= 1</code>: Fixed, given in global coordinate system</li>
<li><code>= 2</code>: Moving, given in local system of body to be followed</li>
</ul>
</li>
<li><code>IDREF: integer</code>: Reference position/heading flag<ul>
<li><code>= 1</code>: Fixed, given in global coordinate system</li>
<li><code>= 2</code>: Moving, given relative to heading of body to be followed</li>
</ul>
</li>
<li><code>POSLPT: real</code>: Cut-off time in low-pass filter for position measurement of body to follow</li>
</ul>
<p><code>XREF</code>, <code>YREF</code> are given values for <code>&lt;CHBDY&gt;</code> in the local coordinate system if <code>CHREF = &lt;CHBDY&gt;</code>, normally “outside” the body. <code>DREF</code> is the relative heading between the heading of the <code>DP</code>-body and the heading of <code>&lt;CHBDY&gt;</code>.</p>
<h4>If CHREF = EXTREF, 1 input line, name and path of external library</h4>
<div class="fragment"><div class="line">EXTRNA</div>
</div><!-- fragment --><ul>
<li><code>EXTRNA: character(120)</code>: Character string describing path and name of external DP-reference library</li>
</ul>
<p><code>XREF</code>, <code>YREF</code> and <code>ZREF</code> are initial values if <code>CHREF = EXTREF</code></p>
<h4>If CHREF = EXTREF, 1 input line</h4>
<div class="fragment"><div class="line">NPCUR</div>
</div><!-- fragment --><ul>
<li><code>NPCUR: integer &gt; 0</code>: Number of points where current velocities shall be given to the external reference library</li>
</ul>
<h4>If CHREF = HLAREF, 1 input line, name of HLA reference</h4>
<div class="fragment"><div class="line">HLARNA</div>
</div><!-- fragment --><ul>
<li><code>HLARNA: character(120)</code>: Character string describing HLA reference name</li>
</ul>
<p><code>XREF</code>, <code>YREF</code> and <code>ZREF</code> are initial values if <code>CHREF = HLAREF</code></p>
<h4>1 input line</h4>
<div class="fragment"><div class="line">IGTYP</div>
</div><!-- fragment --><ul>
<li><code>IGTYP: integer</code>: Type of <code>GUIDANCE</code><ul>
<li><code>= 1</code>: Straight lines and circular arcs</li>
<li><code>= 2</code>: Line of sight (LOS)</li>
</ul>
</li>
</ul>
<h4>If CHREF = GUIDANCE (Guidance System), 1 input line, (CHREF = GUIDANCE)</h4>
<div class="fragment"><div class="line">NWAYP    IWPTYP    IHRTYP</div>
</div><!-- fragment --><ul>
<li><code>NWAYP: integer</code>: Number of waypoints</li>
<li><code>IWPTYP: integer</code>: Waypoint type<ul>
<li><code>= 1</code>: Locally defined relative to body location</li>
<li><code>= 2</code>: Globally defined</li>
</ul>
</li>
<li><code>IHRTYP: integer</code>: Heading reference type<ul>
<li><code>= 1</code>: Tangential to path</li>
<li><code>= 2</code>: Globally fixed</li>
</ul>
</li>
</ul>
<h4>If CHREF = GUIDANCE (Guidance System), 1 input line, (CHREF = GUIDANCE)</h4>
<div class="fragment"><div class="line">TSTART    AMAXX    AMAXY</div>
</div><!-- fragment --><ul>
<li><code>TSTART: real, default: 200</code>: Start time for guidance system, <img class="formulaInl" alt="$[T]$" src="form_70.png"/></li>
<li><code>AMAXX: real</code>: Max. acceleration in local x-direction, <img class="formulaInl" alt="$[L/TT]$" src="form_173.png"/></li>
<li><code>AMAXY: real</code>: Max. acceleration in local y-direction, <img class="formulaInl" alt="$[L/TT]$" src="form_173.png"/></li>
</ul>
<h4>If CHREF = GUIDANCE (Guidance System) and IGTYP = 1,</h4>
<p>Waypoint table, <code>NWAYP</code> input lines, </p>
<div class="fragment"><div class="line">XP    YP    ZP    VREF    PSI     RADT</div>
</div><!-- fragment --><ul>
<li><code>XP: real</code>: X-coordinate of waypoint, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>YP: real</code>: Y-coordinate of waypoint, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>ZP: real</code>: Z-coordinate of waypoint, (dummy), <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>VREF: real &gt; 0</code>: Velocity towards next waypoint, <img class="formulaInl" alt="$[L/T]$" src="form_174.png"/></li>
<li><code>PSI: real</code>: Heading towards next waypoint, (only for <code>IHRTYP=1</code>), <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
<li><code>RADT: real &gt; 0</code>: Turning radius of waypoint, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
</ul>
<p>Maximum rate of turn <img class="formulaInl" alt="$ \mathrm{\dot{\theta} = \frac{VREF}{RADT}}$" src="form_175.png"/></p>
<h4>If IGTYP = 2,</h4>
<p>Waypoint table, <code>NWAYP</code> input lines, (<code>CHREF = GUIDANCE</code>) </p>
<div class="fragment"><div class="line">XP    YP    ZP    VREF    PSI    RADA    LOSLEN</div>
</div><!-- fragment --><ul>
<li><code>XP: real</code>: X-coordinate of waypoint, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>YP: real</code>: Y-coordinate of waypoint, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>ZP: real</code>: Z-coordinate of waypoint, (dummy), <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>VREF: real &gt; 0</code>: Velocity towards next waypoint, <img class="formulaInl" alt="$[L/T]$" src="form_174.png"/></li>
<li><code>PSI: real</code>: Heading towards next waypoint, (only for <code>IHRTYP=1</code>), <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
<li><code>RADA: real &gt; 0</code>: Radius of acceptance, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>LOSLEN: real &gt; 0</code>: ‘Line-of-sight’ length, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
</ul>
<h4>1 input line for IDP = 1, 2 and 3, some or all input in this line may be dummy for IDP = 3</h4>
<div class="fragment"><div class="line">IWIND  WILPT  IMAXTH  THRMAX</div>
</div><!-- fragment --><ul>
<li><code>IWIND: integer, default: 1</code>: Flag for measurement of wind forces to be included in the controller<ul>
<li><code>= 1</code>: No</li>
<li><code>= 2</code>: Yes, but no low-pass filtering</li>
<li><code>= 3</code>: Yes, with low-pass filtering</li>
</ul>
</li>
<li><code>WILPT: real</code>: Cut-off time in low-pass filter for wind measurements, <img class="formulaInl" alt="$[T]$" src="form_70.png"/></li>
<li><code>IMAXTH: integer, default: 0</code>: Flag for specification of maximum total thrust<ul>
<li><code>= 0</code>: No</li>
<li><code>= 1</code>: Yes, included</li>
</ul>
</li>
<li><code>THRMAX: real</code>: Maximum total thrust, i.e. thrust before any thrust reduction is accounted for <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
</ul>
<h4>Bias force estimation for IDP = 1, 2 and 3, 1 input line, may be dummy for IDP = 3</h4>
<div class="fragment"><div class="line">FSTAX       FSTAY       FSTAM</div>
</div><!-- fragment --><ul>
<li><code>FSTAX: real</code>: Start value on non-measured longitudinal external forces acting on the body, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>FSTAY: real</code>: Start value on non-measured transverse external forces acting on the body, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>FSTAM: real</code>: Start value on non-measured external moment acting on the body, <img class="formulaInl" alt="$[FL]$" src="form_154.png"/></li>
</ul>
<h3>PID controller (IDP = 1)</h3>
<h4>1 identification input line</h4>
<div class="fragment"><div class="line">PID CONTroller DATA</div>
</div><!-- fragment --><h4>1 input line, stiffness coefficients, <img class="formulaInl" alt="$\mathrm{K_p}$" src="form_216.png"/></h4>
<div class="fragment"><div class="line">RKPOSX  RKPOSY  RKPOSM</div>
</div><!-- fragment --><ul>
<li><code>RKPOSX: real</code>: Position feedback in surge, <img class="formulaInl" alt="$ [F/L]$" src="form_158.png"/></li>
<li><code>RKPOSY: real</code>: Position feedback in sway, <img class="formulaInl" alt="$ [F/L]$" src="form_158.png"/></li>
<li><code>RKPOSM: real</code>: Position feedback in yaw, <img class="formulaInl" alt="$ [FL]$" src="form_217.png"/></li>
</ul>
<h4>1 input line, damping coefficients, <img class="formulaInl" alt="$\mathrm{K_v}$" src="form_218.png"/></h4>
<div class="fragment"><div class="line">RKVELX  RKVELY  RKVELM</div>
</div><!-- fragment --><ul>
<li><code>RKVELX: real</code>: Velocity feedback in surge, <img class="formulaInl" alt="$ [FT/L]$" src="form_219.png"/></li>
<li><code>RKVELY: real</code>: Velocity feedback in sway, <img class="formulaInl" alt="$ [FT/L]$" src="form_219.png"/></li>
<li><code>RKVELM: real</code>: Velocity feedback in yaw, <img class="formulaInl" alt="$ [FLT]$" src="form_220.png"/></li>
</ul>
<h4>1 input line, <img class="formulaInl" alt="$\mathrm{K_I}$" src="form_221.png"/></h4>
<div class="fragment"><div class="line">RKINTX  RKINTY  RKINTM</div>
</div><!-- fragment --><ul>
<li><code>RKINTX: real</code>: Integral feedback in surge, <img class="formulaInl" alt="$ [F/LT]$" src="form_222.png"/></li>
<li><code>RKINTY: real</code>: Integral feedback in sway, <img class="formulaInl" alt="$ [F/LT]$" src="form_222.png"/></li>
<li><code>RKINTM: real</code>: Integral feedback in yaw, <img class="formulaInl" alt="$ [FL/T]$" src="form_223.png"/></li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">TCWF   ETAWF  TFILTX  TFILTY  TFILTM</div>
</div><!-- fragment --><ul>
<li><code>TCWF: real, default: 10</code>: Centre period of wave filter <img class="formulaInl" alt="$ [T]$" src="form_79.png"/></li>
<li><code>ETAWF: real, default: 1</code>: Strength of wave filter, <code>0 &lt;= ETAWF &lt;= 1</code></li>
<li><code>TFILTX: real, default: 2.5</code>: Filter period for surge, <img class="formulaInl" alt="$ [T]$" src="form_79.png"/></li>
<li><code>TFILTY: real, default: 2.5</code>: Filter period for sway, <img class="formulaInl" alt="$ [T]$" src="form_79.png"/></li>
<li><code>TFILTM: real, default: 2.5</code>: Filter period for yaw, <img class="formulaInl" alt="$ [T]$" src="form_79.png"/></li>
</ul>
<h4>Tuning a control system is no exact science. The following procedure should serve as a guideline.</h4>
<ol type="1">
<li>For each of the three motions surge, sway and yaw, determine position and velocity feedback gains <img class="formulaInl" alt="$K_P$" src="form_182.png"/> and <img class="formulaInl" alt="$K_V$" src="form_183.png"/> that give the wanted stiffness and damping. Set the integral gains <img class="formulaInl" alt="$K_I$" src="form_184.png"/> to zero. Turn off the wave frequency filter ( <img class="formulaInl" alt="$ \eta_{WF} = 0_{} $" src="form_185.png"/>) and set the cutoff frequency of the lowpass filter to 1/5 of the sampling rate. Thruster limitations must not be effective.</li>
<li>From an initial position of non-equilibrium and with no dynamic environmental forces acting, simulate the transient motion towards equilibrium (to avoid complications caused by possible cross-coupling effects, it is safest to do this for one motion at a time, that is simulating pure transients in surge, sway and yaw). The transients should be non-oscillating. If they are not, the damping coefficients must be increased.</li>
<li>Make a simulation with dynamic environmental excitation. Inspect the thruster outputs to see if the amount of wave frequency components is admissible. If it is, proceed to 5. If not, select the appropriate value for the strength parameter of the wave filter according to the description and the figures in 'PID controller' in 'Dynamic positioning' in 'Force models' in the Theory Manual.</li>
<li>With the selected wave filter, simulate transients again. The wave filter introduces negative phase in the control loop, which reduces stability. If any transient is unstable or shows oscillatory behaviour that does not die out rapidly (i.e. during one or two half cycles), stability must be improved. If it is unacceptable to reduce the strength of the wave filter, the remedy is to: 1) make the controller phase more positive at the frequency of oscillation, and/or 2) reduce the controller gain at the same frequency. Remedy (1) is carried out by reducing <img class="formulaInl" alt="$K_P$" src="form_182.png"/> while keeping <img class="formulaInl" alt="$K_V$" src="form_183.png"/> constant. Try this choice first, for example by halving the value of <img class="formulaInl" alt="$K_P$" src="form_182.png"/>. Remedy (2) is effectuated by reducing <img class="formulaInl" alt="$K_P$" src="form_182.png"/> and <img class="formulaInl" alt="$K_V$" src="form_183.png"/> by the same amount (e.g. halving them). Try this remedy if (1) fails or is insufficient.</li>
<li>If integral action is desired, determine the upper frequency limit <img class="formulaInl" alt="$\omega_I$" src="form_186.png"/> for this action, i.e. the frequency above which the integral action becomes insignificant (cf. the figure 'Frequency response of a PID controller (Dashed lines...)' in 'PID controller' in 'Dynamic positioning' in 'Force models' in the Theory Manual). Then set <img class="formulaInl" alt="$ K_I = \omega_I \cong K_P $" src="form_187.png"/> and simulate transients. The integral action too deteriorates stability. If stability is unsatisfactory, <img class="formulaInl" alt="$K_I$" src="form_184.png"/> must be reduced.</li>
<li>If it is known that the amount of measurement noise (the present version of <code>SIMO</code> does not simulate such noise) necessitates harder lowpass filtering of the position measurements, the cutoff frequency of the filter must be reduced from the value set according to paragraph 1 above. This may then lead to an adjustment of the controller gains as outlined in paragraph 4, until a satisfactory transient motion is obtained for all three motion variables.</li>
</ol>
<p>The above procedure reflects the standard knowledge from control theory that for a feedback system to be stable, the open-loop gain must be less than 1 (0 dB) at the crossover frequency (i.e. the frequency at which the open-loop phase is -180 deg.)</p>
<h3>Kalman filter based controller (IDP = 2)</h3>
<h4>1 identification input line</h4>
<div class="fragment"><div class="line">KALMan FILTer DATA</div>
</div><!-- fragment --><h4>1 input line</h4>
<div class="fragment"><div class="line">ILINE   ISTAT</div>
</div><!-- fragment --><ul>
<li><code>ILINE: integer</code>: Flag for measurement of line tensions to be included in the controller<ul>
<li><code>= 0</code>: No line tension/coupling measurements in the Kalman filter</li>
<li><code>= 1</code>: Line tension/coupling measurements in the Kalman filter</li>
<li><code>= 2</code>: Diagonal stiffness matrix included in the estimator of the Kalman filter</li>
<li><code>= 3</code>: Stiffness matrix included in the estimator of the Kalman filter</li>
<li><code>= 4</code>: Stiffness matrix for anchor system, data table for nonlinear lines, and hawser tension measurements are included in the estimator of the Kalman filter</li>
</ul>
</li>
<li><code>ISTAT: integer</code>: Estimation method flag<ul>
<li><code>= 0</code>: Current estimation, quadratic drag formula used</li>
<li><code>= 1</code>: Bias force estimation, linear drag formula used</li>
</ul>
</li>
</ul>
<h4>1 input line, drag coefficients and nominal velocity.</h4>
<p>The drag coefficients should be as correct as possible compared to the vessel to be positioned, but it is also important that <code>DRAGX</code> is not smaller than <code>DRAGY/4</code>. In such cases DRAGX should be overestimated. The nominal velocity, <code>VTYP</code>, should not be smaller than 0.1 m/s since this will give too high amplification for small current speeds. The drag forces on the vessel estimated by the Kalman filter are linearized with respect to this velocity.</p>
<div class="fragment"><div class="line">DRAGX     DRAGY     DRAGM    VTYP   TSTA</div>
</div><!-- fragment --><ul>
<li><code>DRAGX: real</code>: Longitudinal drag coefficient, <img class="formulaInl" alt="$[FT^2/L^2]$" src="form_144.png"/></li>
<li><code>DRAGY: real</code>: Transverse drag coefficient, <img class="formulaInl" alt="$[FT^2/L^2]$" src="form_144.png"/></li>
<li><code>DRAGM: real</code>: Rotational drag coefficient, <img class="formulaInl" alt="$[FLT^2]$" src="form_188.png"/></li>
<li><code>VTYP: real, default: 0.25</code>: Nominal velocity, <img class="formulaInl" alt="$[L/T]$" src="form_174.png"/></li>
<li><code>TSTA: real</code>: Starting period for HF_estimation, <img class="formulaInl" alt="$[T]$" src="form_70.png"/></li>
</ul>
<h4>1 input line if ILINE = 2. The stiffness matrix is given with the wanted position as reference.</h4>
<div class="fragment"><div class="line">STFLIX STFLIY STFLID</div>
</div><!-- fragment --><ul>
<li><code>STFLIX: real</code>: Linear stiffness in global X-direction (not from DP system), <img class="formulaInl" alt="$[F/L]$" src="form_150.png"/></li>
<li><code>STFLIY: real</code>: Linear stiffness in global Y-direction (not from DP system), <img class="formulaInl" alt="$[F/L]$" src="form_150.png"/></li>
<li><code>STFLID: real</code>: Linear stiffness for global heading (not from DP system), <img class="formulaInl" alt="$[FL]$" src="form_154.png"/></li>
</ul>
<h4>3 input lines if ILINE = 3 or 4. The stiffness matrix is given with the wanted position as reference.</h4>
<div class="fragment"><div class="line">STFLi1 STFLi2 STFLi6</div>
</div><!-- fragment --><ul>
<li><code>STFLij: real</code>: Force in global i-direction due to a unit displacement in the global j-direction (not from DP system) <img class="formulaInl" alt="$[F/L,F,FL]$" src="form_189.png"/></li>
</ul>
<p>Diagonal terms are negative for a common anchoring system.</p>
<ul>
<li>i=1 is the global X-direction</li>
<li>i=2 is the global Y-direction</li>
<li>i=6 is the global heading</li>
</ul>
<p>The rotation stiffness is per rad</p>
<h4>1 input line if ILINE = 4.</h4>
<div class="fragment"><div class="line">NNL</div>
</div><!-- fragment --><ul>
<li><code>NNL: integer</code>: Number of nonlinear lines of which forces are estimated in the Kalman filter</li>
</ul>
<h4>NNL times the following block if ILINE = 4.</h4>
<p>1 input line </p>
<div class="fragment"><div class="line">X0  Y0</div>
</div><!-- fragment --><ul>
<li><code>X0: real</code>: Global X-coord. of the line end point anchored at the sea bed <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>Y0: real</code>: Global Y-coord. of the line end point anchored at the sea bed <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
</ul>
<p>1 input line </p>
<div class="fragment"><div class="line">X1  Y1</div>
</div><!-- fragment --><ul>
<li><code>X1: real</code>: X-coord. of the line end point attached to the vessel (given in the body fixed coord. system) <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>Y1: real</code>: Y-coord. of the line end point attached to the vessel (given in the body fixed coord. system) <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
</ul>
<p>1 input line </p>
<div class="fragment"><div class="line">NLT</div>
</div><!-- fragment --><ul>
<li><code>NLT: integer</code>: Number of data lines in the table describing the tension of the anchored line as a function of the horizontal length.</li>
</ul>
<p><code>NLT</code> input lines (characteristic of the nonlinear line) </p>
<div class="fragment"><div class="line">Li  Ti</div>
</div><!-- fragment --><ul>
<li><code>Li: real</code>: Horizontal length of the nonlinear line <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>Ti: real</code>: Horizontal tension of the nonlinear line for the given length <code>Li</code> <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
</ul>
<h4>1 input line if ILINE = 4.</h4>
<div class="fragment"><div class="line">NH</div>
</div><!-- fragment --><ul>
<li><code>NH: integer</code>: Number of hawsers of which force is measured and used in the Kalman filter estimation model.</li>
</ul>
<h4>NH times the following block if ILINE = 4.</h4>
<p>1 input line </p>
<div class="fragment"><div class="line">HAWID</div>
</div><!-- fragment --><ul>
<li><code>HAWID: character(8)</code>: Name (identifier) of the coupling element modelling the hawser. The coupling element should be a simple wire coupling or a fixed elongation coupling.</li>
</ul>
<p>1 input line </p>
<div class="fragment"><div class="line">WNSTDV SEEDN</div>
</div><!-- fragment --><ul>
<li><code>WNSTDV: real</code>: White noise standard deviation of the measurement system, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>SEEDN: integer, default: 1</code>: Seed number for the realisation of the white noise</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">AMX AMY AMR</div>
</div><!-- fragment --><ul>
<li><code>AMX: real</code>: Total mass in surge to be used in Kalman filter, <img class="formulaInl" alt="$[M]$" src="form_71.png"/></li>
<li><code>AMY: real</code>: Total mass in sway to be used in Kalman filter, <img class="formulaInl" alt="$[M]$" src="form_71.png"/></li>
<li><code>AMR: real</code>: Total inertia to be used in Kalman filter, <img class="formulaInl" alt="$[ML^2]$" src="form_190.png"/></li>
</ul>
<p>Total masses and inertia includes body mass and typical hydrodynamic added mass</p>
<p>The linear controller matrix is defined on the next 3 input lines. The position gains will determine the natural periods in the system. It is possible to use:</p>
<ul>
<li><code>-0.01 AMX &lt;= GMATX1 &lt;= -0.005 AMX</code></li>
<li><code>-0.01 AMY &lt;= GMATY1 &lt;= -0.005 AMY</code></li>
<li><code>-0.01 AMR &lt;= GMATD1 &lt;= -0.005 AMR</code></li>
</ul>
<p>These position feedbacks will give natural periods in the range 90 s to 60 s. The higher feedbacks will give the best abilities to suppress disturbances, while the lower feedbacks will give less modulation of thruster signals.</p>
<p>Theoretically, the best vessel behaviour is obtained by approximately 70 % of critical damping, which is obtained by:</p>
<ul>
<li><img class="formulaInl" alt="$ \mathrm{GMATX2 = - \sqrt{2\: |GMATX1| \times AMX}}$" src="form_191.png"/></li>
<li><img class="formulaInl" alt="$ \mathrm{GMATY2 = - \sqrt{2\: |GMATY1| \times AMY}}$" src="form_192.png"/></li>
<li><img class="formulaInl" alt="$ \mathrm{GMATD2 = - \sqrt{2\: |GMATD1| \times AMR}}$" src="form_193.png"/></li>
</ul>
<p>Alternatively:</p>
<ul>
<li><img class="formulaInl" alt="$ \mathrm{GMATX1} = - \left( \frac{2\pi}{T_x} \right)^2 m_x \quad \quad \quad \mathrm{GMATX2} = -2 \xi_x \mathrm{\sqrt{|GMATX1| \times AMX}}$" src="form_194.png"/></li>
<li><img class="formulaInl" alt="$ \mathrm{GMATY1} = - \left( \frac{2\pi}{T_y} \right)^2 m_y \quad \quad \quad \mathrm{GMATY2} = -2 \xi_y \mathrm{\sqrt{|GMATY1| \times AMY}}$" src="form_195.png"/></li>
<li><img class="formulaInl" alt="$ \mathrm{GMATD1} = - \left( \frac{2\pi}{T_{\psi}} \right)^2 m_{\psi} \quad \quad \quad \mathrm{GMATD2} = -2 \xi_{\psi} \mathrm{\sqrt{|GMATD1| \times AMR}}$" src="form_196.png"/></li>
</ul>
<p>where <img class="formulaInl" alt="$T_x$" src="form_197.png"/>, <img class="formulaInl" alt="$T_y$" src="form_198.png"/> and <img class="formulaInl" alt="$T_{\psi} $" src="form_199.png"/> are the chosen/wanted natural periods for surge, sway and yaw, respectively. The damping factors are given as <img class="formulaInl" alt="$\xi_x$" src="form_200.png"/>, <img class="formulaInl" alt="$\xi_y$" src="form_201.png"/> and <img class="formulaInl" alt="$\xi_{\psi}$" src="form_202.png"/>, <img class="formulaInl" alt="$ _{}$" src="form_203.png"/> and they are typically set to a value of 0.7 which indicates a damping level of 70% of the critical damping.</p>
<p>As the first step in tuning the DP-system, the vessel can be moved to an offset position and released with no environmental forces. The DP-system should then be able to produce a wanted transient motion to the desired position. At this stage of the tuning, the thrusters data <b>TMIMA</b> (minimum time to change from minimum to maximum thrust) should be set to a small value, and <b>ANGH</b> (maximum angular velocity of azimuth thrusters) should be set to a large value. These thruster data should be set to their correct values after initial tuning.</p>
<h4>1 input line</h4>
<div class="fragment"><div class="line">GMATX1 GMATX2</div>
</div><!-- fragment --><ul>
<li><code>GMATX1: real</code>: Longitudinal position gain, <img class="formulaInl" alt="$[F/L]$" src="form_150.png"/></li>
<li><code>GMATX2: real</code>: Longitudinal velocity gain, <img class="formulaInl" alt="$[FT/L]$" src="form_145.png"/></li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">GMATY1 GMATY2</div>
</div><!-- fragment --><ul>
<li><code>GMATY1: real</code>: Transverse position gain, <img class="formulaInl" alt="$[F/L]$" src="form_150.png"/></li>
<li><code>GMATY2: real</code>: Transverse velocity gain, <img class="formulaInl" alt="$[FT/L]$" src="form_145.png"/></li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">GMATD1 GMATD2</div>
</div><!-- fragment --><ul>
<li><code>GMATD1: real</code>: Heading gain, <img class="formulaInl" alt="$[FL]$" src="form_154.png"/></li>
<li><code>GMATD2: real</code>: Heading rate gain, <img class="formulaInl" alt="$[FLT]$" src="form_178.png"/></li>
</ul>
<p>The Kalman filter gain matrix is defined on the next 3 input lines.</p>
<p>Depending on the natural periods of the motions (low frequency) and on the wave frequency motions, cut-off frequencies <img class="formulaInl" alt="$\omega_c$" src="form_204.png"/> for filtering the wave frequency motions are normally chosen. Typically, the cut-off periods for surge, sway and yaw of <img class="formulaInl" alt="$T_c = 2 \pi / \omega_c$" src="form_205.png"/> are given values between 25s and 50s.</p>
<p>Then Kalman filter coefficients (for initial tuning) may be chosen as:</p>
<ul>
<li><img class="formulaInl" alt="$ \mathrm{RKXI} = 2 \xi_x \omega_{c,x} \quad \quad \quad \mathrm{RKX2} = \omega^2_{c,x}$" src="form_206.png"/></li>
<li><img class="formulaInl" alt="$ \mathrm{RKYI} = 2 \xi_y \omega_{c,y} \quad \quad \quad \mathrm{RKY2} = \omega^2_{c,y}$" src="form_207.png"/></li>
<li><img class="formulaInl" alt="$ \mathrm{RKDI} = 2 \xi_{\psi} \omega_{c,\psi} \quad \quad \: \: \: \mathrm{RKD2} = \omega^2_{c,\psi}$" src="form_208.png"/></li>
</ul>
<p>The <img class="formulaInl" alt="$ _{} $" src="form_209.png"/> default values for the various <code>RK3</code>-gains are given as guidelines for the case of current estimation (<code>ISTAT = 0</code>). In the case of bias force estimation (<code>ISTAT = 1</code>), it is recommended to use <code>RKX3 = .00001AMX</code>, <code>RKY3 = .00001AMY</code>. In both cases <code>RKD3 = .00005AMR</code>.</p>
<h4>1 input line</h4>
<div class="fragment"><div class="line">RKX1   RKX2   RKX3   RKX4</div>
</div><!-- fragment --><ul>
<li><code>RKX1: real</code>: Longitudinal LF position gain, <img class="formulaInl" alt="$[1]$" src="form_124.png"/></li>
<li><code>RKX2: real</code>: Longitudinal LF velocity gain, <img class="formulaInl" alt="$[1/T]$" src="form_210.png"/></li>
<li><code>RKX3: real, default: 0.00025</code>: Longitudinal current or bias force gain, <img class="formulaInl" alt="$[1/T]$" src="form_210.png"/> or <img class="formulaInl" alt="$[F/L]$" src="form_150.png"/></li>
<li><code>RKX4: real, default: 0.2</code>: Longitudinal HF position gain, <img class="formulaInl" alt="$[1]$" src="form_124.png"/></li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">RKY1   RKY2   RKY3   RKY4</div>
</div><!-- fragment --><ul>
<li><code>RKY1: real</code>: Transverse LF position gain, <img class="formulaInl" alt="$[1]$" src="form_124.png"/></li>
<li><code>RKY2: real</code>: Transverse LF velocity gain, <img class="formulaInl" alt="$[1/T]$" src="form_210.png"/></li>
<li><code>RKY3: real, default: 0.00025</code>: Transverse current or bias force gain, <img class="formulaInl" alt="$[1/T]$" src="form_210.png"/> or <img class="formulaInl" alt="$[F/L]$" src="form_150.png"/></li>
<li><code>RKY4: real, default: 0.2</code>: Transverse HF position gain, <img class="formulaInl" alt="$[1]$" src="form_124.png"/></li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">RKD1  RKD2  RKD3  RKD4</div>
</div><!-- fragment --><ul>
<li><code>RKD1: real</code>: LF heading gain, <img class="formulaInl" alt="$[1]$" src="form_124.png"/></li>
<li><code>RKD2: real</code>: LF heading rate gain, <img class="formulaInl" alt="$[1/T]$" src="form_210.png"/></li>
<li><code>RKD3: real</code>: Bias moment gain, <img class="formulaInl" alt="$[FL]$" src="form_154.png"/></li>
<li><code>RKD4: real, default: 0.2</code>: HF heading gain, <img class="formulaInl" alt="$[1]$" src="form_124.png"/></li>
</ul>
<p>In a case with zero or negligible wave frequency yaw motion, <code>RKD4</code> should be set to zero.</p>
<h3>External controller function data (IDP = 3)</h3>
<h4>1 identification input line for a user-supplied external dynamic positioning controller</h4>
<div class="fragment"><div class="line">EXTErnal DYNAmic POSItioning</div>
</div><!-- fragment --><h4>1 input line, path and filename of library containing the controller</h4>
<div class="fragment"><div class="line">TXXDP</div>
</div><!-- fragment --><ul>
<li><code>TXXDP: character(120)</code>: Character string giving path and filename</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">NPCUR</div>
</div><!-- fragment --><ul>
<li><code>NPCUR: integer &gt; 0</code>: Number of points where current velocities shall be given to the external DP-system library</li>
</ul>
<h3>MTDP controller (IDP = 4)</h3>
<p>No input data on the system description file for this controller, but the communication settings must be given as described in <a class="el" href="a00022.html#ug_external_specification_mtdp">MTDP communication</a>.</p>
<h3>Velocity PI controller (IDP = 5)</h3>
<h4>1 identification input line, velocity reference from HLA</h4>
<div class="fragment"><div class="line">VELOcity CONTroller DATA</div>
</div><!-- fragment --><h4>1 input line, stiffness coefficients, <img class="formulaInl" alt="$ \mathrm{K_P}$" src="form_211.png"/></h4>
<div class="fragment"><div class="line">RKVELX  RKVELY  RKVELM</div>
</div><!-- fragment --><ul>
<li><code>RKVELX: real</code>: Velocity feedback in surge, <img class="formulaInl" alt="$[FT/L]$" src="form_145.png"/></li>
<li><code>RKVELY: real</code>: Velocity feedback in sway, <img class="formulaInl" alt="$[FT/L]$" src="form_145.png"/></li>
<li><code>RKVELM: real</code>: Velocity feedback in yaw, <img class="formulaInl" alt="$[FTL]$" src="form_212.png"/></li>
</ul>
<h4>1 input line, integral coefficients, <img class="formulaInl" alt="$ \mathrm{K_I}$" src="form_213.png"/></h4>
<div class="fragment"><div class="line">RKINTX  RKINTY  RKINTM</div>
</div><!-- fragment --><ul>
<li><code>RKINTX: real</code>: Integral feedback in surge, <img class="formulaInl" alt="$[F/L]$" src="form_150.png"/></li>
<li><code>RKINTY: real</code>: Integral feedback in sway, <img class="formulaInl" alt="$[F/L]$" src="form_150.png"/></li>
<li><code>RKINTM: real</code>: Integral feedback in yaw, <img class="formulaInl" alt="$[FL]$" src="form_154.png"/></li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">TCWF   ETAWF  TFILTX  TFILTY  TFILTM</div>
</div><!-- fragment --><ul>
<li><code>TCWF: real, default: 10</code>: Centre period of wave filter <img class="formulaInl" alt="$[T]$" src="form_70.png"/></li>
<li><code>ETAWF: real, default: 1</code>: Strength of wave filter, <code>0 &lt;= ETAWF &lt;= 1</code></li>
<li><code>TFILTX: real, default: 2.5</code>: Filter period for surge, <img class="formulaInl" alt="$[T]$" src="form_70.png"/></li>
<li><code>TFILTY: real, default: 2.5</code>: Filter period for sway, <img class="formulaInl" alt="$[T]$" src="form_70.png"/></li>
<li><code>TFILTM: real, default: 2.5</code>: Filter period for yaw, <img class="formulaInl" alt="$[T]$" src="form_70.png"/></li>
</ul>
<h1><a class="anchor" id="ug_body_body_components"></a>
Body components</h1>
<p>This data group enables the user to define body points equipped with specified attributes and equipments. The data group 'Body components' defines two types of connection points for coupling elements:</p>
<ul>
<li>Fixed point at a defined location on the body where an end of a coupling element may be attached</li>
<li>Guide point at a defined location on the body where a coupling element may slide through</li>
</ul>
<p>and a specification of equipment that may be located at the point:</p>
<ul>
<li>Winch</li>
<li>Motion compensator</li>
<li>Tensioner (only to a fixed point)</li>
</ul>
<p>A coupling element may be connectable or disconnectable at a fixed connection point, from HLA.</p>
<h4>1 identification input line.</h4>
<div class="fragment"><div class="line">BODY COMPonents</div>
</div><!-- fragment --><h4>1 identification input line</h4>
<div class="fragment"><div class="line">COUPling POINt</div>
</div><!-- fragment --><h4>Text for description of the coupling point, 2 input lines</h4>
<div class="fragment"><div class="line">TXSYS</div>
</div><!-- fragment --><ul>
<li><code>TXSYS: character(60)</code>: Character string describing the coupling</li>
</ul>
<h4>Coupling point type and location, 1 input line</h4>
<div class="fragment"><div class="line">CHCOPO   CHPPT   XCPL   YCPL   ZCPL</div>
</div><!-- fragment --><ul>
<li><code>CHCOPO: character(32)</code>: Identifier for coupling point.</li>
<li><code>CHPPT: character(4)</code>: Type of coupling point<ul>
<li><code>= FIXEd</code>: Fixed point</li>
<li><code>= GUIDe</code>: Guide point</li>
</ul>
</li>
<li><code>XCPL: real</code>: X-coordinate of coupling point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
<li><code>YCPL: real</code>: Y-coordinate of coupling point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
<li><code>ZCPL: real</code>: Z-coordinate of coupling point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
</ul>
<h2><a class="anchor" id="ug_body_body_components_control"></a>
Control of fixed coupling point</h2>
<p>This data group is optional for a fixed coupling point (<code>CHPPT = FIXED</code>)</p>
<h4>1 identification input line</h4>
<div class="fragment"><div class="line">POINt CONTrol</div>
</div><!-- fragment --><h4>1 input line</h4>
<div class="fragment"><div class="line">NAME-POINT-CONTROL        POINT-CONTROL-TYPE</div>
</div><!-- fragment --><ul>
<li><code>NAME-POINT-CONTROL: character(32)</code>: Name (identifier) of the <code>CONTROL</code></li>
<li><code>POINT-CONTROL-TYPE: character(4)</code>: HLA</li>
</ul>
<h2><a class="anchor" id="ug_body_body_components_connectable"></a>
Connectable fixed coupling point</h2>
<p>This data group is optional for a fixed coupling point (<code>CHPPT = FIXED</code>)</p>
<h4>1 identification input line</h4>
<div class="fragment"><div class="line">HLA CONNectable</div>
</div><!-- fragment --><h4>1 input line</h4>
<div class="fragment"><div class="line">CHHCO</div>
</div><!-- fragment --><ul>
<li><code>CHHCO: character(32)</code>: Identifier for HLA Connectable point</li>
</ul>
<h2><a class="anchor" id="ug_body_body_components_motion"></a>
Motion compensator at fixed coupling point</h2>
<p>This data group defines the motion compensator attached to the coupling point. The data group is optional for a fixed type of coupling point (<code>CHPPT = FIXED</code>)</p>
<h4>1 identification input line</h4>
<div class="fragment"><div class="line">MOTIon COMPensator</div>
</div><!-- fragment --><h4>Type of motion compensator, 1 input line</h4>
<div class="fragment"><div class="line">CMOCO</div>
</div><!-- fragment --><ul>
<li><code>CMOCO: character(4)</code>:<ul>
<li><code>= HC_S</code>: <code>SIMO</code> Heave Compensator</li>
<li><code>= HC_D</code>: DLL Heave Compensator</li>
</ul>
</li>
</ul>
<h3><a class="anchor" id="ug_body_body_components_motion_simo"></a>
SIMO heave compensator</h3>
<p>This data group defines a <code>SIMO</code> built-in heave compensator (<code>CMOCO = HC_S</code>)</p>
<h4>1 input line</h4>
<div class="fragment"><div class="line">ITYPE</div>
</div><!-- fragment --><ul>
<li><code>ITYPE: integer, default: 1</code>: Compensator type:<ul>
<li><code>= 1</code>: Generic model, without detailed model of internal components</li>
</ul>
</li>
</ul>
<h4>If ITYPE = 1, 1 input line</h4>
<div class="fragment"><div class="line">LIMOD   FACTOR   AMPMAX   EHLA</div>
</div><!-- fragment --><ul>
<li><code>LIMOD: integer</code>: Limitation handling mode for the compensator.<ul>
<li><code>= 1</code>: <code>FACTOR</code> active</li>
<li><code>= 2</code>: <code>FACTOR</code> active, amplitude limit <code>AMPMAX</code></li>
<li><code>= 3</code>: Limit <code>AMPMAX</code></li>
</ul>
</li>
<li><code>FACTOR: real &lt;= 1</code>: Reduction factor for compensator action at high sea states</li>
<li><code>AMPMAX: real</code>: Clipping level for crane motion measurement <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>EHLA: integer</code>:<ul>
<li><code>= 0</code>: No export to HLA</li>
<li><code>= 1</code>: Piston position exported to HLA</li>
</ul>
</li>
</ul>
<h4>If ITYPE = 1, 1 input line</h4>
<div class="fragment"><div class="line">NWIRE   NWIREC   STROKE   ACYL</div>
</div><!-- fragment --><ul>
<li><code>NWIRE: integer</code>: Number of wire parts from crane top to hook</li>
<li><code>NWIREC: integer</code>: Number of wire parts around compensator cylinder</li>
<li><code>STROKE: real</code>: Max. range of elongation (stroke length) <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>ACYL: real</code>: Cylinder cross section area <img class="formulaInl" alt="$[L^2]$" src="form_135.png"/></li>
</ul>
<h4>If ITYPE = 1, 1 input line</h4>
<div class="fragment"><div class="line">HCKP  HCTD   HCKF   HCTFD   HCKQ     HCTQ   TF1</div>
</div><!-- fragment --><ul>
<li><code>HCKP: real</code>: Gain factor in feedback</li>
<li><code>HCTD: real</code>: Time derivative in feedback</li>
<li><code>HCKF: real</code>: Gain factor in feedforward</li>
<li><code>HCTFD: real</code>: Time derivative in feedforward</li>
<li><code>HCKQ: real</code>: Characteristics of valve</li>
<li><code>HCTQ: real</code>: Valve time constant</li>
<li><code>TF1: real</code>: Time constant in low-pass filter</li>
</ul>
<h4>If ITYPE = 1 and EHLA=1, 1 input line</h4>
<div class="fragment"><div class="line">HC_HLA</div>
</div><!-- fragment --><ul>
<li><code>HC_HLA: character(120)</code>: HLA name of this HC</li>
</ul>
<h3><a class="anchor" id="ug_body_body_components_motion_dll"></a>
DLL heave compensator</h3>
<p>This data group identifies the dynamic linked library (DLL) within which an external heave compensator is described (<code>CHMOCO = HC_D</code>)</p>
<h4>Name of DLL name, 1 input line</h4>
<div class="fragment"><div class="line">CHCLIB</div>
</div><!-- fragment --><ul>
<li><code>CHCLIB: character(120)</code>: Character string for HC library name, incl. path</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">NPCUR</div>
</div><!-- fragment --><ul>
<li><code>NPCUR: integer &gt; 0</code>: Number of points where current velocities shall be given to the external HC library</li>
</ul>
<h2><a class="anchor" id="ug_body_body_components_tensioner"></a>
Tensioner at fixed coupling point</h2>
<p>This data group defines the passive tensioner attached to the coupling point. The data group is optional for a fixed type of coupling point (<code>CHPPT = FIXED</code>).</p>
<p>An example of the force-displacement characteristic for two pre-set mean forces (blue and green lines) is illustrated in the figure below where also the piston motion range due to wave motion is illustrated by a red arrow.</p>
<div class="image">
<img src="force_disp_passive_tensioner.svg" alt="force_disp_passive_tensioner.svg"/>
<div class="caption">
Force - displacement characteristic of a passive tensioner</div></div>
<h4>1 identification input line</h4>
<div class="fragment"><div class="line">TENSioner</div>
</div><!-- fragment --><h4>1 input line</h4>
<div class="fragment"><div class="line">FTENS  DF_DT  STIFFT  STROKE  IHLA</div>
</div><!-- fragment --><ul>
<li><code>FTENS: real</code>: Pretension in tensioner <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>DF_DT: real</code>: Max. rate of change in pretension <img class="formulaInl" alt="$[F/T]$" src="form_214.png"/></li>
<li><code>STIFFT: real</code>: Stiffness at specified pretension <img class="formulaInl" alt="$[F/L]$" src="form_150.png"/></li>
<li><code>STROKE: real</code>: Max. range of elongation (stroke length) <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>IHLA: integer</code>:<ul>
<li><code>= 0</code>: No control from HLA</li>
<li><code>= 1</code>: <code>FTENS</code> adjustable from HLA</li>
</ul>
</li>
</ul>
<h4>If IHLA=1, one line</h4>
<div class="fragment"><div class="line">CPTHLA</div>
</div><!-- fragment --><ul>
<li><code>CPTHLA: character(120)</code>: HLA name of this tensioner</li>
</ul>
<h2><a class="anchor" id="ug_body_body_components_winch"></a>
Winch at fixed coupling point</h2>
<h4>1 OPTIONAL line if CHPPT = FIXEd</h4>
<div class="fragment"><div class="line">COUPling WINCh</div>
</div><!-- fragment --><h4>If Coupling Winch, 1 input line</h4>
<div class="fragment"><div class="line">CHCOWI  CWICO</div>
</div><!-- fragment --><ul>
<li><code>CHCOWI: character(32)</code>: Identifier for coupling winch</li>
<li><code>CWICO: character(4)</code>: Type of coupling winch control<ul>
<li><code>= NRUN</code>: Predefined running of winch</li>
<li><code>= HLA</code>: HLA-Joystick</li>
<li><code>= EXT</code>: External control using an Generic External Control System</li>
</ul>
</li>
</ul>
<h4>1 input line if COUPling WINCh and CHPPT = FIXEd</h4>
<div class="fragment"><div class="line">WACCM  WVELM  DRUMA  DRUML  NRUN</div>
</div><!-- fragment --><ul>
<li><code>WACCM: real</code>: Max. run acceleration for winch <img class="formulaInl" alt="$[L/TT]$" src="form_173.png"/></li>
<li><code>WVELM: real</code>: Max. run velocity for winch <img class="formulaInl" alt="$[L/T]$" src="form_174.png"/></li>
<li><code>DRUMA: real</code>: Max. wire length that can be added to drum <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>DRUML: real</code>: Initial wire length at drum <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>NRUN: integer</code>: Number of winch run intervals. (Dummy if <code>CWICO = HLA</code>)</li>
</ul>
<p><code>DRUMA</code> and <code>DRUML</code> represent limitation to winch operation.</p>
<h4>NRUN input lines if COUPling WINCh and CHPPT = FIXEd and NRUN &gt; 0</h4>
<div class="fragment"><div class="line">TSTART  TSTOP  RUNVEL</div>
</div><!-- fragment --><ul>
<li><code>TSTART: real</code>: Start time for running winch, <img class="formulaInl" alt="$[T]$" src="form_70.png"/>.</li>
<li><code>TSTOP: real</code>: Stop time for running winch, <img class="formulaInl" alt="$[T]$" src="form_70.png"/>.</li>
<li><code>RUNVEL: real</code>: Winch run velocity (positive when paying out), <img class="formulaInl" alt="$[L/T]$" src="form_174.png"/>.</li>
</ul>
<h2><a class="anchor" id="ug_body_body_components_guide"></a>
Guide point</h2>
<h4>1 input line if CHPPT = GUIDe</h4>
<div class="fragment"><div class="line">DGUID  DV1  DV2  DV3</div>
</div><!-- fragment --><ul>
<li><code>DGUID: real</code>: Diameter of guide hole</li>
<li><code>DV1: real</code>: X-comp. of vector normal to hole in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
<li><code>DV2: real</code>: Y-comp. of vector normal to hole in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
<li><code>DV3: real</code>: Z-comp. of vector normal to hole in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
</ul>
<h1><a class="anchor" id="ug_body_generic"></a>
Generic External Control System</h1>
<p>This data group enables the user to define a connection between <code>SIMO</code> and an external Java control system. The control system takes <em>measurements</em> i.e. values from chosen components of the model and returns <em>feedback</em> from the control system to specified <code>SIMO</code> components.</p>
<p>The following measurement component <code>TYPEs</code> are currently supported:</p>
<ul>
<li><code>BODY</code></li>
<li><code>COUPLING</code></li>
</ul>
<p>The following feedback component <code>TYPEs</code> are currently supported:</p>
<ul>
<li><code>WINCH</code></li>
</ul>
<p>For additional information on how to develop a control system for use in <code>SIMO</code>, see <a class="el" href="a00022.html#ug_external_specification_user_java">User-supplied Java code</a>.</p>
<p>For each body there may be defined several external control systems. They are numbered according to the location on the system description file.</p>
<h4>1 identification input line.</h4>
<div class="fragment"><div class="line">GENEric EXTErnal CONTrol system</div>
</div><!-- fragment --><h4>1 input line.</h4>
<div class="fragment"><div class="line">GECID</div>
</div><!-- fragment --><ul>
<li><code>GECID: character</code>: External control system identifier, must be unique</li>
</ul>
<h4>Text for describing external forces, 2 input lines.</h4>
<div class="fragment"><div class="line">TXEXT</div>
</div><!-- fragment --><ul>
<li><code>TXEXT: character</code>: Text describing external control system</li>
</ul>
<h4>External control system specification, 2 input lines</h4>
<div class="fragment"><div class="line">JARNAME CLASSNAME</div>
</div><!-- fragment --><ul>
<li><code>JARNAME: character</code>: Filename of jar-file with control system class</li>
<li><code>CLASSNAME: character</code>: Name of class in jar-file with control system</li>
</ul>
<h4>Main parameters, 1 input line</h4>
<div class="fragment"><div class="line">NFEED NMEAS NINT NREA  NSTR</div>
</div><!-- fragment --><ul>
<li><code>NFEED: integer, default: 0</code>: Number of feedback entities</li>
<li><code>NMEAS: integer, default: 0</code>: Number of measurement entities</li>
<li><code>NINTS: integer, default: 0</code>: Number of integer input parameters</li>
<li><code>NREAS: integer, default: 0</code>: Number of real input parameters</li>
<li><code>NSTRS: integer, default: 0</code>: Number of input strings</li>
</ul>
<h4>Entities to be controlled, NFEED input lines</h4>
<div class="fragment"><div class="line">TYPEn CTRIDn</div>
</div><!-- fragment --><ul>
<li><code>TYPEn: character</code>: Feedback entity type</li>
<li><code>CTRIDn: character</code>: Feedback entity id</li>
</ul>
<h4>Measurements specifications, NMEAS input lines</h4>
<div class="fragment"><div class="line">TYPEn MEASDn</div>
</div><!-- fragment --><ul>
<li><code>TYPEn: character</code>: Measurement entity type</li>
<li><code>MEASn: character</code>: Measurement entity id</li>
</ul>
<h4>Integer parameters, NINT pairs of input lines</h4>
<div class="fragment"><div class="line">CHIDINTn</div>
</div><!-- fragment --><ul>
<li><code>IDINTn: character</code>: String identifier for integer parameter no n</li>
</ul>
<div class="fragment"><div class="line">INTn</div>
</div><!-- fragment --><ul>
<li><code>INTn: integer</code>: Integer parameter no n</li>
</ul>
<h4>Real parameters, NREA pairs of input lines</h4>
<div class="fragment"><div class="line">CHIDREAn</div>
</div><!-- fragment --><ul>
<li><code>IDREAn: character</code>: String identifier for real parameter no n</li>
</ul>
<div class="fragment"><div class="line">REAn</div>
</div><!-- fragment --><ul>
<li><code>REAn: real</code>: Real parameter no n</li>
</ul>
<h4>String parameters, NSTR pairs of input lines</h4>
<div class="fragment"><div class="line">CHIDSTRn</div>
</div><!-- fragment --><ul>
<li><code>IDSTRn: character</code>: String identifier for string parameter no n</li>
</ul>
<div class="fragment"><div class="line">TXSTRn</div>
</div><!-- fragment --><ul>
<li><code>TXSTRn: character</code>: String no n </li>
</ul>
</div></div><!-- contents -->
	</body>
</html>