<?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">Description of Additional Input Files </div>  </div>
</div><!--header-->
<div class="contents">
<div class="toc"><h3>Table of Contents</h3>
<ul><li class="level1"><a href="#ug_description_body">Body type 4, Pre-scribed positions imported from file</a></li>
<li class="level1"><a href="#ug_description_external">External force time series imported from file</a></li>
<li class="level1"><a href="#vawt_intc_specification">Specification of internal control system for VAWT generator torque and electrical power</a><ul><li class="level2"><a href="#vawt_intc_specification_description">Description of internal control system for VAWT generator torque and electrical power</a></li>
<li class="level2"><a href="#vawt_cont_specification_input">Input description</a></li>
</ul>
</li>
</ul>
</div>
<div class="textblock"><h1><a class="anchor" id="ug_description_body"></a>
Body type 4, Pre-scribed positions imported from file</h1>
<p>The name of the time series file is specified in the system input file.</p>
<p>The time series file is an ASCII text file, with comments beginning with apostrophes in the first lines on the file. The data section of the file contains time and the 6 components of the position vector.</p>
<h3>File format:</h3>
<h4>File heading, arbitrary number of lines with apostrophe in the first position of the input line</h4>
<div class="fragment"><div class="line"><span class="stringliteral">&#39; TEXT-1</span></div>
<div class="line"><span class="stringliteral">&#39;</span> TEXT-2</div>
<div class="line"><span class="stringliteral">&#39; ......</span></div>
<div class="line"><span class="stringliteral">&#39;</span> TEXT-n</div>
</div><!-- fragment --><h4>1 input line</h4>
<div class="fragment"><div class="line">NCOL</div>
</div><!-- fragment --><ul>
<li><code>NCOL: integer, default: 6</code>: Number of columns (=6)</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">NROW</div>
</div><!-- fragment --><ul>
<li><code>NROW: integer</code>: Number of time incidents given on file</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">SAMP</div>
</div><!-- fragment --><ul>
<li><code>SAMP: real</code>: Sampling interval <img class="formulaInl" alt="$[T]$" src="form_70.png"/></li>
</ul>
<h4>Position, NROW lines (one per time incident)</h4>
<div class="fragment"><div class="line">XG  YG  ZG  PHI  THETA  PSI</div>
</div><!-- fragment --><ul>
<li><code>XG: real</code>: Global X-coordinate of body <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>YG: real</code>: Global Y-coordinate of body <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>ZG: real</code>: Global Z-coordinate of body <img class="formulaInl" alt="$[L]$" src="form_69.png"/></li>
<li><code>PHI: real</code>: Euler angle, rotation about x-axis <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
<li><code>THETA: real</code>: Euler angle, rotation about y-axis <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
<li><code>PSI: real</code>: Euler angle, rotation about z-axis <img class="formulaInl" alt="$ \mathrm{[deg]}$" src="form_81.png"/></li>
</ul>
<p>The applied rotational order is: <code>PSI -&gt; THETA -&gt; PHI</code></p>
<h4>Example:</h4>
<div class="fragment"><div class="line"><span class="stringliteral">&#39;text</span></div>
<div class="line"><span class="stringliteral">&#39;</span>text</div>
<div class="line"> 6            <span class="stringliteral">&#39;Number of columns</span></div>
<div class="line"><span class="stringliteral"> 1000         &#39;</span>Number of time steps</div>
<div class="line">  1.0         <span class="stringliteral">&#39;Time step</span></div>
<div class="line"><span class="stringliteral">  XG1  YG1  ZG1  PHI1  THETA1  PSI1</span></div>
<div class="line"><span class="stringliteral">  XG2  YG2  ZG2  PHI2  THETA2  PSI2</span></div>
<div class="line"><span class="stringliteral"> ....</span></div>
</div><!-- fragment --><h1><a class="anchor" id="ug_description_external"></a>
External force time series imported from file</h1>
<p>The name of the time series file is specified in the system input file.</p>
<p>The time series file is an ASCII text file, with comments beginning with apostrophes in the first lines on the file. The data section of the file contains time and the 6 components of the position vector.</p>
<h3>File format:</h3>
<h4>File heading, arbitrary number of lines with apostrophe in the first position of the input line</h4>
<div class="fragment"><div class="line"><span class="stringliteral">&#39; TEXT-1</span></div>
<div class="line"><span class="stringliteral">&#39;</span> TEXT-2</div>
<div class="line"><span class="stringliteral">&#39; ......</span></div>
<div class="line"><span class="stringliteral">&#39;</span> TEXT-n</div>
</div><!-- fragment --><h4>1 input line</h4>
<div class="fragment"><div class="line">NCOL</div>
</div><!-- fragment --><ul>
<li><code>NCOL: integer</code>: Number of columns (=6)</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">NROW</div>
</div><!-- fragment --><ul>
<li><code>NROW: integer</code>: Number of rows (i.e. no. of time incidents)</li>
</ul>
<h4>1 input line</h4>
<div class="fragment"><div class="line">SAMP</div>
</div><!-- fragment --><ul>
<li><code>SAMP: real</code>: Sampling interval <img class="formulaInl" alt="$[T]$" src="form_70.png"/></li>
</ul>
<h4>Force components, NROW lines (one per time incident)</h4>
<div class="fragment"><div class="line">FX   FY   FZ   MX   MY   MZ</div>
</div><!-- fragment --><ul>
<li><code>FX: real, default: 0</code>: Force in X-direction, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>FY: real, default: 0</code>: Force in Y-direction, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>FZ: real, default: 0</code>: Force in Z-direction, <img class="formulaInl" alt="$[F]$" src="form_148.png"/></li>
<li><code>MX: real, default: 0</code>: Moment about X-axis, <img class="formulaInl" alt="$[FL]$" src="form_154.png"/></li>
<li><code>MY: real, default: 0</code>: Moment about Y-axis, <img class="formulaInl" alt="$[FL]$" src="form_154.png"/></li>
<li><code>MZ: real, default: 0</code>: Moment about Z-axis, <img class="formulaInl" alt="$[FL]$" src="form_154.png"/></li>
</ul>
<h3>Example:</h3>
<div class="fragment"><div class="line"><span class="stringliteral">&#39;text</span></div>
<div class="line"><span class="stringliteral">&#39;</span>text</div>
<div class="line">6                    <span class="stringliteral">&#39; Number of columns</span></div>
<div class="line"><span class="stringliteral">1000                 &#39;</span> Number of time steps</div>
<div class="line">1.0                  <span class="stringliteral">&#39; Time step</span></div>
<div class="line"><span class="stringliteral">F1     F2   F3   M1   M2   M3</span></div>
<div class="line"><span class="stringliteral">F1     F2   F3   M1   M2   M3</span></div>
<div class="line"><span class="stringliteral">F1     F2   F3   M1   M2   M3</span></div>
</div><!-- fragment --><h1><a class="anchor" id="vawt_intc_specification"></a>
Specification of internal control system for VAWT generator torque and electrical power</h1>
<h2><a class="anchor" id="vawt_intc_specification_description"></a>
Description of internal control system for VAWT generator torque and electrical power</h2>
<p>The implemented generator torque control system includes start-up logic as well as operational logic. A PI controller for the generator torque is applied to achieve the desired rotor speed.</p>
<p>During the start-up period, the reference rotor speed is based on the rotor speed and the current time. The integral control parameter starts with a large value and is relaxed to the operational value after the start-up period.</p>
<p>After the start-up period, the reference rotor speed is based on the low-pass filtered wind speed.</p>
<h3>Control measurement filter</h3>
<p>The generator speed is the sole feedback input. A recursive, single-pole low-pass filter exponential smoothing to reduce the high frequency excitation of the control systems is provided. The discrete time recursion equation for this filter is</p>
<p><img class="formulaInl" alt="$ \mathrm{ \omega_{f.k} = \alpha \omega_{f.k-1} + (1 - \alpha) \omega_K }$" src="form_254.png"/></p>
<p>where</p>
<p><img class="formulaInl" alt="$ \mathrm{ \alpha = exp((-\Delta t)/(TC))}$" src="form_255.png"/></p>
<p>where <img class="formulaInl" alt="$ \mathrm{ \Delta t}$" src="form_256.png"/> is the discrete time step, <img class="formulaInl" alt="$ \mathrm{ TC}$" src="form_257.png"/> is the filter time constant, <img class="formulaInl" alt="$ \mathrm{ \alpha}$" src="form_258.png"/> is the low-pass filter coefficient <img class="formulaInl" alt="$ \mathrm{ \omega_f}$" src="form_259.png"/> is low pass filtered generator speed and <img class="formulaInl" alt="$ \mathrm{k }$" src="form_260.png"/> indicates the time step. The relation between the filter time constant and the cut off (corner) frequency <img class="formulaInl" alt="$ \mathrm{ f_C}$" src="form_261.png"/> is given by:</p>
<p><img class="formulaInl" alt="$ \mathrm{ TC = \frac{1}{2 \pi f_C}}$" src="form_262.png"/></p>
<h3>Generator torque controller</h3>
<p>The generator torque controller uses PI control to try to attain a specified reference speed. The reference speed is determined based on a look-up wind speed/rotor speed table, which is given as input or taken from the default table shown below. The low-pass filtered wind speed is used to determine the reference rotor speed at each time step. Linear interpolation is used in between the reference values.</p>
<h4>The default rotor speed/wind speed table</h4>
<table class="doxtable">
<tr>
<th>Wind speed </th><th>Reference rotor speed  </th></tr>
<tr>
<td><img class="formulaInl" alt="$ \mathrm{[m/s]}$" src="form_263.png"/> </td><td><img class="formulaInl" alt="$ \mathrm{[rad/s]}$" src="form_264.png"/> </td></tr>
<tr>
<td>3.0 </td><td>0.200 </td></tr>
<tr>
<td>8.0 </td><td>0.544 </td></tr>
<tr>
<td>23.0 </td><td>0.544 </td></tr>
<tr>
<td>35.0 </td><td>0.200 </td></tr>
</table>
<h4>PI control</h4>
<p>The PI controller determines the generator torque based on the proportional and integrated errors in rotor speed. The simple regulator algorithm is given by</p>
<p><img class="formulaInl" alt="$ \mathrm{R(t + \Delta t) = R(t) + \Delta \omega \Delta t }$" src="form_265.png"/></p>
<p><img class="formulaInl" alt="$ \mathrm{ Q = K_P \Delta \omega + K_I R (t + \Delta t) }$" src="form_266.png"/></p>
<p>where <img class="formulaInl" alt="$ \mathrm{\Delta t }$" src="form_267.png"/> is the regulator time step, <img class="formulaInl" alt="$ \mathrm{ \Delta \omega}$" src="form_268.png"/> is the rotor speed error, i.e. the difference between filtered rotor speed and rated rotor speed. <img class="formulaInl" alt="$ \mathrm{ R}$" src="form_269.png"/> is the accumulated time integrated speed error. <img class="formulaInl" alt="$ \mathrm{ Q}$" src="form_270.png"/> is the instructed/required generator torque.</p>
<p>The factor <img class="formulaInl" alt="$ \mathrm{\tau_i}$" src="form_271.png"/> is used to relate the proportional and integral gains.</p>
<p><img class="formulaInl" alt="$ \mathrm{K_I = K_P/\tau_i}$" src="form_272.png"/></p>
<p>During start-up, the value of <img class="formulaInl" alt="$ \mathrm{\tau_i}$" src="form_271.png"/> should be small. Therefore, an initial value, final value, and a time period for relaxing <img class="formulaInl" alt="$ \mathrm{\tau_i}$" src="form_271.png"/> are introduced. The relaxation period begins after the defined start-up period. The relaxation procedure is shown in the figure 'Illustration of relaxation of integral gain' below.</p>
<div class="image">
<img src="tau.svg" alt="tau.svg"/>
<div class="caption">
Illustration of relaxation of integral gain.</div></div>
<h4>Start-up</h4>
<p>During the specified start-up period, the reference rotor speed is first calculated based on the filtered wind speed and then a linear ramp factor is applied. The ramp factor is zero at the start of the simulation and increases to one at the end of the start-up period.</p>
<h3>Gain scheduling</h3>
<p>The optimal proportional and integrator gains may vary with rotor speed. At each step the gain will be corrected based on the present rotor speed. The user may specify a gain scheduling law or choose to apply the default law presented in the table 'The default gain scheduling law'. For intervening generator speeds, linear interpolation is used.</p>
<h4>The default gain scheduling law</h4>
<table class="doxtable">
<tr>
<th>Rotor speed </th><th>Correction Factor  </th></tr>
<tr>
<td><img class="formulaInl" alt="$ \mathrm{[rad/s]}$" src="form_264.png"/> </td><td><img class="formulaInl" alt="$ \mathrm{[1]}$" src="form_273.png"/> </td></tr>
<tr>
<td>0.00 </td><td>1.00 </td></tr>
<tr>
<td>0.55 </td><td>1.00 </td></tr>
<tr>
<td>0.60 </td><td>1.50 </td></tr>
<tr>
<td>1.00 </td><td>1.50 </td></tr>
</table>
<h2><a class="anchor" id="vawt_cont_specification_input"></a>
Input description</h2>
<h3>Controller Data, Generator, One input line</h3>
<div class="fragment"><div class="line">DTSAMP  TSTARTUP</div>
</div><!-- fragment --><ul>
<li><code>DTSAMP: real</code>: time interval for control actions <img class="formulaInl" alt="$ \mathrm{[T]}$" src="form_274.png"/></li>
<li><code>TSTARTUP: real</code>: Length of time for using start-up control logic <img class="formulaInl" alt="$ \mathrm{[T]}$" src="form_274.png"/></li>
</ul>
<h3>Controller Data, Generator One input line</h3>
<div class="fragment"><div class="line">TCOMEGA TCWIND WNFILT NOTCH_P2</div>
</div><!-- fragment --><ul>
<li><code>TCOMEGA: real</code>: Time constant for first order low pass filter for rotor speed, <img class="formulaInl" alt="$ \mathrm{TCOMEGA = 1/\omega}$" src="form_275.png"/> <img class="formulaInl" alt="$ \mathrm{[s/rad]}$" src="form_276.png"/></li>
<li><code>TCWIND: real</code>: Time constant for first order low pass filter for wind speed, <img class="formulaInl" alt="$ \mathrm{TCWIND = 1/\omega}$" src="form_277.png"/> <img class="formulaInl" alt="$ \mathrm{[s/rad]}$" src="form_276.png"/></li>
<li><code>WNFILT: real</code>: Radial frequency removed by notch filter. For <img class="formulaInl" alt="$ \mathrm{WNFILT}<0$" src="form_278.png"/>, no notch filter will be applied. <img class="formulaInl" alt="$ \mathrm{[rad/T]}$" src="form_279.png"/></li>
<li><code>NOTCH_P2: real</code>: Width parameter in notch filter</li>
</ul>
<h3>Engine Data, Generator, One input line</h3>
<div class="fragment"><div class="line">GBRATIO MAX_TRQ MAX_TRQRATE</div>
</div><!-- fragment --><ul>
<li><code>GBRATIO: real</code>: Gear box ratio (N rotations of high speed shaft for one rotation of the low speed shaft, I.e. generator versus rotor)</li>
<li><code>MAX_TRQ: real</code>: Rated generator torque <img class="formulaInl" alt="$ \mathrm{[FL]}$" src="form_280.png"/></li>
<li><code>MAX_TRQRATE: real</code>: Maximum generator torque <img class="formulaInl" alt="$ \mathrm{[FL/T]}$" src="form_281.png"/></li>
</ul>
<h3>Controller Data, Generator One input line</h3>
<div class="fragment"><div class="line">KP TAU_I_INIT, TAU_I_FINAL, T_RELAX</div>
</div><!-- fragment --><ul>
<li><code>KP: real</code>: Proportional gain (referred to high speed shaft) <img class="formulaInl" alt="$ \mathrm{[FLT/rad]}$" src="form_282.png"/></li>
<li><code>TAU_I_INIT: real</code>: Initial value of <img class="formulaInl" alt="$ \tau_i $" src="form_283.png"/>, <img class="formulaInl" alt="$ \mathrm{[T]}$" src="form_274.png"/></li>
<li><code>TAU_I_FINAL: real</code>: Final value of <img class="formulaInl" alt="$ \tau_i $" src="form_283.png"/>, <img class="formulaInl" alt="$ \mathrm{[T]}$" src="form_274.png"/></li>
<li><code>T_RELAX: real</code>: Time period for relaxing <img class="formulaInl" alt="$ \tau_i $" src="form_283.png"/> after the start-up period, <img class="formulaInl" alt="$ \mathrm{[T]}$" src="form_274.png"/></li>
</ul>
<h3>Engine Data, Generator actuator One input line</h3>
<div class="fragment"><div class="line">WINDROTSPEED GAINSCHEDULE</div>
</div><!-- fragment --><ul>
<li><code>WINDROTSPEED: character</code>: Wind speed/rotor speed table; Default or Tabulated<ul>
<li><code>= D</code>: Default</li>
<li><code>= T</code>: Tabulated</li>
</ul>
</li>
<li><code>GAINSCHEDULE: character</code>: Gain scheduling; Default or Tabulated<ul>
<li><code>= D</code>: Default</li>
<li><code>= T</code>: Tabulated</li>
</ul>
</li>
</ul>
<h3>Wind speed/rotor speed (WINDROTSPEED=T) One input line</h3>
<div class="fragment"><div class="line">WSNumber</div>
</div><!-- fragment --><ul>
<li><code>WSNumber: integer</code>: Number of points in wind speed/rotor speed table</li>
</ul>
<h3>Wind speed/rotor speed (WINDROTSPEED=T); Wind speed/rotor speed table. WSNumber input lines</h3>
<div class="fragment"><div class="line">WS OMEGA</div>
</div><!-- fragment --><ul>
<li><code>WS: real</code>: Wind speed at hub <img class="formulaInl" alt="$ \mathrm{[L/T]}$" src="form_284.png"/></li>
<li><code>OMEGA: real</code>: Rotor speed <img class="formulaInl" alt="$ \mathrm{[rad/T]}$" src="form_279.png"/></li>
</ul>
<h3>Gain scheduling (GAINSCHEDULE=T) One input line</h3>
<div class="fragment"><div class="line">GSNumber</div>
</div><!-- fragment --><ul>
<li><code>GSNumber: integer</code>: Number of points in gain scheduling table</li>
</ul>
<h3>Gain scheduling; Gain scheduling factors (GAINSCHEDULE=T). GSNumber input lines</h3>
<div class="fragment"><div class="line">OMEGA GF</div>
</div><!-- fragment --><ul>
<li><code>OMEGA: real</code>: Rotor speed <img class="formulaInl" alt="$ \mathrm{[rad/T]}$" src="form_279.png"/></li>
<li><code>GF: real</code>: Gain correction factor</li>
</ul>
<h3>Example input for control system</h3>
<div class="fragment"><div class="line"><span class="stringliteral">&#39;dtsamp  tstartup </span></div>
<div class="line"><span class="stringliteral">0.1   40</span></div>
<div class="line"><span class="stringliteral">&#39;</span> TComega TCwind wnfilt notch_p2</div>
<div class="line">0.6    47.75  1.02   0.05</div>
<div class="line"><span class="stringliteral">&#39; gbratio  max_trq max_trqrate</span></div>
<div class="line"><span class="stringliteral">100           150      15 </span></div>
<div class="line"><span class="stringliteral">&#39;</span> KP, tau_i_init, tau_i_final, t_relax</div>
<div class="line">0.04E6  15  120   120</div>
<div class="line"><span class="stringliteral">&#39; WindRotSpeed GainSchedule</span></div>
<div class="line"><span class="stringliteral">T        T    </span></div>
<div class="line"><span class="stringliteral">&#39;</span> number of points in speed-wind map</div>
<div class="line">4</div>
<div class="line"><span class="stringliteral">&#39; speed-wind map</span></div>
<div class="line"><span class="stringliteral">3 0.2</span></div>
<div class="line"><span class="stringliteral">8.0 0.544</span></div>
<div class="line"><span class="stringliteral">23.0 0.544</span></div>
<div class="line"><span class="stringliteral">35.0 0.20</span></div>
<div class="line"><span class="stringliteral">&#39;</span> number of points in gain scheduling</div>
<div class="line">4</div>
<div class="line"><span class="stringliteral">&#39; gain scheduling table (omega, GF)</span></div>
<div class="line"><span class="stringliteral">0    1.0</span></div>
<div class="line"><span class="stringliteral">0.55 1.0</span></div>
<div class="line"><span class="stringliteral">0.6  1.5</span></div>
<div class="line"><span class="stringliteral">1    1.5                                                    </span></div>
</div><!-- fragment --> </div></div><!-- contents -->
	</body>
</html>