Update InflowWind documentation

docs/source/user/api_change.rst

@@ -34,8 +34,7 @@ IfW driver     6    [separator line]   ===================== File Conversion Opt
 IfW driver     7    WrHAWC             false    WrHAWC    - Convert all data to HAWC2 format? (flag)
 IfW driver     8    WrBladed           false    WrBladed  - Convert all data to Bladed format? (flag)
 IfW driver     9    WrVTK              false    WrVTK     - Convert all data to VTK format? (flag)
-
-
+InflowWind     7    VFlowAng                0   VFlowAng  - Upflow angle (degrees) (not used for native Bladed format WindType=7)
 ============== ==== ================== =============================================================================================================================================================================
 
 \*non-comment line count

docs/source/user/inflowwind/appendix.rst

@@ -27,6 +27,12 @@ The primary InflowWind input file defines the inflow that is generated or read f
 This file includes lines that determine how to scale the non-dimensional full-field
 turbulence files from Bladed. 
 
+4) Uniform Wind Data File
+:download:`(uniform wind input file example) <examples/inflowwind_uniform_example.dat>`: 
+
+This file includes lines that define uniform (deterministic) wind data files.
+
+
 .. _ifw_output_channels:
 
 InflowWind List of Output Channels

docs/source/user/inflowwind/examples/inflowwind_uniform_example.dat

@@ -0,0 +1,14 @@
+! OpenFAST Deterministic Wind File
+#
+# Comment lines begin with "!" or "#" or "%", then the data lines must contain the following columns:
+#
+# If there are only 8 columns, upflow is assumed to be 0.
+#
+# Parameters are interpolated linearly between time steps; using nearest neighbor before the first time 
+# listed in this file and after the last time listed in the file. 
+#
+! Time     Wind    Wind    Vertical    Horiz.      Pwr.Law     Lin.Vert.   Gust     Upflow
+!          Speed   Dir     Speed       Shear       Vert.Shr    Shear       Speed    Angle 
+! (sec)    (m/s)   (Deg)   (m/s)                                            (m/s)   (deg)
+ 0.000000   10   0.000000   0          0.000000   0.300000   0.000000   0.000000      8
+10.000000   12   0.000000   0          0.000000   0.300000   0.000000   0.000000      8

docs/source/user/inflowwind/input.rst

@@ -1,3 +1,4 @@
+
 .. _ifw_input:
 
 InflowWind Input Files
@@ -81,3 +82,32 @@ and tower" not implemented) - Always allow wind file to wrap around
 (unchecked box not implemented) - Only power-law wind profile is
 implemented (not logarithmic, none, or user-defined)
 
+
+.. _ifw_angles:
+
+Angles Specified in InflowWind
+==============================
+Wind direction and upflow angles can be specified in the InflowWind input file.
+When using Native Bladed wind file support in InflowWind, the angles from the InflowWind input are overwritten
+with the values specified in the Native Bladed Input Files. 
+InflowWind rotates the wind box about the hub-height tower center line by these wind direction and upflow angles.
+
+The uniform wind files also specify wind direction and upflow angles.
+The angles specified in uniform wind files DO NOT rotate the wind box, but just convert the local wind speed into global coordinates.
+
+When converting from local ``[u v w]`` to global ``[U V W]`` reference systems, the upflow rotation, ``R(upflow)`` occurs 
+before the wind direction rotation, ``R(wind direction)``:
+
+::
+
+[U V W] = R(wind direction) * R(upflow) * [u v w]
+
+When using a combination of angles in InflowWind and UniformWind files, the UniformWind angles are applied first. 
+
+Note: This means that if you have upflow specified in InflowWind and wind direction specified in UniformWind, the rotation will 
+be performed in a different order than if both angles are specified in the same file.
+
+::
+
+[U V W] = R(wind direction: InflowWind) * R(upflow: InflowWind) * R(wind direction: UniformWind) * R(upflow: UniformWind) * [u v w]
+