<?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">Program Layout </div>  </div>
</div><!--header-->
<div class="contents">
<div class="toc"><h3>Table of Contents</h3>
<ul><li class="level1"><a href="#ug_program_inpmod">INPMOD, input data manipulation</a></li>
<li class="level1"><a href="#ug_program_stamod">STAMOD, initial condition and static equilibrium</a></li>
<li class="level1"><a href="#ug_program_dynmod">DYNMOD, dynamic response calculation</a></li>
<li class="level1"><a href="#ug_program_outmod">OUTMOD, output module</a></li>
<li class="level1"><a href="#ug_program_s2xmod">S2XMOD, export of time series</a></li>
<li class="level1"><a href="#ug_program_simvis">SimVis, 3D visualization program</a></li>
<li class="level1"><a href="#ug_program_file">File system</a></li>
<li class="level1"><a href="#ug_program_running">Running SIMO</a></li>
</ul>
</div>
<div class="textblock"><p>The program system consists of five programs or modules communicating via a file system as shown below.</p>
<div class="image">
<img src="sgd_tbl_a.svg" alt="sgd_tbl_a.svg"/>
</div>
 <p>A complete dynamic analysis must include running the modules <code>STAMOD</code> and <code>DYNMOD</code>. Post processing or export of results is done by <code>OUTMOD</code> or alternatively <code>S2XMOD</code>. However, an efficient data base system simplifies the work during the analysis by storing input data and intermediate results.</p>
<p>The layout of the program system is presented in the figure below. Each module will be further detailed in the following.</p>
<div class="image">
<img src="layout_prog_mods.svg" alt="layout_prog_mods.svg"/>
<div class="caption">
Layout of the SIMO program system and file communication between modules</div></div>
<h1><a class="anchor" id="ug_program_inpmod"></a>
INPMOD, input data manipulation</h1>
<p>The purpose of the module is to provide interfaces to external input data sources, for example hydrodynamic programs, and to modify the system description file, <code>SYSFIL</code>.</p>
<h1><a class="anchor" id="ug_program_stamod"></a>
STAMOD, initial condition and static equilibrium</h1>
<p>The purpose of the module is to define the initial condition for the dynamic simulation. The description of the system to be simulated is read from a file, <code>SYSFIL</code>.</p>
<p>Selection between environmental conditions can be done.</p>
<p>A static equilibrium position may be calculated with average environmental forces applied. Natural periods and oscillation modes of the system may be calculated.</p>
<p>The initial conditions are written to the file <code>INIFIL</code> for use by <code>DYNMOD</code>.</p>
<h1><a class="anchor" id="ug_program_dynmod"></a>
DYNMOD, dynamic response calculation</h1>
<p>The purpose of the module is to calculate responses in the time domain. Before starting time integration of the equation of motion, the various simulation parameters must be initialized.</p>
<h1><a class="anchor" id="ug_program_outmod"></a>
OUTMOD, output module</h1>
<p>The purpose of the module is to read time series files generated in the <code>DYNMOD</code> module, generate, print and plot time series and statistical parameters.</p>
<h1><a class="anchor" id="ug_program_s2xmod"></a>
S2XMOD, export of time series</h1>
<p>The purpose of the module is to export result from dynamic analysis, i.e. time series to various file formats. In present version export to <code>MATLAB</code> ("m"-file), export to <code>ASCII</code>-file and export to <code>DIRECT ACCESS</code> file are available. In addition the module provides simple statistics and plot of time series.</p>
<h1><a class="anchor" id="ug_program_simvis"></a>
SimVis, 3D visualization program</h1>
<p>Stand-alone program for 3-dimensional visualization of static and dynamic analysis, based on <code>GLView</code>.</p>
<h1><a class="anchor" id="ug_program_file"></a>
File system</h1>
<p>When running the <code>SIMO</code> modules, different kind of files are needed. Each module communicates to terminal (or reads a macro file) and generates output on the print file.</p>
<p>The system description file, <code>SYSFIL</code>, contains a description of bodies, couplings and environmental data. It is a symbolic data file which is read by <code>STAMOD</code>. The file is also read by <code>OUTMOD</code> in order to find geometry data for static configuration plots and snapshots.</p>
<p>The initial condition file, <code>INIFIL</code>, is generated by <code>STAMOD</code>. If only modifications to an already defined initial condition are required, <code>STAMOD</code> can also read <code>INIFIL</code>. <code>DYNMOD</code> reads <code>INIFIL</code> to fetch the system to be simulated, and <code>OUTMOD</code> reads <code>INIFIL</code> to get initial positions and key data.</p>
<p>The pregenerated data file, <code>PREFIL</code> is used for internal storage of simulation parameters in <code>DYNMOD</code>. It is also read by <code>OUTMOD</code> to fetch information on the channels that are stored on <code>TSFIL</code>.</p>
<p>The time series file, <code>TSFIL</code>, contains all time series. It is generated by <code>DYNMOD</code>. <code>OUTMOD</code> reads the time series to be processed from <code>TSFIL</code>.</p>
<p>The default file name system utilizes the <b>system identifier</b> and <b>initial condition identifiers</b>, <em>chsys</em> and <em>chini</em>. Both contain up to 8 characters. At the beginning of each module, it is asked if default file names should be used. The default file names will be:</p>
<table class="doxtable">
<tr>
<th align="center">File type </th><th align="center">Short name </th><th align="center">File name syntax </th><th align="center">Example, <em>chsys</em>=s1, <em>chini</em>=i1  </th></tr>
<tr>
<td align="center">System description file </td><td align="center">SYSFIL </td><td align="center">sys[- <em>chsys</em>].dat </td><td align="center">sys-s1.dat </td></tr>
<tr>
<td align="center">Initial condition file </td><td align="center">INIFIL </td><td align="center">ini[- <em>chsys</em>[- <em>chini</em>]].sam </td><td align="center">ini-s1-i1.sam </td></tr>
<tr>
<td align="center">Print from INPMOD </td><td align="center">PRIFIL </td><td align="center">pri[- <em>chsys</em>].lis </td><td align="center">pri-s1.lis </td></tr>
<tr>
<td align="center">Print from STAMOD </td><td align="center">PRSFIL </td><td align="center">prs[- <em>chsys</em>].lis </td><td align="center">prs-s1.lis </td></tr>
<tr>
<td align="center">Print from DYNMOD </td><td align="center">PRDFIL </td><td align="center">prd[- <em>chsys</em>[- <em>chini</em>]].lis </td><td align="center">prd-s1-i1.lis </td></tr>
<tr>
<td align="center">Print from OUTMOD </td><td align="center">PROFIL </td><td align="center">pro[- <em>chsys</em>[- <em>chini</em>]].lis </td><td align="center">pro-s1-i1.lis </td></tr>
<tr>
<td align="center">Pregenerated data file </td><td align="center">PREFIL </td><td align="center">pre[- <em>chsys</em>[- <em>chini</em>]].sam </td><td align="center">pre-s1-i1.sam </td></tr>
<tr>
<td align="center">Time series file </td><td align="center">TSFFIL </td><td align="center">tsf[- <em>chsys</em>[- <em>chini</em>]].ffi </td><td align="center">tsf-s1-i1.ffi </td></tr>
</table>
<h1><a class="anchor" id="ug_program_running"></a>
Running SIMO</h1>
<p><code>SIMO</code> is normally started by typing <b>simo</b> at the command line prompt in the operating system. The system then typically responds by:</p>
<div class="fragment"><div class="line">**********************************************************</div>
<div class="line">*   WELCOME TO                                           * </div>
<div class="line">*                                                        *</div>
<div class="line">*    SSSSSSSSSS    III   MMMMM    MMMM      OOOOOOOO     *</div>
<div class="line">*   SSSSSSSSSSSS   III   MMMMM   MMMMM     OOOOOOOOOO    *</div>
<div class="line">*   SSS            III   MMMMMM MMMMMM    OOO      OOO   * </div>
<div class="line">*   SSS            III   MMM MMMMM MMM    OOO      OOO   *</div>
<div class="line">*   SSSSSSSSSS     III   MMM  MMM  MMM    OOO      OOO   *</div>
<div class="line">*   SSSSSSSSSSS    III   MMM   M   MMM    OOO      OOO   *</div>
<div class="line">*           SSS    III   MMM       MMM    OOO      OOO   *</div>
<div class="line">*           SSS    III   MMM       MMM    OOO      OOO   *</div>
<div class="line">*   SSSSSSSSSSS    III   MMM       MMM     OOOOOOOOOO    * </div>
<div class="line">*    SSSSSSSSS     III   MMM       MMM      OOOOOOOO     *</div>
<div class="line">*                                                        *</div>
<div class="line">*   SIMULATION OF COMPLEX MARINE OPERATIONS              *</div>
<div class="line">**********************************************************</div>
<div class="line"></div>
<div class="line"></div>
<div class="line">Enter system identification &gt; sysa</div>
<div class="line">Enter initial condition identification &gt; inib</div>
<div class="line"></div>
<div class="line">I-&gt; SELECTION OF PROGRAM MODULE</div>
<div class="line">I</div>
<div class="line">I      INP  - SIMO INPMOD</div>
<div class="line">I      STA  - SIMO STAMOD</div>
<div class="line">I      DYN  - SIMO DYNMOD</div>
<div class="line">I      OUT  - SIMO OUTMOD</div>
<div class="line">I      PLO  - SIMO/RIFLEX PLOMOD</div>
<div class="line">I      S2X  - SIMO S2XMOD</div>
<div class="line">I</div>
<div class="line">I      PINP - Print postscript inpmod/stamod/outmod file (simo.plt)</div>
<div class="line">I      PPLO - Print postscript plomod file (pscr-meta.dat)</div>
<div class="line">I</div>
<div class="line">I      DEF  - Redefine default files (for default file names)</div>
<div class="line">I      LIS  - List identifiers (for default file name)</div>
<div class="line">I</div>
<div class="line">I      TERM - Terminate</div>
<div class="line">I</div>
<div class="line">Select option &gt;</div>
</div><!-- fragment --><p>The user is first asked to specify the system identifier and initial condition identifier. They are described in previous sections, and are used to transfer default file names between the modules.</p>
<p>The user has the following options:</p>
<ul>
<li>switch between the program modules</li>
<li>send print files to printer</li>
<li>change default file names</li>
<li>terminate <code>SIMO</code> program system</li>
</ul>
<p>If for example the <code>INPMOD</code> module is selected, the system will respond with the following:</p>
<div class="fragment"><div class="line">   ***************************************************</div>
<div class="line">   *                                                 *</div>
<div class="line">   *   III   N   N   PPPP    M   M    OOO    DDDD    *</div>
<div class="line">   *    I    NN  N   P   P   MM MM   O   O   D   D   *</div>
<div class="line">   *    I    N N N   PPPP    M M M   O   O   D   D   *</div>
<div class="line">   *    I    N  NN   P       M   M   O   O   D   D   *</div>
<div class="line">   *   III   N   N   P       M   M    OOO    DDDD    *</div>
<div class="line">   *                                                 *</div>
<div class="line">   *     Version      2      Release      2          *</div>
<div class="line">   *                                                 *</div>
<div class="line">   *     Module linked at 27-OCT-1994 11:02          *</div>
<div class="line">   ***************************************************</div>
<div class="line"></div>
<div class="line">   System identifier . . . . . . . : sysa</div>
<div class="line">   Initial condition identifier. . : inib</div>
<div class="line"></div>
<div class="line">Use <span class="keywordflow">default</span> file names ? (Y) :</div>
</div><!-- fragment --><p>The module name, version and release number and the link date/time, the system and initial condition identifiers appear on the screen. It is strongly recommended to use default file names.</p>
<div class="fragment"><div class="line">+-----------------------------------------------------------------------+</div>
<div class="line">! File : pri-sysa.lis                                                   !</div>
<div class="line">! has been opened as PRINT FILE                                         !</div>
<div class="line">+-----------------------------------------------------------------------+</div>
<div class="line"></div>
<div class="line">The module allows test print from maximum  10 routines</div>
<div class="line"></div>
<div class="line">Specify number of routines           (                0 ) :</div>
<div class="line"></div>
<div class="line">    The following default plotting parameters are used:</div>
<div class="line">    ---------------------------------------------------</div>
<div class="line"></div>
<div class="line">    Screen device                 :   72</div>
<div class="line">    Plotting device               :   90</div>
<div class="line">    Plot file                     : simo.plt</div>
<div class="line"></div>
<div class="line">Use default values ? (Y)                                        :</div>
</div><!-- fragment --><p>The file name for printed output from the module is displayed. Error messages will be written on this file. There is an option for output of test print from the different program modules. It can be used for debugging purposes in cooperation and on instruction from program system aministrator, and normally the number of routines for test print should be set to 0 (default value).</p>
<p>All modules except <code>DYNMOD</code> generate plots. These can either be seen on screen or sent to postscript files. The default names are <code>simo.plt</code> or <code>pscr-meta.dat</code> (<code>PLOMOD</code>). These files can be opened in i.e. Ghostview and then copied directly into i.e. Microsoft Word.</p>
<p>The following plotting devices are available:</p>
<pre>
Screen      72     X11 (Windows, X-terminals or equivalent)
Plot fil    80     HPGL
            90     Postscript
</pre> </div></div><!-- contents -->
	</body>
</html>