<?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 OUTMOD </div>  </div>
</div><!--header-->
<div class="contents">
<div class="toc"><h3>Table of Contents</h3>
<ul><li class="level1"><a href="#ug_outmod_define">Define input and output files</a></li>
<li class="level1"><a href="#ug_outmod_list">List stored data</a></li>
<li class="level1"><a href="#ug_outmod_time">Time series analysis</a><ul><li class="level2"><a href="#ug_outmod_time_time">Time series</a></li>
<li class="level2"><a href="#ug_outmod_time_statistical">Statistical analysis (Time series statistics)</a></li>
<li class="level2"><a href="#ug_outmod_time_spectral">Spectral analysis</a></li>
</ul>
</li>
<li class="level1"><a href="#ug_outmod_snap">Snap shot of bodies</a></li>
</ul>
</div>
<div class="textblock"><p>The purpose of <code>OUTMOD</code> is to prepare plots of static system geometry and to analyse and present results from the time domain simulation.</p>
<div class="fragment"><div class="line">I-&gt;  OUTMOD main menu</div>
<div class="line">I</div>
<div class="line">I      1 : Define input and output files</div>
<div class="line">I      2 : List stored data</div>
<div class="line">I      3 : Time series analysis</div>
<div class="line">I      4 : Snap shot of bodies</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_outmod_define"></a>
Define input and output files</h1>
<p>It is possible to use <code>OUTMOD</code> for generation of static geometry only. In that case, the input files will be the initial condition file, <code>INIFIL</code>, and the system geometry file, <code>SYSFIL</code>.</p>
<p>If results from time domain simulation are requested, the input files will be <code>PREFIL</code>, the time series file, <code>TSFIL</code>, and the initial condition file, <code>INIFIL</code>. In this case, the names of <code>TSFIL</code> and <code>INIFIL</code> will be read from <code>PREFIL</code> and can not be changed by the user. If snapshots or static system geometry are requested, <code>SYSFIL</code> must be read as well.</p>
<p>Note that <code>SYSFIL</code> is used in <code>OUTMOD</code> only to read body geometry data. It will be favourable to use a reduced <code>SYSFIL</code> as described in Appendix A.</p>
<p>Results from <code>OUTMOD</code> will be written to the print file. If time series are wanted as output, the time series will normally be written. This can be avoided by decreasing the print switch "@ FILE".</p>
<p>Plot information will be written to the plot file, <code>PLOFIL</code>. It is possible to append more plots to a <code>PLOFIL</code> generated in a previous <code>OUTMOD</code> run. Plotting and scaling of plots is done by a separate program, <code>PLOMOD</code>.</p>
<h1><a class="anchor" id="ug_outmod_list"></a>
List stored data</h1>
<p>A summary of channels stored on <code>TSFIL</code> will be presented on the terminal.</p>
<h1><a class="anchor" id="ug_outmod_time"></a>
Time series analysis</h1>
<p>Any part of the time series can be selected for processing. Position time series can be derivated twice before processing.</p>
<h2><a class="anchor" id="ug_outmod_time_time"></a>
Time series</h2>
<p>Average value, standard deviation and extreme values are written to the print file and <code>PLOFIL</code>. The time series is written to <code>PLOFIL</code> and may also be written to the print file. It is also possible to preview a time series plot in <code>OUTMOD</code>.</p>
<p>The plots might appear with response type numbers. The following possibilities exist:</p>
<ul>
<li>1 : Wind velocity</li>
<li>2 : Wave elevation</li>
<li>3 : Wave particle motion at initial position</li>
<li>4 : Wave particle motion for distributed hydrodynamic forces</li>
</ul>
<ul>
<li>7 : Total force</li>
<li>8 : Retardation function force (convolution integral)</li>
<li>9 : Stiffness force</li>
<li>10 : Linear damping force</li>
<li>11 : Quadratic damping force</li>
<li>12 : 1st order wave force</li>
<li>13 : Wind force</li>
<li>14 : Linear current force</li>
<li>15 : Quadratic current force</li>
</ul>
<ul>
<li>17 : 2nd order wave force (wave drift force)</li>
<li>18 : QTF (quadratic transfer function) force</li>
<li>19 : Small body hydrodynamic force</li>
<li>20 : Positioning system force</li>
<li>21 : Coupling system force</li>
<li>23 : Dynamic positioning parameters</li>
<li>24 : Specified force</li>
<li>25 : External force</li>
<li>26 : Thruster force</li>
<li>27 : Distributed hydrodynamic force</li>
<li>28 : Wave drift damping force (wave current interaction)</li>
<li>29 : Global position from time domain calculations</li>
<li>30 : Global acceleration</li>
<li>31 : Local position</li>
<li>32 : Local velocity</li>
<li>33 : Global (total) position</li>
</ul>
<h2><a class="anchor" id="ug_outmod_time_statistical"></a>
Statistical analysis (Time series statistics)</h2>
<p>Input to the statistical analysis is the time series of the response to be analysed. Additional time series for maxima and minima are derived. For all three series, the four first statistical moments are computed:</p>
<p><img class="formulaInl" alt="$ m_i = \frac{1}{n} \sum\limits_{j=1}^{n} x_j^i $" src="form_52.png"/></p>
<p>The results are presented as average value, <img class="formulaInl" alt="$ \mu $" src="form_53.png"/>, standard deviation, <img class="formulaInl" alt="$ \sigma $" src="form_54.png"/>, and coefficients for skewness and excess, <img class="formulaInl" alt="$ \gamma_1$" src="form_55.png"/> and <img class="formulaInl" alt="$ \gamma_2$" src="form_56.png"/>.</p>
<p><img class="formulaInl" alt="$ \mu = m_1 $" src="form_57.png"/></p>
<p><img class="formulaInl" alt="$ \sigma^2 = m_2 - m^2_1 $" src="form_58.png"/></p>
<p><img class="formulaInl" alt="$ \gamma_1 = \left(m_3 - 3 m_1 m_2 + 2 m_1^3 \right) / \sigma^3$" src="form_59.png"/></p>
<p><img class="formulaInl" alt="$ \gamma_2 = \left( m_4 - 3 m_2^2 - 4 m_1 m_3 + 12 m_1^2 m_2 - 6 m_1^4 - 3 \right) / \sigma^4 $" src="form_60.png"/></p>
<p>For a Gaussian process <img class="formulaInl" alt="$ \gamma_1 $" src="form_61.png"/> and <img class="formulaInl" alt="$ \gamma_2 $" src="form_62.png"/> are zero, hence these two parameters describe the deviation from Gaussian distribution. An interpretation of these parameters is shown in the figure below.</p>
<div class="image">
<img src="image059.png" alt="image059.png"/>
<div class="caption">
Interpretation of skewness and excess coefficients</div></div>
<p>The distribution densities and cumulative distributions are computed based on simple ranking into a set of classes defined by the user in terms of:</p>
<ul>
<li>Number of classes.</li>
<li>Lower range defined by number of standard deviations below mean value.</li>
<li>Upper range defined by number of standard deviations above mean value.</li>
</ul>
<p>The range refers to the initial distribution. Thus the distributions of maxima and minima are computed for the same class discretization as the initial distribution.</p>
<p>No output is presented on <code>PLOFIL</code>.</p>
<h2><a class="anchor" id="ug_outmod_time_spectral"></a>
Spectral analysis</h2>
<p>The spectrum estimate is based on frequency averaging ('smoothing') of harmonic components obtained by FFT.</p>
<p>The 'Standard deviation', the 'Average period' and the 'Zero crossing period' are calculated. When the spectral density is given as a function of the frequency in <img class="formulaInl" alt="$\mathrm{[rad/s]}$" src="form_15.png"/>, the definition of these parameters are:</p>
<p>Standard deviation = <img class="formulaInl" alt="$ \sqrt {M_0} $" src="form_63.png"/></p>
<p>Average period = <img class="formulaInl" alt="$ T_{01} = 2\pi M_0 / M_1 $" src="form_64.png"/></p>
<p>Zero crossing period = <img class="formulaInl" alt="$ T_{02} = 2\pi \sqrt {( M_0 / M_2 )}$" src="form_65.png"/></p>
<p><img class="formulaInl" alt="$ M_0 $" src="form_66.png"/>, <img class="formulaInl" alt="$ M_1 $" src="form_67.png"/> and M2 are the zero, first and second order moment of the spectral density.</p>
<p>Spectral moments, spectrum parameters and spectral values are presented on the print file. In addition, spectrum values are written to <code>PLOFIL</code>.</p>
<p>Extreme values are estimated by fitting a Rice distribution to the sample and calculating the expected largest within the time interval to be specified by the user.</p>
<h1><a class="anchor" id="ug_outmod_snap"></a>
Snap shot of bodies</h1>
<p>Both static system geometry and snapshots from dynamic simulation can be generated on <code>PLOFIL</code>. Projections into any of the planes defined by the axes of the global coordinate system can be selected. In addition, 3-dimensional plots can be generated. Rotations of the 3-D plots are specified in <code>PLOMOD</code>.</p>
<p>Wave elevation can be included in the plots. In <code>PLOMOD</code>, the snap shots can be animated.</p>
<p>For 3D plots, results can be written to files for later visualization by a separate program, GLview (not a part of the <code>SIMO</code> program system). The files generated are:</p>
<ul>
<li>ani.geo - containing the geometry</li>
<li>ani.txt - containing displacements on ascii form.</li>
</ul>
<p>The latter should be transformed to binary form by the command: </p>
<pre>
        vec2one     ani.txt     ani.dis
</pre> </div></div><!-- contents -->
	</body>
</html>