Skip to content
This repository was archived by the owner on Nov 27, 2023. It is now read-only.

Commit 22ad032

Browse files
ebranlardebranlard
authored
Merge pull request #49 from OpenFAST/dev
Version 3.3.0
2 parents 865ec3e + 4c54e20 commit 22ad032

File tree

107 files changed

+9458
-5557
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

107 files changed

+9458
-5557
lines changed

‎.github/workflows/development-pipeline.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ jobs:
1717
runs-on: ubuntu-latest
1818
strategy:
1919
matrix:
20-
python-version: [3.6, 3.7, 3.8] # 2.7,
20+
python-version: [3.6, 3.7, 3.8] #
2121
steps:
2222
- name: Checkout
2323
uses: actions/checkout@main

‎.gitignore

+2
Original file line numberDiff line numberDiff line change
@@ -113,6 +113,8 @@ venv.bak/
113113
*.ech
114114
*.out
115115
*.outb
116+
*.viz
117+
*.pyPostMBC
116118

117119
# Hidding files starting with underscore except init
118120
_*

‎README.md

+10-1
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,8 @@ pytest
2222

2323
The repository contains a set of small packages:
2424

25-
- input\_output: read/write OpenFAST/FAST.Farm/OLAF input and output files (see [README](pyFAST/input_output)) and postprocess OpenFAST outputs (see [examples](pyFAST/input_output/examples))
25+
- input\_output: read/write OpenFAST/FAST.Farm/OLAF input and output files (see [README](pyFAST/input_output))
26+
- postpro: postprocess OpenFAST outputs (extract radial data, compute fatigue loads) (see [examples](pyFAST/postpro/examples))
2627
- linearization: tools to deal with OpenFAST linearization, e.g. generate a Campbell diagram (see [examples](pyFAST/linearization/examples/))
2728
- aeroacoustics: tools for aeroacoustics (generate BL files and plot outputs)
2829
- case\_generation: tools to generate and run a set of input of OpenFAST input files (see [examples](pyFAST/case_generation/examples))
@@ -75,6 +76,14 @@ ADpol = polar.toAeroDyn('AeroDyn_Polar_DU21_A17.dat')
7576
### Write a set of OpenFAST input file for multiple simulations
7677
Find examples scripts in this [folder](pyFAST/case_generation/examples).
7778

79+
### Postprocessing
80+
81+
Below are different scripts to manipulate OpenFAST outputs:
82+
83+
- [Extract average radial data](pyFAST/postpro/examples/Example_RadialPostPro.py).
84+
- [Interpolate data at different radial positions](pyFAST/postpro/examples/Example_RadialInterp.py).
85+
- [Compute damage equivalent loads](pyFAST/postpro/examples/Example_EquivalentLoad.py).
86+
- [Change column names and units](pyFAST/postpro/examples/Example_Remap.py).
7887

7988

8089
## Future work and friend projects

‎data/NREL5MW/5MW_Baseline/NRELOffshrBsline5MW_ServoDyn_StC.dat

+96-94
Large diffs are not rendered by default.

‎data/NREL5MW/5MW_Land_Lin_BladeOnly/ElastoDyn.dat

+145
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,145 @@
1+
------- ELASTODYN v3.2 INPUT FILE ----------------------------------------------
2+
NREL 5.0 MW Baseline Wind Turbine for Use in Offshore Analysis. Properties from Dutch Offshore Wind Energy Converter (DOWEC) 6MW Pre-Design (10046_009.pdf) and REpower 5M 5MW (5m_uk.pdf)
3+
---------------------- SIMULATION CONTROL --------------------------------------
4+
False Echo - Echo input data to "<RootName>.ech" (flag)
5+
3 Method - Integration method: {1: RK4, 2: AB4, or 3: ABM4} (-)
6+
"DEFAULT" DT - Integration time step (s)
7+
---------------------- DEGREES OF FREEDOM --------------------------------------
8+
True FlapDOF1 - First flapwise blade mode DOF (flag)
9+
True FlapDOF2 - Second flapwise blade mode DOF (flag)
10+
True EdgeDOF - First edgewise blade mode DOF (flag)
11+
False TeetDOF - Rotor-teeter DOF (flag) [unused for 3 blades]
12+
False DrTrDOF - Drivetrain rotational-flexibility DOF (flag)
13+
False GenDOF - Generator DOF (flag)
14+
False YawDOF - Yaw DOF (flag)
15+
False TwFADOF1 - First fore-aft tower bending-mode DOF (flag)
16+
False TwFADOF2 - Second fore-aft tower bending-mode DOF (flag)
17+
False TwSSDOF1 - First side-to-side tower bending-mode DOF (flag)
18+
False TwSSDOF2 - Second side-to-side tower bending-mode DOF (flag)
19+
False PtfmSgDOF - Platform horizontal surge translation DOF (flag)
20+
False PtfmSwDOF - Platform horizontal sway translation DOF (flag)
21+
False PtfmHvDOF - Platform vertical heave translation DOF (flag)
22+
False PtfmRDOF - Platform roll tilt rotation DOF (flag)
23+
False PtfmPDOF - Platform pitch tilt rotation DOF (flag)
24+
False PtfmYDOF - Platform yaw rotation DOF (flag)
25+
---------------------- INITIAL CONDITIONS --------------------------------------
26+
0 OoPDefl - Initial out-of-plane blade-tip displacement (meters)
27+
0 IPDefl - Initial in-plane blade-tip deflection (meters)
28+
0 BlPitch(1) - Blade 1 initial pitch (degrees)
29+
0 BlPitch(2) - Blade 2 initial pitch (degrees)
30+
0 BlPitch(3) - Blade 3 initial pitch (degrees) [unused for 2 blades]
31+
0 TeetDefl - Initial or fixed teeter angle (degrees) [unused for 3 blades]
32+
0 Azimuth - Initial azimuth angle for blade 1 (degrees)
33+
0 RotSpeed - Initial or fixed rotor speed (rpm)
34+
0 NacYaw - Initial or fixed nacelle-yaw angle (degrees)
35+
0 TTDspFA - Initial fore-aft tower-top displacement (meters)
36+
0 TTDspSS - Initial side-to-side tower-top displacement (meters)
37+
0 PtfmSurge - Initial or fixed horizontal surge translational displacement of platform (meters)
38+
0 PtfmSway - Initial or fixed horizontal sway translational displacement of platform (meters)
39+
0 PtfmHeave - Initial or fixed vertical heave translational displacement of platform (meters)
40+
0 PtfmRoll - Initial or fixed roll tilt rotational displacement of platform (degrees)
41+
0 PtfmPitch - Initial or fixed pitch tilt rotational displacement of platform (degrees)
42+
0 PtfmYaw - Initial or fixed yaw rotational displacement of platform (degrees)
43+
---------------------- TURBINE CONFIGURATION -----------------------------------
44+
1 NumBl - Number of blades (-)
45+
63 TipRad - The distance from the rotor apex to the blade tip (meters)
46+
1.5 HubRad - The distance from the rotor apex to the blade root (meters)
47+
-2.5 PreCone(1) - Blade 1 cone angle (degrees)
48+
-2.5 PreCone(2) - Blade 2 cone angle (degrees)
49+
-2.5 PreCone(3) - Blade 3 cone angle (degrees) [unused for 2 blades]
50+
0 HubCM - Distance from rotor apex to hub mass [positive downwind] (meters)
51+
0 UndSling - Undersling length [distance from teeter pin to the rotor apex] (meters) [unused for 3 blades]
52+
0 Delta3 - Delta-3 angle for teetering rotors (degrees) [unused for 3 blades]
53+
0 AzimB1Up - Azimuth value to use for I/O when blade 1 points up (degrees)
54+
-5.0191 OverHang - Distance from yaw axis to rotor apex [3 blades] or teeter pin [2 blades] (meters)
55+
1.912 ShftGagL - Distance from rotor apex [3 blades] or teeter pin [2 blades] to shaft strain gages [positive for upwind rotors] (meters)
56+
-5 ShftTilt - Rotor shaft tilt angle (degrees)
57+
1.9 NacCMxn - Downwind distance from the tower-top to the nacelle CM (meters)
58+
0 NacCMyn - Lateral distance from the tower-top to the nacelle CM (meters)
59+
1.75 NacCMzn - Vertical distance from the tower-top to the nacelle CM (meters)
60+
-3.09528 NcIMUxn - Downwind distance from the tower-top to the nacelle IMU (meters)
61+
0 NcIMUyn - Lateral distance from the tower-top to the nacelle IMU (meters)
62+
2.23336 NcIMUzn - Vertical distance from the tower-top to the nacelle IMU (meters)
63+
1.96256 Twr2Shft - Vertical distance from the tower-top to the rotor shaft (meters)
64+
87.6 TowerHt - Height of tower above ground level [onshore] or MSL [offshore] (meters)
65+
0 TowerBsHt - Height of tower base above ground level [onshore] or MSL [offshore] (meters)
66+
0 PtfmCMxt - Downwind distance from the ground level [onshore] or MSL [offshore] to the platform CM (meters)
67+
0 PtfmCMyt - Lateral distance from the ground level [onshore] or MSL [offshore] to the platform CM (meters)
68+
0 PtfmCMzt - Vertical distance from the ground level [onshore] or MSL [offshore] to the platform CM (meters)
69+
0 PtfmRefzt - Vertical distance from the ground level [onshore] or MSL [offshore] to the platform reference point (meters)
70+
---------------------- MASS AND INERTIA ----------------------------------------
71+
0 TipMass(1) - Tip-brake mass, blade 1 (kg)
72+
0 TipMass(2) - Tip-brake mass, blade 2 (kg)
73+
0 TipMass(3) - Tip-brake mass, blade 3 (kg) [unused for 2 blades]
74+
56780 HubMass - Hub mass (kg)
75+
115926 HubIner - Hub inertia about rotor axis [3 blades] or teeter axis [2 blades] (kg m^2)
76+
534.116 GenIner - Generator inertia about HSS (kg m^2)
77+
240000 NacMass - Nacelle mass (kg)
78+
2.60789E+06 NacYIner - Nacelle inertia about yaw axis (kg m^2)
79+
0 YawBrMass - Yaw bearing mass (kg)
80+
0 PtfmMass - Platform mass (kg)
81+
0 PtfmRIner - Platform inertia for roll tilt rotation about the platform CM (kg m^2)
82+
0 PtfmPIner - Platform inertia for pitch tilt rotation about the platform CM (kg m^2)
83+
0 PtfmYIner - Platform inertia for yaw rotation about the platform CM (kg m^2)
84+
---------------------- BLADE ---------------------------------------------------
85+
17 BldNodes - Number of blade nodes (per blade) used for analysis (-)
86+
"../5MW_Baseline/NRELOffshrBsline5MW_Blade.dat" BldFile(1) - Name of file containing properties for blade 1 (quoted string)
87+
"../5MW_Baseline/NRELOffshrBsline5MW_Blade.dat" BldFile(2) - Name of file containing properties for blade 2 (quoted string)
88+
"../5MW_Baseline/NRELOffshrBsline5MW_Blade.dat" BldFile(3) - Name of file containing properties for blade 3 (quoted string) [unused for 2 blades]
89+
---------------------- ROTOR-TEETER --------------------------------------------
90+
0 TeetMod - Rotor-teeter spring/damper model {0: none, 1: standard, 2: user-defined from routine UserTeet} (switch) [unused for 3 blades]
91+
0 TeetDmpP - Rotor-teeter damper position (degrees) [used only for 2 blades and when TeetMod=1]
92+
0 TeetDmp - Rotor-teeter damping constant (N-m/(rad/s)) [used only for 2 blades and when TeetMod=1]
93+
0 TeetCDmp - Rotor-teeter rate-independent Coulomb-damping moment (N-m) [used only for 2 blades and when TeetMod=1]
94+
0 TeetSStP - Rotor-teeter soft-stop position (degrees) [used only for 2 blades and when TeetMod=1]
95+
0 TeetHStP - Rotor-teeter hard-stop position (degrees) [used only for 2 blades and when TeetMod=1]
96+
0 TeetSSSp - Rotor-teeter soft-stop linear-spring constant (N-m/rad) [used only for 2 blades and when TeetMod=1]
97+
0 TeetHSSp - Rotor-teeter hard-stop linear-spring constant (N-m/rad) [used only for 2 blades and when TeetMod=1]
98+
---------------------- DRIVETRAIN ----------------------------------------------
99+
100 GBoxEff - Gearbox efficiency (%)
100+
97 GBRatio - Gearbox ratio (-)
101+
8.67637E+08 DTTorSpr - Drivetrain torsional spring (N-m/rad)
102+
6.215E+06 DTTorDmp - Drivetrain torsional damper (N-m/(rad/s))
103+
---------------------- FURLING -------------------------------------------------
104+
False Furling - Read in additional model properties for furling turbine (flag) [must currently be FALSE)
105+
"unused" FurlFile - Name of file containing furling properties (quoted string) [unused when Furling=False]
106+
---------------------- TOWER ---------------------------------------------------
107+
20 TwrNodes - Number of tower nodes used for analysis (-)
108+
"../5MW_Baseline/NRELOffshrBsline5MW_Onshore_ElastoDyn_Tower.dat" TwrFile - Name of file containing tower properties (quoted string)
109+
---------------------- OUTPUT --------------------------------------------------
110+
False SumPrint - Print summary data to "<RootName>.sum" (flag)
111+
1 OutFile - Switch to determine where output will be placed: {1: in module output file only; 2: in glue code output file only; 3: both} (currently unused)
112+
True TabDelim - Use tab delimiters in text tabular output file? (flag) (currently unused)
113+
"ES10.3E2" OutFmt - Format used for text tabular output (except time). Resulting field should be 10 characters. (quoted string) [not checked for validity!] (currently unused)
114+
0 TStart - Time to begin tabular output (s) (currently unused)
115+
1 DecFact - Decimation factor for tabular output {1: output every time step} (-) (currently unused)
116+
0 NTwGages - Number of tower nodes that have strain gages for output [0 to 9] (-)
117+
0 TwrGagNd - List of tower nodes that have strain gages [1 to TwrNodes] (-) [unused if NTwGages=0]
118+
0 NBlGages - Number of blade nodes that have strain gages for output [0 to 9] (-)
119+
5, BldGagNd - List of blade nodes that have strain gages [1 to BldNodes] (-) [unused if NBlGages=0]
120+
OutList - The next line(s) contains a list of output parameters. See OutListParameters.xlsx for a listing of available output channels, (-)
121+
"OoPDefl1" - Blade 1 out-of-plane and in-plane deflections and tip twist
122+
"IPDefl1" - Blade 1 out-of-plane and in-plane deflections and tip twist
123+
"BldPitch1" - Blade 1 pitch angle
124+
"Azimuth" - Blade 1 azimuth angle
125+
"RotSpeed" - Low-speed shaft and high-speed shaft speeds
126+
"GenSpeed" - Low-speed shaft and high-speed shaft speeds
127+
"TTDspFA" - Tower fore-aft and side-to-side displacements and top twist
128+
"TTDspSS" - Tower fore-aft and side-to-side displacements and top twist
129+
"RootMyc1" - In-plane bending, out-of-plane bending, and pitching moments at the root of blade 1
130+
"RotThrust" - Rotor thrust at the main bearing
131+
"RotTorq" - Rotor torque at the main bearing
132+
"RotPwr" - Rotor power (this is equivalent to the low-speed shaft power)
133+
"TwrBsFxt" - Fore-aft shear, side-to-side shear, and vertical forces at the base of the tower (mudline)
134+
"TwrBsFyt" - Fore-aft shear, side-to-side shear, and vertical forces at the base of the tower (mudline)
135+
"TwrBsFzt" - Fore-aft shear, side-to-side shear, and vertical forces at the base of the tower (mudline)
136+
"TwrBsMxt" - Side-to-side bending, fore-aft bending, and yaw moments at the base of the tower (mudline)
137+
"TwrBsMyt" - Side-to-side bending, fore-aft bending, and yaw moments at the base of the tower (mudline)
138+
"TwrBsMzt" - Side-to-side bending, fore-aft bending, and yaw moments at the base of the tower (mudline)
139+
END of input file (the word "END" must appear in the first 3 columns of this last OutList line)
140+
---------------------- NODE OUTPUTS --------------------------------------------
141+
0 BldNd_BladesOut - Blades to output
142+
99 BldNd_BlOutNd - Blade nodes on each blade (currently unused)
143+
OutListED - The next line(s) contains a list of output parameters. See OutListParameters.xlsx, ElastoDyn_Nodes tab for a listing of available output channels, (-)
144+
END of input file (the word "END" must appear in the first 3 columns of this last OutList line)
145+
---------------------------------------------------------------------------------------

0 commit comments

Comments
 (0)