OpenFAST input into Ashes
OpenFAST is an open-source wind turbine simulation tool (see
https://github.com/OpenFAST
). OpenFAST is based on FAST developed by NREL (see
https://nwtc.nrel.gov/FAST
). This section lists the inputs that are necessary to create a wind turbine model in OpenFAST, and their equivalent in Ashes.
Because of differences in the theories and implementations in
OpenFAST
and Ashes, not all parameters in
OpenFAST
are applicable to Ashes, and vice-versa. In this section, the parameters that do not have an equivalent in Ashes or that are not relevant are omitted. More information about
OpenFAST
can be found in the user guide here
https://openfast.readthedocs.io/en/master/
An
OpenFAST
model is composed of many different input files. Here, the different subsection cover the different input files necessary to create an onshore turbine with
OpenFAST
.
This section applies to the version
OpenFAST 2.1.0
, released
2019-03-27
1 Main file (.fst)
This file is the mother file in
OpenFAST
. It contains some of the information about the simulation and the solver, and links to other files that define the model. This file is composed of the following sections:
1.1 Simulation control
| OpenFAST | Ashes | Comment |
| TMax |
N/A in time simulation
Duration in the Batch window |
Total simulation time |
| DT | Analysis -> General-> Time step | Time step of the finite element solver |
1.2 Feature switches and flags
This section tells OpenFAST which modules will be included in the simulation (for example, a module to include Mooring lines or to compute aerodynamic loads). Ashes is not based on a modular framework, therefore all features are included by default but can be removed during a simulation.
|
OpenFAST
|
Ashes | Comment |
| CompElast | N/A | In Ashes, the whole structure is considered by default, which is equivalent to have this parameter set to 2 in FAST. To remove the blades in Ashes, you can remove the RNA in the Support structure files . You can also simulate stiff blades with the parameter Analysis ->General->Rotor model . It is also possible to set the number of blades to 0 with the Rotor ->Number of Blades parameter. |
| CompInflow | N/A | The wind type in Ashes is defined by the Atmosphere ->Wind type parameter |
| CompAero | N/A | By default, the aerodynamic loads in Ashes are computed using the Unsteady BEM algorithm. This can be changed in the Aerodynamics ->Advanced tab. It is possible to turn off the aerodynamic loads in the Live Window of the Simulation window |
| CompServo | N/A | By default, a controller is included in Ashes. |
| CompHydro | N/A | By default, hydrodynamic loads are included in Ashes, but can be turned off in the Live Window of the Simulation window |
| CompSub | N/A | Soil-Structure interaction can be included in Ashes in the Support section files . More info about the soil-structure interaction is given in the theory manual, in the Geotechnical modeling section. |
| CompMoring | N/A | Mooring lines can be included for floaters in the Support section files . More information about the mooring lines can be found in the theory manual in the Catenary lines section. |
| CompIce | N/A | For the time being, there is no model for Ice on blades in Ashes. The suggested workaround is to modify the characteristics of the blades in the Blade shape file and the Blade structure file . |
1.3 Input files
The parameters composing the different FAST files are explained in the rest of the subsections of this section.
| n OpenFAST | Ashes | Comment |
| EDFile | N/A | Defines the initial conditions and the model configuration. |
| BDBldFile | N/A | The blades in Ashes are defined in the Blade database . Different blades can be selected with the Rotor ->Blade type parameter. |
| InflowFile | N/A | The wind type in Ashes is defined by the Atmosphere ->Wind type parameter |
| AeroFile | N/A | Defines the aerodynamic parameters of the simulations. |
| ServoFile | N/A | Defines the controller. |
| Hydrofile | N/A | Defines the hydrodynamic parameters of the simulation |
| SubFile | N/A | Defines the soil-structure interaction parameters |
| MoorignFile | N/A | Defines the mooring lines |
| IceFile | N/A | Defines the input for modeling ice on the blades |
1.4 Output
In Ashes, the ouput is managed through the
Sensors
.
1.5 Linearization
Simulations in Ashes are fully non-linear unless specified otherwise in the
Analysis parameters
.
1.6 Visualization
In Ashes, the model is visualized in the
Simulation window
.
The data can be visualized in the Sensors pane (see Visualize the data ).
The data can be visualized in the Sensors pane (see Visualize the data ).
2 EDFile (ElastoDyn file)
In OpenFAST, the EDFile (for
ElastoDynFile
)
defines the initial conditions of the simulations and some parameters related to the simulation. This file is composed of the following sections:
2.1 Simulation control
|
OpenFAST
|
Ashes | Comment |
| DT | Analysis -> Time step | Time step of the FEM solver. In Ashes, it is not possible to define different time steps for different parts of the simulation |
2.2 Environmental conditions
|
OpenFAST
|
Ashes | Comment |
| Gravity | Environment ->Gravitational acceleration | To change the gravitational acceleration in Ashes, you also have to change the parameter Environment ->Gravity scheme to User defined |
2.3 Degrees of Freedom
All degrees of freedom are enabled by default in Ashes. You can block certain degrees of freedom by adding
Supports
to the
Support section files
2.4 Initial conditions
In Ashes, the state of the structure at time t = 0 (i.e. Initial conditions) is specified in the
Analysis parameters
window, in the
Initial conditions
tab.
Not all initial conditions from the OpenFAST EDFile can be specified in Ashes. In particular, Ashes does not allow yet for displacements as initial conditions, unless the whole structure's initial conditions is specified as a given mode shape. This can be done by specifying
Use mode shape as initial conditions
in the
Initial conditions
tab.
The initial conditions that can be specified in Ashes are given in the following table:
|
OpenFAST
|
Ashes | Comment |
| BlPitch(x) | Pitch angle | Initial pitch angle of all blades in of the WT. Note that Ashes does not allow for different starting pitch angles for different blades |
| Azimuth | Azimuth angle | Azimuth angle for the first blade. An angle of 0 corresponds to the blade pointing upwards |
| RotSpeed | RPM | Rotational speed of the rotor. Note that in Ashes you can also specify an initial TSR or an initial Blade Tip Speed. |
| NacYaw | Yaw angle | Angle of the RNA around the yaw axis |
2.5 Turbine configiration
This section defines several parameter of the model.
|
OpenFAST
|
Ashes | Comment |
| NumBl | Rotor ->Number of blades | |
| TipRad | N/A | In Ashes the tip radius is defined by the blade length and the rotor hub |
| HubRad | Hub ->Radius | Hub Radius. The root of the blade will be placed this distance from the main shaft |
| PreCone(x) | Rotor ->Cone angle | In Ashes, the cone angle is the same for all blades of the WT. Note that a negative cone angle in OpenFAST correpsonds to a positive one in Ashes |
| HubCM | N/A | In Ashes, the center of mass of the hub is located at the center of the hub. This can be adjusted by varying the parameters of the main shaft. |
| OverHang | Main shaft ->Hori. Distance to Hub | In OpenFAST , the distance between the hub and the tower top is given along the main shaft. This means that these parameters will not be equal in Ashes and FAST if the tilt angle is different than 0 |
| ShftGagL | Main shaft ->Front bearing position | Note that in Ashes this distance is given as a percentage of the shaft length |
| ShftTilt | RNA ->Tilt angle | Note that a negative tilt angle in OpenFAST corresponds to a positive one in Ashes |
| NacMxn | Nacelle frame ->CM horizontal offset | Horizontal position of the center of mass of the nacell wrt the tower top. Note that a positive value in OpenFAST corresponds to a negative one in Ashes. |
| NacMzn | Nacelle frame ->CM vertical offset | Vertical position of the center of mass of the nacelle wrt the tower top (this time Ashes and OpenFAST have the same sign convention, yey!) |
| Twr2Shft | Main shaft ->Vert. Distance to hub | Note that OpenFAST requires the distance between the tower top and the shaft, whereas Ashes requires the distance between the tower top and the hub. To get the two to match, you will need to account for the Horizontal distance to hub and the cone angle. |
| TowerHt | Tubular tower ->Height | For tubular towers defined by Support section files , this parameter will disappear and the tower height will be defined by the position of the nodes in the file instead |
| TowerBsHt | Support structure ->Vertical offset | |
| PtfmCMxt | Support structure ->Initial Surge | This parameter is only available for Floaters |
| PtfmCMyt | Support structure ->Initial Sway | This parameter is only available for Floaters |
| PtfmCMzt | Support structure -> Draft | This parameter is only available for Floaters |
2.6 Mass and Inertia
|
OpenFAST
|
Ashes | Comment |
| HubMass | Hub ->Mass | To modify the hub mass, you also have to change the parameter Mass scheme to User defined |
| HubIner | Hub ->Inertia | Inerta of the hub around the rotor axis |
| NacMass | Nacelle frame ->Mass |
2.7 Blade
The blades in Ashes are defined in the
Blade database
.
The blades can be selected with the
Rotor
->Blade type
parameter
2.8 Rotor teeter
It is not possible to implement teeters in Ashes..
2.9 Drivetrain
|
OpenFAST
|
Ashes | Comment |
| GboxEff | N/A | To account for the efficiency of the Gearbox, you can include it in the generator efficiency with the Generator ->Efficiency factor parameter |
| GBRatio | Gearbox ->Gear ratio |
2.10 Furling
It is not possible to implement furling systems in Ashes.
2.11 Tower
|
OpenFAST
|
Ashes | Comment |
| TwrNodes | Tubular tower ->Maximum element lenght | In Ashes, you cannot input the number of elements of the tower but rather the maximum length of each element. For towers defined by Support section files , this parameter is not available and the number of nodes will be defined by the file itself. |
| TwrFile | Tubular tower ->Input file | In Ashes, support structures are modelled with FEM frame elements, as opposed to mode shapes. Therefore, the file describing the tower in Ashes is very different than the one in OpenFAST . |
2.12 Output
In Ashes, the ouput are managed in the
Sensors
pane.
3 BDBldFile (BeamDyn Blade file)
Ashes uses a database system to manage the blades. New blades can be created and stored in the
Blade database
, and selected for the current model with the
Rotor
->Blade type
parameter.
Note that to create a new blade, you must make sure that the airfoils composing this blade are added to the
Airfoil database
4 TwrFile (Tower file)
Tower input files can be defined as explained in the
Support section examples
section.
4.1 Tower parameters
|
OpenFAST
|
Ashes | Comment |
| NTwrInpSt | N/A | In Ashes, the number of tower elements is defined by the elements created in the Members section |
| TwrFADmp (1) | N/A | Damping for the tower can be modelled with Rayleigh damping to obtain a given damping ratio at a given eigenperiod (see How to use Rayleigh damping ) |
| TwrFADmp (2) | N/A | Damping for the tower can be modelled with Rayleigh damping to obtain a given damping ratio at a given eigenperiod (see How to use Rayleigh damping ) |
4.2 Distributed tower properties
It is possible to define the elements of a tower based on their structural properties rather than their geometrical properties by using
Circular shape cross sections
(see
Keywords
) in the
Support section files
. In that case the following properties can be adjusted:
|
OpenFAST
|
Ashes | Comment |
| HtFract | z-coordinate | In Ashes, elements are defined as going from one node to another. It is possible to define the height of an element by adjusting the height of its defining nodes |
| TMassDen | Mass | |
| TwFAStif/TwSSStif | EI | For Circular shape cross section , only one stiffness can be defined. If the stiffness of the elements is different in the longitudinal and transversal directions, Rectangular shape cross section must be selected. |
5 Inflowfile
This file defines the atmospheric environmental conditions.
|
OpenFAST
|
Ashes | Comments |
| WindType | Atmosphere ->Wind Type |
5.1 Parameters for steady wind conditions
This wind type corresponds to
Live
or
Uniform
in Ashes
|
OpenFAST
|
Ashes | Comments |
| HWindSpeed | Uniform wind ->Initial wind speed | |
| RefHt | Uniform wind ->Reference height | This parameter only appears if the Reference height Scheme is set to User defined |
| PLexp | Uniform wind ->Power law exponent | This parameter only appears if Shear is toggled on |
5.2 Turbulent wind
Ashes can read turbulent wind files generated with
TurbSim
or with the
IEC Mann turbulence generator
(corresponding to the
HAWC2 format
in OpenFAST). This files can be generated with the
Turbulent wind tool
and selected as input with the
Turbulent wind
->Turbulent wind file
parameter.
If a Mann turbulence wind file (i.e. HAWC2 format) is selected, the following parameters can be applied in Ashes:
|
OpenFAST
|
Ashes | Comments |
| nx - ny - nz | Number of grid points | These can be defined in the Turbulent wind tool |
| dx - dy - dz | Distance between grids | These are calculated based on the number of grid points and the dimensions of the grid |
| RefHt | Turbulent wind ->Reference height | This parameter only appears if the Reference height Scehem is set to User defined |
| SigmaFx | Turbulent wind ->Turbulence intensity | Ashes requires the turbulence intensity while FAST requires the standard deviation. |
| Uref | Turbulent wind ->Avegare wind speed | |
| PLExp | Turbulent wind ->Power law exponent | Only appears if Shear is toggled on |
6 AeroFile
The aerofile contains the parameters of the aerodynamic simulation and of some environmental conditions. The parameters for the aerodynamic computation can generally be found in the
Analysis parameters
window under the
Aerodynamics
tab. The parameter for the environmental conditions can generally be found in the
Atmosphere
part.
6.1 Simulation control
|
OpenFAST
|
Ashes | Comment |
| DTAero | Analysis ->Time step | In Ashes, the time step for the aerodynamic loads computation is the same as the finite element solver |
| WakeMode | Aerodynamics ->Advanced->BEM mode | In Ashes you can chose between a Steady BEM or an Unsteady BEM algorithm. You can toggle the aerodynamic loads off in the Live window |
| AFAeroMod | N/A |
Dynamic stall is applied by default when using
Unsteady BEM
|
| TwrShadow | Aerodynamics ->Tower shadow | The influence of the tower is computed based on potential flow theory |
| TwrAero | N/A | Aerodynamic drag loads on the tower are computed by default. You can remove them by setting the drag coefficient to 0, in the Aerodynamics section for parameterized towers or in the Support section files for input file based towers |
6.2 Environmental conditions
|
OpenFAST
|
Ashes | Comment |
| AirDens | Atmosphere ->Air density | Only visible if the Density scheme is set to User defined |
| KinVisc | Atmosphere ->Dynamic viscosity (of air) | Ashes requires the dynamic viscosity whereas FAST requires the kinematic viscosity. Only visible if the Viscosity scheme is set to User defined. |
6.3 Blade-Element/Momentum Theory options
Details about how the BEM theory is implemented in Ashes can be found in the theory manual, in the
BEM algorithm
section.
|
OpenFAST
|
Ashes | Comment |
| SkewMod | N/A | Only one type of skewed-wake correction is available in Ashes (see Steady BEM ) |
| TipLoss | Aerodynamics ->Tip Loss Correction | Following Prandtl's model, see Steady BEM |
| HubLoss | Aerodynamics ->Hub Loss correction | Following Prandtl's model, see Steady BEM |
| TanInd | N/A | Ashes always includes the tangential induction in the BEM computation |
| AIDrag | N/A | Ashes always includes the drag term in the axial-induction calculations |
| TIDrag | N/A | Ashes always includes the drag term in the tangential-induction calculation |
6.4 Airfoil information and Rotor/Blade Properties
In Ashes, the blades and airfoils are defined in the
Blade database
and the
Airfoil database
, respectively. The accepted formats for the input files are given in the
File formats
section.
6.5 Tower Influence and Aerodynamics
In Ashes, the tower can be defined either by parameters or by an input file.
If the tower is defined by parameters , the diameter at different heights is calculated based on the parameters input in the Tubular tower Part. The aerodynamic drag coefficient is then input in Aerodynamics ->Aero drag coefs. of circular cs.
If the tower is defined by parameters , the diameter at different heights is calculated based on the parameters input in the Tubular tower Part. The aerodynamic drag coefficient is then input in Aerodynamics ->Aero drag coefs. of circular cs.
If the tower is defined from file
, the diameter and the drag coefficient will be input in the
Support section files
.
7 ServoFile
This file defines the characteristics of the controller. The parameterized controller in Ashes is implemented according to Section 7.2 of the definition of the NREL 5 MW turbine document (
Jonkman et al. (2009o)
, available here
https://www.nrel.gov/docs/fy09osti/38060.pdf
)
Both OpenFAST and Ashes can read Bladed-style dlls. In Ashes, the path to the dll file is input in the
External controller
window.