<?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">Input to VIVANA </div>  </div>
</div><!--header-->
<div class="contents">
<div class="toc"><h3>Table of Contents</h3>
<ul><li class="level1"><a href="#um_input_general">General information</a></li>
<li class="level1"><a href="#um_input_control">Control information</a></li>
<li class="level1"><a href="#um_input_viv_frequency">VIV frequency analysis</a></li>
<li class="level1"><a href="#um_input_specification">Specification of section properties</a><ul><li class="level2"><a href="#um_input_specification_excitation_zone">Excitation zone properties</a></li>
<li class="level2"><a href="#um_input_specification_added">Added mass properties</a></li>
<li class="level2"><a href="#um_input_specification_excitation_coefficients">Excitation coefficient properties</a></li>
<li class="level2"><a href="#um_input_specification_damping">Damping factor properties</a></li>
<li class="level2"><a href="#um_input_specification_strouhal">Strouhal number properties</a></li>
</ul>
</li>
<li class="level1"><a href="#um_input_viv_response">VIV response analysis</a></li>
<li class="level1"><a href="#um_input_viv_fatigue">VIV fatigue analysis</a></li>
<li class="level1"><a href="#um_input_vivana_print">VIVANA print flags</a></li>
<li class="level1"><a href="#um_input_vivana_mpf_print">VIVANA MPF print flags</a></li>
<li class="level1"><a href="#um_input_termination">Termination of input data</a></li>
</ul>
</div>
<div class="textblock"><h1><a class="anchor" id="um_input_general"></a>
General information</h1>
<p>Input to the <code>VIVANA</code> module comprises two data files. One of these data files must be an ascii file given by the user, and the other one must be a binary result file from the static solution found by <code>RIFLEX</code> (<code>&lt;prefix&gt;_ifnsys.sam</code>). The file provided by the user must be named using the same prefix as was used for the <code>RIFLEX</code> analysis. This chapter describes the contents of the user defined input file to <code>VIVANA</code> (<code>&lt;prefix&gt;_vivana.inp</code>). A typical input file for <code>VIVANA</code> is listed in Appendix A.</p>
<p>The input to <code>VIVANA</code> is divided into seven sections:</p>
<ul>
<li><a class="el" href="a00012.html#um_input_control">Control information</a></li>
<li><a class="el" href="a00012.html#um_input_viv_frequency">VIV frequency analysis</a></li>
<li><a class="el" href="a00012.html#um_input_specification">Specification of section properties</a></li>
<li><a class="el" href="a00012.html#um_input_viv_response">VIV response analysis</a></li>
<li><a class="el" href="a00012.html#um_input_viv_fatigue">VIV fatigue analysis</a></li>
<li><a class="el" href="a00012.html#um_input_vivana_print">VIVANA print flags</a></li>
<li><a class="el" href="a00012.html#um_input_vivana_mpf_print">VIVANA MPF print flags</a></li>
</ul>
<p>Theoretical descriptions of the VIV evaluation scheme and the response analysis method are given in the <a class="el" href="a00014.html#um_references_vivana_theory">VIVANA Theory Manual</a>.</p>
<h1><a class="anchor" id="um_input_control"></a>
Control information</h1>
<h4>Data group identifier, one input line</h4>
<div class="fragment"><div class="line">VIVAna CONTrol INFOrmation chvers</div>
</div><!-- fragment --><ul>
<li><code>CHVERS: character(8)</code>: VIVANA input file version, e.g. 4.0</li>
</ul>
<p>Identification of the analysis must be given in three lines of text. This text will be printed to the <code>vivana.res</code> file.</p>
<h4>Heading, three input lines</h4>
<div class="fragment"><div class="line">HEADn</div>
</div><!-- fragment --><ul>
<li><code>HEADn: character, default: CH</code>: Line n of heading text</li>
</ul>
<p>Always 3 card images which may all be blank.</p>
<h4>Identification of system and environment, one input line</h4>
<div class="fragment"><div class="line">IDRIS IDSTAT IDENV TEMP IRSTYP</div>
</div><!-- fragment --><ul>
<li><code>IDRIS: character(6)</code>: Riser identifier, corresponding to the model established by <code>RIFLEX</code> module <code>INPMOD</code> and used in <code>STAMOD</code>. See Input to INPMOD, Data Group B, Riser type specification in <a class="el" href="a00014.html#um_references_riflex_user">RIFLEX User Manual</a>.</li>
<li><code>IDSTAT: character(6)</code>: Static condition identifier, corresponding to the static analysis carried out by <code>RIFLEX</code> module <code>STAMOD</code>. See Input to STAMOD, Data Group A, Principal run parameters in <a class="el" href="a00014.html#um_references_riflex_user">RIFLEX User Manual</a>.</li>
<li><code>IDENV: character(6)</code>: Environment identifier, corresponding to the environment established by <code>RIFLEX</code> <code>INPMOD</code> and used in <code>STAMOD</code>. See Input to INPMOD, Data Group D: Environmental Data in <a class="el" href="a00014.html#um_references_riflex_user">RIFLEX User Manual</a>.</li>
<li><code>TEMP: real, default: 4</code>: Water temperature <img class="formulaInl" alt="$ [\mathrm{deg}] $" src="form_11.png"/></li>
<li><code>IRSTYP: integer, default: 1</code>: Option for type of VIV loads to be applied<ul>
<li><code>= 1</code>: Cross-flow VIV loads are applied</li>
<li><code>= 2</code>: In-line VIV loads are applied</li>
<li><code>= 3</code>: Combined cross-flow and in-line VIV loads are applied</li>
</ul>
</li>
</ul>
<h4>Specification of work array dimension</h4>
<p>It is possible for the user to decide how much computer memory should be allocated to a <code>VIVANA</code> analysis.</p>
<h4>Data group identifier, one input line</h4>
<div class="fragment"><div class="line">WORK ARRAy DIMEnsion</div>
</div><!-- fragment --><h4>Number of words allocated for VIVANA analysis, one input line</h4>
<div class="fragment"><div class="line">NWIWA</div>
</div><!-- fragment --><ul>
<li><code>NWIWA: integer, default: 9000000</code>: Number of words allocated for <code>VIVANA</code> analysis</li>
</ul>
<h1><a class="anchor" id="um_input_viv_frequency"></a>
VIV frequency analysis</h1>
<p>This data group is optional, default values will be inserted if the data group is not given.</p>
<h4>Data group identifier, one input line</h4>
<div class="fragment"><div class="line">EIGEnvalue ANALysis PARAmeters</div>
</div><!-- fragment --><h4>Number of eigenvalues and -vectors, one input line</h4>
<div class="fragment"><div class="line">NEIG NVEC</div>
</div><!-- fragment --><ul>
<li><code>NEIG: integer, default: 10</code>: Number of eigenvalues to be calculated</li>
<li><code>NVEC: integer, default: 10</code>: Number of eigenvectors to be calculated</li>
</ul>
<p>The number of eigenvalues and eigenvectors to be calculated is the total number of frequencies. Once these have been found the program selects the cross-flow or in-line frequencies as relevant. Approximately 50% of the calculated frequencies are in-line and 50% are cross-flow. This means that in order to study VIV response up to frequency no. 30, the user must specify <code>NEIG</code> and <code>NVEC</code> &gt;= 60.</p>
<h4>Computation parameters, one input line</h4>
<p>The parameters below correspond to Lanczos' method for solution of eigenvalue problems. For a detailed discussion, see <a class="el" href="a00014.html#um_references_nour-omid_et_al">Nour-Omid et al.</a> or <a class="el" href="a00014.html#um_references_parlett">Parlett</a>.</p>
<div class="fragment"><div class="line">EPS1 EPS2 EPS3 KSR MAXIT KEX SHIFT MAXNIV</div>
</div><!-- fragment --><ul>
<li><code>EPS1: real, default: 0</code>: Maximum acceptable relative error in computed eigenvalues</li>
<li><code>EPS2: real, default: 0</code>: Limit value for singularity test during factorization</li>
<li><code>EPS3: real, default: 0</code>: Orthogonality limit:<ul>
<li>If <img class="formulaInl" alt="$ \mathrm{ \boldsymbol{\mathrm{v}}_i \, ^T \boldsymbol{\mathrm{v}}_i = \delta_{ii} }$" src="form_12.png"/> and <img class="formulaInl" alt="$ \mathrm{ \boldsymbol{\mathrm{v}}_i\,^T \boldsymbol{\mathrm{v}}_j = \delta_{ij} }$" src="form_13.png"/> and <img class="formulaInl" alt="$ \mathrm{| \delta_{ij} | < EPS3 \times \delta_{ii} }$" src="form_14.png"/>, <img class="formulaInl" alt="$ \mathrm{ \quad\boldsymbol{\mathrm{v}}_i } $" src="form_15.png"/> and <img class="formulaInl" alt="$ \mathrm{ \boldsymbol{\mathrm{v}}_j }$" src="form_16.png"/> are orthogonal</li>
</ul>
</li>
<li><code>KSR: integer, default: 1</code>: Start vector code:<ul>
<li><code>KSR =</code> <img class="formulaInl" alt="$ \pm $" src="form_17.png"/><code>1</code>: a pseudo-random start vector is generated by the eigenvalue solver</li>
<li><code>KSR =</code> <img class="formulaInl" alt="$ \pm $" src="form_17.png"/><code>2</code>: the diagonal of the mass matrix is used as start vector</li>
<li><code>KSR =</code> <img class="formulaInl" alt="$ \pm $" src="form_17.png"/><code>3</code>: a start vector of unit elements is used</li>
<li>For positive <code>KSR</code> the start vector is premultiplied with <b>H</b> before use; if a negative value is specified the start vector is used directly. See the <a class="el" href="a00014.html#um_references_riflex_theory">RIFLEX Theory Manual</a>.</li>
</ul>
</li>
<li><code>MAXIT: integer, default: 5</code>: Maximum no of iterations in reorthogonalization.<ul>
<li>If a negative value is specified, reorthogonalization is not iterative; e.g. <code>MAXIT = -2</code> will cause a two-pass Gram-Smith orthogonalization to be employed to all new <img class="formulaInl" alt="$ \mathrm{ \boldsymbol{\mathrm{ v_{}}}_i } $" src="form_18.png"/> (i&gt;1), irrespective of <code>EPS3</code>.</li>
<li>For high values of <code>NEIG</code> (&gt;50) a doublepass orthogonalization is recommended (<code>MAXIT = -2</code>)</li>
</ul>
</li>
<li><code>KEX: integer, default: 0</code>: Parameter controlling the frequency with which the small tridiagonal eigenvalue problem is solved.<ul>
<li>Must be in the range of <code>0 &lt;= KEX &lt;= 5</code>.</li>
<li>If a zero value is specified, a default value of 2 is used</li>
</ul>
</li>
<li><code>SHIFT: real, default: 0</code>: The shift value <img class="formulaInl" alt="$ \sigma $" src="form_19.png"/></li>
<li><code>MAXNIV: integer, default: 0</code>: Number of Lanczos steps to be used.<ul>
<li>A default value suitable for the eigenvalue routines is automatically computed if a <code>0</code> is specified.</li>
<li><code>MAXNIV</code> should only be given a value <img class="formulaInl" alt="$ \neq $" src="form_20.png"/> <code>0</code> for small problems</li>
</ul>
</li>
</ul>
<p>If zero or negative values are specified for <code>EPS1</code> - <code>EPS3</code> default values are inserted</p>
<h4>Data group identifier, one input line</h4>
<div class="fragment"><div class="line">EIGEnvalue PRINt OPTIons</div>
</div><!-- fragment --><h4>Print selection parameters, one input line</h4>
<div class="fragment"><div class="line">NPEIG NPVEC</div>
</div><!-- fragment --><ul>
<li><code>NPEIG: integer, default: 0</code>: Number of eigenvalues to be printed (<code>&lt;= NEIG</code>)</li>
<li><code>NPVEC: integer, default: 0</code>: Number of eigenvectors to be printed (<code>&lt;= NVEC</code>)<ul>
<li><code>= 0</code>: All eigenvectors are printed</li>
</ul>
</li>
</ul>
<h1><a class="anchor" id="um_input_specification"></a>
Specification of section properties</h1>
<p>This data group is mandatory. Property types such as excitation zone definition, added mass as a function of non-dimensional frequency, excitation coefficient as a function of non-dimensional frequency and response, damping and Strouhal number may be specified by the user. However, data specified by the user will be disregarded by <code>VIVANA</code> if in-line VIV is to be calculated. In that particular case, <code>VIVANA</code> will use default data irrespective of what is specified in this datagroup.</p>
<p>For the various property types; e.g. added mass, excitation, Strouhal number; an arbitrary number of data sets may be defined in the input file. Within each of these property types the data sets are given unique numbers. The cross section properties for each segment are then defined by referring to these numbers. <a class="el" href="a00016.html#um_appendix_a">Appendix A: Typical VIVANA Input File</a> shows an example where several property types are given.</p>
<h4>Data group identifier, one input line</h4>
<div class="fragment"><div class="line">SECTion PROPerty SPECification</div>
</div><!-- fragment --><div class="fragment"><div class="line">NSEGP</div>
</div><!-- fragment --><ul>
<li><code>NSEGP: integer</code>: Number of segments for which properties are given. Must be equal to the number of segments in the model specified in <code>INPMOD</code></li>
</ul>
<h4>Specification of cross-section property for each segment, NSEGP input lines.</h4>
<div class="fragment"><div class="line">ISEGP IEXCZO IADDMA1 IEXCIT1 IDAMPG ISTROU IADDMA2 IEXCIT2</div>
</div><!-- fragment --><ul>
<li><code>ISEGP: integer, default: 0</code>: Segment number (global).</li>
<li><code>IEXCZO: integer, default: 0</code>: Cross section property specification for excitation zone limits. Refers to <code>IPRONO</code> in <a class="el" href="a00012.html#um_input_specification_excitation_zone">Excitation zone properties</a>.</li>
<li><code>IADDMA1: integer, default: 0</code>: Cross section property specification for cross-flow (<code>IRSTYP = 1</code> or <code>IRSTYP = 3</code>) or in-line (<code>IRSTYP = 2</code>) added mass as a function of non-dimensional frequency. Refers to <code>IPRONO</code> in <a class="el" href="a00012.html#um_input_specification_added">Added mass properties</a>.</li>
<li><code>IEXCIT1: integer, default: 0</code>: Cross section property specification for cross-flow (<code>IRSTYP = 1</code> or <code>IRSTYP = 3</code>) or in-line (<code>IRSTYP = 2</code>) excitation coefficient as a function of non-dimensional frequency. Refers to <code>IPRONO</code> in <a class="el" href="a00012.html#um_input_specification_excitation_coefficients">Excitation coefficient properties</a>.</li>
<li><code>IDAMPG: integer, default: 0</code>: Cross section property specification for hydrodynamic damping. Refers to <code>IPRONO</code> in <a class="el" href="a00012.html#um_input_specification_damping">Damping factor properties</a>.<ul>
<li>The program has two possible ways to calculate the damping, see <a class="el" href="a00012.html#um_input_specification_damping">Damping factor properties</a> in this manual :<ol type="1">
<li>The damping terms <img class="formulaInl" alt="$ \mathrm{R_{sw}}$" src="form_21.png"/>, <img class="formulaInl" alt="$ \mathrm{R_{lv}}$" src="form_22.png"/> and <img class="formulaInl" alt="$ \mathrm{R_{hv}}$" src="form_23.png"/> will be used directly, ref. <a class="el" href="a00014.html#um_references_vivana_theory">VIVANA Theory Manual</a>, Section The Damping Model, Hydrodynamic damping outside the excitation zone.</li>
<li>The damping is calculated using the excitation curves defined for that section. A still water damping coefficient must be given as input.</li>
</ol>
</li>
</ul>
</li>
<li><code>ISTROU: integer, default: 0</code>: Cross section property specification for Strouhal number. Refers to <code>IPRONO</code> in <a class="el" href="a00012.html#um_input_specification_strouhal">Strouhal number properties</a>.</li>
<li><code>IADDMA2: integer, default: 0</code>: Cross section property specification for in-line added mass as a function of non-dimensional frequency for the case of combined cross-flow and in-line (<code>IRSTYP = 3</code>). Refers to <code>IPRONO</code> in <a class="el" href="a00012.html#um_input_specification_added">Added mass properties</a>. Note that the response frequency iterations will adjust the in-line added mass so that the in-line response frequency is twice that of the cross-flow response frequency. <code>IADDMA2</code> must be zero for pure cross-flow (<code>IRSTYP = 1</code>) or pure in-line (<code>IRSTYP = 2</code>).</li>
<li><code>IEXCIT2: integer, default: 0</code>: Cross section property specification for in-line excitation coefficient as a function of non-dimensional frequency for the case of combined cross-flow and in-line (<code>IRSTYP = 3</code>). Refers to <code>IPRONO</code> in <a class="el" href="a00012.html#um_input_specification_excitation_coefficients">Excitation coefficient properties</a>. <code>IEXCIT2</code> must be zero for pure cross-flow (<code>IRSTYP = 1</code>) or pure in-line (<code>IRSTYP = 2</code>).</li>
</ul>
<p>The cross-section properties referenced in this data group must be defined using any of the following "PROPERTY" - data groups.</p>
<p>The default value of zero for <code>IEXCZO</code>, <code>IADDMA1/2</code>, <code>IEXCIT1/2</code>, <code>IDAMPG</code> and <code>ISTROU</code> tells the program to use the following:</p>
<table class="doxtable">
<tr>
<th align="center"></th><th align="center">Cross-flow VIV (IRSTYP = 1) </th><th align="center">In-line VIV (IRSTYP = 2)  </th></tr>
<tr>
<td align="center">Excitation zone limits </td><td align="center"><img class="formulaInl" alt="$\hat{f}_ {\mathrm{min}}$" src="form_24.png"/>:0.125 <img class="formulaInl" alt="$\hat{f}_ {\mathrm{max}}$" src="form_25.png"/>:0.3 </td><td align="center"><img class="formulaInl" alt="$\hat{f}_ {\mathrm{min}}$" src="form_24.png"/>:0.2 <img class="formulaInl" alt="$\hat{f}_ {\mathrm{max}}$" src="form_25.png"/>:0.9 </td></tr>
<tr>
<td align="center">Added mass as function of <img class="formulaInl" alt="$\hat{f}$" src="form_26.png"/> </td><td align="center">See the figure with the VIVANA CF added mass model in the Theory Manual, Section Calculation of Response Frequencies, Added mass, CF response. </td><td align="center">See the figure with the VIVANA IL added mass model in the Theory Manual, Section Calculation of Response Frequencies, Added mass, pure IL response. </td></tr>
<tr>
<td align="center">Excitation coefficients as function of <img class="formulaInl" alt="$\hat{f}$" src="form_26.png"/> </td><td align="center">A modified version of Gopalkrishnan's coefficients will be used, ref. the Theory Manual. Section Excitation Force Model, Default excitation coefficient model, CF response. </td><td align="center">A modified version of <a class="el" href="a00014.html#um_references_aronsen_omae">Aronsen</a>'s coefficients will be used, ref. the Theory Manual. Section Excitation Force Model, Default excitation coefficient model, pure IL response. </td></tr>
<tr>
<td align="center">Hydrodynamic damping </td><td align="center">The damping terms <img class="formulaInl" alt="$ \mathrm{R_{sw}}$" src="form_21.png"/>, <img class="formulaInl" alt="$ \mathrm{R_{lv}}$" src="form_22.png"/> and <img class="formulaInl" alt="$ \mathrm{R_{hv}}_ {}$" src="form_27.png"/> will be used directly, ref. the Theory Manual, Section The Damping Model, Hydrodynamic damping outside the excitation zone. </td><td align="center">Same as for Cross-flow VIV. </td></tr>
<tr>
<td align="center">Strouhal number definition </td><td align="center">The program calculates the Strouhal number as a function of the Reynolds number for each element in the model, see the Theory Manual, Section Dimensionless Parameters, Strouhal number. </td><td align="center">Same as for Cross-flow VIV. </td></tr>
</table>
<p>A constant added mass of 1.0 is recommended for analyses with response frequencies corresponding to high modes; e.g. above mode 15.</p>
<h2><a class="anchor" id="um_input_specification_excitation_zone"></a>
Excitation zone properties</h2>
<h4>Specification of excitation zone range.</h4>
<div class="fragment"><div class="line">PROPerty EXCItation ZONE</div>
</div><!-- fragment --><h4>Number of excitation zones specified</h4>
<div class="fragment"><div class="line">NEXZON</div>
</div><!-- fragment --><ul>
<li><code>NEXZON: integer</code>: Number of excitation zones specified in this datagroup.</li>
</ul>
<h4>Specification of excitation zone limits for various sections of the structure, NEXZON input lines.</h4>
<div class="fragment"><div class="line">IPRONO CPRPID FHMIN FHMAX</div>
</div><!-- fragment --><ul>
<li><code>IPRONO: integer</code>: Cross-section property specification number for property type <em>Excitation zone properties</em>.</li>
<li><code>CPRPID: character(8)</code>: Text to identify the cross-section property</li>
<li><code>FHMIN: real, default: 0.125</code>: Minimum value of <img class="formulaInl" alt="$ \hat{f} $" src="form_28.png"/> in the excitation zone.</li>
<li><code>FHMAX: real, default: 0.2</code>: Maximum value of <img class="formulaInl" alt="$ \hat{f} $" src="form_28.png"/> in the excitation zone.</li>
</ul>
<p>It is not allowed to specify a broader excitation range for a cross-section than the range used for specification of the associated excitation coefficient curves.</p>
<h2><a class="anchor" id="um_input_specification_added"></a>
Added mass properties</h2>
<h4>Specification of added mass as a function of non-dimensionalfrequency.</h4>
<div class="fragment"><div class="line">PROPerty ADDED MASS</div>
</div><!-- fragment --><h4>Number of added mass curves specified</h4>
<div class="fragment"><div class="line">NADCUR</div>
</div><!-- fragment --><ul>
<li><code>NADCUR: integer</code>: Number of added mass curves to be defined by the user.</li>
</ul>
<h4>Specification of added mass as a function of non-dimensional frequency, repeated NADCUR times</h4>
<p>One input line</p>
<div class="fragment"><div class="line">IPRONO CPRPID NAMPT</div>
</div><!-- fragment --><ul>
<li><code>IPRONO: integer</code>: Cross-section property specification number for property type <em>Added mass properties</em>.</li>
<li><code>CPRPID: character(8)</code>: Text to identify the cross-section property</li>
<li><code>NAMPT: integer &gt;= 1</code>: Number of points in <img class="formulaInl" alt="$ \mathrm{C_a} \, \hat{f} $" src="form_29.png"/> curve.</li>
</ul>
<p>Constant added mass can be given either by using <code>NAMPT=1</code> or by using an constant added mass curve <code>NAMPT&gt;=2</code>.</p>
<p>Note that if <code>IRSTYP=3</code> (Combined cross-flow and in-line VIV) and constant added mass curve with <code>NAMPT=1</code> is used for all sections, no IL frequency iteration is performed. The IL frequency is twice the CF frequency.</p>
<p>Constant added mass coefficient, <code>NAMPT=1</code> input lines</p>
<div class="fragment"><div class="line">ADDMCO</div>
</div><!-- fragment --><ul>
<li><code>ADDMCO: real</code>: Added mass coefficient</li>
</ul>
<p>Added mass coefficient as a function of non-dimensional frequency, <code>NAMPT&gt;=2</code> input lines</p>
<div class="fragment"><div class="line">FHAT ADDMCO</div>
</div><!-- fragment --><ul>
<li><code>FHAT: real</code>: Non-dimensional frequency</li>
<li><code>ADDMCO: real</code>: Added mass coefficient</li>
</ul>
<h2><a class="anchor" id="um_input_specification_excitation_coefficients"></a>
Excitation coefficient properties</h2>
<p>Two different ways of specifying excitation coefficients are available in <code>VIVANA</code>. The excitation coefficient is used in the response analysis for calculating the excitation force on the cylinder. Calculation of excitation force is irrespective of how the excitation coefficients are specified by the user.</p>
<p>Excitation force is calculated for elements within the excitation zone. The excitation zone is defined by the excitation frequency bandwidth. The excitation frequency bandwidth is by default [0.125, 0.3] for cross-flow VIV, but it is possible for the user to define his/her own excitation frequency range for any part of the model, see <a class="el" href="a00012.html#um_input_specification_excitation_zone">Excitation coefficient properties</a>. We would normally recommend the user to set the frequency bandwidth equal to the frequency range for which excitation coefficients are provided. Elements outside of the excitation zone will add damping to the system, see the Theory Manual, Section Calculation of Response Frequencies, Added mass, CF response for details.</p>
<h4>Specification of excitation coefficient as a function of non-dimensional frequency and response amplitude.</h4>
<div class="fragment"><div class="line">PROPerty EXCITATION COEFFICIENT</div>
</div><!-- fragment --><h4>Number of excitation coefficient data sets to be specified</h4>
<div class="fragment"><div class="line">NLCT01 NLCT02</div>
</div><!-- fragment --><ul>
<li><code>NLCT01: integer, default: 0</code>: Number of excitation coefficient data sets to be specified on the same format as the default curves (Type 1).</li>
<li><code>NLCT02: integer, default: 0</code>: Number of excitation coefficient data sets to be specified on the table format (Type 2)</li>
</ul>
<h4>Specification of default format excitation coefficient data (Type 1), 2xNLCT01 input lines</h4>
<p>One input line</p>
<div class="fragment"><div class="line">IPRONO CPRPID NFT01</div>
</div><!-- fragment --><ul>
<li><code>IPRONO: integer</code>: Cross-section property specification number for property type <em>Excitation coefficient property</em>.</li>
<li><code>CPRPID: character(8)</code>: Text to identify the cross-section property</li>
<li><code>NFT01: integer &gt;= 2</code>: Number of points in <img class="formulaInl" alt="$ \mathrm{C_e(} \hat{f} \mathrm{, \frac{A}{D})}$" src="form_30.png"/> curve specification.</li>
</ul>
<p>Excitation coefficient as a function of non-dimensional frequency and response amplitude, <code>NFT01</code> input lines</p>
<div class="fragment"><div class="line">FHAT ACL0 ACLMAX CLMAX CLA0</div>
</div><!-- fragment --><ul>
<li><code>FHAT: real</code>: Non-dimensional frequency</li>
<li><code>ACL0: real</code>: <img class="formulaInl" alt="$ \mathrm{ \frac{A}{D}} $" src="form_31.png"/> ratio for when <img class="formulaInl" alt="$ \mathrm{C_e } $" src="form_32.png"/> <code>= 0</code></li>
<li><code>ACLMAX: real</code>: <img class="formulaInl" alt="$ \mathrm{ \frac{A}{D}} $" src="form_31.png"/> ratio for when <img class="formulaInl" alt="$ \mathrm{C_e}$" src="form_33.png"/> <code>=</code> <img class="formulaInl" alt="$ \mathrm{ C_{emax}} $" src="form_34.png"/></li>
<li><code>CLMAX: real</code>: Maximum excitation coefficient</li>
<li><code>CLA0: real</code>: Excitation coefficient for <img class="formulaInl" alt="$ \mathrm{ \frac{A}{D} } $" src="form_35.png"/> <code>= 0</code></li>
</ul>
<p>The definition of these four parameters is shown in a figure in the Theory Manual, Section Excitation Force Model, Default excitation coefficient model, CF.</p>
<h4>Specification of table format excitation coefficient data set (Type 2). The input data described in the following is to be specified for <code>NLCT02</code> excitation coefficient data sets</h4>
<div class="fragment"><div class="line">IPRONO CPRPID NFT02</div>
</div><!-- fragment --><ul>
<li><code>IPRONO: integer</code>: Cross-section property specification number for property type <em>Excitation coefficient property</em>.</li>
<li><code>CPRPID: character(8)</code>: Text to identify the cross-section property</li>
<li><code>NFT02: integer &gt;= 2</code>: Number of non-dimensional frequencies for which an excitation coefficient curve is specified for this data set.</li>
</ul>
<p>Specification of table format excitation coefficient curves (Type 2). The input data described in the following is to be specified for <code>NFT02</code> excitation coefficient curves.</p>
<div class="fragment"><div class="line">FHTYP2 NPOINT</div>
</div><!-- fragment --><ul>
<li><code>FHTYP2: real</code>: Non-dimensional frequency.</li>
<li><code>NPOINT: integer &gt;= 2</code>: Number of data points for <code>FHTYP2</code></li>
</ul>
<p>Excitation coefficient as a function of <img class="formulaInl" alt="$ \mathrm{ \frac{A}{D}} $" src="form_31.png"/> for <code>FHTYP02</code>, <code>NPOINT</code> inputlines</p>
<div class="fragment"><div class="line">AD CL</div>
</div><!-- fragment --><ul>
<li><code>AD: real</code>: Amplitude to diameter ratio.</li>
<li><code>CL: real</code>: Excitation coefficient</li>
</ul>
<p><code>AD</code> and <code>FHTYP2</code> must be given in either increasing or decreasing order.</p>
<p>It is crucial for the analysis that the data covers to complete <img class="formulaInl" alt="$ \mathrm{ \frac{A}{D}} $" src="form_31.png"/> -ratio range. That means that the minimum <img class="formulaInl" alt="$ \mathrm{ \frac{A}{D}} $" src="form_31.png"/> -ratio should be zero and the maximum value approximately 2.</p>
<p>It is recommended that all extrapolation be done outside of <code>VIVANA</code>.</p>
<p>If the excitation curves are used to model sections covered with VIV suppression devices, one should note that:</p>
<ul>
<li>The theoretical model can cover cases with up to approximately 75% coverage of VIV suppression devices. For these cases the bare riser controls the VIV behaviour (frequency, mode etc.)</li>
<li>For larger coverages the straked riser takes control of the VIV behaviour. Model tests indicate a different physical behaviour than for the bare controlled riser. The behaviour seems to be dependent on pitch and height of the strakes. The responding frequencies and modes are generally lower.</li>
</ul>
<h2><a class="anchor" id="um_input_specification_damping"></a>
Damping factor properties</h2>
<h4>Specification of damping factors</h4>
<div class="fragment"><div class="line">PROPerty DAMPing FACTors</div>
</div><!-- fragment --><h4>Number of damping factors specified</h4>
<div class="fragment"><div class="line">NDPFAC01 NDPFAC02</div>
</div><!-- fragment --><ul>
<li><code>NDPFAC01: integer</code>: Number of damping factor sets for various sections of the structure relative to Venugopal.</li>
<li><code>NDPFAC02: integer, default: 0</code>: Number of damping factor sets for various sections of the structure using user defined excitation curves in table format.</li>
</ul>
<h4>Specification of damping factor sets for various sections of the structure, NDPFAC01 input lines.</h4>
<div class="fragment"><div class="line">IPRONO CPRPID FSTILL FLOWV FHIGHV</div>
</div><!-- fragment --><ul>
<li><code>IPRONO: integer</code>: Cross-section property specification number for property type <em>Damping factor properties</em>.</li>
<li><code>CPRPID: character(8)</code>: Text to identify the cross-section property</li>
<li><code>FSTILL: real, default: 1</code>: Factor Venugopal still water damping contribution, <img class="formulaInl" alt="$ \mathrm{R_{s \alpha}}$" src="form_36.png"/>.</li>
<li><code>FLOWV: real, default: 1</code>: Factor Venugopal low velocity region.</li>
<li><code>FHIGHV: real, default: 1</code>: Factor Venugopal high velocity region.</li>
</ul>
<h4>Specification of damping factor for various sections of the structure, NDPFAC02 input lines.</h4>
<div class="fragment"><div class="line">IPRONO CPRPID FSTILL</div>
</div><!-- fragment --><ul>
<li><code>IPRONO: integer</code>: Cross-section property specification number for property type <em>Damping factor properties</em>.</li>
<li><code>CPRPID: character(8)</code>: Text to identify the cross-section property</li>
<li><code>FSTILL: real, default: 1</code>: Still water damping factor</li>
</ul>
<p>If a section has damping defined as <code>NDPFAC02</code>, the section <em>must</em> have excitation coefficients given on table format.</p>
<p>The still water damping coefficient is calculated using the empirical formulae</p>
<p><img class="formulaInl" alt="$c_{sw} = \frac{\omega \pi \rho D^2}{2} \left( 1 + \left(\frac{A}{D} \right)^2 \right) F_{still} $" src="form_37.png"/></p>
<p>The value of <img class="formulaInl" alt="$F_{still}$" src="form_38.png"/> must be found using curve fitting of the data points <img class="formulaInl" alt="$c_{sw}$" src="form_39.png"/> as a function of the <img class="formulaInl" alt="$ \mathrm{\frac{A_{}}{D}}$" src="form_40.png"/>-ratio. These data points can be found from still water decay tests.</p>
<h2><a class="anchor" id="um_input_specification_strouhal"></a>
Strouhal number properties</h2>
<div class="fragment"><div class="line">PROPerty STROuhal SPECification</div>
</div><!-- fragment --><p>The user may allow the program to calculate local Strouhal number for an element as a function of the Reynolds number. The program then interpolates in a user defined <img class="formulaInl" alt="$\mathrm{ S_t (Re) }$" src="form_41.png"/> curve if given, or in a default <img class="formulaInl" alt="$\mathrm{ S_t (Re) }$" src="form_41.png"/> curve.</p>
<p>Alternatively, the user may specify a constant Strouhal number for all the elements in a segment. This is done by specifying <code>STROU</code>. <code>STROU</code> will then be used as the Strouhal number for all the elements in the segment.</p>
<div class="fragment"><div class="line">NSTRSP</div>
</div><!-- fragment --><ul>
<li><code>NSTRSP: integer</code>: Number of Strouhal number sets specified in this data group.</li>
</ul>
<h4>Specification of Strouhal number sets, NSTRSP data sets.</h4>
<div class="fragment"><div class="line">IPRONO CPRPID NPUDSC STROU</div>
</div><!-- fragment --><ul>
<li><code>IPRONO: integer</code>: Cross-section property specification number for property type <em>Strouhal number properties</em>.</li>
<li><code>CPRPID: character(8)</code>: Text to identify the cross-section property</li>
<li><code>NPUDSC: integer, default: 0</code>: Number of points in user defined Strouhal-Reynolds number curve.<ul>
<li><code>NPUDSC &lt; 0</code>: Default curve will be used</li>
<li><code>NPUDSC = 0</code>: Constant Strouhal number</li>
<li><code>NPUDSC &gt; 0</code>: User defined curve will be used</li>
</ul>
</li>
<li><code>STROU: real, default: 0.19</code>: Fixed Strouhal number<ul>
<li>Dummy for <code>NPUDSC</code> <img class="formulaInl" alt="$ \neq $" src="form_20.png"/> <code>0</code></li>
</ul>
</li>
</ul>
<h4>User defined curve giving the relationship between Strouhal number and Reynolds number, NPUDSC input lines.</h4>
<div class="fragment"><div class="line">REYNUM STRNUM</div>
</div><!-- fragment --><ul>
<li><code>REYNUM: real</code>: Reynolds number</li>
<li><code>STRNUM: real</code>: Strouhal number</li>
</ul>
<p>Reynolds numbers must be given in increasing order.</p>
<h1><a class="anchor" id="um_input_viv_response"></a>
VIV response analysis</h1>
<h4>Data group identifier, one input line</h4>
<div class="fragment"><div class="line">RESPonse ANALysis PARAmeters</div>
</div><!-- fragment --><h4>Response parameters, one input line</h4>
<div class="fragment"><div class="line">RELDAM IOPFRC IPRINT</div>
</div><!-- fragment --><ul>
<li><code>RELDAM: real, default: 0</code>: Relative structural damping<ul>
<li><code>RELDAM = 0.1</code> gives 10% relative damping.</li>
</ul>
</li>
<li><code>IOPFRC: integer, default: 1</code>: Force switch<ul>
<li><code>IOPFRC = 0</code>: Forces calculated using stiffness matrix</li>
<li><code>IOPFRC = 1</code>: Forces calculated using curvature and axial strain. This option requires that the axial and bending stiffness is linear for all elements.</li>
</ul>
</li>
<li><code>IPRINT: integer, default: 1</code>: Print switch<ul>
<li><code>IPRINT = 1</code>: Final results are printed to Matrix Plot file</li>
<li><code>IPRINT = 2</code>: Final results, results from the final iteration and axial force and bending moments are printed to Matrix Plot file</li>
<li><code>IPRINT = 5</code>: Final results, detailed results from all iterations and axial force and bending moments are printed to Matrix Plot file.</li>
</ul>
</li>
</ul>
<h4>Response parameters, one input line</h4>
<div class="fragment"><div class="line">IFRIT MAX_ITER CHILIM CONLIM SCAINI</div>
</div><!-- fragment --><ul>
<li><code>IFRIT: integer, default: 2</code>: Response iteration method<ul>
<li><code>IFRIT = 1</code>: Fixed point</li>
<li><code>IFRIT = 2</code>: Newton - Raphson</li>
</ul>
</li>
<li><code>MAX_ITER: integer, default: 30</code>: Maximum number of iterations</li>
<li><code>CHILIM: character(6), default: AMPNOR</code>: Convergence criterion<ul>
<li><code>CHILIM = AMPNOR</code>: Norm of amplitude change for translations</li>
<li><code>CHILIM = DIFMAX</code>: Maximum difference</li>
<li><code>CHILIM = NONE</code>: No convergency test. <code>MAX_ITER</code> iterations will be performed.</li>
<li><code>CHILIM = 5</code>: As <code>AMPNOR</code>, Norm of amplitude change for translations</li>
<li><code>CHILIM = 3</code>: As <code>DIFMAX</code>, Maximum difference</li>
<li><code>CHILIM = 0</code>: As <code>NONE</code>, No convergency test</li>
<li><code>CHILIM = 1</code>: Quadratic norm. Not recommended.</li>
<li><code>CHILIM = 2</code>: Relative maximum difference. Not recommended.</li>
<li><code>CHILIM = 4</code>: Unbalanced force. Not recommended.</li>
</ul>
</li>
<li><code>CONLIM: real, default: 0.0001</code>: Convergence limit for the iteration<ul>
<li><code>CHILIM = NONE</code> or <code>0</code>: Dummy</li>
<li><code>CHILIM = DIFMAX</code> or <code>3</code>: Dimension <img class="formulaInl" alt="$ \mathrm{[L]}$" src="form_42.png"/></li>
<li>All other values of <code>CHILIM</code>: Nondinemsional</li>
</ul>
</li>
<li><code>SCAINI: real, default: 0.5</code>: Scaling factor for the initial response estimate<ul>
<li><code>SCAINI = 0</code>: Scale initial response estimate based on the average <img class="formulaInl" alt="$ \mathrm{ \frac{A}{D} }$" src="form_43.png"/> for zero excitation in the excitation zone</li>
<li><code>SCAINI &gt; 0</code>: Scale initial response estimate so that the maximum amplitude is <img class="formulaInl" alt="$ \mathrm{SCAINI * D_{avg}}$" src="form_44.png"/>.</li>
</ul>
</li>
</ul>
<h4>Response parameters, one input line</h4>
<div class="fragment"><div class="line">IOPTSH NUDDF ADLIM REXPAL REXPAH</div>
</div><!-- fragment --><ul>
<li><code>IOPTSH: integer, default: 0</code>: Option for combining response frequencies<ul>
<li><code>IOPTSH = 0</code>: Response frequencies act concurrently</li>
<li><code>IOPTSH = 1</code>: Response frequencies act consecutively, i.e. time sharing</li>
</ul>
</li>
<li><code>NUDDF: integer, default: 0</code>: Number of dominating frequencies given in user defined frequency ranking. Not used for <code>IOPTSH = 1</code>.</li>
<li><code>ADLIM: real, default: 0.01</code>: Amplitude limit for including frequency frequency. normalized by the minimum diameter <img class="formulaInl" alt="$ \mathrm{[1]}$" src="form_45.png"/>.</li>
<li><code>REXPAL: real, default: 0</code>: Cut-off excitation parameter ration for frequencies below the identified dominating frequency <img class="formulaInl" alt="$ \mathrm{[1]}$" src="form_45.png"/>.</li>
<li><code>REXPAH: real, default: 0</code>: Cut-off excitation parameter ration for frequencies above the identified dominating frequency <img class="formulaInl" alt="$ \mathrm{[1]}$" src="form_45.png"/>.</li>
</ul>
<p>Analysis of frequency content in time series from VIV experiments with high response frequencies shows that the response process is often somewhere between concurrent and consecutive. The response frequency at a location shifts between different consecutive values. However, other frequencies often dominate at other locations. Further work is needed before firm recommendations may be given.</p>
<p>For cylinders with constant diameter in linearly sheared flow the values <code>REXPAL = 0.2</code> and <code>REXPAH = 1.0</code> agree well with experiments.</p>
<h4>User defined frequency ranking, NUDDF input lines</h4>
<div class="fragment"><div class="line">IDOMFRQ</div>
</div><!-- fragment --><ul>
<li><code>IDOMFRQ: integer</code>: Frequency number</li>
</ul>
<p>The most dominating frequency is to be specified first, then the second most dominating frequency is specified etc.</p>
<p>If <code>NUDDF = 0</code> the program will give the possible response frequencies a ranking according to an excitation parameter for each frequency.</p>
<p><img class="formulaInl" alt="$ \mathrm{E_i = \sum\limits_{j=1}^{N_{Ex}} l_j \, D_j^2 \, u_j^2 \left( \frac{A}{D} \right)_{C_e = 0, \,j} }$" src="form_46.png"/></p>
<p>where</p>
<ul>
<li><img class="formulaInl" alt="$ \mathrm{E_i} $" src="form_47.png"/> is the excitation parameter for frequency i.</li>
<li><img class="formulaInl" alt="$ \mathrm{l_j }$" src="form_48.png"/> is the length of element j within the excitation zone.</li>
<li><img class="formulaInl" alt="$ \mathrm{D_j }$" src="form_49.png"/> is the diameter of element j.</li>
<li><img class="formulaInl" alt="$ \mathrm{u_j }$" src="form_50.png"/> is the flow velocity at the midpoint of element j.</li>
<li><img class="formulaInl" alt="$ \mathrm{N_{Ex} }$" src="form_51.png"/> is the number of elements in the excitation zone.</li>
<li><img class="formulaInl" alt="$ \mathrm{\left( \frac{A}{D} \right)_{C_e = 0, \,j} }$" src="form_52.png"/> is the normalised response amplitude that give <img class="formulaInl" alt="$ \mathrm{C_e = 0 }$" src="form_53.png"/>, given as a function of the local value of <img class="formulaInl" alt="$ \hat{f} $" src="form_28.png"/> for frequency i.</li>
</ul>
<h1><a class="anchor" id="um_input_viv_fatigue"></a>
VIV fatigue analysis</h1>
<h4>Data group identifier, one input line</h4>
<div class="fragment"><div class="line">VIVResponse FATIgue DAMAge</div>
</div><!-- fragment --><h4>Control data, one input line</h4>
<div class="fragment"><div class="line">IOPFAT NSECT NPCS IOPPR TSIOPPR CHTSPRN</div>
</div><!-- fragment --><ul>
<li><code>IOPFAT: integer, default: 0</code>: Option for fatigue calculation<ul>
<li><code>IOPFAT = 0</code>: Determined by parameter <code>IOPTSH</code> in <a class="el" href="a00012.html#um_input_viv_response">VIV response analysis</a>.<ul>
<li>For <code>IOPTSH = 0</code>, concurrent response frequencies, the default is 1.</li>
<li>For <code>IOPTSH = 1</code>, consecutive response frequencies, the default is 2.</li>
</ul>
</li>
<li><code>IOPFAT = 1</code>: Fatigue calculated in time domain using rain-flow counting.<ul>
<li>Currently not available for <code>IOPTSH = 1</code>.</li>
</ul>
</li>
<li><code>IOPFAT = 2</code>: Fatigue calculated in frequency domain using Rayleigh distributed stress cycles.<ul>
<li>Currently not available for <code>IOPTSH = 0</code>.</li>
<li>May only be used for SN curves with a single straight line.</li>
</ul>
</li>
<li><code>IOPFAT = 3</code>: Fatigue calculated directly from constant stress amplitude.<ul>
<li>Not available for <code>IRSTYP = 3</code> or <code>IOPTSH = 0</code> and multiple response frequencies.</li>
</ul>
</li>
</ul>
</li>
<li><code>NSECT: integer, default: 0</code>: Number of cross-sections to be analysed<ul>
<li><code>NSECT = 0</code>: All elements</li>
<li><code>NSECT &gt; 0</code>: Specified elements. Additional data is given in the end of this subsection. Not allowed for <code>IOPFAT = 2</code>, fatigue calculated in frequency domain.</li>
</ul>
</li>
<li><code>NPCS: integer, default: 8</code>: Number of points around cross-section where fatigue is calculated, <code>1 &lt;= NPCS &lt;= 16</code>, see <a class="el" href="a00012.html#um_fatigue_points">Illustration of points around the cross-section</a>. For definition of local axis, see <a class="el" href="a00014.html#um_references_riflex_user">RIFLEX User Manual</a>.</li>
<li><code>IOPPR: integer, default: 0</code>: Print option for fatigue results<ul>
<li><code>IOPPR = 0</code>: Print results only for most critical point in the cross-section</li>
<li><code>IOPPR &gt; 0</code>: Print results for all <code>NPCS</code> points</li>
</ul>
</li>
<li><code>TSIOPPR: integer, default: 0</code>: Time series print switch. Dummy if <code>IOPTSH = 1</code>.<ul>
<li><code>TSIOPPR = 0</code>: No print of tension, y- and z- curvature time series to file</li>
<li><code>TSIOPPR = 1</code>: Print of tension, y- and z- curvature time series to file</li>
<li><code>TSIOPPR = -1</code>: Print of tension, y- and z- curvature time series to file, skip fatigue calculation.</li>
</ul>
</li>
<li><code>CHTSPRN: character(256)</code>: Time series file name</li>
</ul>
<p>Tension and curvature time series are printed for the <code>NSECT</code> specified elements or for all elements if <code>NSECT = 0</code>. The format of the time series file is given in <a class="el" href="a00018.html#um_appendix_b">Appendix B: Format of Time Series File</a>.</p>
<p>Note that the two input lines of subsection SN curve data must be given below even if <code>NSECT &gt; 0</code>.</p>
<h4>Stress time series data, one input line. Given if <code>IOPFAT = 0</code> or <code>IOPFAT = 1</code>.</h4>
<div class="fragment"><div class="line">TSLEN DT IRSNO</div>
</div><!-- fragment --><ul>
<li><code>TSLEN: real, default: 0</code>: Length of stress time series to be generated for fatigue calculation <img class="formulaInl" alt="$ \mathrm{[T]}$" src="form_54.png"/>.<ul>
<li>Minimum length is 60.</li>
</ul>
</li>
<li><code>DT: real, default: 0</code>: Time step to be used in the stress time series <img class="formulaInl" alt="$ \mathrm{[T]}$" src="form_54.png"/>.</li>
<li><code>IRSNO: integer, default: 31415</code>: Seed for generating random phase angles.</li>
</ul>
<p>The time unit is usually seconds.</p>
<p>A warning will be written if the user specifies a time step DT which is larger than <img class="formulaInl" alt="$ \mathrm{\frac{2 \pi}{\omega_{max} \times 20}}$" src="form_55.png"/>, wheer <img class="formulaInl" alt="$ \mathrm{\omega_{max}}$" src="form_56.png"/> is the largest of the discrete response frequencies.</p>
<p>If default <code>TSLEN</code> and <code>DT</code> are used, <code>TSLEN</code> and <code>DT</code> are calculated by <code>VIVANA</code>.</p>
<h4>Cross-sectional data, one input line</h4>
<div class="fragment"><div class="line">DSCFA DSCFY DSCFZ ASI WSTI THI RFACT</div>
</div><!-- fragment --><ul>
<li><code>DSCFA: real, default: 1</code>: Default stress concentration factor for axial force contribution.</li>
<li><code>DSCFY: real, default: 1</code>: Default stress concentration factor for bending about Yaxis.</li>
<li><code>DSCFZ: real, default: 1</code>: Default stress concentration factor for bending about Zaxis.</li>
<li><code>ASI: real, default: 0</code>: Optional cross-section area.<ul>
<li><code>= 0.0</code>: Use the values specified in or derived from the cross section properties given in <code>INPMOD</code></li>
</ul>
</li>
<li><code>WSTI: real, default: 0</code>: Optional section modulus.<ul>
<li><code>= 0.0</code>: Use the values specified in or derived from the cross section properties given in <code>INPMOD</code></li>
</ul>
</li>
<li><code>THI: real, default: 0</code>: Optional wall thickness.<ul>
<li><code>= 0.0</code>: Use the values specified in or derived from the cross section properties given in <code>INPMOD</code></li>
</ul>
</li>
<li><code>RFACT: real, default: 0.001</code>: Factor between the stress unit <img class="formulaInl" alt="$ \mathrm{[S]}$" src="form_57.png"/> used to define the SN curve and the force and length units <img class="formulaInl" alt="$ \mathrm{[F]}$" src="form_58.png"/> and <img class="formulaInl" alt="$ \mathrm{[L]}$" src="form_42.png"/> chosen in <code>INPMOD</code>.<ul>
<li><img class="formulaInl" alt="$ \mathrm{S \times RFACT = \frac{F}{L^2} } $" src="form_59.png"/></li>
</ul>
</li>
</ul>
<p>If <img class="formulaInl" alt="$ \mathrm{kN}$" src="form_0.png"/> and <img class="formulaInl" alt="$ \mathrm{m}$" src="form_2.png"/> were chosen as force and length units while the SN curve is given in <img class="formulaInl" alt="$ \mathrm{MPa}$" src="form_60.png"/>, <code>RFACT</code> should be set to <code>0.001</code>.</p>
<p>If the SI units <img class="formulaInl" alt="$ \mathrm{N}$" src="form_61.png"/> and <img class="formulaInl" alt="$ \mathrm{m}$" src="form_2.png"/> were chosen for force and length and the SN curve is in <img class="formulaInl" alt="$ \mathrm{MPa}$" src="form_60.png"/>, <code>RFACT</code> should be set to <code>1.0E-6</code>.</p>
<p>Note that the stress concentration factors are included in the reported stress distributions.</p>
<h4>SN curve data, two input lines</h4>
<div class="fragment"><div class="line">NSNCRV RELDUR</div>
</div><!-- fragment --><ul>
<li><code>NSNCRV: integer &gt; 0</code>: Number of selected SN curves</li>
<li><code>RELDUR</code>: real, default: 0.0<code>: Relative duration / probability of the current condition.</code>0.0 &lt;= RELDUR &lt;= 1.0<code>. If</code>RELDUR &gt; 0.0<code>, the fatigue damage contributions, the calculated fatigue damage scaled by</code>RELDUR<code>, will be written to the</code>_vivana.mpf` file.</li>
</ul>
<div class="fragment"><div class="line">CHIDSNi...CHIDSNnsncrv</div>
</div><!-- fragment --><ul>
<li><code>CHIDSNi: character(6)</code>: Identification of selected SN curve i, i = 1, ...,<code>NSNCRV</code></li>
</ul>
<h4>Cross-section specification, NSECT input lines.</h4>
<div class="fragment"><div class="line">CHILIN ISEG IEL IEND SCFA SCFY SCFZ</div>
</div><!-- fragment --><ul>
<li><code>CHILIN: character(8)</code>: Line identifier</li>
<li><code>ISEG: integer</code>: Segment number on line.</li>
<li><code>IEL: integer</code>: Local element number on specified segment.</li>
<li><code>IEND: integer</code>:<ul>
<li><code>IEND = 1</code>: Cross-section at end with smallest node number checked.</li>
<li><code>IEND = 2</code>: Cross-section at end with largest node number checked.</li>
</ul>
</li>
<li><code>SCFA: real, default: DSCFA</code>: Stress concentration factor for axial force contribution.</li>
<li><code>SCFY: real, default: DSCFY</code>: Stress concentration factor for bending about Yaxis.</li>
<li><code>SCFZ: real, default: DSCFZ</code>: Stress concentration factor for bending about Zaxis.</li>
</ul>
<p>If SCFs are given several times for the one element, the last one given is used.</p>
<p>Note that the stress concentration factors are included in the reported stress distributions.</p>
<h4>SN curve properties</h4>
<div class="fragment"><div class="line">NOFC</div>
</div><!-- fragment --><ul>
<li><code>NOFC: integer</code>: Number of SN curves</li>
</ul>
<h4>SN curve, 2xNOFC input lines</h4>
<div class="fragment"><div class="line">CHIDSN NOSL LIMIND FATLIM TREF KEXP</div>
</div><!-- fragment --><ul>
<li><code>CHIDSN: character(6)</code>: Identification of SN curve</li>
<li><code>NOSL: integer &lt;= 5</code>: Number of straight lines defining the SN curve.</li>
<li><code>LIMIND: integer, default: 0</code>: Fatigue limit indicator<ul>
<li><code>LIMIND &lt; 0</code>: Fatigue limit in terms of stress cycles is specified.</li>
<li><code>LIMIND = 0</code>: No fatigue limit.</li>
<li><code>LIMIND &gt; 0</code>: Fatigue limit in terms of stress range is specified.</li>
</ul>
</li>
<li><code>FATLIM: real, default: 0</code>: Fatigue limit, interpretation dependent on <code>LIMIND</code>.<ul>
<li><code>LIMIND &lt; 0</code>: Logarithm of number of stress cycles for which the SN curve becomes horizontal.</li>
<li><code>LIMIND = 0</code>: <code>FATLIM</code> is dummy.</li>
<li><code>LIMIND &gt; 0</code>: Stress range level for which the SN curve becomes horizonal.</li>
</ul>
</li>
<li><code>TREF: real, default: 0</code>: Reference thickness for thickness correction</li>
<li><code>KEXP: real, default: 0</code>: Exponent for thickness correction</li>
</ul>
<p>If <code>TREF</code> is set equal to <code>0</code> the thickness correction will be omitted.</p>
<h4>Fatigue capacity curve constants</h4>
<div class="fragment"><div class="line">RM1 RC1 RMi RNCi</div>
</div><!-- fragment --><ul>
<li><code>RM1: real</code>: Slope of the SN curve.<ul>
<li>First curve segment for <code>NOSL &gt; 1</code></li>
<li>Total curve for <code>NOSL = 1</code>.</li>
</ul>
</li>
<li><code>RC1: real</code>: Constant defining the SN curve. First segment or total curve.</li>
<li><code>RMi: real</code>: Slope of curve segment i, i = 2, ..., <code>NOSL</code></li>
<li><code>RNCi: real</code>: Transition point between curve segment (i-1), and i, i = 2, ..., <code>NOSL</code>.<ul>
<li>The transition point is given as the logaritmic value, see <a class="el" href="a00012.html#um_fatigue_curve_input">Illustration of input data for fatigue capacity curve definition</a>.</li>
</ul>
</li>
</ul>
<p><a class="anchor" id="um_fatigue_points"></a></p>
<div class="image">
<img src="um_fatigue_points.svg" alt="um_fatigue_points.svg"/>
<div class="caption">
Illustration of points around the cross-section where fatigue is calculated.</div></div>
<p><a class="anchor" id="um_fatigue_curve_input"></a></p>
<div class="image">
<img src="um_fatigue_curve_input.svg" alt="um_fatigue_curve_input.svg"/>
<div class="caption">
Illustration of input data for fatigue capacity curve definition.</div></div>
<p>The SN curves defined by the input parameters are always assumed to relate the stress range, <img class="formulaInl" alt="$ \mathrm{\Delta S} $" src="form_62.png"/>, to the number of cycles before failure, N.</p>
<p>A straight-lined SN curve in log-log scale is in general defined as</p>
<p><img class="formulaInl" alt="$ N = C \times \left( \Delta S \left( \frac{t}{t_{ref}} \right) ^k \right) ^m_{}$" src="form_63.png"/></p>
<p>or</p>
<p><img class="formulaInl" alt="$ \log N = \log C + m \log \left( \Delta S \left( \frac{t}{t_{ref}} \right) ^k \right)_{}$" src="form_64.png"/></p>
<p>where:</p>
<ul>
<li><img class="formulaInl" alt="$N$" src="form_65.png"/>: Number of cycles to failure</li>
<li><img class="formulaInl" alt="$\Delta S$" src="form_66.png"/>: Stress range</li>
<li><img class="formulaInl" alt="$t$" src="form_67.png"/>: Cross section thickness</li>
<li><img class="formulaInl" alt="$t_{ref}$" src="form_68.png"/>: Reference thickness</li>
<li><img class="formulaInl" alt="$k_{}$" src="form_69.png"/>: Exponent for thickness correction</li>
</ul>
<p>The two input parameters used to define SN curves are directly found in the equation above, namely.</p>
<ul>
<li><img class="formulaInl" alt="$ RC = \log C \quad $" src="form_70.png"/> (always positive)</li>
<li><img class="formulaInl" alt="$ RM = m \quad \quad $" src="form_71.png"/> (always negative)</li>
</ul>
<p>If the user has a SN curve without having these parameters explicitly defined, they can be calculated as follows; see also <a class="el" href="a00012.html#um_SN_curve_calculation">Calculation of SN curve parameters</a>.</p>
<p><a class="anchor" id="um_SN_curve_calculation"></a></p>
<div class="image">
<img src="um_SN_curve_calculation.svg" alt="um_SN_curve_calculation.svg"/>
<div class="caption">
Calculation of SN curve parameters.</div></div>
<p>Using the two points A and B on <a class="el" href="a00012.html#um_SN_curve_calculation">Calculation of SN curve parameters</a> to define the straight line, we have</p>
<p><img class="formulaInl" alt="$ \log N = \frac{\log N_2 - \log N_1}{\log \Delta S_2 - \log \Delta S_1} \times \log \Delta S - \frac{\log N_2 - \log N_1}{\log \Delta S_2 - \log \Delta S_1} \times \log \Delta S_1 + \log N_1 $" src="form_72.png"/></p>
<p>Hence</p>
<p><img class="formulaInl" alt="$ RM = \frac{\log N_2 - \log N_1}{\log \Delta S_2 - \log \Delta S_1} \quad $" src="form_73.png"/> (always negative)</p>
<p><img class="formulaInl" alt="$ RC = - RM \times \log \Delta S_1 + \log N_1 \quad $" src="form_74.png"/> (always positive)</p>
<p>The relation between these parameters specified for different unit systems is easily found from the equations above.</p>
<h1><a class="anchor" id="um_input_vivana_print"></a>
VIVANA print flags</h1>
<h4>Data group identifier, one input line</h4>
<div class="fragment"><div class="line">VIVAna RESUlt PRINt</div>
</div><!-- fragment --><h4>Print flags, one input line</h4>
<div class="fragment"><div class="line">IPRELF IPRSTF IPRDRG IPRRSP IPRCNG</div>
</div><!-- fragment --><ul>
<li><code>IPRELF: integer, default: 1</code>: Print flag for printing local element forces to the <code>_vivana.res</code> file.<ul>
<li><code>IPRELF = 0</code>: No print</li>
<li><code>IPRELF = 1</code>: Print</li>
</ul>
</li>
<li><code>IPRSTR: integer, default: 1</code>: Print flag for printing local element stresses to the <code>_vivana.res</code> file.<ul>
<li>Interpreted as <code>IPRELF</code>.</li>
</ul>
</li>
<li><code>IPRDRG: integer, default: 1</code>: Print flag for printing drag amplification factor to the <code>_vivana.res</code> file.<ul>
<li>Interpreted as <code>IPRELF</code>.</li>
</ul>
</li>
<li><code>IPRRSP: integer, default: 1</code>: Print flag for printing VIV response (displacements) to the <code>_vivana.res</code> file.<ul>
<li>Intepreted as <code>IPRELF</code>.</li>
</ul>
</li>
<li><code>IPRCNG: integer, default: 1</code>: Print flag for printing convergence during the response analysis to the <code>_vivana.res</code> file.<ul>
<li>Interpreted as <code>IRRELF</code>.</li>
</ul>
</li>
</ul>
<h1><a class="anchor" id="um_input_vivana_mpf_print"></a>
VIVANA MPF print flags</h1>
<h4>Data group identifier, one input line</h4>
<div class="fragment"><div class="line">VIVAna RMPF PRINT</div>
</div><!-- fragment --><h4>Print flags, one input line</h4>
<div class="fragment"><div class="line">IPRCRV NSNAPP DTSNAP</div>
</div><!-- fragment --><ul>
<li><code>IPRCRV: integer, default: 0</code>: Print flag for printing curvature to the <code>_vivana.mpf</code> file.<ul>
<li><code>IPRCRV = 0</code>: No print</li>
<li><code>IPRCRV = 1</code>: Print</li>
</ul>
</li>
<li><code>NSNAPP: integer, default: -1</code>: Number of snapshpts to be printed on the <code>_vivana.mpf</code> file.<ul>
<li><code>NSTEP = 0</code>: No print of snapshots</li>
<li><code>MSTEP &lt; 0</code>: Default values will be used, see below.</li>
</ul>
</li>
<li><code>DTSNAP: real, default: 0</code>: Time step for print of snapshots<ul>
<li><code>DTSTEP &lt;= 0</code>: Default values will be used, see below.</li>
<li><code>DTSNAP &gt; 0</code>: Snapshots will be printed at <code>DTSNAP</code> intervals.</li>
</ul>
</li>
</ul>
<p>The default printing of snapshots depends on how response frequencies are combined, see input prameter <code>IOPTSH</code> in <a class="el" href="a00012.html#um_input_viv_response">VIV response analysis</a>. For concurrently acting frequencies, <code>IOPTSH = 0</code>, the default is 20 snapshots and the default time step for the snapshots is 1/20 th of the period of the highest ranking response frequency with significant response.</p>
<p>For consecutively acting frequencies, <code>IOPTSH = 1</code>, the default number of snapshots is <img class="formulaInl" alt="$ \mathrm{MAX(20,8*NFREQ\_SIGNRES)} $" src="form_75.png"/>, where <code>NFREQ_SIGNRES</code> is the number of response frequencies with significant response. Snapshots are allocated to the different response frequencies depending on their predicted relative durations, but with at least one snapshot per response frequency. The default time step will distribute the snapshots in each response period.</p>
<h1><a class="anchor" id="um_input_termination"></a>
Termination of input data</h1>
<h4>One input line</h4>
<div class="fragment"><div class="line">END</div>
</div><!-- fragment --> </div></div><!-- contents -->
	</body>
</html>