Turbine Definition ASCII File ============================= Turbine objects can be exported as a QBlade project file (``.qpr``) or into the text based ``.trb`` format. When a turbine object is exported into the ``.trb`` format, the associated blade (``.bld``) file is automatically created. Furthermore, the structural definition files (if the turbine has a structural model) and the controller parameters are also automatically placed into the folder structure See an exemplary ``.trb`` file below: .. code-block:: console ----------------------------------------QBlade Turbine Definition File---------------------------------------------- Generated with : QBlade IH v2.0.2_alpha windows Archive Format: 310002 Time : 12:07:32 Date : 29.06.2022 ----------------------------------------Object Name----------------------------------------------------------------- NREL_5MW_Servo_OC3 OBJECTNAME - the name of the turbine object ----------------------------------------Rotor Definition------------------------------------------------------------ Aero/NREL_5MW.bld BLADEFILE - the path of the blade file that is used in this turbine definition 0 TURBTYPE - the turbine type (0 = HAWT or 1 = VAWT) 3 NUMBLADES - the number of blades (a Structural Model overrides this value) 0 ROTORCONFIG - the rotor configuration (0 = UPWIND or 1 = DOWNWIND) 0 ROTATIONALDIR - the direction of rotor rotation (0 = STANDARD or 1 = REVERSED) 1 DISCTYPE - type of rotor discretization (0 = from Bladetable, 1 = linear, 2 = cosine) 20 NUMPANELS - the number of aerodynamic panels per blade (unused if DISCTYPE = 0) ----------------------------------------Turbine Geometry Parameters------------------------------------------------- These values are only used if no Structural Model is defined for this Turbine, in case of a Structural Model the geometry is defined in the Structural Input Files!! 10.5000 OVERHANG - the rotor overhang [m] (HAWT only) 0.0000 SHAFTTILT - the shaft tilt angle [deg] (HAWT only) 0.0000 ROTORCONE - the rotor cone angle [deg] (HAWT only) 0.0000 CLEARANCE - the rotor clearance to ground [m] (VAWT only) 0.0000 XTILT - the rotor x-tilt angle [deg] (VAWT only) 0.0000 YTILT - the rotor y-tilt angle [deg] (VAWT only) 126.0000 TOWERHEIGHT - the tower height [m] 1.8000 TOWERTOPRAD - the tower top radius [m] 2.5200 TOWERBOTRAD - the tower bottom radius [m] ----------------------------------------Aerodynamic Models---------------------------------------------------------- 0 DYNSTALLTYPE - the dynamic stall model: 0 = none; 1 = OYE; 2 = GORMONT-BERG or 3 = ATEFLAP 8 TF_OYE - Tf constant for the OYE dynamic stall model 6 AM_GB - Am constant for the GORMONT-BERG dynamic stall model 3 TF_ATE - Tf constant for the ATEFLAP dynamic stall model 2 TP_ATE - Tp constant for the ATEFLAP dynamic stall model 1 2PLIFTDRAG - include the 2 point lift drag correction? (0 = OFF or 1 = ON) 0 HIMMELSKAMP - include the Himmelskamp Stall delay? (0 = OFF or 1 = ON) (HAWT only) 0 TOWERSHADOW - include the tower shadow effect (0 = OFF or 1 = ON) 1 TOWERDRAG - the tower drag coefficient [-] (if a Structural Model is used the tower drag is defined in the tower input file) ----------------------------------------Wake Type------------------------------------------------------------------ 1 WAKETYPE - the wake type: 0 = free vortex wake; 1 = unsteady BEM (unsteady BEM is only available for HAWT) ----------------------------------------Vortex Wake Parameters------------------------------------------------------ Only used if waketype = 0 0 WAKEINTTYPE - the wake integration type: 0 = EF; 1 = PC; 2 = PC2B 1 WAKEROLLUP - calculate wake self-induction (0 = OFF or 1 = ON) 1 TRAILINGVORT - include trailing vortex elements (0 = OFF or 1 = ON) 1 SHEDVORT - include shed vortex elements (0 = OFF or 1 = ON) 0 CONVECTIONTYPE - the wake convection type (0 = BL, 1 = HH, 2 = LOC) 1.00 WAKERELAXATION - the wake relaxation factor [0-1] 1.00 FIRSTWAKEROW - first wake row length [-] 200000 MAXWAKESIZE - the maximum number of wake elements [-] 100 MAXWAKEDIST - the maximum wake distance from the rotor plane (normalized by dia) [-] 0.00100 WAKEREDUCTION - the wake reduction factor [-] 0 WAKELENGTHTYPE - the wake length type (0 = counted in rotor revolutions, 1 = counted in time steps) 1000000.00 CONVERSIONLENGTH - the wake conversion length (to particles) [-] 0.50 NEARWAKELENGTH - the near wake length [-] 2.00 ZONE1LENGTH - the wake zone 1 length [-] 4.00 ZONE2LENGTH - the wake zone 2 length [-] 6.00 ZONE3LENGTH - the wake zone 3 length [-] 2 ZONE1FACTOR - the wake zone 1 factor (integer!) [-] 2 ZONE2FACTOR - the wake zone 2 factor (integer!) [-] 2 ZONE3FACTOR - the wake zone 3 factor (integer!) [-] ----------------------------------------Vortex Core Parameters------------------------------------------------------ Only used if waketype = 0 1.00 BOUNDCORERADIUS - the fixed core radius of the bound blade vortex (fraction of local chord) [0-1] 0.05 WAKECORERADIUS - the initial core radius of the free wake vortex (fraction of local chord) [0-1] 800.00 VORTEXVISCOSITY - the turbulent vortex viscosity 0 VORTEXSTRAIN - calculate vortex strain 0 = OFF, 1 = ON 20 MAXSTRAIN - the maximum element strain, before elements are removed from the wake [-] ----------------------------------------Gamma Iteration Parameters-------------------------------------------------- Only used if waketype = 0 0.40 GAMMARELAXATION - the relaxation factor used in the gamma (circulation) iteration [0-1] 0.00100 GAMMAEPSILON - the relative gamma (circulation) convergence criteria 100 GAMMAITERATIONS - the maximum number of gamma (circulation) iterations (integer!) [-] ----------------------------------------Unsteady BEM Parameters------------------------------------------------------ 12 POLARDISC - the polar discretization for the unsteady BEM (integer!) [-] 0 BEMTIPLOSS - use BEM tip loss factor, 0 = OFF, 1 = ON 0.00 BEMSPEEDUP - initial BEM convergence acceleration time [s] ----------------------------------------Structural Model------------------------------------------------------------- Structure/OC3_Sparbuoy_Main_LPMD.str STRUCTURALFILE - the input file for the structural model (leave blank if unused) 0 GEOMSTIFFNESS - enable geometric stiffness, 0 = OFF, 1 = ON ----------------------------------------Turbine Controller----------------------------------------------------------- 3 CONTROLLERTYPE - the type of turbine controller 0 = none, 1 = BLADED, 2 = DTU, 3 = TUB TUBCon_1.3.9_64Bit CONTROLLERFILE - the controller file name, WITHOUT file ending (.dll or .so ) - leave blank if unused, this file must be located in the /ControllerFiles subdirectory of QBlade Control/TUBCon_Params_V1.3.9_NREL5MW.xml PARAMETERFILE - the controller parameter file name (leave blank if unused)