4.18.10. FAST.Farm Primary Input File
When a default value is available,
DEFAULT may be used instead of the value.
Check the regression test cases for updates to this input file.
1------- FAST.Farm for OpenFAST INPUT FILE -------------------------------------------------
2Comment
3--- SIMULATION CONTROL ---
4False Echo - Echo input data to <RootName>.ech? (flag)
5FATAL AbortLevel - Error level when simulation should abort (string) {"WARNING", "SEVERE", "FATAL"}
62000.0 TMax - Total run time (s) [>=0.0]
71 Mod_AmbWind - Ambient wind model (-) (switch) {1: high-fidelity precursor in VTK format, 2: one InflowWind module, 3: multiple instances of InflowWind module}
82 Mod_WaveField - Wave field handling (-) (switch) {1: use individual HydroDyn inputs without adjustment, 2: adjust wave phases based on turbine offsets from farm origin}
90 Mod_SharedMooring - Shared mooring system model (switch) {0: None, 3=MoorDyn}}
10--- SHARED MOORING SYSTEM --- [used only for Mod_SharedMoor>0]
11"" SharedMoorFile - Name of file containing shared mooring system input parameters (quoted string) [used only when Mod_SharedMooring > 0]
120.04 DT_Mooring - Time step for farm-level mooring coupling with each turbine (s) [used only when Mod_SharedMooring > 0]
13--- AMBIENT WIND: PRECURSOR IN VTK FORMAT --- [used only for Mod_AmbWind=1]
142.0 DT_Low-VTK - Time step for low-resolution wind data input files; will be used as the global FAST.Farm time step (s) [>0.0]
150.5 DT_High-VTK - Time step for high-resolution wind data input files (s) [>0.0]
16"unused" WindFilePath - Path name to VTK wind data files from precursor (string)
17False ChkWndFiles - Check all the ambient wind files for data consistency? (flag)
18--- AMBIENT WIND: INFLOWWIND MODULE --- [used only for Mod_AmbWind=2 or 3]
192.0 DT_Low - Time step for low-resolution wind data interpolation; will be used as the global FAST.Farm time step (s) [>0.0]
200.5 DT_High - Time step for high-resolution wind data interpolation (s) [>0.0]
21300 NX_Low - Number of low-resolution spatial nodes in X direction for wind data interpolation (-) [>=2]
22300 NY_Low - Number of low-resolution spatial nodes in Y direction for wind data interpolation (-) [>=2]
2335 NZ_Low - Number of low-resolution spatial nodes in Z direction for wind data interpolation (-) [>=2]
245.0 X0_Low - Origin of low-resolution spatial nodes in X direction for wind data interpolation (m)
255.0 Y0_Low - Origin of low-resolution spatial nodes in Y direction for wind data interpolation (m)
265.0 Z0_Low - Origin of low-resolution spatial nodes in Z direction for wind data interpolation (m)
2710.0 dX_Low - Spacing of low-resolution spatial nodes in X direction for wind data interpolation (m) [>0.0]
2810.0 dY_Low - Spacing of low-resolution spatial nodes in Y direction for wind data interpolation (m) [>0.0]
2910.0 dZ_Low - Spacing of low-resolution spatial nodes in Z direction for wind data interpolation (m) [>0.0]
3016 NX_High - Number of high-resolution spatial nodes in X direction for wind data interpolation (-) [>=2]
3116 NY_High - Number of high-resolution spatial nodes in Y direction for wind data interpolation (-) [>=2]
3217 NZ_High - Number of high-resolution spatial nodes in Z direction for wind data interpolation (-) [>=2]
33"InflowWind.dat" InflowFile - Name of file containing InflowWind module input parameters (quoted string)
34--- WIND TURBINES ---
351 NumTurbines - Number of wind turbines (-) [>=1] [last 6 columns below used only for Mod_AmbWind=2 or 3]
36WT_X WT_Y WT_Z WT_FASTInFile X0_High Y0_High Z0_High dX_High dY_High dZ_High
37(m) (m) (m) (string) (m) (m) (m) (m) (m) (m)
38605.0 1500.0 0.0 "/FAST/Test18.fst" 525.0 1425.0 5.0 10.0 10.0 10.0
39--- WAKE DYNAMICS ---
401 Mod_Wake - Switch between wake formulations {1:Polar, 2:Curl, 3:Cartesian} (-) (switch)
415.0 dr - Radial increment of radial finite-difference grid (m) [>0.0]
4240 NumRadii - Number of radii in the radial finite-difference grid (-) [>=2]
43140 NumPlanes - Number of wake planes (-) [>=2]
44DEFAULT f_c - Cutoff (corner) frequency of the low-pass time-filter for the wake advection, deflection, and meandering model [recommended=1.28*U0/R] (Hz) [>0.0]
45DEFAULT C_HWkDfl_O - Calibrated parameter in the correction for wake deflection defining the horizontal offset at the rotor (m) or DEFAULT [=0.0]
46DEFAULT C_HWkDfl_OY - Calibrated parameter in the correction for wake deflection defining the horizontal offset at the rotor scaled with yaw error (m/deg) or DEFAULT [=0.3]
47DEFAULT C_HWkDfl_x - Calibrated parameter in the correction for wake deflection defining the horizontal offset scaled with downstream distance (-) or DEFAULT [=0.0]
48DEFAULT C_HWkDfl_xY - Calibrated parameter in the correction for wake deflection defining the horizontal offset scaled with downstream distance and yaw error (1/deg) or DEFAULT [=-0.004]
49DEFAULT C_NearWake - Calibrated parameter for the near-wake correction (-) [>1. and <2.5] or DEFAULT [=1.8]
50DEFAULT k_vAmb - Calibrated parameter for the influence of ambient turbulence in the eddy viscosity (-) [>=0.0] or DEFAULT [=0.05]
51DEFAULT k_vShr - Calibrated parameter for the influence of the shear layer in the eddy viscosity (-) [>=0.0] or DEFAULT [=0.016]
52DEFAULT C_vAmb_DMin - Calibrated parameter in the eddy viscosity filter function for ambient turbulence defining the transitional diameter fraction between the minimum and exponential regions (-) [>=0.0] or DEFAULT [=0.0]
53DEFAULT C_vAmb_DMax - Calibrated parameter in the eddy viscosity filter function for ambient turbulence defining the transitional diameter fraction between the exponential and maximum regions (-) [> C_vAmb_DMin] or DEFAULT [=1.0]
54DEFAULT C_vAmb_FMin - Calibrated parameter in the eddy viscosity filter function for ambient turbulence defining the value in the minimum region (-) [>=0.0 and <=1.0] or DEFAULT [=1.0]
55DEFAULT C_vAmb_Exp - Calibrated parameter in the eddy viscosity filter function for ambient turbulence defining the exponent in the exponential region (-) [> 0.0] or DEFAULT [=0.01]
56DEFAULT C_vShr_DMin - Calibrated parameter in the eddy viscosity filter function for the shear layer defining the transitional diameter fraction between the minimum and exponential regions (-) [>=0.0] or DEFAULT [=3.0]
57DEFAULT C_vShr_DMax - Calibrated parameter in the eddy viscosity filter function for the shear layer defining the transitional diameter fraction between the exponential and maximum regions (-) [> C_vShr_DMin] or DEFAULT [=25.0]
58DEFAULT C_vShr_FMin - Calibrated parameter in the eddy viscosity filter function for the shear layer defining the value in the minimum region (-) [>=0.0 and <=1.0] or DEFAULT [=0.2]
59DEFAULT C_vShr_Exp - Calibrated parameter in the eddy viscosity filter function for the shear layer defining the exponent in the exponential region (-) [> 0.0] or DEFAULT [=0.1]
60DEFAULT Mod_WakeDiam - Wake diameter calculation model (-) (switch) {1: rotor diameter, 2: velocity based, 3: mass-flux based, 4: momentum-flux based} or DEFAULT [=1]
61DEFAULT C_WakeDiam - Calibrated parameter for wake diameter calculation (-) [>0.0 and <0.99] or DEFAULT [=0.95] [unused for Mod_WakeDiam=1]
62DEFAULT Mod_Meander - Spatial filter model for wake meandering (-) (switch) {1: uniform, 2: truncated jinc, 3: windowed jinc} or DEFAULT [=3]
63DEFAULT C_Meander - Calibrated parameter for wake meandering (-) [>=1.0] or DEFAULT [=1.9]
64--- CURLED-WAKE PARAMETERS [only used if Mod_Wake=2 or 3] ---
65True Swirl - Switch to include swirl velocities in wake [only used if Mod_Wake=2 or Mod_Wake=3] (-) (switch) [DEFAULT=TRUE]
660 k_VortexDecay - Vortex decay constant for curl (-) [DEFAULT=0]
67DEFAULT NumVortices - The number of vortices in the curled wake model (-) [DEFAULT=100]
68DEFAULT sigma_D - The width of the vortices in the curled wake model non-dimesionalized by rotor diameter (-) [DEFAULT=0.2]
69DEFAULT FilterInit - Switch to filter the initial wake plane deficit and select the number of grid points for the filter {0: no filter, 1: filter of size 1} or DEFAULT [DEFAULT=1] [unused for Mod_Wake=1] (switch)
70DEFAULT k_vCurl - Calibrated parameter for scaling the eddy viscosity in the curled-wake model (-) [only used if Mod_Wake=2 or Mod_Wake=3] [>=0] or DEFAULT [DEFAULT=2.0 ]
71DEFAULT Mod_Projection - Switch to select how the wake plane velocity is projected in AWAE {1: keep all components, 2: project against plane normal} or DEFAULT [DEFAULT=1: if Mod_Wake is 1 or 3, or DEFAULT=2: if Mod_Wake is 2] (switch)
72--- VISUALIZATION ---
73False WrDisWind - Write low- and high-resolution disturbed wind data to <RootName>.Low.Dis.t<n>.vtk etc. (flag)
741 NOutDisWindXY - Number of XY planes for output of disturbed wind data across the low-resolution domain to <RootName>.Low.DisXY<n_out>.t<n>.vtk (-) [0 to 9]
7590.0 OutDisWindZ - Z coordinates of XY planes for output of disturbed wind data across the low-resolution domain (m) [1 to NOutDisWindXY] [unused for NOutDisWindXY=0]
762 NOutDisWindYZ - Number of YZ planes for output of disturbed wind data across the low-resolution domain to <RootName>/Low.DisYZ<n_out>.t<n>.vtk (-) [0 to 9]
77600.0,978.0 OutDisWindX X - coordinates of YZ planes for output of disturbed wind data across the low-resolution domain (m) [1 to NOutDisWindYZ] [unused for NOutDisWindYZ=0]
781 NOutDisWindXZ - Number of XZ planes for output of disturbed wind data across the low-resolution domain to <RootName>/Low.DisXZ<n_out>.t<n>.vtk (-) [0 to 9]
791500.0 OutDisWindY - Y coordinates of XZ planes for output of disturbed wind data across the low-resolution domain (m) [1 to NOutDisWindXZ] [unused for NOutDisWindXZ=0]
804.0 WrDisDT - Time step for disturbed wind visualization output (s) [>0.0] or DEFAULT [=DT_Low or DT_Low-VTK] [unused for WrDisWind=False and NOutDisWindXY=NOutDisWindYZ=NOutDisWindXZ=0]
81--- OUTPUT ---
82True SumPrint - Print summary data to <RootName>.sum? (flag)
8399999.9 ChkptTime - Amount of time between creating checkpoint files for potential restart (s) [>0.0]
840.0 TStart - Time to begin tabular output (s) [>=0.0]
851 OutFileFmt - Format for tabular (time-marching) output file (switch) {1: text file [<RootName>.out], 2: binary file [<RootName>.outb], 3: both}
86True TabDelim - Use tab delimiters in text tabular output file? (flag) {uses spaces if False}
87"ES10.3E2" OutFmt - Format used for text tabular output, excluding the time channel. Resulting field should be 10 characters. (quoted string)
88DEFAULT OutAllPlanes - Output all wake planes at all time steps. [DEFAULT=False]
893 NOutRadii - Number of radial nodes for wake output for an individual rotor (-) [0 to 20]
900, 15, 39 OutRadii - List of radial nodes for wake output for an individual rotor (-)
912 NOutDist - Number of downstream distances for wake output for an individual rotor (-) [1 to NOutRadii] [unused for NOutRadii=0] rotor (-) [0 to 9]
920.0, 378.0 OutDist - List of downstream distances for wake output for an individual rotor (m) [1 to NOutDist] [unused for NOutDist =0]
931 NWindVel - Number of points for wind output (-) [0 to 9]
94600.0 WindVelX - List of coordinates in the X direction for wind output (m) [1 to NWindVel] [unused for NWindVel=0]
951500.0 WindVelY - List of coordinates in the Y direction for wind output (m) [1 to NWindVel] [unused for NWindVel=0]
9690.0 WindVelZ - List of coordinates in the Z direction for wind output (m) [1 to NWindVel] [unused for NWindVel=0]
97 OutList - The next line(s) contains a list of output parameters. (quoted string)
98"RtAxsXT1, RtAxsYT1, RtAxsZT1"
99"RtPosXT1, RtPosYT1, RtPosZT1"
100"YawErrT1"
101"TIAmbT1"
102"CtT1N01, CtT1N02, CtT1N03, CtT1N04, CtT1N05"
103"WkAxsXT1D1, WkAxsXT1D2, WkAxsXT1D3"
104"WkAxsYT1D1, WkAxsYT1D2, WkAxsYT1D3"
105"WkAxsZT1D1, WkAxsZT1D2, WkAxsZT1D3"
106"WkPosXT1D1, WkPosXT1D2, WkPosXT1D3"
107"WkPosYT1D1, WkPosYT1D2, WkPosYT1D3"
108"WkPosZT1D1, WkPosZT1D2, WkPosZT1D3"
109"WkDfVxT1N01D1, WkDfVxT1N02D1, WkDfVxT1N03D1, WkDfVxT1N04D1, WkDfVxT1N05D1"
110"WkDfVxT1N01D2, WkDfVxT1N02D2, WkDfVxT1N03D2, WkDfVxT1N04D2, WkDfVxT1N05D2"
111"WkDfVxT1N01D3, WkDfVxT1N02D3, WkDfVxT1N03D3, WkDfVxT1N04D3, WkDfVxT1N05D3"
112"WkDfVrT1N01D1, WkDfVrT1N02D1, WkDfVrT1N03D1, WkDfVrT1N04D1, WkDfVrT1N05D1"
113"WkDfVrT1N01D2, WkDfVrT1N02D2, WkDfVrT1N03D2, WkDfVrT1N04D2, WkDfVrT1N05D2"
114"WkDfVrT1N01D3, WkDfVrT1N02D3, WkDfVrT1N03D3, WkDfVrT1N04D3, WkDfVrT1N05D3"
115END of input file (the word "END" must appear in the first 3 columns of this last OutList line)