Skip to content

Commit df9ee7d

Browse files
authored
Merge pull request #146 from OpenFAST/dev
Merge dev into main for Release v4.0.2
2 parents c19cbdc + 54a2998 commit df9ee7d

9 files changed

+627
-0
lines changed
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
------- OpenFAST EXAMPLE INPUT FILE -------------------------------------------
2+
FAST Certification Test #18: NREL 5.0 MW Baseline Wind Turbine (Onshore)
3+
---------------------- SIMULATION CONTROL --------------------------------------
4+
True Echo - Echo input data to <RootName>.ech (flag)
5+
"FATAL" AbortLevel - Error level when simulation should abort (string) {"WARNING", "SEVERE", "FATAL"}
6+
10 TMax - Total run time (s)
7+
0.00625 DT - Recommended module time step (s)
8+
2 InterpOrder - Interpolation order for input/output time history (-) {1=linear, 2=quadratic}
9+
0 NumCrctn - Number of correction iterations (-) {0=explicit calculation, i.e., no corrections}
10+
99999 DT_UJac - Time between calls to get Jacobians (s)
11+
1000000 UJacSclFact - Scaling factor used in Jacobians (-)
12+
---------------------- FEATURE SWITCHES AND FLAGS ------------------------------
13+
1 CompElast - Compute structural dynamics (switch) {1=ElastoDyn; 2=ElastoDyn + BeamDyn for blades; 3=Simplified ElastoDyn}
14+
2 CompInflow - Compute inflow wind velocities (switch) {0=still air; 1=InflowWind; 2=external from ExtInflow}
15+
2 CompAero - Compute aerodynamic loads (switch) {0=None; 1=AeroDisk; 2=AeroDyn; 3=ExtLoads}
16+
1 CompServo - Compute control and electrical-drive dynamics (switch) {0=None; 1=ServoDyn}
17+
0 CompSeaSt - Compute sea state information (switch) {0=None; 1=SeaState}
18+
0 CompHydro - Compute hydrodynamic loads (switch) {0=None; 1=HydroDyn}
19+
0 CompSub - Compute sub-structural dynamics (switch) {0=None; 1=SubDyn; 2=External Platform MCKF}
20+
0 CompMooring - Compute mooring system (switch) {0=None; 1=MAP++; 2=FEAMooring; 3=MoorDyn; 4=OrcaFlex}
21+
0 CompIce - Compute ice loads (switch) {0=None; 1=IceFloe; 2=IceDyn}
22+
0 MHK - MHK turbine type (switch) {0=Not an MHK turbine; 1=Fixed MHK turbine; 2=Floating MHK turbine}
23+
---------------------- ENVIRONMENTAL CONDITIONS --------------------------------
24+
9.80665 Gravity - Gravitational acceleration (m/s^2)
25+
1.225 AirDens - Air density (kg/m^3)
26+
0 WtrDens - Water density (kg/m^3)
27+
1.464E-05 KinVisc - Kinematic viscosity of working fluid (m^2/s)
28+
335 SpdSound - Speed of sound in working fluid (m/s)
29+
103500 Patm - Atmospheric pressure (Pa) [used only for an MHK turbine cavitation check]
30+
1700 Pvap - Vapour pressure of working fluid (Pa) [used only for an MHK turbine cavitation check]
31+
0 WtrDpth - Water depth (m)
32+
0 MSL2SWL - Offset between still-water level and mean sea level (m) [positive upward]
33+
---------------------- INPUT FILES ---------------------------------------------
34+
"NRELOffshrBsline5MW_Onshore_ElastoDyn.dat" EDFile - Name of file containing ElastoDyn input parameters (quoted string)
35+
"../../openfast/5MW_Baseline/NRELOffshrBsline5MW_BeamDyn.dat" BDBldFile(1) - Name of file containing BeamDyn input parameters for blade 1 (quoted string)
36+
"../../openfast/5MW_Baseline/NRELOffshrBsline5MW_BeamDyn.dat" BDBldFile(2) - Name of file containing BeamDyn input parameters for blade 2 (quoted string)
37+
"../../openfast/5MW_Baseline/NRELOffshrBsline5MW_BeamDyn.dat" BDBldFile(3) - Name of file containing BeamDyn input parameters for blade 3 (quoted string)
38+
"InflowWind_Steady_10mps.dat" InflowFile - Name of file containing inflow wind input parameters (quoted string)
39+
"NRELOffshrBsline5MW_Onshore_AeroDyn.dat" AeroFile - Name of file containing aerodynamic input parameters (quoted string)
40+
"NRELOffshrBsline5MW_Onshore_ServoDyn.dat" ServoFile - Name of file containing control and electrical-drive input parameters (quoted string)
41+
"unused" SeaStFile - Name of file containing sea state input parameters (quoted string)
42+
"unused" HydroFile - Name of file containing hydrodynamic input parameters (quoted string)
43+
"unused" SubFile - Name of file containing sub-structural input parameters (quoted string)
44+
"unused" MooringFile - Name of file containing mooring system input parameters (quoted string)
45+
"unused" IceFile - Name of file containing ice input parameters (quoted string)
46+
---------------------- OUTPUT --------------------------------------------------
47+
True SumPrint - Print summary data to "<RootName>.sum" (flag)
48+
5 SttsTime - Amount of time between screen status messages (s)
49+
99999 ChkptTime - Amount of time between creating checkpoint files for potential restart (s)
50+
"default" DT_Out - Time step for tabular output (s) (or "default")
51+
0 TStart - Time to begin tabular output (s)
52+
4 OutFileFmt - Format for tabular (time-marching) output file (switch) {1: text file [<RootName>.out], 2: binary file [<RootName>.outb], 3: both 1 and 2, 4: uncompressed binary [<RootName>.outb, 5: both 1 and 4}
53+
True TabDelim - Use tab delimiters in text tabular output file? (flag) {uses spaces if false}
54+
"ES10.3E2" OutFmt - Format used for text tabular output, excluding the time channel. Resulting field should be 10 characters. (quoted string)
55+
---------------------- LINEARIZATION -------------------------------------------
56+
False Linearize - Linearization analysis (flag)
57+
False CalcSteady - Calculate a steady-state periodic operating point before linearization? [unused if Linearize=False] (flag)
58+
3 TrimCase - Controller parameter to be trimmed {1:yaw; 2:torque; 3:pitch} [used only if CalcSteady=True] (-)
59+
0.001 TrimTol - Tolerance for the rotational speed convergence [used only if CalcSteady=True] (-)
60+
0.01 TrimGain - Proportional gain for the rotational speed error (>0) [used only if CalcSteady=True] (rad/(rad/s) for yaw or pitch; Nm/(rad/s) for torque)
61+
0 Twr_Kdmp - Damping factor for the tower [used only if CalcSteady=True] (N/(m/s))
62+
0 Bld_Kdmp - Damping factor for the blades [used only if CalcSteady=True] (N/(m/s))
63+
2 NLinTimes - Number of times to linearize (-) [>=1] [unused if Linearize=False]
64+
30, 60 LinTimes - List of times at which to linearize (s) [1 to NLinTimes] [used only when Linearize=True and CalcSteady=False]
65+
1 LinInputs - Inputs included in linearization (switch) {0=none; 1=standard; 2=all module inputs (debug)} [unused if Linearize=False]
66+
1 LinOutputs - Outputs included in linearization (switch) {0=none; 1=from OutList(s); 2=all module outputs (debug)} [unused if Linearize=False]
67+
False LinOutJac - Include full Jacobians in linearization output (for debug) (flag) [unused if Linearize=False; used only if LinInputs=LinOutputs=2]
68+
False LinOutMod - Write module-level linearization output files in addition to output for full system? (flag) [unused if Linearize=False]
69+
---------------------- VISUALIZATION ------------------------------------------
70+
0 WrVTK - VTK visualization data output: (switch) {0=none; 1=initialization data only; 2=animation; 3=mode shapes}
71+
1 VTK_type - Type of VTK visualization data: (switch) {1=surfaces; 2=basic meshes (lines/points); 3=all meshes (debug)} [unused if WrVTK=0]
72+
true VTK_fields - Write mesh fields to VTK data files? (flag) {true/false} [unused if WrVTK=0]
73+
15 VTK_fps - Frame rate for VTK output (frames per second){will use closest integer multiple of DT} [used only if WrVTK=2 or WrVTK=3]
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,71 @@
1+
------- InflowWind INPUT FILE -------------------------------------------------------------------------
2+
Steady 8 m/s winds with no shear for FAST CertTests #20 and #25
3+
---------------------------------------------------------------------------------------------------------------
4+
False Echo - Echo input data to <RootName>.ech (flag)
5+
1 WindType - switch for wind file type (1=steady; 2=uniform; 3=binary TurbSim FF; 4=binary Bladed-style FF; 5=HAWC format; 6=User defined; 7=native Bladed FF)
6+
0 PropagationDir - Direction of wind propagation (meteorological rotation from aligned with X (positive rotates towards -Y) -- degrees) (not used for native Bladed format WindType=7)
7+
0 VFlowAng - Upflow angle (degrees) (not used for native Bladed format WindType=7)
8+
False VelInterpCubic - Use cubic interpolation for velocity in time (false=linear, true=cubic) [Used with WindType=2,3,4,5,7]
9+
1 NWindVel - Number of points to output the wind velocity (0 to 9)
10+
0 WindVxiList - List of coordinates in the inertial X direction (m)
11+
0 WindVyiList - List of coordinates in the inertial Y direction (m)
12+
90 WindVziList - List of coordinates in the inertial Z direction (m)
13+
================== Parameters for Steady Wind Conditions [used only for WindType = 1] =========================
14+
10 HWindSpeed - Horizontal wind speed (m/s)
15+
90 RefHt - Reference height for horizontal wind speed (m)
16+
0.2 PLExp - Power law exponent (-)
17+
================== Parameters for Uniform wind file [used only for WindType = 2] ============================
18+
"unused" FileName_Uni - Filename of time series data for uniform wind field. (-)
19+
90 RefHt_Uni - Reference height for horizontal wind speed (m)
20+
125.88 RefLength - Reference length for linear horizontal and vertical sheer (-)
21+
================== Parameters for Binary TurbSim Full-Field files [used only for WindType = 3] ==============
22+
"unused" FileName_BTS - Name of the Full field wind file to use (.bts)
23+
================== Parameters for Binary Bladed-style Full-Field files [used only for WindType = 4 or WindType = 7] =========
24+
"unused" FileNameRoot - WindType=4: Rootname of the full-field wind file to use (.wnd, .sum); WindType=7: name of the intermediate file with wind scaling values
25+
False TowerFile - Have tower file (.twr) (flag) ignored when WindType = 7
26+
================== Parameters for HAWC-format binary files [Only used with WindType = 5] =====================
27+
"wasp\Output\basic_5u.bin" FileName_u - name of the file containing the u-component fluctuating wind (.bin)
28+
"wasp\Output\basic_5v.bin" FileName_v - name of the file containing the v-component fluctuating wind (.bin)
29+
"wasp\Output\basic_5w.bin" FileName_w - name of the file containing the w-component fluctuating wind (.bin)
30+
64 nx - number of grids in the x direction (in the 3 files above) (-)
31+
32 ny - number of grids in the y direction (in the 3 files above) (-)
32+
32 nz - number of grids in the z direction (in the 3 files above) (-)
33+
16 dx - distance (in meters) between points in the x direction (m)
34+
3 dy - distance (in meters) between points in the y direction (m)
35+
3 dz - distance (in meters) between points in the z direction (m)
36+
90 RefHt_Hawc - reference height; the height (in meters) of the vertical center of the grid (m)
37+
------------- Scaling parameters for turbulence ---------------------------------------------------------
38+
1 ScaleMethod - Turbulence scaling method [0 = none, 1 = direct scaling, 2 = calculate scaling factor based on a desired standard deviation]
39+
1 SFx - Turbulence scaling factor for the x direction (-) [ScaleMethod=1]
40+
1 SFy - Turbulence scaling factor for the y direction (-) [ScaleMethod=1]
41+
1 SFz - Turbulence scaling factor for the z direction (-) [ScaleMethod=1]
42+
12 SigmaFx - Turbulence standard deviation to calculate scaling from in x direction (m/s) [ScaleMethod=2]
43+
8 SigmaFy - Turbulence standard deviation to calculate scaling from in y direction (m/s) [ScaleMethod=2]
44+
2 SigmaFz - Turbulence standard deviation to calculate scaling from in z direction (m/s) [ScaleMethod=2]
45+
------------- Mean wind profile parameters (added to HAWC-format files) ---------------------------------
46+
5 URef - Mean u-component wind speed at the reference height (m/s)
47+
2 WindProfile - Wind profile type (0=constant;1=logarithmic,2=power law)
48+
0 PLExp_Hawc - Power law exponent (-) (used for PL wind profile type only)
49+
0.03 Z0 - Surface roughness length (m) (used for LG wind profile type only)
50+
0 XOffset - Initial offset in +x direction (shift of wind box)
51+
================== LIDAR Parameters ===========================================================================
52+
0 SensorType - Switch for lidar configuration (0 = None, 1 = Single Point Beam(s), 2 = Continuous, 3 = Pulsed)
53+
0 NumPulseGate - Number of lidar measurement gates (used when SensorType = 3)
54+
30 PulseSpacing - Distance between range gates (m) (used when SensorType = 3)
55+
0 NumBeam - Number of lidar measurement beams (0-5)(used when SensorType = 1)
56+
-200 FocalDistanceX - Focal distance co-ordinates of the lidar beam in the x direction (relative to hub height) (only first coordinate used for SensorType 2 and 3) (m)
57+
0 FocalDistanceY - Focal distance co-ordinates of the lidar beam in the y direction (relative to hub height) (only first coordinate used for SensorType 2 and 3) (m)
58+
0 FocalDistanceZ - Focal distance co-ordinates of the lidar beam in the z direction (relative to hub height) (only first coordinate used for SensorType 2 and 3) (m)
59+
0, 0, 0 RotorApexOffsetPos - Offset of the lidar from hub height (m)
60+
17 URefLid - Reference average wind speed for the lidar[m/s]
61+
0.25 MeasurementInterval - Time between each measurement [s]
62+
False LidRadialVel - TRUE => return radial component, FALSE => return 'x' direction estimate
63+
1 ConsiderHubMotion - Flag whether to consider the hub motion's impact on Lidar measurements
64+
====================== OUTPUT ==================================================
65+
False SumPrint - Print summary data to <RootName>.IfW.sum (flag)
66+
OutList - The next line(s) contains a list of output parameters. See OutListParameters.xlsx for a listing of available output channels, (-)
67+
"Wind1VelX" X-direction wind velocity at point WindList(1)
68+
"Wind1VelY" Y-direction wind velocity at point WindList(1)
69+
"Wind1VelZ" Z-direction wind velocity at point WindList(1)
70+
END of input file (the word "END" must appear in the first 3 columns of this last OutList line)
71+
---------------------------------------------------------------------------------------

0 commit comments

Comments
 (0)