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]
7False UseSC - Use a super controller? (flag)
81 Mod_AmbWind - Ambient wind model (-) (switch) {1: high-fidelity precursor in VTK format, 2: one InflowWind module, 3: multiple instances of InflowWind module}
92 Mod_WaveField - Wave field handling (-) (switch) {1: use individual HydroDyn inputs without adjustment, 2: adjust wave phases based on turbine offsets from farm origin}
100 Mod_SharedMooring - Shared mooring system model (switch) {0: None, 3=MoorDyn}}
11--- SUPER CONTROLLER --- [used only for UseSC=True]
12"SC_DLL.dll" SC_FileName Name/location of the dynamic library {.dll [Windows] or .so [Linux]} containing the Super Controller algorithms (quoted string)
13--- SHARED MOORING SYSTEM --- [used only for Mod_SharedMoor>0]
14"" SharedMoorFile - Name of file containing shared mooring system input parameters (quoted string) [used only when Mod_SharedMooring > 0]
150.04 DT_Mooring - Time step for farm-level mooring coupling with each turbine (s) [used only when Mod_SharedMooring > 0]
16--- AMBIENT WIND: PRECURSOR IN VTK FORMAT --- [used only for Mod_AmbWind=1]
172.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]
180.5 DT_High-VTK - Time step for high-resolution wind data input files (s) [>0.0]
19"unused" WindFilePath - Path name to VTK wind data files from precursor (string)
20False ChkWndFiles - Check all the ambient wind files for data consistency? (flag)
21--- AMBIENT WIND: INFLOWWIND MODULE --- [used only for Mod_AmbWind=2 or 3]
222.0 DT_Low - Time step for low-resolution wind data interpolation; will be used as the global FAST.Farm time step (s) [>0.0]
230.5 DT_High - Time step for high-resolution wind data interpolation (s) [>0.0]
24300 NX_Low - Number of low-resolution spatial nodes in X direction for wind data interpolation (-) [>=2]
25300 NY_Low - Number of low-resolution spatial nodes in Y direction for wind data interpolation (-) [>=2]
2635 NZ_Low - Number of low-resolution spatial nodes in Z direction for wind data interpolation (-) [>=2]
275.0 X0_Low - Origin of low-resolution spatial nodes in X direction for wind data interpolation (m)
285.0 Y0_Low - Origin of low-resolution spatial nodes in Y direction for wind data interpolation (m)
295.0 Z0_Low - Origin of low-resolution spatial nodes in Z direction for wind data interpolation (m)
3010.0 dX_Low - Spacing of low-resolution spatial nodes in X direction for wind data interpolation (m) [>0.0]
3110.0 dY_Low - Spacing of low-resolution spatial nodes in Y direction for wind data interpolation (m) [>0.0]
3210.0 dZ_Low - Spacing of low-resolution spatial nodes in Z direction for wind data interpolation (m) [>0.0]
3316 NX_High - Number of high-resolution spatial nodes in X direction for wind data interpolation (-) [>=2]
3416 NY_High - Number of high-resolution spatial nodes in Y direction for wind data interpolation (-) [>=2]
3517 NZ_High - Number of high-resolution spatial nodes in Z direction for wind data interpolation (-) [>=2]
36"InflowWind.dat" InflowFile - Name of file containing InflowWind module input parameters (quoted string)
37--- WIND TURBINES ---
381 NumTurbines - Number of wind turbines (-) [>=1] [last 6 columns below used only for Mod_AmbWind=2 or 3]
39WT_X WT_Y WT_Z WT_FASTInFile X0_High Y0_High Z0_High dX_High dY_High dZ_High
40(m) (m) (m) (string) (m) (m) (m) (m) (m) (m)
41605.0 1500.0 0.0 "/FAST/Test18.fst" 525.0 1425.0 5.0 10.0 10.0 10.0
42--- WAKE DYNAMICS ---
431 Mod_Wake - Switch between wake formulations {1:Polar, 2:Curl, 3:Cartesian} (-) (switch)
445.0 dr - Radial increment of radial finite-difference grid (m) [>0.0]
4540 NumRadii - Number of radii in the radial finite-difference grid (-) [>=2]
46140 NumPlanes - Number of wake planes (-) [>=2]
47DEFAULT 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]
48DEFAULT C_HWkDfl_O - Calibrated parameter in the correction for wake deflection defining the horizontal offset at the rotor (m) or DEFAULT [=0.0]
49DEFAULT 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]
50DEFAULT C_HWkDfl_x - Calibrated parameter in the correction for wake deflection defining the horizontal offset scaled with downstream distance (-) or DEFAULT [=0.0]
51DEFAULT 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]
52DEFAULT C_NearWake - Calibrated parameter for the near-wake correction (-) [>1. and <2.5] or DEFAULT [=1.8]
53DEFAULT k_vAmb - Calibrated parameter for the influence of ambient turbulence in the eddy viscosity (-) [>=0.0] or DEFAULT [=0.05]
54DEFAULT k_vShr - Calibrated parameter for the influence of the shear layer in the eddy viscosity (-) [>=0.0] or DEFAULT [=0.016]
55DEFAULT 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]
56DEFAULT 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]
57DEFAULT 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]
58DEFAULT 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]
59DEFAULT 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]
60DEFAULT 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]
61DEFAULT 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]
62DEFAULT 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]
63DEFAULT Mod_WakeDiam - Wake diameter calculation model (-) (switch) {1: rotor diameter, 2: velocity based, 3: mass-flux based, 4: momentum-flux based} or DEFAULT [=1]
64DEFAULT C_WakeDiam - Calibrated parameter for wake diameter calculation (-) [>0.0 and <0.99] or DEFAULT [=0.95] [unused for Mod_WakeDiam=1]
65DEFAULT Mod_Meander - Spatial filter model for wake meandering (-) (switch) {1: uniform, 2: truncated jinc, 3: windowed jinc} or DEFAULT [=3]
66DEFAULT C_Meander - Calibrated parameter for wake meandering (-) [>=1.0] or DEFAULT [=1.9]
67--- CURLED-WAKE PARAMETERS [only used if Mod_Wake=2 or 3] ---
68True Swirl - Switch to include swirl velocities in wake [only used if Mod_Wake=2 or Mod_Wake=3] (-) (switch) [DEFAULT=TRUE]
690 k_VortexDecay - Vortex decay constant for curl (-) [DEFAULT=0]
70DEFAULT NumVortices - The number of vortices in the curled wake model (-) [DEFAULT=100]
71DEFAULT sigma_D - The width of the vortices in the curled wake model non-dimesionalized by rotor diameter (-) [DEFAULT=0.2]
72DEFAULT 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)
73DEFAULT 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 ]
74DEFAULT 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)
75--- VISUALIZATION ---
76False WrDisWind - Write low- and high-resolution disturbed wind data to <RootName>.Low.Dis.t<n>.vtk etc. (flag)
771 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]
7890.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]
792 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]
80600.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]
811 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]
821500.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]
834.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]
84--- OUTPUT ---
85True SumPrint - Print summary data to <RootName>.sum? (flag)
8699999.9 ChkptTime - Amount of time between creating checkpoint files for potential restart (s) [>0.0]
870.0 TStart - Time to begin tabular output (s) [>=0.0]
881 OutFileFmt - Format for tabular (time-marching) output file (switch) {1: text file [<RootName>.out], 2: binary file [<RootName>.outb], 3: both}
89True TabDelim - Use tab delimiters in text tabular output file? (flag) {uses spaces if False}
90"ES10.3E2" OutFmt - Format used for text tabular output, excluding the time channel. Resulting field should be 10 characters. (quoted string)
91DEFAULT OutAllPlanes - Output all wake planes at all time steps. [DEFAULT=False]
923 NOutRadii - Number of radial nodes for wake output for an individual rotor (-) [0 to 20]
930, 15, 39 OutRadii - List of radial nodes for wake output for an individual rotor (-)
942 NOutDist - Number of downstream distances for wake output for an individual rotor (-) [1 to NOutRadii] [unused for NOutRadii=0] rotor (-) [0 to 9]
950.0, 378.0 OutDist - List of downstream distances for wake output for an individual rotor (m) [1 to NOutDist] [unused for NOutDist =0]
961 NWindVel - Number of points for wind output (-) [0 to 9]
97600.0 WindVelX - List of coordinates in the X direction for wind output (m) [1 to NWindVel] [unused for NWindVel=0]
981500.0 WindVelY - List of coordinates in the Y direction for wind output (m) [1 to NWindVel] [unused for NWindVel=0]
9990.0 WindVelZ - List of coordinates in the Z direction for wind output (m) [1 to NWindVel] [unused for NWindVel=0]
100 OutList - The next line(s) contains a list of output parameters. (quoted string)
101"RtAxsXT1, RtAxsYT1, RtAxsZT1"
102"RtPosXT1, RtPosYT1, RtPosZT1"
103"YawErrT1"
104"TIAmbT1"
105"CtT1N01, CtT1N02, CtT1N03, CtT1N04, CtT1N05"
106"WkAxsXT1D1, WkAxsXT1D2, WkAxsXT1D3"
107"WkAxsYT1D1, WkAxsYT1D2, WkAxsYT1D3"
108"WkAxsZT1D1, WkAxsZT1D2, WkAxsZT1D3"
109"WkPosXT1D1, WkPosXT1D2, WkPosXT1D3"
110"WkPosYT1D1, WkPosYT1D2, WkPosYT1D3"
111"WkPosZT1D1, WkPosZT1D2, WkPosZT1D3"
112"WkDfVxT1N01D1, WkDfVxT1N02D1, WkDfVxT1N03D1, WkDfVxT1N04D1, WkDfVxT1N05D1"
113"WkDfVxT1N01D2, WkDfVxT1N02D2, WkDfVxT1N03D2, WkDfVxT1N04D2, WkDfVxT1N05D2"
114"WkDfVxT1N01D3, WkDfVxT1N02D3, WkDfVxT1N03D3, WkDfVxT1N04D3, WkDfVxT1N05D3"
115"WkDfVrT1N01D1, WkDfVrT1N02D1, WkDfVrT1N03D1, WkDfVrT1N04D1, WkDfVrT1N05D1"
116"WkDfVrT1N01D2, WkDfVrT1N02D2, WkDfVrT1N03D2, WkDfVrT1N04D2, WkDfVrT1N05D2"
117"WkDfVrT1N01D3, WkDfVrT1N02D3, WkDfVrT1N03D3, WkDfVrT1N04D3, WkDfVrT1N05D3"
118END of input file (the word "END" must appear in the first 3 columns of this last OutList line)