<?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">Introduction </div>  </div>
</div><!--header-->
<div class="contents">
<div class="toc"><h3>Table of Contents</h3>
<ul><li class="level1"><a href="#um_introduction_purpose">Purpose of program</a></li>
<li class="level1"><a href="#um_introduction_program">Program documentation</a></li>
<li class="level1"><a href="#um_introduction_structure">Structure of VIVANA</a></li>
<li class="level1"><a href="#um_introduction_explanation">Explanation of files used</a></li>
<li class="level1"><a href="#um_introduction_applied">Applied units and physical constants</a></li>
</ul>
</div>
<div class="textblock"><h1><a class="anchor" id="um_introduction_purpose"></a>
Purpose of program</h1>
<p>It is well known that ocean currents may cause vortex induced vibrations (VIV) on slender marine structures. The processes that governs VIV has been studied as a part of the DEEPER project, and an effort has been made to improve the physical understanding of VIV for long risers, cables and pipelines in sheared current. The main result of this work is the computer program <code>VIVANA</code>, which has been maintained and developed continuously since the DEEPER project was finished.</p>
<p>The purpose of <code>VIVANA</code> is to calculate the response of a slender beam structure in a current, excited by vortex shedding. Cross-flow and in-line response can be calculated separately. <code>VIVANA</code> is not a complete analysis program in the sense that it is a stand-alone program that can be applied without any support from other programs. <code>VIVANA</code> requires that a description of the structure and its static shape is available on a specific file format. In its standard implementation, <code>VIVANA</code> is linked to the analysis program system <code>RIFLEX</code> (see RIFLEX Theory Manual). <code>RIFLEX</code> can handle a large variety of slender marine structures such as tensioned and flexible risers, anchor lines, umbilicals, tendons, pipelines during installation and free spanning pipelines. Such structures may hence also be analysed by <code>VIVANA</code>. Some of the structure types that <code>VIVANA</code> is able to handle are seen in <a class="el" href="a00004.html#um_slender_structures">Examples of slender structures that can be analysed by VIVANA</a>.</p>
<p><a class="anchor" id="um_slender_structures"></a></p>
<div class="image">
<img src="um_slender_structures.svg" alt="um_slender_structures.svg"/>
<div class="caption">
Examples of slender structures that can be analysed by VIVANA.</div></div>
<h1><a class="anchor" id="um_introduction_program"></a>
Program documentation</h1>
<p>The program documentation comprises of:</p>
<ul>
<li>General description, <a class="el" href="a00014.html#um_references_vivana_general">see references</a>.</li>
<li>User Manual containing description of input and output (this document).</li>
<li>Theory Manual containing a description of mathematical models used in the program, <a class="el" href="a00014.html#um_references_vivana_theory">see references</a>.</li>
<li>Acceptance manual containing input data for test cases and results from analyses, <a class="el" href="a00014.html#um_references_vivana_acceptance">see references</a>.</li>
</ul>
<h1><a class="anchor" id="um_introduction_structure"></a>
Structure of VIVANA</h1>
<div class="image">
<img src="um_program_system.svg" alt="um_program_system.svg"/>
<div class="caption">
Components of the VIVANA program system.</div></div>
<p>A complete VIV analysis consists of:</p>
<ul>
<li>An initial <code>RIFLEX</code> analysis using the <code>INPMOD</code> (system modelling and environment data) and <code>STAMOD</code> (nonlinear static analysis) modules.</li>
<li>Calculation of vortex induced vibrations in <code>VIVANA</code>. The analysis method is described in the VIVANA Theory Manual.</li>
<li>From the computed response amplitudes and frequencies <code>VIVANA</code> can calculate fatigue damage and drag force amplification.</li>
<li>An updated static analysis may be carried out by a second use of <code>STAMOD</code> where magnified drag coefficients are introduced. This type of analysis will require a special input file for <code>RIFLEX</code> <code>STAMOD</code>, which is described in the RIFLEX User Manual.</li>
</ul>
<p>Note that <code>RIFLEX</code> can handle complex structural systems in three dimensions and arbitrary current profiles, including variation of current direction with water depth. The present <code>VIVANA</code> version is, however, limited to handle structures that consist of one main line only (no branching) and that in its initial configuration is found in one plane. The current profile must be unidirectional and attach the structure in its main plane or perpendicular to this plane.</p>
<h1><a class="anchor" id="um_introduction_explanation"></a>
Explanation of files used</h1>
<p>When running the <code>RIFLEX</code> and <code>VIVANA</code> modules, different kinds of files are needed. The files can be divided into the following categories:</p>
<ol type="1">
<li>Symbolic input/output files (i.e. readable ASCII files).</li>
<li>Binary files for internal communication between <code>RIFLEX</code> and <code>VIVANA</code> modules.</li>
<li>Files for export of results for post processing.</li>
</ol>
<p>An overview of files used is given in <a class="el" href="a00004.html#um_program_files">File system for communication between modules</a>. The user will need to specify input files for the <code>INPMOD</code>, <code>STAMOD</code> and <code>VIVANA</code> modules.</p>
<p>The internal file communication is organized via run command procedures and therefore hidden from the user. Description of the file name conventions used in the standard run command procedure supplied with a <code>VIVANA</code> installation is given in <a class="el" href="a00010.html#um_how_running">Running VIVANA</a>.</p>
<h3>Symbolic input/output files</h3>
<p>Each analysis module needs a symbolic data file to read input data from (extension '<code>.inp</code>') and one symbolic file to print out major results (extension '<code>.res</code>'). These files are denoted:</p>
<ul>
<li><code>xxxxxx.inp</code> - symbolic input file to module <code>xxxxxx</code></li>
<li><code>xxxxxx.res</code> - symbolic result file from module <code>xxxxxx</code></li>
</ul>
<p><code>xxxxxx</code> here means either <code>INPMOD</code>, <code>STAMOD</code> or <code>VIVANA</code>, see <a class="el" href="a00004.html#um_program_files">File system for communication between modules</a>. The <code>INPMOD</code> and <code>STAMOD</code> input files are described in the <a class="el" href="a00014.html#um_references">RIFLEX User Manual</a>, while the <code>VIVANA</code> input file is described in <a class="el" href="a00012.html#um_input_general">Input to VIVANA</a>.</p>
<h3>Files for internal communication between modules</h3>
<p>Files for internal communication are binary, direct access data files in either SAM-DMS format (extension '<code>.sam</code>') or in FFILE format (extension '<code>.ffi</code>').</p>
<p>A short description of files used will be given in the following:</p>
<ul>
<li><code>ifninp.sam</code> - storage of all data given as input to the <code>INPMOD</code> module. System data read by <code>STAMOD</code> for generation of finite element model.</li>
<li><code>ifnsys.sam</code> - contains system finite element model generated by <code>STAMOD</code>.</li>
<li><code>ifndmp.sam</code> - temporary storage of all system data. To be used in possible restart analysis in <code>STAMOD</code>.</li>
<li><code>ifnsta.ffi</code> - storage of results from static analysis.</li>
<li><code>infnviv.ffi</code> - storage of results from VIV evaluation and response calculations.</li>
</ul>
<p>Results from <code>VIVANA</code> are available on two files, the <code>&lt;prefix&gt;_VIVANA.RES</code> file and the <code>&lt;prefix&gt;_VIVANA.mpf</code> file. The first file contains echo of input and key information, while the other can be handled by MATRIXPLOT for production of plots. Note that <code>&lt;prefix&gt;</code> in the file names represents a user specified prefix that is also used as prefix for input files for all <code>RIFLEX</code> modules and <code>VIVANA</code>.</p>
<p><a class="anchor" id="um_program_files"></a></p>
<div class="image">
<img src="um_program_files.svg" alt="um_program_files.svg"/>
<div class="caption">
File system for communication between modules.</div></div>
<h1><a class="anchor" id="um_introduction_applied"></a>
Applied units and physical constants</h1>
<p>In the input specification to the <code>RIFLEX</code> module <code>INPMOD</code> the user is allowed to select mass and force units. This is done by specifying the gravitational constant as the ratio of force to mass units. In order to allow inconsistent units, e.g. <img class="formulaInl" alt="$ \mathrm{kN}$" src="form_0.png"/>, <img class="formulaInl" alt="$ \mathrm{kg}$" src="form_1.png"/>, <img class="formulaInl" alt="$ \mathrm{m}$" src="form_2.png"/>, <img class="formulaInl" alt="$ \mathrm{s}$" src="form_3.png"/>, the acceleration in terms of force to mass will be different than acceleration in terms of the ratio length to squared time. A constant is therefore introduced as a specification of the difference, see the <a class="el" href="a00014.html#um_references">VIVANA Theory Manual</a> for further details.</p>
<p>The unit specification made by the user in <code>INPMOD</code> also applies to the results from the <code>VIVANA</code> module. </p>
</div></div><!-- contents -->
	</body>
</html>