4.6.1. Input and Output Files
4.6.1.1. Units
AeroDisk uses the SI system (kg, m, s, N).
4.6.1.2. Input file
The AeroDisk input file defines the general inputs required for the actuator disk calculations. The following inputs may be changed by the user to achieve the desired behaviour.
4.6.1.2.1. Simulation Control
echo [switch]
Write the input file contents to a file <RootName>.ADsk.ech. This is useful for diagnosing errors reported about the input file.
DT [seconds]
Integration time step for AeroDisk to use, or _”default”_ to use the glue code time step.
4.6.1.2.2. Environmental Conditions
AirDens [kg/m^3]
Air density, or _”default”_ to use the air density from the glue code
4.6.1.2.3. Actuator Disk Properties
RotorRad [m]
Radius of the rotor, or _”default”_ to use the value passed from the glue code
The lookup table for the disk actuator forces and moments follows. The data in this table is flexible as it allows for a very simple lookup based on a single variable (TSR for example), or up to four variables. The last six columns of the table must include the six force and moment coefficients that correspond to a set of conditions given in the first set of columns.
InColNames [-]
Comma separated List of column names corresponding to the variable columns in the input file. See below for options.
InColDims [-]
Comma separted list of the number unique entries for each of the named variable column names. The number of rows in the table must be equal to the product of all numbers given. Must be the same number of entries as given in InColNames
For the input variable columns in the table, at least one column must be given, with a maximum of four of the five listed below (TSR and RtSpd are mutually exclusive).
TSR [-]
Tip Speed Ratio, cannot be used with _RtSpd_
RtSpd [rpm]
Rotor speed, cannot be used with _TSR_
VRel [m/s]
Relative velocity of wind normal to rotor
Pitch [deg]
Collective blade pitch
Skew [deg]
Skew angle of inflow. If this is not provided, the affect of skew is modeled as \((cos(\chi))^2\)
The remaining six columns of the table must contain the force and moment coefficents. See the example table below.
4.6.1.2.4. Sample input file
Note that the table given below is for illustration of the format and does not represent any particular turbine.
--- AERO DISK INPUT FILE -------
Sample actuator disk input file
--- SIMULATION CONTROL ---------
FALSE echo - Echo input data to "<RootName>.ADsk.ech" (flag)
"default" DT - Integration time step (s)
--- ENVIRONMENTAL CONDITIONS ---
1.225 AirDens - Air density (kg/m^3) (or "default")
--- ACTUATOR DISK PROPERTIES ---
63.0 RotorRad - Rotor radius (m) (or "default")
"RtSpd,VRel" InColNames - Input column headers (string) {may include a combination of "TSR, RtSpd, VRel, Pitch, Skew"} (up to 4 columns) [choose TSR or RtSpd,VRel; if Skew is absent, Skew is modeled as (COS(Skew))^2]
9,2 InColDims - Number of unique values in each column (-) (must have same number of columns as InColName) [each >=2]
RtSpd VRel C_Fx C_Fy C_Fz C_Mx C_My C_Mz
(rpm) (m/s) (-) (-) (-) (-) (-) (-)
3.0 9.0 0.2347 0.0 0.0 0.0306 0.0 0.0
4.0 9.0 0.2349 0.0 0.0 0.0314 0.0 0.0
5.0 9.0 0.2350 0.0 0.0 0.0322 0.0 0.0
6.0 9.0 0.2351 0.0 0.0 0.0330 0.0 0.0
7.0 9.0 0.2352 0.0 0.0 0.0338 0.0 0.0
8.0 9.0 0.2352 0.0 0.0 0.0346 0.0 0.0
9.0 9.0 0.2351 0.0 0.0 0.0353 0.0 0.0
10.0 9.0 0.2350 0.0 0.0 0.0361 0.0 0.0
11.0 9.0 0.2349 0.0 0.0 0.0368 0.0 0.0
3.0 12.0 0.7837 0.0 0.0 0.0663 0.0 0.0
4.0 12.0 0.7733 0.0 0.0 0.0663 0.0 0.0
5.0 12.0 0.7628 0.0 0.0 0.0663 0.0 0.0
6.0 12.0 0.7520 0.0 0.0 0.0662 0.0 0.0
7.0 12.0 0.7409 0.0 0.0 0.0660 0.0 0.0
8.0 12.0 0.7297 0.0 0.0 0.0658 0.0 0.0
9.0 12.0 0.7182 0.0 0.0 0.0656 0.0 0.0
10.0 12.0 0.7066 0.0 0.0 0.0653 0.0 0.0
11.0 12.0 0.6947 0.0 0.0 0.0649 0.0 0.0
--- OUTPUTS --------------------
OutList - The next line(s) contains a list of output parameters. See OutListParameters.xlsx for a listing of available output channels, (-)
END of input file (the word "END" must appear in the first 3 columns of this last OutList line)
--------------------------------
4.6.1.3. Outputs
- The write outputs are:
“ADSpeed”: Actuator disk rotational speed (rpm)
“ADTSR”: Actuator disk tip-speed ratio (-)
“ADPitch”: Actuator-disk collective blade-pitch angle (deg)
“ADVWindx, ADVWindy, ADVWindz”: Actuator-disk-averaged wind velocity in the local coordinate system (m/s)
“ADSTVx, ADSTVy, ADSTVz”: Actuator-disk structural translational velocity in the local coordinate system (m/s)
“ADVRel”: Actuator-disk-averaged relative wind speed (m/s)
“ADSkew”: Actuator-disk inflow-skew angle (deg)
“ADCp, ADCt, ADCq”: Actuator-disk power, thrust, and torque coefficients (-)
“ADFx, ADFy, ADFz”: Actuator disk aerodynamic force loads in the local coordinate system (N)
“ADMx, ADMy, ADMz”: Actuator disk aerodynamic moment loads in the local coordinate system (N-m)
“ADPower”: Actuator disk power (W)