<?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">Coupling Specification </div>  </div>
</div><!--header-->
<div class="contents">
<div class="toc"><h3>Table of Contents</h3>
<ul><li class="level1"><a href="#ug_coupling_simple">Simple wire coupling</a></li>
<li class="level1"><a href="#ug_coupling_multiple">Multiple wire coupling</a></li>
<li class="level1"><a href="#ug_coupling_lift">Lift line coupling</a></li>
<li class="level1"><a href="#ug_coupling_force">Force-elongation with fixed attack points</a></li>
<li class="level1"><a href="#ug_coupling_docking">Docking cone coupling</a></li>
<li class="level1"><a href="#ug_coupling_fender">Fender coupling</a></li>
<li class="level1"><a href="#ug_coupling_bumper">Bumper element coupling</a></li>
<li class="level1"><a href="#ug_coupling_ratchet">Ratchet coupling</a></li>
<li class="level1"><a href="#ug_coupling_moment">Moment coupling</a></li>
<li class="level1"><a href="#ug_coupling_external">External coupling function data</a></li>
</ul>
</div>
<div class="textblock"><h4>1 input line</h4>
<div class="fragment"><div class="line">COUPling DATA</div>
</div><!-- fragment --><h4>1 input line</h4>
<div class="fragment"><div class="line">CHCPL</div>
</div><!-- fragment --><ul>
<li><code>CHCPL: character(8)</code>: Coupling identifier</li>
</ul>
<h4>Text for describing the coupling system, 2 input lines.</h4>
<div class="fragment"><div class="line">TXCPL</div>
</div><!-- fragment --><ul>
<li><code>TXCPL: character(60)</code>: Character string describing the coupling</li>
</ul>
<p>The data group in the four previous input lines must be followed by a specification of one of the following coupling models. This means that in the case of several or multiple couplings, the previous data group has to be repeated.</p>
<h1><a class="anchor" id="ug_coupling_simple"></a>
Simple wire coupling</h1>
<h4>1 identifying input line</h4>
<div class="fragment"><div class="line">SIMPle WIRE COUPling</div>
</div><!-- fragment --><h4>Connection point 1 - Alternative 1: 1 input line</h4>
<div class="fragment"><div class="line">CHBDY1   XBDY1   YBDY1   ZBDY1</div>
</div><!-- fragment --><ul>
<li><code>CHBDY1: character(8)</code>: Identifier for body 1</li>
<li><code>XBDY1: real</code>: X-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
<li><code>YBDY1: real</code>: Y-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
<li><code>ZBDY1: real</code>: Z-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
</ul>
<h4>Connection point 1 - Alternative 2: 1 input line</h4>
<div class="fragment"><div class="line">CPL_NAME1</div>
</div><!-- fragment --><ul>
<li><code>CPL_NAME1: character(32)</code>: Name (identifier) of coupling point in end 1</li>
</ul>
<p><code>CPL_NAME1</code> must have been defined as a coupling point in data group <code>"COUPling POINt"</code>.</p>
<p><code>CPL_NAME1</code> must be identical to identifier <code>CHCOPO</code>.</p>
<h4>Connection point 2 - Alternative 1: 1 input line</h4>
<div class="fragment"><div class="line">CHBDY2   XBDY2   YBDY2   ZBDY2</div>
</div><!-- fragment --><ul>
<li><code>CHBDY2: character(8)</code>: Identifier for body 2</li>
<li><code>XBDY2: real</code>: X-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
<li><code>YBDY2: real</code>: Y-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
<li><code>ZBDY2: real</code>: Z-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
</ul>
<h4>Connection point 2 - Alternative 2: 1 input line</h4>
<div class="fragment"><div class="line">CPL_NAME2</div>
</div><!-- fragment --><ul>
<li><code>CPL_NAME2: character(32)</code>: Name (identifier) of coupling point in end 2</li>
</ul>
<p><code>CPL_NAME2</code> must have been defined as a coupling point in data group <code>"COUPling POINt"</code>.</p>
<p><code>CPL_NAME2</code> must be identical to identifier <code>CHCOPO</code>. <code>CPL_NAME2</code> must be different from <code>CPL_NAME1</code>.</p>
<h4>1 input line if guide points are wanted ( NGUIDE &gt; 0 )</h4>
<div class="fragment"><div class="line">NGUIDE</div>
</div><!-- fragment --><ul>
<li><code>NGUIDE: integer</code>: Number of guide points<ul>
<li><code>= 0</code> if no guide points are specified</li>
</ul>
</li>
</ul>
<h4>NGUIDE input lines</h4>
<div class="fragment"><div class="line">CHGUPO  IACTIVE</div>
</div><!-- fragment --><ul>
<li><code>CHGUPO: character(32)</code>: Identifier for guide point</li>
<li><code>IACTIVE: integer, default: 1</code>:<ul>
<li><code>= 0</code>: Guide point not entered on line</li>
<li><code>= 1</code>: Coupling point entered on line</li>
</ul>
</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">EA   RLEN   FLEXC   DAMPSW    IREST   EHLA   HLACON1   HLACON2</div>
</div><!-- fragment --><ul>
<li><code>EA: real</code>: Wire cross section stiffness, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>RLEN: real</code>: Initial, unstretched wire length, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>FLEXC: real, default: 0</code>: Connection flexibility, <img class="formulaInl" alt="$[L/F]$" src="form_234.png"/></li>
<li><code>DAMPSW: real, default: 0</code>: Material damping <img class="formulaInl" alt="$[FT]$" src="form_235.png"/>. <img class="formulaInl" alt="$ \mathrm{Force = dampsw * (\Delta L / \Delta t)/L}$" src="form_236.png"/></li>
<li><code>IREST: integer, default: 0</code>: Flag for “Restoring Coupling”, only used in <code>STAMOD</code></li>
<li><code>EHLA: integer, default: 0</code>: HLA export flag for simplified wire,<ul>
<li><code>= 0</code>: No export</li>
<li><code>= 1</code>: HLA Export</li>
</ul>
</li>
<li><code>HLACON1: integer, default: 0</code>: HLA control flag for connection of line end 1<ul>
<li><code>= 0</code>: not HLA connectable</li>
<li><code>= 1</code>: HLA connectable</li>
</ul>
</li>
<li><code>HLACON2: integer, default: 0</code>: HLA control flag for connection of line end 2,<ul>
<li><code>= 0</code>: not HLA connectable</li>
<li><code>= 1</code>: HLA connectable</li>
</ul>
</li>
</ul>
<p><code>FLEXC</code> (inverse of stiffness) is the flexibility in the wire attachment point. This flexibility should account both for flexibility in the construction and elasticity in the wire between the winch and the used wire attachment point.</p>
<p><code>DAMPSW</code> is specified material damping in the line. The value can normally be set to 1-2% of E * A, where E is the modulus of elasticity and A is the cross-sectional area.</p>
<h4>If EHLA = 1, 1 input line, HLA name of simple wire object,</h4>
<div class="fragment"><div class="line">CHCHLA</div>
</div><!-- fragment --><ul>
<li><code>CHCHLA: character(120)</code>: Character string describing HLA coupling object name</li>
</ul>
<h4>If HLACON1 = 1, 1 input line, HLA name of connectable line end 1</h4>
<div class="fragment"><div class="line">CHCON1</div>
</div><!-- fragment --><ul>
<li><code>CHCON1: character(120)</code>: Character string describing HLA connectable line end 1</li>
</ul>
<h4>If HLACON2 = 1, 1 input line, HLA name of connectable line end 2</h4>
<div class="fragment"><div class="line">CHCON2</div>
</div><!-- fragment --><ul>
<li><code>CHCON2: character(120)</code>: Character string describing HLA connectable line end 2</li>
</ul>
<h4>Element failure, 1 input line</h4>
<div class="fragment"><div class="line">IFMOCO FTIME BTENS</div>
</div><!-- fragment --><ul>
<li><code>IFMOCO: integer</code>: Failure mode of coupling element<ul>
<li><code>= 0</code>: no failure</li>
<li><code>= 1</code>: failure by exceedance of <code>BTENS</code> after specified time<ul>
<li>The coupling element breaks when both <code>FTIME</code> and <code>BTENS</code> are exceeded</li>
</ul>
</li>
<li><code>= 2</code>: failure activated after specified time if Tens <code>&lt; BTENS</code></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>
<h1><a class="anchor" id="ug_coupling_multiple"></a>
Multiple wire coupling</h1>
<p>Multiple wire couplings makes it possible to model several wire segments connected in a common branch point, for example a crane wire with a sling arrangement, connected in the hook.</p>
<p>Each of the wire segments must be separately specified by <code>COUPling DATA</code> and <code>MULTiple WIRE COUPling</code> data groups, e.g. each segment is treated as a separate coupling. Typically 2-4 segments are attached to one body (lifted object), and 1 segment to another body (crane vessel).</p>
<h4>1 identifying input line</h4>
<div class="fragment"><div class="line">MULTiple WIRE COUPling</div>
</div><!-- fragment --><h4>Connection points - Alternative 1: 1 input line</h4>
<div class="fragment"><div class="line">CHBRAN   CHBDY   XBDY   YBDY   ZBDY</div>
</div><!-- fragment --><ul>
<li><code>CHBRAN: character(8)</code>: Identifier for branch point.</li>
<li><code>CHBDY: character(8)</code>: Identifier for body.</li>
<li><code>XBDY: real</code>: X-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
<li><code>YBDY: real</code>: Y-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
<li><code>ZBDY: real</code>: Z-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
</ul>
<h4>Connection points - Alternative 2: 1 input line</h4>
<div class="fragment"><div class="line">CHBRAN   CPL_NAME2</div>
</div><!-- fragment --><ul>
<li><code>CHBRAN: character(8)</code>: Identifier for branch point.</li>
<li><code>CPL_NAME2: character(32)</code>: Name (identifier) of coupling point in end 2</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">EA   RLEN   FLEXC   DAMPSW    IREST   EHLA</div>
</div><!-- fragment --><ul>
<li><code>EA: real</code>: Wire cross section stiffness, <img class="formulaInl" alt="$[F]$" src="form_148.png"/>.</li>
<li><code>RLEN: real</code>: Initial, unstretched wire length, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
<li><code>FLEXC: real, default: 0</code>: Connection flexibility, <img class="formulaInl" alt="$[L/F]$" src="form_234.png"/>.</li>
<li><code>DAMPSW: real, default: 0</code>: Material damping <img class="formulaInl" alt="$[FT]$" src="form_235.png"/>. <img class="formulaInl" alt="$ \mathrm{Force = dampsw * (\Delta L / \Delta t)/L}$" src="form_236.png"/></li>
<li><code>IREST: integer, default: 0</code>: Flag for “Restoring Coupling”, only used in <code>STAMOD</code></li>
<li><code>EHLA: integer, default: 0</code>: HLA export flag for multiple wire element<ul>
<li><code>= 0</code>: No export</li>
<li><code>= 1</code>: HLA export</li>
</ul>
</li>
</ul>
<p><code>FLEXC</code> (inverse of stiffness) is the flexibility in the wire attachment point. This flexibility should account both for flexibility in the construction and elasticity in the wire between the winch and the used wire attachment point.</p>
<p><code>DAMPSW</code> is specified material damping in the line. The value can normally be set to 1-2% of E*A, where E is the modulus of elasticity and A is the cross-sectional area.</p>
<h4>If EHLA = 1, 1 input line, HLA name of multiple wire object,</h4>
<div class="fragment"><div class="line">CHCHLA</div>
</div><!-- fragment --><ul>
<li><code>CHCHLA: character(120)</code>: Character string describing HLA coupling object name</li>
</ul>
<h4>Element failure, 1 input line</h4>
<div class="fragment"><div class="line">IFMOCO FTIME BTENS</div>
</div><!-- fragment --><ul>
<li><code>IFMOCO: integer</code>: Failure mode of coupling element<ul>
<li><code>= 0</code>: no failure</li>
<li><code>= 1</code>: failure by exceedance of <code>BTENS</code> 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 coupling element breaks when both <code>FTIME</code> and <code>BTENS</code> are exceeded</p>
<h1><a class="anchor" id="ug_coupling_lift"></a>
Lift line coupling</h1>
<p>The lift line coupling is a single line model, which includes in a simplified way the following features:</p>
<ul>
<li>drag forces on the line</li>
<li>static line weight</li>
<li>longitudinal inertia forces due to vertical acceleration at both ends.</li>
</ul>
<p>The model assumes that the line is straight.</p>
<h4>1 identifying input line</h4>
<div class="fragment"><div class="line">LIFT LINE COUPling</div>
</div><!-- fragment --><h4>Connection point end 1 - Alternative 1: 1 input line</h4>
<div class="fragment"><div class="line">CHBDY1   XBDY1   YBDY1   ZBDY1</div>
</div><!-- fragment --><ul>
<li><code>CHBDY1: character(8)</code>: Identifier for body 1</li>
<li><code>XBDY1: real</code>: X-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
<li><code>YBDY1: real</code>: Y-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
<li><code>ZBDY1: real</code>: Z-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
</ul>
<h4>Connection point end 1 - Alternative 2: 1 input line</h4>
<div class="fragment"><div class="line">CPL_NAME1</div>
</div><!-- fragment --><ul>
<li><code>CPL_NAME1: character(32)</code>: Name (identifier) of coupling point in end 1</li>
</ul>
<p><code>CPL_NAME1</code> must have been defined as a coupling point in data group <code>"COUPling POINt"</code>.</p>
<p><code>CPL_NAME1</code> must be identical to identifier <code>CHCOPO</code></p>
<h4>Connection point end 2 - Alternative 1: 1 input line</h4>
<div class="fragment"><div class="line">CHBDY2   XBDY2   YBDY2   ZBDY2</div>
</div><!-- fragment --><ul>
<li><code>CHBDY2: character(8)</code>: Identifier for body 2</li>
<li><code>XBDY2: real</code>: X-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
<li><code>YBDY2: real</code>: Y-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
<li><code>ZBDY2: real</code>: Z-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
</ul>
<h4>Connection point end 2 - Alternative 2: 1 input line</h4>
<div class="fragment"><div class="line">CPL_NAME2</div>
</div><!-- fragment --><ul>
<li><code>CPL_NAME2: character(32)</code>: Name (identifier) of coupling point in end 2</li>
</ul>
<p><code>CPL_NAME2</code> must have been defined as a coupling point in data group <code>"COUPling POINt"</code>.</p>
<p><code>CPL_NAME2</code> must be identical to identifier <code>CHCOPO</code>. <code>CPL_NAME2</code> must be different from <code>CPL_NAME1</code>.</p>
<h4>1 input line</h4>
<div class="fragment"><div class="line">NEL  IACC  EHLA  HLACON1  HLACON2</div>
</div><!-- fragment --><ul>
<li><code>NEL: integer</code>: Number of elements in the line</li>
<li><code>IACC: integer, default: 0</code>: Flag for including acceleration of the line<ul>
<li><code>= 0</code>: No acceleration of the line included</li>
<li><code>= 1</code>: Acceleration of the line included in the force calculations</li>
</ul>
</li>
<li><code>EHLA: integer, default: 0</code>: HLA export flag for lift line,<ul>
<li><code>= 0</code>: No export</li>
<li><code>= 1</code>: HLA Export</li>
</ul>
</li>
<li><code>HLACON1: integer, default: 0</code>: HLA control flag for connection of line end 1<ul>
<li><code>= 0</code>: not HLA connectable</li>
<li><code>= 1</code>: HLA connectable</li>
</ul>
</li>
<li><code>HLACON2: integer, default: 0</code>: HLA control flag for connection of line end 2<ul>
<li><code>= 0</code>: not HLA connectable</li>
<li><code>= 1</code>: HLA connectable</li>
</ul>
</li>
</ul>
<p>The model for including line acceleration in the line force calculations is simplified, assuming linear variation of acceleration along the length.</p>
<h4>If EHLA = 1, 1 input line, HLA name of lift line object</h4>
<div class="fragment"><div class="line">CHCHLA</div>
</div><!-- fragment --><ul>
<li><code>CHCHLA: character(120)</code>: Character string describing HLA coupling object name</li>
</ul>
<h4>If HLACON1 = 1, 1 input line, HLA name of connectable line end 1</h4>
<div class="fragment"><div class="line">CHCON1</div>
</div><!-- fragment --><ul>
<li><code>CHCON1: character(120)</code>: Character string describing HLA connectable line end 1</li>
</ul>
<h4>If HLACON2 = 1, 1 input line, HLA name of connectable line end 2</h4>
<div class="fragment"><div class="line">CHCON2</div>
</div><!-- fragment --><ul>
<li><code>CHCON2: character(120)</code>: Character string describing HLA connectable line end 2</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">DIA   EMOD   EMFACT   RLEN   FLEXC   DAMPSW</div>
</div><!-- fragment --><ul>
<li><code>DIA: real</code>: Segment diameter, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>EMOD: real</code>: Modulus of elasticity <img class="formulaInl" alt="$[F/L^2]$" src="form_230.png"/></li>
<li><code>EMFAC: real</code>: Factor of elasticity<ul>
<li><code>= 2</code>: For chains</li>
<li><code>= 1</code>: For other segment types</li>
</ul>
</li>
<li><code>RLEN: real</code>: Initial, unstretched line length, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>FLEXC: real, default: 0</code>: Connection flexibility, <img class="formulaInl" alt="$[L/F]$" src="form_234.png"/></li>
<li><code>DAMPSW: real, default: 0</code>: Material damping <img class="formulaInl" alt="$[FT]$" src="form_235.png"/>. <img class="formulaInl" alt="$ \mathrm{Force = DAMPSW * (\Delta L / \Delta t)/L}$" src="form_237.png"/></li>
</ul>
<p>Total stiffness, <img class="formulaInl" alt="$ \mathrm{EA = EMOD \times EMFAC \times DIA^2 \times \pi /4}$" src="form_238.png"/></p>
<p><code>FLEXC</code> (inverse of stiffness) is the flexibility in the wire attachment point. This flexibility should account both for flexibility in the construction and elasticity in the wire between the winch and the used wire attachment point.</p>
<p><code>DAMPSW</code> is material damping in the line. The value can normally be set to 1-2% of E*A, where E is the modulus of elasticity and A is the cross-sectional area.</p>
<h4>1 input line</h4>
<div class="fragment"><div class="line">UWIA   WATFAC   CDN   CDL</div>
</div><!-- fragment --><ul>
<li><code>UWIA: real</code>: Unit weight in air, <img class="formulaInl" alt="$[F/L]$" src="form_150.png"/></li>
<li><code>WATFAC: real</code>: The ratio of weight in water to weight in air.<ul>
<li>Normally 0.81 for wire and 0.87 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>
<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>
<h4>Element failure, 1 input line</h4>
<div class="fragment"><div class="line">IFMOCO FTIME BTENS</div>
</div><!-- fragment --><ul>
<li><code>IFMOCO: integer</code>: Failure mode of coupling element<ul>
<li><code>= 0</code>: no failure</li>
<li><code>= 1</code>: failure by exceedance of <code>BTENS</code> after specified time<ul>
<li>The coupling element breaks when both <code>FTIME</code> and <code>BTENS</code> are exceeded</li>
</ul>
</li>
<li><code>= 2</code>: failure activated after specified time if Tens <code>&lt; BTENS</code></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><b>Note!</b> The coupling element breaks when both <code>FTIME</code> and <code>BTENS</code> are exceeded.</p>
<h1><a class="anchor" id="ug_coupling_force"></a>
Force-elongation with fixed attack points</h1>
<h4>1 identifying input line</h4>
<div class="fragment"><div class="line">FIXEd ELONgation COUPling</div>
</div><!-- fragment --><h4>Connection point 1 - Alternative 1: 1 input line</h4>
<div class="fragment"><div class="line">CHBDY1   XBDY1   YBDY1   ZBDY1</div>
</div><!-- fragment --><ul>
<li><code>CHBDY1: character(8)</code>: Identifier for body 1</li>
<li><code>XBDY1: real</code>: X-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
<li><code>YBDY1: real</code>: Y-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
<li><code>ZBDY1: real</code>: Z-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
</ul>
<h4>Connection point 1 - Alternative 2: 1 input line</h4>
<div class="fragment"><div class="line">CPL_NAME1</div>
</div><!-- fragment --><ul>
<li><code>CPL_NAME1: character(32)</code>: Name (identifier) of coupling point in end 1</li>
</ul>
<p><code>CPL_NAME1</code> must have been defined as a coupling point in data group <code>"COUPling POINt"</code>.</p>
<p><code>CPL_NAME1</code> must be identical to identifier <code>CHCOPO</code>.</p>
<h4>Connection point 2 - Alternative 1: 1 input line</h4>
<div class="fragment"><div class="line">CHBDY2   XBDY2   YBDY2   ZBDY2</div>
</div><!-- fragment --><ul>
<li><code>CHBDY2: character(8)</code>: Identifier for body 2</li>
<li><code>XBDY2: real</code>: X-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
<li><code>YBDY2: real</code>: Y-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
<li><code>ZBDY2: real</code>: Z-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
</ul>
<h4>Connection point 2 - Alternative 2: 1 input line</h4>
<div class="fragment"><div class="line">CPL_NAME2</div>
</div><!-- fragment --><ul>
<li><code>CPL_NAME2: character(32)</code>: Name (identifier) of coupling point in end 2</li>
</ul>
<p><code>CPL_NAME2</code> must have been defined as a coupling point in data group <code>"COUPling POINt"</code>.</p>
<p><code>CPL_NAME2</code> must be identical to identifier <code>CHCOPO</code>. <code>CPL_NAME2</code> must be different from <code>CPL_NAME1</code>.</p>
<h4>1 input line</h4>
<div class="fragment"><div class="line">NPT  IMETH  EXP  INTPOC  VEMIC  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 coupling element<ul>
<li><code>= 3</code>: Spring, coordinates of both end points are given</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 velocity in damping term</li>
<li><code>INTPOC: 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>VEMIC: real, default: 0</code>: Velocity limit for friction force (EXP = 0) See below.</li>
<li><code>EHLA: integer, default: 0</code>: HLA export flag for coupling element<ul>
<li><code>= 0</code>: No export</li>
<li><code>= 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 the value <code>EXPD=1</code> is used when Abs(vel.)<code>&lt;VEMIN</code> and <code>EXPD&lt;1</code>.</p>
<p>The damping force (<code>EXP=1</code>) for Vel<code>=VEMIC</code> is equal to Damping force (<code>EXP=</code>as given).</p>
<h4>If EHLA = 1, 1 input line, HLA name of force-elongation object,</h4>
<div class="fragment"><div class="line">CHCHLA</div>
</div><!-- fragment --><ul>
<li><code>CHCHLA: character(120)</code>: Character string describing HLA coupling object name</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 attraction of the bodies, <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 are to specified in increasing order and can not be negative.</p>
<h4>Element failure, 1 input line (Shall be given for all values of IMETH)</h4>
<div class="fragment"><div class="line">IFMOCO FTIME BTENS</div>
</div><!-- fragment --><ul>
<li><code>IFMOCO: integer</code>: Failure mode of coupling element<ul>
<li><code>= 0</code>: No failure</li>
<li><code>= 1</code>: Failure by exceeding the tension after specified time.</li>
<li><code>= 2</code>: Activated after specified time if Tens <code>&lt; BTENS</code></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><b>Note!</b> The coupling element breaks when both <code>FTIME</code> and <code>BTENS</code> are exceeded</p>
<h1><a class="anchor" id="ug_coupling_docking"></a>
Docking cone coupling</h1>
<h4>1 identifying input line</h4>
<div class="fragment"><div class="line">DOCKing CONE COUPling</div>
</div><!-- fragment --><h4>Connection point 1 - Alternative 1: 1 input line</h4>
<div class="fragment"><div class="line">CHBDY1   XBDY1   YBDY1   ZBDY1</div>
</div><!-- fragment --><ul>
<li><code>CHBDY1: character(8)</code>: Identifier for body 1</li>
<li><code>XBDY1: real</code>: X-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
<li><code>YBDY1: real</code>: Y-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
<li><code>ZBDY1: real</code>: Z-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
</ul>
<h4>Connection point 1 - Alternative 2: 1 input line</h4>
<div class="fragment"><div class="line">CPL_NAME1</div>
</div><!-- fragment --><ul>
<li><code>CPL_NAME1: character(32)</code>: Name (identifier) of coupling point in end 1</li>
</ul>
<p><code>CPL_NAME1</code> must have been defined as a coupling point in data group <code>"COUPling POINt"</code>.</p>
<p><code>CPL_NAME1</code> must be identical to identifier <code>CHCOPO</code>.</p>
<h4>Connection point 2 - Alternative 1: 1 input line</h4>
<div class="fragment"><div class="line">CHBDY2   XBDY2   YBDY2   ZBDY2</div>
</div><!-- fragment --><ul>
<li><code>CHBDY2: character(8)</code>: Identifier for body 2 (Body with cone)</li>
<li><code>XBDY2: real</code>: X-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
<li><code>YBDY2: real</code>: Y-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
<li><code>ZBDY2: real</code>: Z-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
</ul>
<h4>Connection point 2 - Alternative 2: 1 input line</h4>
<div class="fragment"><div class="line">CPL_NAME2</div>
</div><!-- fragment --><ul>
<li><code>CPL_NAME2: character(32)</code>: Name (identifier) of coupling point in end 2</li>
</ul>
<p><code>CPL_NAME2</code> must have been defined as a coupling point in data group <code>"COUPling POINt"</code>.</p>
<p><code>CPL_NAME2</code> must be identical to identifier <code>CHCOPO</code>. <code>CPL_NAME2</code> must be different from <code>CPL_NAME1</code></p>
<h4>1 input line</h4>
<div class="fragment"><div class="line">NPT  EXP  INTPOC  VEMIC  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 velocity in damping term,</li>
<li><code>INTPOC: 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>VEMIC: 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 coupling element<ul>
<li><code>= 0</code>: No export</li>
<li><code>= 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 the value <code>EXPD=1</code> is used when Abs(vel.)<code>&lt;VEMIN</code> and <code>EXPD&lt;1</code>.</p>
<p>The damping force (<code>EXP=1</code>) for Vel<code>=VEMIC</code> is equal to Damping force (<code>EXP=</code>as given).</p>
<h4>For EHLA = 1, 1 input line</h4>
<div class="fragment"><div class="line">CHCHLA</div>
</div><!-- fragment --><ul>
<li><code>CHCHLA: character(120)</code>: Character string describing HLA coupling 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</code>: Friction coefficient for sliding along the cone or cylinder surface</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>Direction vectors of guide axis are defined in local coordinate system of body 2 (direction from end of cylinder and inwards). They 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 values signify attraction of the bodies, <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_239.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">IFMOCO FTIME BTENS</div>
</div><!-- fragment --><ul>
<li><code>IFMOCO: integer</code>: Failure mode of coupling element<ul>
<li><code>= 0</code>: No failure</li>
<li><code>= 1</code>: Failure by exceeding the tension after specified time.</li>
<li><code>= 2</code>: Activated after specified time if Tens <code>&lt; BTENS</code></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><b>Note!</b> The coupling element breaks when both <code>FTIME</code> and <code>BTENS</code> are exceeded</p>
<h1><a class="anchor" id="ug_coupling_fender"></a>
Fender coupling</h1>
<h4>1 identifying line</h4>
<div class="fragment"><div class="line">FENDer COUPling</div>
</div><!-- fragment --><h4>1 input line</h4>
<div class="fragment"><div class="line">NPT   IFRIC   DYNFRIC   STAFRIC   STIFFRIC    EXP   INTPO   VEMIN  EHLA</div>
</div><!-- fragment --><ul>
<li><code>NPT: integer</code>: Number of points in characteristics</li>
<li><code>IFRIC: integer</code>: Fender model<ul>
<li><code>= 1</code>: Fender point</li>
<li><code>= 2</code>: Fender roller (zero friction in one direction)</li>
</ul>
</li>
<li><code>DYNFRIC: real</code>: Dynamic 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</li>
<li><code>INTPO: integer</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>= 0</code>: No export</li>
<li><code>= 1</code>: HLA export</li>
</ul>
</li>
</ul>
<p>A fender roller is modeled as a point with zero friction in one specified direction. A spherical fender is a sphere with given diameter and omni-directional friction.</p>
<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> will be used when Abs(vel.)<code>&lt;VEMIN</code> and <code>EXP&lt;1</code>.</p>
<h4>If EHLA = 1, 1 input line,HLA name of fender object,</h4>
<div class="fragment"><div class="line">CHCHLA</div>
</div><!-- fragment --><ul>
<li><code>CHCHLA: character(120)</code>: Character string describing HLA coupling object name</li>
</ul>
<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>Attachment point on body 1 in local body 1 coordinates (fender point), 1 input line.</h4>
<div class="fragment"><div class="line">CHBDY1    XF   YF   ZF</div>
</div><!-- fragment --><ul>
<li><code>CHBDY1: character(8)</code>: Identificator of body 1</li>
<li><code>XF: real</code>: X-coordinate of fender point, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>YF: real</code>: Y-coordinate of fender point, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>ZF: real</code>: Z-coordinate of fender point, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
</ul>
<h4>Definition of fender plane and roller axis in Local body 2 coordinates, 1 input line.</h4>
<div class="fragment"><div class="line">CHBDY2   XP  YP   ZP   XN   YN   ZN   XA   YA   ZA</div>
</div><!-- fragment --><ul>
<li><code>CHBDY2: character(8)</code>: Identificator of body 2</li>
<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 fender 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 fender 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 fender rotation axis <img class="formulaInl" alt="$[L]$" src="form_69.png"/><ul>
<li>Dummy for <code>IFRIC = 1</code></li>
</ul>
</li>
</ul>
<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>Local body 2 coordinates are used. It is assumed that {<code>XP,YP,ZP</code>} 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_239.png"/></li>
</ul>
<p>The characteristics can be given for monotonic increasing or decreasing distances, <code>DIST</code></p>
<ul>
<li>Point fender: All <code>DIST &lt;= 0</code></li>
<li>Spherical fender: All <code>DIST &gt; 0</code></li>
<li><code>AFORCE = 0</code> at the largest distance</li>
</ul>
<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_image041.png" alt="app-a_image041.png"/>
<div class="caption">
Illustration of fender plane dimensions</div></div>
<h1><a class="anchor" id="ug_coupling_bumper"></a>
Bumper element coupling</h1>
<h4>1 identifying line</h4>
<div class="fragment"><div class="line">BUMPer ELEMent COUPling</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</li>
<li><code>EHLA: integer, default: 0</code>: HLA export flag for bumper<ul>
<li><code>= 0</code>: No export</li>
<li><code>= 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> when Abs(vel.)<code>&lt;VEMIN</code> and <code>EXPD&lt;1</code>.</p>
<div class="image">
<img src="app-a_image042.png" alt="app-a_image042.png"/>
<div class="caption">
Example of a pair of bumpers</div></div>
<h4>If EHLA = 1, 1 input line, HLA name of bumper object</h4>
<div class="fragment"><div class="line">CHCHLA</div>
</div><!-- fragment --><ul>
<li><code>CHCHLA: character(120)</code>: Character string describing HLA coupling object name</li>
</ul>
<h4>Coordinates of bumper line attached to body no. 1, 1 input line.</h4>
<div class="fragment"><div class="line">CHBDY1   XA1   YA1   ZA1   XA2   YA2   ZA2</div>
</div><!-- fragment --><ul>
<li><code>CHBDY1: character(8)</code>: Identificator of body 1</li>
<li><code>XA1: real</code>: X-coordinate of bumper end 1, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>YA1: real</code>: Y-coordinate of bumper end 1, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>ZA1: real</code>: Z-coordinate of bumper end 1, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>XA2: real</code>: X-coordinate of bumper end 2, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>YA2: real</code>: Y-coordinate of bumper end 2, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>ZA2: real</code>: Z-coordinate of bumper end 2, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
</ul>
<p>Local body 1 coordinates</p>
<h4>Coordinates of bumper line attached to body no. 2, 1 input line.</h4>
<div class="fragment"><div class="line">CHBDY2   XB1   YB1   ZB1  XB2   YB2   ZB2</div>
</div><!-- fragment --><ul>
<li><code>CHBDY2: character(8)</code>: Identificator of body 2</li>
<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 2 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>
<h1><a class="anchor" id="ug_coupling_ratchet"></a>
Ratchet coupling</h1>
<p>A ratchet coupling can either give compression or tension force, calculated from stiffness, damping and deviation from a reference length. A compression element will slide (and increase the reference length) when the compressive force becomes smaller than a specified minimum value. Similarly a tension element will slide and decrease the reference length if the tension passes the specified minimum tension.</p>
<h4>1 identifying line</h4>
<div class="fragment"><div class="line">RATChet   COUPling</div>
</div><!-- fragment --><h4>1 input line</h4>
<div class="fragment"><div class="line">CHBDY1   XBDY1   YBDY1   ZBDY1</div>
</div><!-- fragment --><ul>
<li><code>CHBDY1: character(8)</code>: Identifier for body 1</li>
<li><code>XBDY1: real</code>: X-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
<li><code>YBDY1: real</code>: Y-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
<li><code>ZBDY1: real</code>: Z-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">CHBDY2   XBDY2   YBDY2   ZBDY2</div>
</div><!-- fragment --><ul>
<li><code>CHBDY2: character(8)</code>: Identifier for body 2</li>
<li><code>XBDY2: real</code>: X-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
<li><code>YBDY2: real</code>: Y-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
<li><code>ZBDY2: real</code>: Z-coordinate of coupling connection point in body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/>.</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">CHTYPE    RFMIN   RSTIFF   TSTART   RDAMP    REXP    VEMIN</div>
</div><!-- fragment --><ul>
<li><code>CHTYPE: character(4)</code>:<ul>
<li><code>TENSion</code>: Tension element</li>
<li><code>COMPression</code>: Pressure element</li>
</ul>
</li>
<li><code>RFMIN: real</code>: Static force in element <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>RSTIFF: real</code>: Element stiffness <img class="formulaInl" alt="$[F/L]$" src="form_150.png"/></li>
<li><code>TSTART: real</code>: Time when dynamics in element will be activated <img class="formulaInl" alt="$[T]$" src="form_70.png"/></li>
<li><code>RDAMP: real</code>: Damping coefficient</li>
<li><code>REXP: real</code>: Exponent in damping</li>
<li><code>VEMIN: real, default: 0</code>: Velocity limit for damping force (<code>EXPD=0</code>)</li>
</ul>
<p><code>RFMIN</code> is minimum compression force if <code>CHTYPE = COMP</code></p>
<p><code>RFMIN</code> is minimum tension if <code>CHTYPE = TENS</code>, <code>RFMIN</code> can be zero.</p>
<p>Small velocities and <code>REXP=0</code> can result in a large damping force that suddenly changes sign. To avoid this, <code>SIMO</code> will use <code>REXP=1</code> when Abs(vel.)<code>&lt;VEMIN</code> and <code>REXP&lt;1</code></p>
<h4>Element failure, 1 input line</h4>
<div class="fragment"><div class="line">IFAIL  FTIME  F_FAIL</div>
</div><!-- fragment --><ul>
<li><code>IFAIL: integer</code>: Failure mode of coupling element<ul>
<li><code>= 0</code>: no failure</li>
<li><code>= 1</code>: failure by exceedance of force 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>F_FAIL: real</code>: Maximum force, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
</ul>
<p>The coupling element fails when both <code>FTIME</code> and <code>F_FAIL</code> are exceeded</p>
<h1><a class="anchor" id="ug_coupling_moment"></a>
Moment coupling</h1>
<h4>1 identification input line.</h4>
<div class="fragment"><div class="line">MOMEnt COUPling</div>
</div><!-- fragment --><h4>Direction of moment coupling, 1 input line</h4>
<div class="fragment"><div class="line">CHBDY1  DV1  DV2  DV3</div>
</div><!-- fragment --><ul>
<li><code>CHBDY1: character(8)</code>: Identifier for body 1</li>
<li><code>DV1: real</code>: X-component of rotation axis, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>DV2: real</code>: Y-component of rotation axis, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>DV3: real</code>: Z-component of rotation axis, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
</ul>
<p>The vector defines the direction of a moment in the body fixed coordinate system of <code>BODY1</code></p>
<p>This direction will be constant in the local system during a simulation. At each time step the corresponding vector in the global system and in <code>BODY2</code> system will be calculated. At the initial position, the relative rotation (about the moment axis) is defined to be zero. From one time instant to the next during a simulation, the change in relative rotation about the axis will be computed and added to total relative rotation. This means that the calculated moment related to stiffness will be able to handle rotations of more than 360 degrees (or less than -360deg.)</p>
<h4>1 input line</h4>
<div class="fragment"><div class="line">CHBDY2</div>
</div><!-- fragment --><ul>
<li><code>CHBDY2: real</code>: Identifier for body 2</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">MOM0  MOMK  CPOS  EXPOS  CNEG  EXNEG</div>
</div><!-- fragment --><ul>
<li><code>MOM0: real</code>: Initial moment <img class="formulaInl" alt="$[FL]$" src="form_154.png"/></li>
<li><code>MOMK: real</code>: Moment stiffness <img class="formulaInl" alt="$[FL/\mathrm{rad}]$" src="form_240.png"/></li>
<li><code>CPOS: real</code>: Damping coefficient for positive rotation</li>
<li><code>EXPOS: real</code>: Exponent in damping - positive rotation</li>
<li><code>CNEG: real</code>: Damping coefficient for negative rotation</li>
<li><code>EXNEG: real</code>: Exponent in damping - negative rotation</li>
</ul>
<div class="image">
<img src="app-a_image043.png" alt="app-a_image043.png"/>
<div class="caption">
Example of moment coupling</div></div>
<h1><a class="anchor" id="ug_coupling_external"></a>
External coupling function data</h1>
<p>The characteristics of a coupling element can be programmed as an external library, which is executed during a simulation. The required amount of input parameters depends on the external software. All parameters must be written, even if some are dummy (not used).</p>
<h4>1 identifying line</h4>
<div class="fragment"><div class="line">EXTErnal COUPling FUNCtion</div>
</div><!-- fragment --><h4>1 input line, path and filename of library containing the coupling</h4>
<div class="fragment"><div class="line">TXXCO</div>
</div><!-- fragment --><ul>
<li><code>TXXCO: 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 coupling library</li>
</ul>
<h4>1 input lines</h4>
<div class="fragment"><div class="line">CHBDY1 XBDY1 YBDY1 ZBDY1 EHLA</div>
</div><!-- fragment --><ul>
<li><code>CHBDY1: character(8)</code>: Identificator for body 1</li>
<li><code>XBDY1: real</code>: X-coordinate of body attack point in its body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>YBDY1: real</code>: Y-coordinate of body attack point in its body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>ZBDY1: real</code>: Z-coordinate of body attack point in its body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">CHBDY2 XBDY2 YBDY2 ZBDY2</div>
</div><!-- fragment --><ul>
<li><code>CHBDY2: character(8)</code>: Identificator for body 2</li>
<li><code>XBDY2: real</code>: X-coordinate of body 2 attack point in its body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>YBDY2: real</code>: Y-coordinate of body 2 attack point in its body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>ZBDY2: real</code>: Z-coordinate of body 2 attack point in its body fixed coordinate system, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
</ul>
<h4>1 input line, may be dummy input if not used</h4>
<div class="fragment"><div class="line">NEL   IACC   EHLA</div>
</div><!-- fragment --><ul>
<li><code>NEL: integer, default: 10</code>: Number of elements in the line</li>
<li><code>IACC: integer, default: 0</code>: Flag for including acceleration of the line<ul>
<li><code>= 0</code>: No acceleration of the line</li>
<li><code>= 1</code>: Acceleration of the line included in the force calculations</li>
</ul>
</li>
<li><code>EHLA: integer, default: 0</code>: HLA export flag for coupling<ul>
<li><code>= 0</code>: No export</li>
<li><code>= 1</code>: HLA export</li>
</ul>
</li>
</ul>
<p>The model for including line acceleration in the line force calculations is simplified.</p>
<h4>If EHLA = 1, 1 input line, HLA name of external coupling object,</h4>
<div class="fragment"><div class="line">CHCHLA</div>
</div><!-- fragment --><ul>
<li><code>CHCHLA: character(120)</code>: Character string describing HLA coupling object name</li>
</ul>
<h4>1 input line, may be dummy input if not used</h4>
<div class="fragment"><div class="line">DIA   EMOD   EMFACT   RLEN   FLEXC   DAMPSW</div>
</div><!-- fragment --><ul>
<li><code>DIA: real</code>: Segment diameter, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>EMOD: real</code>: Modulus of elasticity <img class="formulaInl" alt="$[F/L^2]$" src="form_230.png"/></li>
<li><code>EMFAC: real</code>: Factor of elasticity<ul>
<li><code>= 2</code>: For chains</li>
<li><code>= 1</code>: For other segment types</li>
</ul>
</li>
<li><code>RLEN: real</code>: Initial, unstretched line length, <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>FLEXC: real, default: 0</code>: Connection flexibility, <img class="formulaInl" alt="$[L/F]$" src="form_234.png"/></li>
<li><code>DAMPSW: real, default: 0</code>: Material damping <img class="formulaInl" alt="$[FT]$" src="form_235.png"/>. <img class="formulaInl" alt="$ \mathrm{Force = dampsw * (\Delta L / \Delta t)/L}$" src="form_236.png"/></li>
</ul>
<p>Total stiffness, <code>EA = EMOD</code> * <code>EMFAC</code> * <code>DIA</code> <img class="formulaInl" alt="$ ^2$" src="form_241.png"/> * <img class="formulaInl" alt="$ \pi$" src="form_242.png"/>/4.</p>
<h4>1 input line, may be dummy input if not used</h4>
<div class="fragment"><div class="line">UWIA   WATFAC   CDN   CDL</div>
</div><!-- fragment --><ul>
<li><code>UWIA: real</code>: Unit weight in air, <img class="formulaInl" alt="$[F/L]$" src="form_150.png"/></li>
<li><code>WATFAC: real</code>: The ratio of weight in water to weight in air, normally 0.81 for wire and 0.87 for chain</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>
<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>
<h4>Element failure, 1 input line</h4>
<div class="fragment"><div class="line">IFMOCO FTIME BTENS</div>
</div><!-- fragment --><ul>
<li><code>IFMOCO: integer</code>: Failure mode of coupling element<ul>
<li><code>= 0</code>: no failure</li>
<li><code>= 1</code>: failure by exceedance of tension after specified time</li>
<li><code>= 2</code>: Activated after specified time if Tens <code>&lt; BTENS</code></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 coupling element breaks when both <code>FTIME</code> and <code>BTENS</code> are exceeded </p>
</div></div><!-- contents -->
	</body>
</html>