<?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">Use of DYNMOD </div>  </div>
</div><!--header-->
<div class="contents">
<div class="toc"><h3>Table of Contents</h3>
<ul><li class="level1"><a href="#ug_dynmod_read">Read initial condition file</a></li>
<li class="level1"><a href="#ug_dynmod_set">Set simulation parameters</a><ul><li class="level2"><a href="#ug_dynmod_set_main">Main analysis parameters</a></li>
<li class="level2"><a href="#ug_dynmod_set_main_method">Method parameters</a></li>
<li class="level2"><a href="#ug_dynmod_set_main_storage">Storage parameters</a></li>
</ul>
</li>
<li class="level1"><a href="#ug_dynmod_initialization">Initialization of time domain simulation</a><ul><li class="level2"><a href="#ug_dynmod_initialization_wind">Reading wind time series from file</a></li>
<li class="level2"><a href="#ug_dynmod_initialization_wave">Reading wave elevation from file.</a></li>
</ul>
</li>
<li class="level1"><a href="#ug_dynmod_time">Time domain simulation</a></li>
<li class="level1"><a href="#ug_dynmod_work">Work array size in DYNMOD</a></li>
</ul>
</div>
<div class="textblock"><p>The purpose of <code>DYNMOD</code> is to perform time domain simulation of the system with initial condition as defined by <code>INIFIL</code>. Main analysis parameters, method parameters, storage parameters and integration parameters must be specified. The different options in the main menu must be selected in increasing order.</p>
<div class="fragment"><div class="line">I-&gt;  DYNMOD main menu</div>
<div class="line">I</div>
<div class="line">I      1 : Read initial condition file</div>
<div class="line">I      2 : Set simulation parameters</div>
<div class="line">I      3 : Initialize simulation</div>
<div class="line">I      4 : Time domain simulation</div>
<div class="line">I     99 : Terminate</div>
<div class="line">I</div>
<div class="line">I-&gt;  Select option ( 1 ) &gt;</div>
</div><!-- fragment --><h1><a class="anchor" id="ug_dynmod_read"></a>
Read initial condition file</h1>
<p>An <code>INIFIL</code> prepared by <code>STAMOD</code> will be read.</p>
<h1><a class="anchor" id="ug_dynmod_set"></a>
Set simulation parameters</h1>
<p>Default values representing the "most common used" values are assigned to all parameters. Within each group default values can be selected for all parameters. Specification can thus be done with a minimum of keystrokes. Otherwise default values are obtained by pressing 'Return' during the specification.</p>
<h2><a class="anchor" id="ug_dynmod_set_main"></a>
Main analysis parameters</h2>
<h3>Motion mode for station-keeping forces</h3>
<p>If any of the bodies included in the simulation are of type 2, i.e. the motion is separated in HF and LF motions, the station-keeping forces may be calculated due to LF response or due to the total HF+LF response, which is the default.</p>
<h3>Wave generation method</h3>
<p>The time series of wave responses are generated by superposition of harmonic components with uniformly distributed phases by means of pre-generation by the Fast Fourier transform (FFT) or by time domain summation of the harmonic components.</p>
<p>Due to these time-consuming calculations, a combination of pre-generated time series and cosine series in the time domain is made possible. For such a combination it is also possible to ensure that the same realization of wave components is used for both options for wave response calculation.</p>
<div class="fragment"><div class="line">Specification of calculation method <span class="keywordflow">for</span> waves:</div>
<div class="line">-----------------------------------------------</div>
<div class="line"></div>
<div class="line">I-&gt;  Select method <span class="keywordflow">for</span> calculation of waves</div>
<div class="line">I</div>
<div class="line">I      1 : No waves to be calculated</div>
<div class="line">I      2 : FFT only</div>
<div class="line">I      3 : FFT and Cosine series combined</div>
<div class="line">I      4 : Cosine series only</div>
<div class="line">I      5 : Visualization (cosine series)</div>
<div class="line">I-&gt;  Select option ( 2 ):</div>
</div><!-- fragment --><h3>Wind gust generation method</h3>
<p>The time series of wind gust are generated either by superposition of harmonic components with uniformly distributed phases by means of pre-generation by the Fast Fourier transform (FFT) or by a time domain state-space model driven by white noise.</p>
<div class="fragment"><div class="line">Specification of calculation method <span class="keywordflow">for</span> wind gust:</div>
<div class="line">--------------------------------------------------</div>
<div class="line"></div>
<div class="line">I-&gt;  Select method <span class="keywordflow">for</span> calculation of wind</div>
<div class="line">I</div>
<div class="line">I      1 : No wind gust to be calculated</div>
<div class="line">I      2 : FFT</div>
<div class="line">I      3 : State Space model</div>
</div><!-- fragment --><h3>Random seed for waves and wind</h3>
<p>A seed for generation of random phase angles must be specified. With different seed numbers, different time series of wind and waves will be generated.</p>
<p>It is also possible to read wind and waves from an ASCII file.</p>
<p>Each body may experience the same wind time series; alternatively different wind time series will be generated for each body.</p>
<p>Time series of wind force will be calculated for those bodies that have defined wind force coefficients.</p>
<h3>FFT parameters, simulation length</h3>
<p>If waves or dynamic wind responses are included in the simulation, time series can be generated by FFT. The number of time steps in the pre-generated series must be an integer power of 2. For example 2¹¹ steps equals 2048 steps.</p>
<h3>Wave generation by summation of harmonic components (cosine series) in the time domain</h3>
<p>The time series generated (equidistant frequencies), will repeat themselves with a period <img class="formulaInl" alt="$ T_p = 2 \pi/\Delta \omega_{\mathit{k} \: \mathrm{min} }$" src="form_41.png"/>, where <img class="formulaInl" alt="$ \mathrm{\Delta \omega_{\mathit{k}\: min} }$" src="form_42.png"/> is the smallest frequency increment. For user-given number of wave components for wind sea and swell, it is important that the number of components is sufficiently high to avoid a repeating wave response time series for the longest duration of the simulated operation that is close to stationary.</p>
<p>Stochastic amplitudes may be specified to be used for time domain wave response generation. This is a conflict with the assumption of ergodic processes, and analyses will often require simulations with multiple wave realizations in order to be able to give reliable extreme value estimates.</p>
<h3>Time step</h3>
<p>The time step for the retardation functions is used as the default time step in the simulation. There is a possibility of subdividing each time step into sub steps. Sub steps will not be in stored on the time series file. Care should be used when using a large number of sub steps, particularly when retardation functions are specified.</p>
<h2><a class="anchor" id="ug_dynmod_set_main_method"></a>
Method parameters</h2>
<h3>Possible wave responses</h3>
<p>The following wave responses may be calculated:</p>
<ul>
<li>Wave elevation in origin</li>
<li>First order motion</li>
<li>Wave particle motion at body initial position for those bodies that have defined small body hydrodynamic forces.</li>
<li>Wave particle motion for slender structures with distributed hydrodynamic forces</li>
<li><img class="formulaInl" alt="$ 1^{ \mathrm{st}}$" src="form_43.png"/> order wave forces</li>
<li><img class="formulaInl" alt="$ 1^{ \mathrm{st}}$" src="form_43.png"/> order diffracted wave kinematics at selected points around large volume bodies</li>
<li>Wave drift forces</li>
<li>Wave drift damping forces</li>
<li>Full <img class="formulaInl" alt="$ 2^{ \mathrm{nd}}$" src="form_44.png"/> order wave forces (sum- or difference- frequencies)</li>
<li>Ringing forces</li>
</ul>
<h3>Wave responses by FFT, corrections due to heading changes</h3>
<p>The following possibilities exist:</p>
<ul>
<li>No correction, i.e. responses calculated for initial heading is used throughout the simulation.</li>
<li>Interpolation in time domain. The response is initially calculated for a number of different headings, and interpolation between these is performed in time domain. The maximum heading change compared to initial heading must be specified, and simulation stops if this is exceeded.</li>
<li>For wave drift forces only: the first (and optionally also the second) derivative of average drift forces is applied to modify the pre-generated forces in time domain.</li>
</ul>
<h3>Calculation methods for wave drift forces</h3>
<p>The following methods exist:</p>
<ul>
<li>Average force will be calculated for each time step, calculation in the time domain</li>
<li>Use initial average force, and make corrections in time domain using the derivative of average force, calculation by FFT</li>
<li>Newman model, calculation by FFT or in the time domain (cosine series)</li>
<li>Extend drift force coefficients to full quadratic transfer functions, by using the Newman approximation, calculation by FFT or in the time domain (cosine series)</li>
</ul>
<h3>Calculation methods for 2nd order forces (QTF)</h3>
<p>Quadratic transfer functions for both sum and difference frequencies and optionally directional seas may be used as input. The following methods exist.</p>
<ul>
<li>Using the frequency diagonal as wave drift force coefficients and apply the Newman model.</li>
<li>Using the frequency diagonal and expand to off-diagonal terms by Newmans approximation.</li>
<li>Use full QTF matrix.</li>
</ul>
<p>Calculation of these forces in the time domain is not yet implemented.</p>
<h3>Wave elevation</h3>
<p>Normally, the resultant wave elevation is stored on the time series file. Alternatively, time series for each direction may be stored separately.</p>
<h3>Wind velocities</h3>
<p>Wind velocities will be calculated for the wind propagation direction, but also transverse gust speed may be specified:</p>
<div class="fragment"><div class="line">Wind velocity:</div>
<div class="line">--------------</div>
<div class="line"></div>
<div class="line">I-&gt;  Wind velocity, body-<span class="keywordtype">id</span></div>
<div class="line">I</div>
<div class="line">I       1 : One dimensional</div>
<div class="line">I       2 : Two dimensional</div>
<div class="line">I</div>
<div class="line">I-&gt;  Select option ( 2 ) :</div>
</div><!-- fragment --><h3>Wind forces</h3>
<p>Three force models are available:</p>
<ul>
<li>Calculation of static force (due to average wind velocity).</li>
<li>Force due to total wind velocity.</li>
<li>Force due to relative wind velocity.</li>
</ul>
<p>Interpolation of wind force coefficients between directions may be performed by either linear or spline interpolation.</p>
<h3>Current forces</h3>
<p>Two force models are available:</p>
<ul>
<li>Calculation of static force.</li>
<li>Force due to relative current velocity.</li>
</ul>
<p>Interpolation of current force coefficients between directions may be performed by either linear or spline interpolation.</p>
<p>The methods to be selected apply for both linear and quadratic current force coefficients.</p>
<h2><a class="anchor" id="ug_dynmod_set_main_storage"></a>
Storage parameters</h2>
<p>The following results from time domain simulation can be stored on the time series file:</p>
<ul>
<li>Wind speed.</li>
<li>Wind force.</li>
<li>Wave elevation. For short-crested sea, either each wave component or for resultant wave may be stored.</li>
<li>Wave particle velocities and accelerations, either for each directional wave component or for resultant wave.</li>
<li>Diffracted wave elevation and wave particle velocities and accelerations.</li>
<li><img class="formulaInl" alt="$ 1^{ \mathrm{st}}$" src="form_43.png"/> order wave force for degrees of freedom where transfer functions have been read. Either for each directional wave component or for resultant wave.</li>
<li><img class="formulaInl" alt="$ 2^{ \mathrm{nd}}$" src="form_44.png"/> order wave force for degrees of freedom where transfer functions are read. If <img class="formulaInl" alt="$ 2^{ \mathrm{nd}}$" src="form_44.png"/> order wave forces are modified due to heading changes, the force on the file will be updated, and the original value is lost.</li>
<li>Total force.</li>
<li>Retardation force.</li>
<li>Hydrostatic stiffness force.</li>
<li>Linear damping force.</li>
<li>Quadratic damping force.</li>
<li>Linear current drag force.</li>
<li>Quadratic current drag force.</li>
<li>Small body hydrodynamic force.</li>
<li>Total force from all elements of a body. In addition, the total force and the components of each element can be stored.</li>
<li>Total force from all couplings of a body. In addition, the total force and components in global and local system can be stored for each coupling element.</li>
<li>Total force from all thrusters of a body. In addition, force and direction of individual thrusters can be stored.</li>
<li>Dynamic positioning estimators.</li>
<li>Specified forces.</li>
<li>Global positions.</li>
<li>Global accelerations.</li>
<li>Local velocities.</li>
</ul>
<h1><a class="anchor" id="ug_dynmod_initialization"></a>
Initialization of time domain simulation</h1>
<p>Time series of wind speed, wave elevation, wave particle motion, <img class="formulaInl" alt="$ 1^{ \mathrm{st}}$" src="form_43.png"/> order wave forces and <img class="formulaInl" alt="$ 2^{ \mathrm{nd}}$" src="form_44.png"/> order wave forces will be generated at the initial positions of the bodies.</p>
<p>If regular waves are specified, these are also generated in the same way as irregular waves. The frequencies of the harmonic components are multiples of the frequency increment, <img class="formulaInl" alt="$\Delta \omega $" src="form_45.png"/>.</p>
<p><img class="formulaInl" alt="$ \Delta \omega = \frac{2 \pi}{N_t \Delta t} $" src="form_46.png"/></p>
<p>where <img class="formulaInl" alt="$ N_t$" src="form_47.png"/> is the number of time steps and <img class="formulaInl" alt="$ \Delta t$" src="form_48.png"/> is the time increment. The obtained wave periods will normally be slightly different from the specified ones since the selected wave frequency is a multiple of <img class="formulaInl" alt="$ \Delta \omega$" src="form_49.png"/>.</p>
<p>If wave periods are carefully selected, the specified wave periods will be obtained. The condition for this is that the specified simulation duration is an integer number of wave periods:</p>
<p><img class="formulaInl" alt="$ \frac{\omega}{\Delta \omega}= \frac{N_t \Delta t}{T}$" src="form_50.png"/> is an integer</p>
<p>where <img class="formulaInl" alt="$ T $" src="form_2.png"/> is the specified wave period.</p>
<h2><a class="anchor" id="ug_dynmod_initialization_wind"></a>
Reading wind time series from file</h2>
<p>Optionally, it is possible to read wind velocity or wind velocity and direction (for each body) from an ASCII file.</p>
<div class="fragment"><div class="line">Read wind series at body-<span class="keywordtype">id</span> from file? (N)            : YES</div>
<div class="line"></div>
<div class="line">Name of wind-file</div>
<div class="line">File name may be DROP</div>
<div class="line"></div>
<div class="line">File name</div>
<div class="line">        ---------------------------------------------</div>
<div class="line">Old    (wind.asc                                     )</div>
<div class="line">New   :</div>
<div class="line"></div>
<div class="line">Scaling factor:</div>
</div><!-- fragment --><p>In case one dimensional wind velocity has been specified, the input file should contain the time series of wind velocity only. The propagation wind direction for the present wind case is used (chosen in <code>STAMOD</code>, specified on <code>SYSFIL</code>). If two-dimensional wind velocity, the input file must contain series of both wind velocity and wind direction (in degrees). In this case the read wind time series is transformed to the propagation direction and transverse direction of the present wind case (chosen in <code>STAMOD</code>, specified on <code>SYSFIL</code>). This will not have any influence on the results from the simulation. It will only have an effect on the stored wind time series, stored as components in propagation and transverse directions.</p>
<p>Both the read wind velocity and time step will be scaled by the square root of the scaling factor.</p>
<p>The time step given on the ASCII file may be different from the time step used in the simulation. The specified wind time series will be re-sampled using the time step applied in the simulation based on linear interpolation. Further the velocities will be scaled by the square root of the scaling factor.</p>
<p>If the read time series is shorter than the length of the simulation, the wind velocity in the last part of the simulation will be set to zero.</p>
<p>It is assumed that the reference height for wind velocity coincides with the height for which wind force coefficients are given. Further, no filtering (application of admittance function) is done on the read wind times series.</p>
<h3>File format (ASCII) for one dimensional wind velocity</h3>
<ul>
<li>Line 1 : Number of samples</li>
<li>Line 2 : Time step</li>
<li>Line 3 : Arbitrary text</li>
<li>Line 4 : Arbitrary text</li>
<li>Lines 5-N : Time series read in free format (arbitrary number of samples on each line)</li>
</ul>
<p>Example: </p>
<div class="fragment"><div class="line"> 2048       <span class="stringliteral">&#39; Number of samples</span></div>
<div class="line"><span class="stringliteral"> .50        &#39;</span> Time step</div>
<div class="line">Text 1</div>
<div class="line">Text 2</div>
<div class="line">     20.0000</div>
<div class="line">     20.3923</div>
<div class="line">     20.7822           21.1672</div>
<div class="line">     21.5451           21.9134</div>
<div class="line">  .</div>
<div class="line">  .</div>
</div><!-- fragment --><h3>File format (ASCII) for two-dimensional wind velocity</h3>
<p>File head: (<em>The file head may contain an arbitrary number of comment lines starting with:</em>`)</p>
<ul>
<li>Line 1 : Number of samples</li>
<li>Line 2 : Time step</li>
<li>Line 3 : Number of columns (=2)</li>
</ul>
<p>Time series:</p>
<ul>
<li>Line 4 : velocity direction</li>
<li>Line 5 : velocity direction</li>
<li>.</li>
<li>.</li>
<li>.</li>
<li>Line 3 + N : velocity direction</li>
</ul>
<p>Example </p>
<div class="fragment"><div class="line">  2048       <span class="stringliteral">&#39; Number of samples \</span></div>
<div class="line"><span class="stringliteral">&#39;</span> Comment line 1                  \</div>
<div class="line">  .50        <span class="stringliteral">&#39; Time step           \</span></div>
<div class="line"><span class="stringliteral">  2          &#39;</span> Format type     **Head of file**</div>
<div class="line"><span class="stringliteral">&#39; Comment line 2                   /</span></div>
<div class="line"><span class="stringliteral">&#39;</span> Comment line 3                  /</div>
<div class="line"><span class="stringliteral">&#39; Last comment line              /</span></div>
<div class="line"><span class="stringliteral">  20.0000      180.000</span></div>
<div class="line"><span class="stringliteral">  20.3923      180.500</span></div>
<div class="line"><span class="stringliteral">  20.7822      181.000</span></div>
<div class="line"><span class="stringliteral">  21.1672      181.500</span></div>
<div class="line"><span class="stringliteral">  21.5451      182.000</span></div>
<div class="line"><span class="stringliteral">   .</span></div>
<div class="line"><span class="stringliteral">   .</span></div>
</div><!-- fragment --><h2><a class="anchor" id="ug_dynmod_initialization_wave"></a>
Reading wave elevation from file.</h2>
<p>Provided that long-crested waves are specified, it is possible to read wave elevation time series from an ASCII file:</p>
<div class="fragment"><div class="line">Should wave time series be read from file at body-<span class="keywordtype">id</span> from file? (N)           : YES</div>
<div class="line"></div>
<div class="line">Name of wave-file</div>
<div class="line">File name may be DROP</div>
<div class="line"></div>
<div class="line">File name</div>
<div class="line">        ---------------------------------------------</div>
<div class="line">Old    (wave.asc                                     )</div>
<div class="line">New   :</div>
<div class="line"></div>
<div class="line">Scaling factor:                   (1.0000) :</div>
<div class="line">X and Y coord. where wave is given (full scale).</div>
<div class="line"></div>
<div class="line">X-coord. (wave)                                  ( 0.00000 ) :</div>
<div class="line">Y-coord. (wave)                                  ( 0.00000 ) :</div>
<div class="line"></div>
<div class="line">Water depth in FULL scale                         ( 1000.00 ) :</div>
<div class="line"></div>
<div class="line">Cut-off periode for HP filter of wave signal     ( 40.0000 ) :</div>
</div><!-- fragment --><p>The propagation wave direction for the present sea state is used (chosen in <code>STAMOD</code>, specified on <code>SYSFIL</code>).</p>
<p>The read wave elevation will be scaled by the scaling factor while the time step is scaled by the square root of the scaling factor.</p>
<p>The time step given on the ASCII file may be different from the time step used in the simulation. The specified wave elevation time series will be re-sampled according to the time step used in the simulation based on linear interpolation. If the read time series is shorter than the length of the simulation, the wave elevation in the last part of the simulation will be set to zero.</p>
<h3>File format (ASCII) for wave elevation</h3>
<ul>
<li>Line 1 : Number of samples</li>
<li>Line 2 : Time step</li>
<li>Line 3 : Arbitrary text</li>
<li>Line 4 : Arbitrary text</li>
<li>Lines 5-N : Time series read in free format (arbitrary number of samples on each line)</li>
</ul>
<p>Example: </p>
<div class="fragment"><div class="line"> 2048       <span class="stringliteral">&#39; Number of samples</span></div>
<div class="line"><span class="stringliteral"> .50        &#39;</span> Time step</div>
<div class="line">Text 1</div>
<div class="line">Text 2</div>
<div class="line">     20.0000</div>
<div class="line">     20.3923</div>
<div class="line">     20.7822           21.1672</div>
<div class="line">     21.5451           21.9134</div>
<div class="line">  .</div>
<div class="line">  .</div>
</div><!-- fragment --><p>A complete example from a simulation is given below.</p>
<div class="fragment"><div class="line">Should wave time series be read from file ? (N)                  : y</div>
<div class="line"></div>
<div class="line"> Name of wave-file</div>
<div class="line"> File name may be DROP</div>
<div class="line"></div>
<div class="line"> File name</div>
<div class="line">         ----------------------------------------</div>
<div class="line"> Old    (wave.asc                                )</div>
<div class="line"> New   : wave.asc</div>
<div class="line"></div>
<div class="line"> Scale factor                         (     1.00000      ) :</div>
<div class="line"></div>
<div class="line"> Time step in model scale is 0.0200 sec.</div>
<div class="line"> Each series consists of  131072 points.</div>
<div class="line"></div>
<div class="line"> Wave signal in full scale contains    2048 values</div>
<div class="line"> different from zero.</div>
<div class="line"></div>
<div class="line"> The wave is transformed to ORIGO according to wave direction</div>
<div class="line"> and coord. of the point where the wave is given.</div>
<div class="line"> Transf. dist. is in FULL scale.</div>
<div class="line"> Deep water is NOT assumed : w*w = g*k*tanh(k*d)</div>
<div class="line"> The wave read from file replaces the wave</div>
<div class="line"> specified on the system input file.</div>
<div class="line"> The wave must be <span class="keywordtype">long</span>-crested.</div>
<div class="line"> Wave dir. is taken from the system input file.</div>
<div class="line"></div>
<div class="line"> X and Y coord. where wave is given (full scale).</div>
<div class="line">                                      :</div>
<div class="line"> X-coord. (wave)                      (     0.00000      ) : 10</div>
<div class="line"> Y-coord. (wave)                      (     0.00000      ) : 20</div>
<div class="line"> Wave direction   45.00 deg. results in a</div>
<div class="line"> transformation distance of -21.21 m</div>
<div class="line"></div>
<div class="line"> Water depth in FULL scale            (     100.000      ) : 200</div>
<div class="line"></div>
<div class="line"> Cut-off period for HP filter of wave signal</div>
<div class="line">                                      (     40.0000      ) : 100</div>
</div><!-- fragment --><h1><a class="anchor" id="ug_dynmod_time"></a>
Time domain simulation</h1>
<p>The simulation time and the integration method must be specified.</p>
<p>Clutch on <img class="formulaInl" alt="$1^{\mathrm{st}}$" src="form_51.png"/> order wave forces is implemented. The first and second derivatives of the clutch function are zero in both ends. The duration of the clutch function must be specified.</p>
<h1><a class="anchor" id="ug_dynmod_work"></a>
Work array size in DYNMOD</h1>
<p>The size of the <code>DYNMOD</code> work arrays may be specified using the environment variable <code>SIMO_MEM</code>. The variables give the size in MB, i.e. 4 times the number of million words. The minimum size is 4 MB and the maximum size is 800 MB.</p>
<p>The default size of the <code>DYNMOD</code> work array is 4 million words, e.g. 16 MB. </p>
</div></div><!-- contents -->
	</body>
</html>